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.

Release files for receptorctl 1.6.9

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for receptorctl 1.6.9
File	Size	Uploaded
receptorctl-1.6.9.tar.gz	46.7 kB	Sep 18, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for receptorctl 1.6.9
File	Interpreter	ABI	Platform	Reset
receptorctl-1.6.9-py3-none-any.whl 10.7 kB Sep 18, 2026	Python 3	none	any	Details

Total release size: 57.4 kB

Release files / receptorctl-1.6.9.tar.gz

Download URL	receptorctl-1.6.9.tar.gz
Size	46.7 kB
Tags	Source
SHA-256 checksum How to use checksums	`b98a878c79d5841cc3aa1b72fe1aad4cebacbb7997722eced155783f3d0d373d`
BLAKE2b-256 checksum How to use checksums	`ba3da54a05a34093cc57c109c0ae5a91ab6080b79ea1a1d7dd8d7ced24f78f5f`
Upload date	Sep 18, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.12.3`

Release files / receptorctl-1.6.9-py3-none-any.whl

Download URL	receptorctl-1.6.9-py3-none-any.whl
Size	10.7 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`011e0255385b78e4f39e092479786bad8a4069da4b9205bbac1bdad77d688e33`
BLAKE2b-256 checksum How to use checksums	`6d8817ad75c9289991cb84af55961d69d90b9fa9a2328fd7b6caa3f631882d38`
Upload date	Sep 18, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.12.3`