History

David Hewitt 50e33d86c7 add `call_bound` and `call_method_bound`		2024-01-03 13:24:14 +00:00
..
decorator	add `call_bound` and `call_method_bound`	2024-01-03 13:24:14 +00:00
getitem	examples: remove requirements-dev.txt files	2023-10-26 08:24:30 +01:00
maturin-starter	release notes for 0.20.1	2023-12-30 21:34:45 +00:00
plugin	release notes for 0.20.1	2023-12-30 21:34:45 +00:00
sequential	Create subinterpreter example	2023-11-26 09:49:56 +00:00
setuptools-rust-starter	release notes for 0.20.1	2023-12-30 21:34:45 +00:00
string-sum	Merge pull request #3536 from davidhewitt/maturin-build-args	2023-10-29 13:27:15 +00:00
word-count	release notes for 0.20.1	2023-12-30 21:34:45 +00:00
Cargo.toml	bump version to 0.21.0-dev	2023-11-19 06:41:10 +00:00
README.md	Create subinterpreter example	2023-11-26 09:49:56 +00:00

PyO3 Examples

These example crates are a collection of toy extension modules built with PyO3. They are all tested using nox in PyO3's CI.

Below is a brief description of each of these:

Example	Description
`decorator`	A project showcasing the example from the Emulating callable objects chapter of the guide.
`maturin-starter`	A template project which is configured to use `maturin` for development.
`setuptools-rust-starter`	A template project which is configured to use `setuptools_rust` for development.
`word-count`	A quick performance comparison between word counter implementations written in each of Rust and Python.
`plugin`	Illustrates how to use Python as a scripting language within a Rust application
`sequential`	Illustrates how to use pyo3-ffi to write subinterpreter-safe modules

Creating new projects from these examples

To copy an example, use cargo-generate. Follow the commands below, replacing <example> with the example to start from:

$ cargo install cargo-generate
$ cargo generate --git https://github.com/PyO3/pyo3 examples/<example>

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