Metadata-Version: 2.4
Name: synology-apm-repo-cli
Version: 0.2.0
Summary: Command-line browser/exporter for Synology APM/APV/Object-Storage dedup repositories, built on synology-apm-repo-sdk
Author: Synology Inc.
License-Expression: Apache-2.0
Project-URL: Homepage, https://www.synology.com/products/ActiveProtectAppliance
Project-URL: Repository, https://github.com/synology-apm/apm-repo-sdk-python
Project-URL: Issue Tracker, https://github.com/synology-apm/apm-repo-sdk-python/issues
Keywords: synology,activeprotect,backup,apm,dedup,cli
Classifier: Environment :: Console
Classifier: Intended Audience :: System Administrators
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Topic :: System :: Systems Administration
Requires-Python: >=3.11
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: synology-apm-repo-sdk==0.2.0
Requires-Dist: typer<0.28,>=0.12
Requires-Dist: rich>=13.0
Dynamic: license-file

# synology-apm-repo-cli

Command-line browser and exporter for Synology APV/Object-Storage
dedup backup repositories, built on `synology-apm-repo-sdk`. Offline,
read-only.

## Install

Run directly without installing:

```bash
uvx synology-apm-repo-cli --help
```

Or install with pip:

```bash
pip install synology-apm-repo-cli
```

Installs the `synology-apm-repo-cli` command.

## Usage

```bash
synology-apm-repo-cli ls "/path/to/repository#Test-Workload-01/my-vm/2026-08-07 09:00"
synology-apm-repo-cli tree "/path/to/repository#Test-Workload-01/my-vm/2026-08-07 09:00"
synology-apm-repo-cli cat "/path/to/repository#Test-Workload-01/my-vm/2026-08-07 09:00/Documents/report.pdf" > report.pdf
synology-apm-repo-cli export "/path/to/repository#Test-Workload-01/my-vm/2026-08-07 09:00/Documents/report.pdf" -o ./report.pdf
synology-apm-repo-cli verify /path/to/repository --level full
```

`ls`/`tree`/`cat`/`export`'s argument is a single
`<path>#<segment>/<segment>/...` ref; `doctor`/`key`/`verify` take a plain
repository path instead, and `dump`/`profile` are sub-command groups of
their own — run `synology-apm-repo-cli <command> --help` for that command's
own options. Commands: `doctor`, `ls`, `tree`, `cat`, `export`, `key`,
`verify`, `dump`, `profile`.

## Requirements

Python 3.11+.

## License

Apache-2.0.
