pyo3/examples/setuptools-rust-starter
David Hewitt bd3c3adf46 examples: make Cargo.toml files more uniform 2021-12-15 08:28:25 +00:00
..
.template examples: make Cargo.toml files more uniform 2021-12-15 08:28:25 +00:00
setuptools_rust_starter examples: export __doc__ in example projects 2021-10-01 09:05:58 +01:00
src examples: export __doc__ in example projects 2021-10-01 09:05:58 +01:00
tests examples: export __doc__ in example projects 2021-10-01 09:05:58 +01:00
Cargo.toml examples: make Cargo.toml files more uniform 2021-12-15 08:28:25 +00:00
MANIFEST.in examples: maturin and setuptools_rust examples 2021-04-03 11:59:41 +01:00
README.md examples: add links to cargo-generate 2021-12-15 08:12:43 +00:00
cargo-generate.toml examples: add cargo-generate configuration 2021-12-15 08:11:46 +00:00
pyproject.toml examples: add cargo-generate configuration 2021-12-15 08:11:46 +00:00
requirements-dev.txt examples: use setuptools-rust 1.0.0 2021-11-21 20:39:52 +00:00
setup.cfg examples: add cargo-generate configuration 2021-12-15 08:11:46 +00:00
setup.py examples: add cargo-generate configuration 2021-12-15 08:11:46 +00:00
tox.ini examples: use pip 21.3 2021-10-13 00:05:33 +01:00

README.md

setuptools-rust-starter

An example of a basic Python extension module built using PyO3 and setuptools_rust.

Building and Testing

To build this package, first install setuptools_rust:

pip install setuptools_rust

To build and test use python setup.py develop:

pip install -r requirements-dev.txt
python setup.py develop && pytest

Alternatively, install tox and run the tests inside an isolated environment:

tox -e py

Copying this example

Use cargo-generate:

$ cargo install cargo-generate
$ cargo generate --git https://github.com/PyO3/pyo3 examples/setuptools-rust-starter

(cargo generate will take a little while to clone the PyO3 repo first; be patient when waiting for the command to run.)