تثبيت واجهة Python البرمجية

المتطلبات المسبقة

أولًا، أنشئ بيئة بسيطة فيها Python فقط. استخدم بيئات Python الافتراضية.

python3 -m venv /path/to/virtual/environment

فعّل بيئتك الجديدة.

source /path/to/virtual/environment/bin/activate

هناك طريقتان أساسيتان لتثبيت هذه الحزمة: من PyPI أو من المصدر. والطريقة المفضلة هي التثبيت من PyPI:

التثبيت من PyPI

pip install qiskit-fermions

التثبيت من المصدر

إذا كنت تخطط للتطوير داخل المستودع فعليك التثبيت من المصدر.

أولًا، يجب تثبيت Qiskit في بيئة Python نفسها التي ستثبّت فيها qiskit-fermions. أبسط طريقة لذلك هي من PyPI، لكن يمكنك تثبيت Qiskit من المصدر إن أردت.

$ pip install qiskit

بعد ذلك، انسخ مستودع qiskit-fermions.

git clone git@github.com:Qiskit/qiskit-fermions.git

الآن، ثبّت سلسلة أدوات Rust، وحدّث pip، وادخل إلى المستودع. راجع وثائق Rust لمعرفة تعليمات تثبيت سلسلة الأدوات.

### <INSTALL RUST HERE> ###
pip install --upgrade pip
cd qiskit-fermions

ثبّت بقية اعتماديات build. وإن كنت تخطط للتطوير داخل المستودع، فثبّت اعتماديات dev.

pip install --group build
pip install --group dev  # optional

الخطوة التالية هي تثبيت qiskit-fermions في البيئة الافتراضية.

pip install .

تلميح

يمكنك أيضًا إجراء تثبيت قابل للتحرير مع تصريف حزمة Rust الأساسية بوضع release:

SETUPTOOLS_RUST_CARGO_PROFILE=release pip install -e .

تلميح

تعتمد بعض الميزات على اعتماديات اختيارية. لتثبيتها جميعًا، استخدم الإضافة all:

pip install ".[all]"

راجع قسم [project.optional-dependencies] في pyproject.toml لمعرفة مجموعات الاعتماديات المتاحة.

يمكنك اختياريًا التحقق من نجاح التثبيت. أبسط اختبار هو محاولة استيراد أحد الأصناف التي توفرها حزمة qiskit-fermions، كما في المثال التالي:

python -c "from qiskit_fermions.circuit import FermionicCircuit"

إذا اكتمل هذا بنجاح، فقد نجح تثبيتك.

تلميح

يمكنك أيضًا تشغيل مجموعة اختبارات Python بأكملها:

pip install --group test
make testpython

لتشغيل الاختبارات التي تستخدم الاعتماديات الاختيارية أيضًا، ثبّت الإضافات واستخدم الهدف testoptional:

pip install -e ".[all]"
make testoptional