Metadata-Version: 2.4
Name: xcpcio
Version: 0.75.0
Summary: xcpcio python lib
Project-URL: homepage, https://github.com/xcpcio/xcpcio
Project-URL: documentation, https://github.com/xcpcio/xcpcio
Project-URL: repository, https://github.com/xcpcio/xcpcio
Author-email: Dup4 <hi@dup4.com>
Maintainer-email: Dup4 <hi@dup4.com>, cubercsl <hi@cubercsl.site>
License-Expression: MIT
Keywords: xcpcio
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Software Development :: Build Tools
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.11
Requires-Dist: aiofiles>=23.0.0
Requires-Dist: aiohttp>=3.8.0
Requires-Dist: click>=8.0.0
Requires-Dist: fastapi>=0.117.1
Requires-Dist: pydantic>=2.11.7
Requires-Dist: pyyaml>=6.0.0
Requires-Dist: semver>=3.0.0
Requires-Dist: tenacity>=8.0.0
Requires-Dist: uvicorn>=0.36.0
Requires-Dist: zstandard>=0.25.0
Description-Content-Type: text/markdown

# xcpcio-python

Python library and CLI tools for XCPCIO.

## Features

- **Type Definitions**: Pydantic models for contest data structures (teams, submissions, problems, etc.)
- **Constants**: Shared constants for submission statuses, time units, and penalty calculations
- **CCS Archiver**: CLI tool to archive CCS API data to contest package format
- **Contest API Server**: CLI tool to serve contest packages via CCS API
- **Cross-Language Compatibility**: Mirrors TypeScript types for data consistency

## Installation

```bash
pip install xcpcio
```

Or install with [uv](https://github.com/astral-sh/uv):

```bash
uv add xcpcio
```

## Development

### Setup

```bash
# Clone repository
git clone https://github.com/xcpcio/xcpcio.git
cd xcpcio/python

# Install dependencies with uv
uv sync
```

### Testing

```bash
# Run tests
uv run pytest

# Run specific test file
uv run pytest tests/test_types.py
```

## Documentation

For detailed documentation, visit:

- [Clics Utility Guide](https://xcpcio.com/guide/clics-utility)

## License

[MIT](../LICENSE) License &copy; 2020 - PRESENT [XCPCIO][xcpcio]

[xcpcio]: https://xcpcio.com
