Receptorctl

Receptorctl is a front-end CLI and importable Python library that interacts with Receptor over its control socket interface.

Setting up nox

This project includes a nox configuration to automate tests, checks, and other functions in a reproducible way using isolated environments. Before you submit a PR, you should install nox and verify your changes.

To run make receptorctl-lint and receptorctl-test from the repository root, you must first install nox.

Install nox using python3 -m pip install nox or your distribution's package manager.
Run nox --list from the receptorctl directory to view available sessions.

You can run nox with no arguments to execute all checks and tests. Alternatively, you can run only certain tasks as outlined in the following sections.

By default nox sessions install pinned dependencies from pyproject.toml.

Checking changes to Receptorctl

Run the following nox sessions to check for code style and formatting issues:

Run all checks.
```
nox -s lint
```
Check code style.
```
nox -s check_style
```
Check formatting.
```
nox -s check_format
```
Format code if the check fails.
```
nox -s format
```

Running Receptorctl tests

Run the following nox sessions to test Receptorctl changes:

Run tests against the complete matrix of Python versions.
```
nox -s tests
```

Run tests against a specific Python version.

# For example, this command tests Receptorctl against Python 3.12.
nox -s tests-3.12

Updating dependencies

Update dependencies using uv as follows:

Add or modify packages in pyproject.toml under dependencies or optional-dependencies.
Regenerate the lock file from the receptorctl directory:
```
uv lock
```

The uv.lock file pins all dependencies with cryptographic hashes for reproducible installs. Commit the updated uv.lock file along with your pyproject.toml changes.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

receptorctl-1.6.8.tar.gz (46.7 kB view details)

Uploaded Sep 1, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

receptorctl-1.6.8-py3-none-any.whl (10.7 kB view details)

Uploaded Sep 1, 2026 Python 3

File details

Details for the file receptorctl-1.6.8.tar.gz.

File metadata

Download URL: receptorctl-1.6.8.tar.gz
Upload date: Sep 1, 2026
Size: 46.7 kB
Tags: Source
Uploaded using Trusted Publishing? No
Uploaded via: twine/7.0.0 CPython/3.12.3

File hashes

Hashes for receptorctl-1.6.8.tar.gz
Algorithm	Hash digest
SHA256	`0b0b0fe33b0734d1beed83dd57d1f8d0115e96fba63791f8d86e4925714c34ef`
MD5	`1815c478e6d2ebb37009eef19f9b14c6`
BLAKE2b-256	`0629649671759647ef163bd91eea395d7cc00a451b906854b681d1d8d3a2d19f`

See more details on using hashes here.

File details

Details for the file receptorctl-1.6.8-py3-none-any.whl.

File metadata

Download URL: receptorctl-1.6.8-py3-none-any.whl
Upload date: Sep 1, 2026
Size: 10.7 kB
Tags: Python 3
Uploaded using Trusted Publishing? No
Uploaded via: twine/7.0.0 CPython/3.12.3

File hashes

Hashes for receptorctl-1.6.8-py3-none-any.whl
Algorithm	Hash digest
SHA256	`ffb05a28df434477f13e5152bad6d6f7230dd304a93adef3c0ae55873a2ee3e2`
MD5	`56cb8431891a586ce981d77624e52d18`
BLAKE2b-256	`28baba8290a5e664df37fa1c27a85def28d95466939aa08e29cf12b7505b63d0`