پیکربندی #

شعر را می توان از طریق دستور پیکربندی پیکربندی کرد (اطلاعات بیشتری در مورد استفاده از آن در اینجا مشاهده کنید) یا مستقیماً در پرونده Config. TOML که هنگام اجرای آن دستور به طور خودکار ایجاد می شود. این پرونده به طور معمول در یکی از دایرکتوری های زیر یافت می شود:

• سیستم عامل مک:~/کتابخانه/ترجیحات/پیپتری
• ویندوز: ٪ AppData ٪ pypoetry

برای UNIX ، ما از XDG مشخصات خود را دنبال می کنیم و از $ xdg_config_home پشتیبانی می کنیم. این یعنی به طور پیش فرض~/. Config/pypoetry.

پیکربندی محلی #

شعر همچنین امکان داشتن تنظیماتی را که خاص برای یک پروژه با انتقال گزین ه-محلی به دستور پیکربندی است ، فراهم می کند.

پیکربندی شعر VirtualEnvs. Create

توجه داشته باشید

پیکربندی محلی برنامه شعر شما در پرونده Poetry. toml ذخیره می شود ، که جدا از pyproject. toml است.

هشدار

در مورد بررسی این پرونده در مخزن خود توجه داشته باشید زیرا ممکن است حاوی اطلاعات خاص یا حساس کاربر باشد.

لیست پیکربندی فعلی #

برای لیست پیکربندی فعلی می توانید از گزین ه-لیست دستور پیکربندی استفاده کنید:

پیکربندی شع ر-لیست 

که چیزی شبیه به این را به شما می دهد:

اگر می خواهید مقدار یک تنظیم خاص را ببینید ، می توانید نام آن را به دستور پیکربندی بدهید

پیکربندی شعر VirtualEnvs. Path 

برای یک لیست کامل از تنظیمات پشتیبانی شده ، تنظیمات موجود را مشاهده کنید.

افزودن یا به روزرسانی تنظیمات پیکربندی #

برای تغییر یا در غیر این صورت یک تنظیم پیکربندی جدید ، می توانید یک مقدار را پس از نام تنظیم منتقل کنید:

پیکربندی شعر virtualenvs. path/path/to/cache/directory/virtualenvs 

برای یک لیست کامل از تنظیمات پشتیبانی شده ، تنظیمات موجود را مشاهده کنید.

حذف یک تنظیم خاص #

اگر می خواهید یک تنظیم تنظیم شده قبلی را حذف کنید ، می توانید از گزین ه-inset استفاده کنید:

پیکربندی شعر VirtualEnvs. Pat h-Unset 

تنظیم سپس مقدار پیش فرض خود را بازیابی می کند.

با استفاده از متغیرهای محیط #

بعضی اوقات ، به ویژه هنگام استفاده از شعر با ابزارهای CI ، استفاده از متغیرهای محیط ساده تر است و نیازی به اجرای دستورات پیکربندی نیست.

شعر از این پشتیبانی می کند و هر تنظیم را می توان با استفاده از متغیرهای محیط تنظیم کرد.

متغیرهای محیط باید توسط Poetry_ پیشوند شوند و از نام بزرگ تنظیمات و با نقاط و خطوط جایگزین شده توسط زیرکور تشکیل شده است ، در اینجا یک مثال است:

این همچنین برای تنظیمات مخفی مانند اعتبارنامه کار می کند:

شعر از دایرکتوری های پیش فرض زیر استفاده می کند:

پیکربندی فهرست #

• لینوکس: $ xdg_config_home/pypoetry یا~/. config/pypoetry
• ویندوز: ٪ AppData ٪ pypoetry
• سیستم عامل مک:~/کتابخانه/ترجیحات/پیپتری

با تنظیم متغیر محیط POETRY_CONFIG_DIR می توانید فهرست پیکربندی را نادیده بگیرید.

فهرست داده ها #

• لینوکس: $ xdg_data_home/pypoetry یا~/. local/share/pypoetry
• ویندوز: ٪ AppData ٪ pypoetry
• سیستم عامل مک:~/کتابخانه/پشتیبانی برنامه/پیپتری

با تنظیم متغیرهای محیط POETRY_DATA_DIR یا POETRY_HOME می توانید فهرست داده ها را نادیده بگیرید. اگر Poetry_Home تنظیم شود ، اولویت بالاتری به آن داده می شود.

فهرست حافظه پنهان #

• لینوکس: $ xdg_cache_home/pypoetry یا~/. cache/pypoetry
• ویندوز: ٪ localappdata ٪ pypoetry
• سیستم عامل مک:~/کتابخانه/ذخیره/پیپتری

می توانید با تنظیم متغیر محیط Poetry_Cache_dir ، فهرست حافظه نهان را نادیده بگیرید.

تنظیمات موجود #

cache-dir #

نوع: رشته

مسیر به فهرست حافظه نهان که توسط شعر استفاده می شود.

پیش فرض یکی از دایرکتوری های زیر:

• سیستم عامل مک:~/کتابخانه/ذخیره/پیپتری
• ویندوز: C: Users \ AppData Local Pypoetration حافظه پنهان
• یونیکس:~/. cache/pypoetry

Experimental. System-Git-Client #

نوع: بولی

پیش فرض: نادرست

معرفی شده در 1. 2. 0

برای کارهای مرتبط با GIT از سیستم پشتیبان مشتری GIT استفاده کنید.

شعر از Dulwich به طور پیش فرض برای کارهای مرتبط با GIT استفاده می کند تا به در دسترس بودن مشتری GIT اعتماد نکند.

اگر با هر مشکلی با آن روبرو شدید ، برای استفاده از سیستم با پس زمینه GIT True تنظیم کنید.

installer. max-borkers #

نوع: int

پیش فرض: number_of_cores + 4

معرفی شده در 1. 2. 0

حداکثر تعداد کارگران را هنگام استفاده از نصب موازی تنظیم کنید. number_of_cores توسط os. cpu_count () تعیین می شود. اگر این یک استثناء NotimemplementError را ایجاد کند ، شماره_ف_کورس فرض می شود که 1 باشد.

اگر این پارامتر پیکربندی روی مقداری بیشتر از number_of_cores + 4 تنظیم شود ، تعداد حداکثر کارگران هنوز در شماره_of_cores + 4 محدود است.

توجه داشته باشید این پیکربندی هنگام نصب نادیده گرفته می شود.

installer. Mode-Installation #

نوع: بولی

پیش فرض: درست است

معرفی شده در 1. 4. 0

از یک روش مدرن تر و سریعتر برای نصب بسته استفاده کنید.

اگر این امر باعث بروز مشکلات شود ، می توانید با تنظیم آن در کاذب آن را غیرفعال کنید و مشکلاتی را که با آن روبرو هستید در مورد ردیاب مسئله گزارش دهید.

installer. no-bynary #

نوع: رشته |بولی

پیش فرض: نادرست

معرفی شده در 1. 2. 0

هنگام تنظیم این پیکربندی به کاربران امکان می دهد خط مشی فرمت توزیع بسته را برای همه بسته های خاص یا خاص پیکربندی کنند.

توجه داشته باشید

این پیکربندی فقط هنگام استفاده از نصب کننده جدید رعایت می شود. اگر آن را غیرفعال کرده اید، لطفاً آن را دوباره فعال کنید.

مانند تمام پیکربندی هایی که در اینجا توضیح داده شده است، این یک پیکربندی خاص کاربر است. این بدان معنی است که در هنگام ایجاد یک فایل قفل یا رفع وابستگی ها، این مورد در نظر گرفته نمی شود. این فقط در هنگام انتخاب توزیع برای وابستگی در یک محیط مدیریت شده Poetry اعمال می شود.

توجه داشته باشید

برای استفاده خاص پروژه، توصیه می شود که با --local پیکربندی شود.

پیکربندی شعر --local installer. no-binary :all: 

توجه داشته باشید

برای محیط های CI یا کانتینری استفاده از متغیر محیطی برای پیکربندی ممکن است مفید باشد.

installer. parallel #

نوع: بولی

پیش فرض: درست است

معرفی شده در 1. 1. 4

Use parallel execution when using the new (>=1. 1. 0) نصب کننده.

virtualenvs. create #

نوع: بولی

پیش فرض: درست است

یک محیط مجازی جدید ایجاد کنید اگر قبلاً وجود ندارد.

اگر روی false تنظیم شود، Poetry یک محیط مجازی جدید ایجاد نمی کند. اگر یک محیط مجازی را در /virtualenvs یا /. venv تشخیص دهد، وابستگی ها را در آنها نصب می کند، در غیر این صورت وابستگی ها را در محیط سیستم های پایتون نصب می کند.

توجه داشته باشید

اگر Poetry تشخیص دهد که در یک محیط مجازی فعال در حال اجرا است، بدون در نظر گرفتن مقدار تعیین شده برای virtualenvs. create، هرگز یک محیط مجازی جدید ایجاد نخواهد کرد.

توجه داشته باشید

توجه داشته باشید که نصب وابستگی ها در محیط سیستم احتمالا بسته های موجود را ارتقا یا حذف می کند و در نتیجه سایر برنامه ها را از بین می برد. نصب بسته های اضافی پایتون پس از نصب پروژه ممکن است در عوض پروژه Poetry را خراب کند.

به همین دلیل است که توصیه می شود همیشه یک محیط مجازی ایجاد کنید. این موضوع در کانتینرهای Docker نیز صادق است، زیرا ممکن است حاوی بسته های پایتون اضافی نیز باشند.

virtualenvs. in-project #

نوع: بولی

پیش فرض: هیچکدام

virtualenv را در دایرکتوری ریشه پروژه ایجاد کنید.

اگر به صراحت تنظیم نشود، شعر به طور پیش فرض محیط مجازی را در زیر /virtualenvs ایجاد می کند یا از پوشه /. venv در صورت موجود بودن استفاده می کند.

اگر روی true تنظیم شود، virtualenv در پوشه ای به نام venv در دایرکتوری ریشه پروژه ایجاد و انتظار می رود.

اگر روی false تنظیم شود، شعر هر دایرکتوری venv. موجود را نادیده می گیرد.

virtualenvs. options. always-copy #

نوع: بولی

پیش فرض: نادرست

معرفی شده در 1. 2. 0

اگر روی true تنظیم شود، پارامتر --always-copy هنگام ایجاد محیط مجازی به virtualenv منتقل می شود، به طوری که تمام فایل های مورد نیاز به جای symlink در آن کپی می شوند.

virtualenvs. options. no-pip #

نوع: بولی

پیش فرض: نادرست

معرفی شده در 1. 2. 0

اگر روی True تنظیم شود ، پارامتر-NO-PIP در مورد ایجاد محیط مجازی به VirtualEnv منتقل می شود. این بدان معنی است که وقتی یک محیط مجازی جدید ایجاد می شود ، PIP در محیط نصب نمی شود.

توجه داشته باشید

شعر ، برای عملیات داخلی خود ، از چرخ PIP تعبیه شده در بسته VirtualEnv که به عنوان وابستگی در محیط زمان اجرا شعر نصب شده است ، استفاده می کند. اگر کاربر هنگام تنظیم این گزینه PIP PIP را اجرا کند ، از PIP از نمونه تعبیه شده PIP استفاده می شود.

اگر می خواهید یک محیط مجازی و بدون بسته اضافی داشته باشید ، می توانید با خیال راحت این کار را به همراه بدون تنظیمات تنظیم کنید. این برای محیط های تولید مطلوب است.

virtualenvs. options. no-setuptools #

نوع: بولی

پیش فرض: نادرست

معرفی شده در 1. 2. 0

اگر روی True تنظیم شود ، پارامتر-No-Setuptools در ایجاد محیط مجازی به VirtualEnv منتقل می شود. این بدان معنی است که وقتی یک محیط مجازی جدید ایجاد می شود ، Setuptools در محیط نصب نمی شود. شعر ، برای عملیات داخلی خود ، نیازی به تنظیمات ندارد و این با اطمینان می تواند درست باشد.

هشدار

برخی از ابزارهای توسعه مانند IDE ، فرض می کنند که بسته های Setuptools (و سایر) همیشه در یک محیط مجازی موجود و در دسترس هستند. این می تواند باعث شود برخی از ویژگی ها در این ابزارها همانطور که انتظار می رود کار نکنند.

VirtualEnvs. Options. System-Site-Packages #

نوع: بولی

پیش فرض: نادرست

به محیط مجازی دسترسی به فهرست سیستم های بسته بندی سایت را بدهید. در مورد ایجاد مجازی اعمال می شود.

virtualenvs. path #

نوع: رشته

پیش فرض: /virtualenvs

دایرکتوری که در آن محیط های مجازی ایجاد می شود.

توجه داشته باشید

این تنظیم مسیر جهانی ذخیره سازی محیط مجازی را کنترل می کند. به احتمال زیاد در سطح محلی مفید نخواهد بود. برای ذخیره محیط های مجازی در ریشه پروژه ، به VirtualEnvs. in-Project مراجعه کنید.

VirtualEnvs. Prefer-Active-Python (آزمایش) #

نوع: بولی

پیش فرض: نادرست

معرفی شده در 1. 2. 0

برای ایجاد یک محیط مجازی جدید از نسخه Python در حال حاضر فعال استفاده کنید. در صورت تنظیم نادرست ، از نسخه پایتون استفاده شده در هنگام نصب شعر استفاده می شود.

virtualenvs. prompt #

نوع: رشته

پیش فرض: -PY

معرفی شده در 1. 2. 0

رشته قالب که هنگام فعال شدن محیط مجازی ، سریع نمایش داده می شود. متغیرهای project_name و python_version برای قالب بندی در دسترس هستند.

مخازن#

نوع: رشته

یک مخزن جایگزین جدید تنظیم کنید. برای اطلاعات بیشتر به مخازن مراجعه کنید.

http-basic.: #

نوع: (رشته ، رشته)

اعتبار مخازن (نام کاربری و رمز عبور) را برای. برای اطلاعات بیشتر به مخازن - پیکربندی اعتبارنامه مراجعه کنید.

pypi-token.: #

نوع: رشته

اعتبار مخازن (با استفاده از توکن API) را برای. برای اطلاعات بیشتر به مخازن - پیکربندی اعتبارنامه مراجعه کنید.

گواهینامه ها.. کارت: #

نوع: رشته |بولی

مرجع گواهی سفارشی را برای مخزن تنظیم کنید. برای اطلاعات بیشتر به مخازن - پیکربندی اعتبارنامه - مرجع گواهینامه سفارشی مراجعه کنید.

اگر باید تأیید گواهی TLS برای این مخزن رد شود ، می توان این پیکربندی را روی نادرست تنظیم کرد.

گواهینامه ها .. کلیت-کری: #

نوع: رشته