# plesty update

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

```bash
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

```bash
# 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.