Metadata-Version: 2.5
Name: uploadkit-cli
Version: 0.1.0
Summary: Developer CLI for UploadKit validation, inspection, and simulation
Project-URL: Homepage, https://github.com/uploadkit/uploadkit-cli
Project-URL: Repository, https://github.com/uploadkit/uploadkit-cli
Author: UploadKit
License-Expression: Apache-2.0
License-File: LICENSE
Keywords: cli,uploadkit,validation
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
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: Typing :: Typed
Requires-Python: >=3.10
Requires-Dist: click>=8.1
Requires-Dist: uploadkit-security>=0.2.0
Requires-Dist: uploadkit-testing>=0.1.0
Requires-Dist: uploadkit>=0.2.0
Provides-Extra: all
Requires-Dist: uploadkit-audio>=0.1.0; extra == 'all'
Requires-Dist: uploadkit-office>=0.1.0; extra == 'all'
Requires-Dist: uploadkit-pdf>=0.1.0; extra == 'all'
Provides-Extra: audio
Requires-Dist: uploadkit-audio>=0.1.0; extra == 'audio'
Provides-Extra: dev
Requires-Dist: coverage>=7.0; extra == 'dev'
Requires-Dist: pytest>=8.0; extra == 'dev'
Requires-Dist: uploadkit-audio>=0.1.0; extra == 'dev'
Requires-Dist: uploadkit-office>=0.1.0; extra == 'dev'
Requires-Dist: uploadkit-pdf>=0.1.0; extra == 'dev'
Provides-Extra: office
Requires-Dist: uploadkit-office>=0.1.0; extra == 'office'
Provides-Extra: pdf
Requires-Dist: uploadkit-pdf>=0.1.0; extra == 'pdf'
Description-Content-Type: text/markdown

# uploadkit-cli

[![CI](https://github.com/uploadkit/uploadkit-cli/actions/workflows/ci.yml/badge.svg)](https://github.com/uploadkit/uploadkit-cli/actions/workflows/ci.yml)
[![Python](https://img.shields.io/badge/python-3.10%20%7C%203.11%20%7C%203.12%20%7C%203.13%20%7C%203.14-blue)](pyproject.toml)

Developer CLI for UploadKit validation, inspection, and upload simulation.

## What problem does this solve?

A local debug surface for composing Core + security + feature-package validators
without writing app code.

## When to use it

Use during development and CI to lint fixture uploads.

## When not to use it

- Do not expose framework HTTP APIs here.
- Do not use as a production upload gateway.

## Installation

```bash
pip install uploadkit-cli

# Optional feature packages
pip install 'uploadkit-cli[pdf,office,audio]'
# or
pip install 'uploadkit-cli[all]'
```

## Commands

```bash
uploadkit validate path/to/file.pdf -e pdf
uploadkit inspect path/to/file.docx
uploadkit simulate path/to/file.wav --policy audio --json
uploadkit policies list
uploadkit doctor
```

Exit code `1` on validation failure (CI-friendly with `--json`).

## Coverage

No coverage badge yet. CI runs pytest without a coverage gate, and current
smoke tests leave many CLI branches unexercised (missing optional extras,
inspect error paths, flag variants) — about **65%** when measured locally.

A coverage badge will be added once CI enforces a gate. Unlike Core /
framework adapters, this package does not claim 100% coverage.

## Changelog

See [CHANGELOG.md](CHANGELOG.md).

## Contributing

See [CONTRIBUTING.md](CONTRIBUTING.md).
