fastapi/docs/bn/docs/environment-variables.md

এনভায়রনমেন্ট ভেরিয়েবলস

/// tip

আপনি যদি "এনভায়রনমেন্ট ভেরিয়েবলস" কী এবং সেগুলো কীভাবে ব্যবহার করতে হয় সেটা জানেন, তাহলে এই অংশটি স্কিপ করে যেতে পারেন।

///

এনভায়রনমেন্ট ভেরিয়েবল (সংক্ষেপে "env var" নামেও পরিচিত) হলো এমন একটি ভেরিয়েবল যা পাইথন কোডের বাইরে, অপারেটিং সিস্টেমে থাকে এবং আপনার পাইথন কোড (বা অন্যান্য প্রোগ্রাম) দ্বারা যাকে রিড করা যায়।

এনভায়রনমেন্ট ভেরিয়েবলস অ্যাপ্লিকেশনের সেটিংস পরিচালনা করতে, পাইথনের ইনস্টলেশন প্রক্রিয়ার অংশ হিসেবে, ইত্যাদি কাজে উপযোগী হতে পারে।

Env Vars তৈরী এবং ব্যবহার

আপনি শেল (টার্মিনাল)-এ, পাইথনের প্রয়োজন ছাড়াই, এনভায়রনমেন্ট ভেরিয়েবলস তৈরি এবং ব্যবহার করতে পারবেনঃ

//// tab | লিনাক্স, ম্যাকওএস, উইন্ডোজ Bash

// আপনি চাইলে MY_NAME নামে একটি env var তৈরি করতে পারেন
$ export MY_NAME="Wade Wilson"

// তারপরে এটিকে চাইলে অন্যান্য প্রোগ্রামে ব্যবহার করতে পারেন
$ echo "Hello $MY_NAME"

Hello Wade Wilson

////

//// tab | উইন্ডোজ পাওয়ারশেল

// MY_NAME নামে env var তৈরি
$ $Env:MY_NAME = "Wade Wilson"

// অন্যান্য প্রোগ্রামে এটিকে ব্যবহার
$ echo "Hello $Env:MY_NAME"

Hello Wade Wilson

////

পাইথনে env vars রিড করা

আপনি চাইলে পাইথনের বাইরে, টার্মিনালে (বা অন্য কোনো উপায়ে) এনভায়রনমেন্ট ভেরিয়েবলস তৈরি করতে পারেন, এবং পরে সেগুলো পাইথনে রিড (অ্যাক্সেস করতে) পারেন।

উদাহরণস্বরূপ, আপনার main.py নামে একটি ফাইল থাকতে পারেঃ

import os

name = os.getenv("MY_NAME", "World")
print(f"Hello {name} from Python")

/// tip

os.getenv() এর দ্বিতীয় আর্গুমেন্টটি হলো এর ডিফল্ট ভ্যালু যা রিটার্ন করা হবে।

যদি এটি দেওয়া না হয়, ডিফল্টভাবে None ব্যবহৃত হবে, এখানে আমরা ডিফল্ট ভ্যালু হিসেবে "World" ব্যবহার করেছি।

///

তারপরে পাইথন প্রোগ্রামটিকে নিম্নোক্তভাবে কল করা যাবেঃ

//// tab | লিনাক্স, ম্যাকওএস, উইন্ডোজ Bash

// এখনো আমরা এনভায়রনমেন্ট ভেরিয়েবল সেট করিনি
$ python main.py

// যেহেতু env var সেট করা হয়নি, তাই আমরা ডিফল্ট ভ্যালু পাচ্ছি

Hello World from Python

// কিন্তু আমরা প্রথমে যদি একটা এনভায়রনমেন্ট ভারিয়েবল তৈরি করে নেই
$ export MY_NAME="Wade Wilson"

// এবং তারপর আবার প্রোগ্রাটিকে কল করি
$ python main.py

// এখন এটি এনভায়রনমেন্ট ভেরিয়েবল রিড করতে পারবে

Hello Wade Wilson from Python

////

//// tab | উইন্ডোজ পাওয়ারশেল

// এখনো আমরা এনভায়রনমেন্ট ভেরিয়েবল সেট করিনি
$ python main.py

// যেহেতু env var সেট করা হয়নি, তাই আমরা ডিফল্ট ভ্যালু পাচ্ছি

Hello World from Python

// কিন্তু আমরা প্রথমে যদি একটা এনভায়রনমেন্ট ভারিয়েবল তৈরি করে নেই
$ $Env:MY_NAME = "Wade Wilson"

// এবং তারপর আবার প্রোগ্রাটিকে কল করি
$ python main.py

// এখন এটি এনভায়রনমেন্ট ভেরিয়েবল রিড করতে পারবে

Hello Wade Wilson from Python

////

যেহেতু এনভায়রনমেন্ট ভেরিয়েবলস কোডের বাইরে সেট করা যায়, কিন্তু পরবর্তীতে কোড দ্বারা রিড করা যায়, এবং বাকি ফাইলগুলোর সাথে রাখতে (git এ কমিট) হয় না, তাই কনফিগারেশনস বা সেটিংস এর জন্য এগুলো সাধারণত ব্যবহৃত হয়ে থাকে।

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

এটি করতে, প্রোগ্রামটি রান করার ঠিক আগেই, একই লাইনে এনভায়রনমেন্ট ভেরিয়েবল তৈরি করুন:

// প্রোগ্রামটি কল করার সময় একই লাইনে MY_NAME এনভায়রনমেন্ট ভেরিয়েবল তৈরি করুন
$ MY_NAME="Wade Wilson" python main.py

// এখন এটি এনভায়রনমেন্ট ভ্যরিয়েবলটিকে রিড করতে পারবে

Hello Wade Wilson from Python

// পরবর্তীতে এনভায়রনমেন্ট ভেরিয়েবলটিকে আর ব্যবহার করা যাচ্ছে না
$ python main.py

Hello World from Python

/// tip

এটি নিয়ে আরো বিস্তারিত পড়তে পারেন এখানে The Twelve-Factor App: Config।

///

টাইপস এবং ভ্যালিডেশন

এই এনভায়রনমেন্ট ভেরিয়েবলগুলো শুধুমাত্র টেক্সট স্ট্রিংস হ্যান্ডেল করতে পারে, যেহেতু এগুলো পাইথনের বাইরে অবস্থিত এবং অন্যান্য প্রোগ্রাম এবং সিস্টেমের বাকি অংশের (এমনকি বিভিন্ন অপারেটিং সিস্টেম যেমন লিনাক্স, উইন্ডোজ, ম্যাকওএস) সাথে সামঞ্জস্যপূর্ণ হতে হয়।

এর অর্থ হচ্ছে পাইথনে এনভায়রনমেন্ট ভেরিয়েবল থেকে রিড করা যেকোনো ভ্যালু একটি str হবে, এবং অন্য কোনো টাইপে কনভার্সন বা যেকোনো ভেলিডেশন কোডে আলাদাভাবে করতে হবে।

এনভায়রনমেন্ট ভেরিয়েবল ব্যবহার করে এপ্লিকেশন সেটিংস হ্যান্ডেল করা নিয়ে আরো বিস্তারিত জানা যাবে Advanced User Guide - Settings and Environment Variables{.internal-link target=_blank}.

PATH এনভায়রনমেন্ট ভেরিয়েবল

PATH নামে একটি বিশেষ এনভায়রনমেন্ট ভেরিয়েবল রয়েছে, যেটি প্রোগ্রাম রান করার জন্য অপারেটিং সিস্টেমস (লিনাক্স, ম্যাকওএস, উইন্ডোজ) দ্বারা ব্যবহৃত হয়।

PATH ভেরিয়েবল এর ভ্যালু হচ্ছে একটি বিশাল স্ট্রিং যা ডিরেক্টরিকে কোলন : দিয়ে আলাদা করার মাধ্যমে লিনাক্সে ও ম্যাকওএস এ, এবং সেমিকোলন ; এর মাধ্যমে উইন্ডোজ এ তৈরি করা থাকে।

উদাহরণস্বরূপ, PATH ভেরিয়েবল নিচের মতো দেখতে হতে পারেঃ

//// tab | লিনাক্স, ম্যাকওএস

/usr/local/bin:/usr/bin:/bin:/usr/sbin:/sbin

তারমানে হলো সিস্টেম প্রোগ্রামগুলোকে নিচের ডিরেক্টরিগুলোতে খুঁজবেঃ

• /usr/local/bin
• /usr/bin
• /bin
• /usr/sbin
• /sbin

////

//// tab | উইন্ডোজ

C:\Program Files\Python312\Scripts;C:\Program Files\Python312;C:\Windows\System32

তারমানে হলো সিস্টেম প্রোগ্রামগুলোকে নিচের ডিরেক্টরিগুলোতে খুঁজবেঃ

• C:\Program Files\Python312\Scripts
• C:\Program Files\Python312
• C:\Windows\System32

////

যখন আপনি টার্মিনালে কোনো কমান্ড লিখবেন, অপারেটিং সিস্টেম প্রত্যেকটি ডিরেক্টরিতে প্রোগ্রামটি খুঁজবে যেগুলো PATH এনভায়রনমেন্ট ভেরিয়েবল এ লিস্ট করা আছে।

উদাহরণস্বরূপ, যখন আপনি টার্মিনালে python টাইপ করবেন, অপারেটিং সিস্টেম এই লিস্ট এর প্রথম ডিরেক্টরিতে python নামের একটি প্রোগ্রাম খুঁজবে।

যদি এটি খুঁজে পায়, তাহলে এটি প্রোগ্রামটিকে ব্যবহার করবে। অন্যথায় এটি অন্যান্য ডিরেক্টরিগুলোতে এটিকে খুঁজতে থাকবে।

পাইথন ইনস্টল এবং PATH আপডেট

যখন আপনি পাইথন ইনস্টল করেন, আপনি PATH এনভায়রনমেন্ট ভেরিয়েবল আপডেট করতে চান কিনা সেটা জিজ্ঞেস করা হতে পারে।

//// tab | লিনাক্স, ম্যাকওএস

ধরা যাক আপনি পাইথন ইনস্টল করলেন এবং এটি /opt/custompython/bin ডিরেক্টরিতে ইনস্টল হচ্ছে।

যদি আপনি "Yes" সিলেক্ট করে PATH এনভায়রনমেন্ট ভেরিয়েবল আপডেট করতে চান, তাহলে ইনস্টলার /opt/custompython/bin কে PATH এনভায়রনমেন্ট ভেরিয়েবল এ এড করে দিবে।

এটা দেখতে এমনটা হতে পারেঃ

/usr/local/bin:/usr/bin:/bin:/usr/sbin:/sbin:/opt/custompython/bin

এইভাবে, আপনি যখন টার্মিনালে python টাইপ করেন, সিস্টেম পাইথন প্রোগ্রামটিকে /opt/custompython/bin (সর্বশেষ ডিরেক্টরি) তে খুঁজে পাবে এবং এটাকে ব্যবহার করবে।

////

//// tab | উইন্ডোজ

ধরা যাক আপনি পাইথন ইনস্টল করলেন এবং এটি C:\opt\custompython\bin ডিরেক্টরিতে ইনস্টল হচ্ছে।

যদি আপনি "Yes" সিলেক্ট করে PATH এনভায়রনমেন্ট ভেরিয়েবল আপডেট করতে চান, তাহলে ইনস্টলার C:\opt\custompython\bin কে PATH এনভায়রনমেন্ট ভেরিয়েবল এ এড করে দিবে।

C:\Program Files\Python312\Scripts;C:\Program Files\Python312;C:\Windows\System32;C:\opt\custompython\bin

এইভাবে, আপনি যখন টার্মিনালে python টাইপ করেন, সিস্টেম পাইথন প্রোগ্রামটিকে C:\opt\custompython\bin (সর্বশেষ ডিরেক্টরি) তে খুঁজে পাবে এবং এটাকে ব্যবহার করবে।

////

তাই, আপনি যদি টাইপ করেনঃ

$ python

//// tab | লিনাক্স, ম্যাকওএস

সিস্টেম python প্রোগ্রামকে /opt/custompython/bin এ খুঁজে পাবে এবং এটাকে রান করবে।

এটা মোটামুটিভাবে নিচের মতো করে লেখার সমান হবেঃ

$ /opt/custompython/bin/python

////

//// tab | উইন্ডোজ

সিস্টেম python প্রোগ্রামকে C:\opt\custompython\bin\python এ খুঁজে পাবে এবং এটাকে রান করবে।

এটা মোটামুটিভাবে নিচের মতো করে লেখার সমান হবেঃ

$ C:\opt\custompython\bin\python

////

এই তথ্যগুলো ভার্চুয়াল এনভায়রনমেন্টস{.internal-link target=_blank} শেখার ক্ষেত্রে সহায়ক হবে।

উপসংহার

এর মাধ্যমে আপনি এনভায়রনমেন্ট ভেরিয়েবলস কি এবং এটিকে পাইথনে কিভাবে ব্যবহার করতে হয় তার সম্পর্কে বেসিক ধারনা পেলেন।

চাইলে এই সম্পর্কে আরো বিস্তারিত পড়তে পারেন Wikipedia for Environment Variable এ।

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

উদাহরণস্বরূপ, আপনার এই ইনফরমেশনটি পরবর্তী, ভার্চুয়াল এনভায়রনমেন্টস অংশে দরকার হবে।