Metadata-Version: 2.4
Name: dockpy-cli
Version: 0.0.1.dev1
Summary: dockpy-cli - Docker CLI tool with async operations
Project-URL: Issue Tracker, https://github.com/bbdevs/dockpy/issues
Project-URL: Source Code, https://gerrit.bbdevs.com/dockpy
Author-email: BBDevs <dev@bbdevs.com>
License: Apache-2.0
Keywords: async,cli,container,docker,orchestration
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: System :: Systems Administration
Classifier: Topic :: Utilities
Requires-Python: >=3.10
Requires-Dist: click>=8.1.7
Requires-Dist: dockpy-core
Requires-Dist: dockpy-sdk
Requires-Dist: rich>=13.7.0
Requires-Dist: ruyaml>=0.91.0
Requires-Dist: tomli>=2.0.0
Provides-Extra: dev
Requires-Dist: pytest-asyncio>=0.21.1; extra == 'dev'
Requires-Dist: pytest-click>=1.1.0; extra == 'dev'
Requires-Dist: pytest-cov>=4.1.0; extra == 'dev'
Requires-Dist: pytest>=7.4.3; extra == 'dev'
Requires-Dist: tomli-w>=1.0.0; extra == 'dev'
Description-Content-Type: text/markdown

# dockpy-cli

Docker CLI tool with async operations built on the dockpy-sdk.

## Installation

```bash
pip install dockpy-cli
```

Or with pipx (recommended for CLI usage):

```bash
pipx install dockpy-cli
```

## Quick Start

```bash
# Verify installation
dp --help

# Container operations
dp container list
dp container create nginx:latest --name my-web -d

# Image operations
dp image list
dp image pull python:3.10
```

## Commands

### Containers
```bash
dp container list              # List all containers
dp container create IMAGE      # Create a new container
dp container start CONTAINER   # Start a container
dp container stop CONTAINER    # Stop a container
dp container logs CONTAINER    # View container logs
dp container remove CONTAINER  # Remove a container
```

### Images
```bash
dp image list                  # List all images
dp image pull IMAGE            # Pull an image
dp image push IMAGE            # Push an image
dp image remove IMAGE          # Remove an image
```

## Output Formats

Supports multiple output formats:
- **Table** (default) - Formatted ASCII tables
- **JSON** - Machine-readable JSON output
- **YAML** - YAML formatted output

Example:
```bash
dp container list --format json
dp image list --format yaml
```

## Documentation

See the [main repository](https://gerrit.bbdevs.com/dockpy) for full documentation.

## License

Apache License 2.0 - See LICENSE file for details.

