Instalează API-ul Python

Cerințe preliminare

Mai întâi, creează un mediu minimal în care este instalat doar Python. Folosește medii virtuale Python.

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

Activează noul tău mediu.

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

Există două moduri principale de a instala acest pachet: din PyPI sau din sursă. Metoda recomandată este instalarea din PyPI:

Instalare din PyPI

pip install qiskit-fermions

Instalare din sursă

Dacă plănuiești să dezvolți în depozit, ar trebui să instalezi din sursă.

Mai întâi, Qiskit trebuie instalat în același mediu Python în care instalezi qiskit-fermions. Cea mai simplă cale este din PyPI, dar poți instala Qiskit din sursă dacă dorești.

$ pip install qiskit

Apoi, clonează depozitul qiskit-fermions.

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

Acum, instalează setul de instrumente Rust, actualizează pip și intră în depozit. Consultă documentația Rust pentru instrucțiuni despre instalarea setului de instrumente.

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

Instalează dependențele build rămase. Dacă plănuiești să dezvolți în depozit, instalează dependențele dev.

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

Pasul următor este să instalezi qiskit-fermions în mediul virtual.

pip install .

Sugestie

Poți efectua și o instalare editabilă, compilând în continuare crate-ul Rust de bază în modul release:

SETUPTOOLS_RUST_CARGO_PROFILE=release pip install -e .

Sugestie

Unele funcționalități depind de dependențe opționale. Pentru a le instala pe toate, folosește extra-ul all:

pip install ".[all]"

Consultă secțiunea [project.optional-dependencies] din pyproject.toml pentru a vedea ce grupuri de dependențe sunt disponibile.

Opțional, poți verifica dacă instalarea a reușit. Cel mai simplu test este să încerci să imporți una dintre clasele furnizate de pachetul qiskit-fermions, ca în exemplul următor:

python -c "from qiskit_fermions.circuit import FermionicCircuit"

Dacă aceasta se termină cu succes, instalarea a funcționat.

Sugestie

Poți rula și întreaga suită de teste Python:

pip install --group test
make testpython

Pentru a rula suplimentar testele care exersează dependențele opționale, instalează extra-urile și folosește ținta testoptional:

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