ইনস্টলেশন

আপনি PyPI থেকে লাইব্রেরি ইনস্টল করছেন বা GitHub থেকে ক্লোন করছেন, আমরা আপনাকে একটি সক্রিয় ভার্চুয়াল পরিবেশ ব্যবহার করে নীচের পদক্ষেপগুলি পরিচালনা করার পরামর্শ দিচ্ছি। কিভাবে একটি ভার্চুয়াল পরিবেশ তৈরি এবং সক্রিয় করতে হয় সে সম্পর্কে তথ্যের জন্য, ভার্চুয়াল এনভায়রনমেন্ট ডকুমেন্টেশন দেখুন।

PyPI থেকে মডিউল ইনস্টল করুন

লাইব্রেরিটি PyPI তে বিতরণ করা হয় এবং নিম্নলিখিত কমান্ডের সাহায্যে পিপ ব্যবহার করে ইনস্টল করা যেতে পারে:

python -m pip install google-ads

GitHub থেকে লাইব্রেরি ইনস্টল করুন

লাইব্রেরির সোর্স কোড গিটহাব থেকে আপনার স্থানীয় মেশিনে ক্লোন করা যেতে পারে। সহজে উদাহরণগুলি চালানোর জন্য বা লাইব্রেরি নিজেই বিকাশ করার জন্য সোর্স কোড ক্লোন করা দরকারী। রেফারেন্সের জন্য, ব্যবহারের জন্য লাইব্রেরি কনফিগার করার জন্য একটি প্রমাণীকরণ উদাহরণ চালানো একটি প্রয়োজনীয় পদক্ষেপ।

  1. নিশ্চিত করুন যে python3.8 বা তার পরে আপনার পরিবেশে উপস্থিত রয়েছে। সবচেয়ে সহজ উপায় হল pyenv ব্যবহার করা:

    pyenv local 3.8
  2. GitHub থেকে ক্লায়েন্ট লাইব্রেরি ক্লোন করুন:

    git clone git@github.com:googleads/google-ads-python.git
  3. সংগ্রহস্থল লিখুন এবং এটি ইনস্টল করুন:

    cd google-ads-python
    python -m pip install .
  4. আপনি যদি লাইব্রেরিটি বিকাশ করতে চান তবে কোনও পরিবর্তন করার আগে এবং পরে ইউনিট পরীক্ষা চালান:

    1. আপনার পরিবেশে পাইথন ভাষার সমস্ত সমর্থিত সংস্করণ উপলব্ধ রয়েছে তা নিশ্চিত করুন। pyenv ব্যবহার করে ::

      pyenv local 3.8 3.9 3.10 3.11 3.12
    2. লাইব্রেরির পরীক্ষা-নির্দিষ্ট নির্ভরতা ইনস্টল করুন:

      python -m pip install .[tests]
    3. লাইব্রেরি সঠিকভাবে কাজ করছে তা নিশ্চিত করতে ইউনিট পরীক্ষা চালান:

      nox
    4. ঐচ্ছিক: ইউনিট পরীক্ষাগুলি ডকার ব্যবহার করেও চালানো যেতে পারে। প্রথমত, আপনাকে অবশ্যই ডকার ইনস্টল করতে হবে। তারপর, google-ads-python ডিরেক্টরি থেকে, নিম্নলিখিতগুলি চালান:

      docker build -t google-ads-python:test .
      docker run -it google-ads-python:test nox