plesty update#

Update metadata in an existing Plesty project. Only the options you provide are changed; everything else is left as-is.

plesty update [OPTIONS]

Operates on the directory set by the global --project-dir option (defaults to the current working directory).

Options#

Option

Description

--author TEXT

New author name — updates [project].authors[0].name in pyproject.toml

--email TEXT

New author email — updates [project].authors[0].email in pyproject.toml

--name NAME

New PyPI distribution name — updates [project].name in pyproject.toml

--standard STANDARD

Regenerate .gitlab-ci.yml using the given compliance standard (pixel, nebula, or quantum).

--no-ci

Remove the .gitlab-ci.yml file if present.

At least one option must be provided.

Examples#

# Change author and email
plesty update --author "Jane Doe" --email jane@example.com

# Rename the PyPI distribution
plesty update --name plesty-pm100d-device

# Regenerate CI with nebula standard
plesty update --standard nebula

# Remove the CI file
plesty update --no-ci

# Combine multiple updates in one call
plesty update --author "Jane Doe" --email jane@example.com --standard quantum

# Update a project in another directory
plesty --project-dir ../plesty-power_meter-device update --author "Jane Doe"

Notes#

  • --author / --email update [project] metadata in pyproject.toml. Per-file copyright is declared in REUSE.toml; edit it there if the change affects authorship.

  • --name changes only [project].name. The Python package directory name and all import paths in source files are left unchanged.

  • --standard fully regenerates .gitlab-ci.yml from scratch using the hub-module CI component; any manual edits to that file will be lost.