Встановлення Python API

Передумови

Спочатку створи мінімальне середовище, у якому встановлено лише 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