Metadata-Version: 2.4
Name: cli-anything-zentao
Version: 0.3.0
Summary: A modern CLI interface for ZenTao Project Management System
Home-page: https://github.com/cli-anything/zentao
Author: CLI-Anything
Author-email: CLI-Anything <noreply@example.com>
License: MIT
Project-URL: Homepage, https://github.com/cli-anything/zentao
Project-URL: Documentation, https://github.com/cli-anything/zentao#readme
Project-URL: Repository, https://github.com/cli-anything/zentao
Project-URL: Issues, https://github.com/cli-anything/zentao/issues
Keywords: zentao,pms,project-management,cli,task,bug,story
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: System Administrators
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Office/Business
Classifier: Topic :: Software Development
Classifier: Topic :: Software Development :: Bug Tracking
Classifier: Topic :: Utilities
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: click>=8.0.0
Requires-Dist: click-repl>=0.2.0
Requires-Dist: prompt-toolkit>=3.0.0
Requires-Dist: requests>=2.25.0
Provides-Extra: dev
Requires-Dist: pytest>=7.0.0; extra == "dev"
Requires-Dist: pytest-cov>=4.0.0; extra == "dev"
Requires-Dist: black>=23.0.0; extra == "dev"
Requires-Dist: isort>=5.0.0; extra == "dev"
Requires-Dist: mypy>=1.0.0; extra == "dev"
Requires-Dist: build>=0.10.0; extra == "dev"
Requires-Dist: twine>=4.0.0; extra == "dev"
Dynamic: author
Dynamic: home-page
Dynamic: license-file
Dynamic: requires-python

# ZenTao PMS CLI

A modern CLI interface for ZenTao Project Management System with support for one-shot commands, REPL mode, and JSON output.

## Installation

```bash
pip install zentao-cli
```

## Quick Start

### Login to ZenTao

```bash
zentao-cli auth login --url http://zentao.example.com --account admin --password your_password
```

### List Projects

```bash
zentao-cli project list
```

### Create a Task

```bash
zentao-cli task create --execution 123 --name "Implement feature X" --assigned user1
```

### JSON Output (for automation)

```bash
zentao-cli project list --json
```

### Interactive REPL Mode

```bash
zentao-cli repl
```

## Commands

### Authentication

| Command | Description |
|---------|-------------|
| `auth login` | Login to ZenTao server |
| `auth logout` | Logout from ZenTao |
| `auth status` | Show authentication status |

### Projects

| Command | Description |
|---------|-------------|
| `project list` | List all projects |
| `project show <id>` | Show project details |
| `project create` | Create a new project |
| `project update <id>` | Update a project |
| `project delete <id>` | Delete a project |

### Tasks

| Command | Description |
|---------|-------------|
| `task list` | List tasks |
| `task show <id>` | Show task details |
| `task create` | Create a new task |
| `task assign <id>` | Assign task to user |
| `task start <id>` | Start a task |
| `task finish <id>` | Finish a task |
| `task close <id>` | Close a task |

### Bugs

| Command | Description |
|---------|-------------|
| `bug list` | List bugs |
| `bug show <id>` | Show bug details |
| `bug create` | Create a new bug |
| `bug resolve <id>` | Resolve a bug |
| `bug close <id>` | Close a bug |

### Stories

| Command | Description |
|---------|-------------|
| `story list` | List stories |
| `story show <id>` | Show story details |
| `story create` | Create a new story |
| `story close <id>` | Close a story |

### Products

| Command | Description |
|---------|-------------|
| `product list` | List products |
| `product show <id>` | Show product details |

### Executions

| Command | Description |
|---------|-------------|
| `execution list` | List executions/sprints |
| `execution show <id>` | Show execution details |

### Users

| Command | Description |
|---------|-------------|
| `user list` | List users |
| `user me` | Show current user info |

## Options

| Option | Description |
|--------|-------------|
| `--json` | Output in JSON format |
| `--version` | Show version |
| `--help` | Show help |

## Configuration

Session data is stored in `~/.config/zentao-cli/session.json`.

## Examples

### One-shot Commands

```bash
# Login
zentao-cli auth login --url http://zentao.example.com --account admin

# List active projects
zentao-cli project list --status doing

# Create and start a task
zentao-cli task create --execution 1 --name "Write docs" --assigned user1
zentao-cli task start 100

# Get bug details in JSON
zentao-cli bug show 50 --json
```

### REPL Mode

```bash
$ zentao-cli repl
zentao> auth login http://zentao.example.com admin password
zentao> project list
zentao> task create --execution 123 --name "Fix bug" --assigned user1
zentao> exit
```

## API Reference

The CLI interacts with ZenTao's REST API v1. Key endpoints:

- `/tokens` - Authentication
- `/projects` - Projects CRUD
- `/executions` - Executions/sprints
- `/tasks` - Tasks CRUD and status changes
- `/bugs` - Bugs CRUD and lifecycle
- `/stories` - Stories/requirements
- `/products` - Products
- `/users` - Users

## License

This CLI harness is provided as-is for interfacing with ZenTao PMS.

## Version

Current version: 0.3.0
