Metadata-Version: 2.4
Name: corellia-cli
Version: 1.0.2
Summary: A Python CLI framework for project scaffolding and environment synchronization.
Author: Lorenzo Petrecca
License: MIT
Project-URL: Homepage, https://github.com/lorenzo-petrecca/Corellia
Project-URL: Repository, https://github.com/lorenzo-petrecca/Corellia
Project-URL: Issues, https://github.com/lorenzo-petrecca/Corellia/issues
Keywords: cli,python,scaffolding,environment,framework
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Software Development :: Build Tools
Classifier: Topic :: Utilities
Classifier: Operating System :: MacOS
Classifier: Operating System :: POSIX :: Linux
Requires-Python: >=3.12
Description-Content-Type: text/markdown
License-File: LICENSE.md
Requires-Dist: typer<1.0,>=0.12
Requires-Dist: tomli-w<2.0,>=1.0
Provides-Extra: dev
Requires-Dist: pytest<9.0,>=8.0; extra == "dev"
Dynamic: license-file

![Status](https://img.shields.io/badge/status-experimental-orange)
![License](https://img.shields.io/badge/license-MIT-green)

# Corellia

Corellia is an opinionated CLI tool for managing Python projects.

It provides a unified workflow to:

* manage Python versions
* create and manage virtual environments
* install and track dependencies
* structure projects consistently
* execute project scripts
* build distributable packages

---

## Why Corellia

Python development often requires coordinating multiple tools:

* pyenv
* venv
* pip
* git

Corellia orchestrates them into a **single, consistent interface**, reducing setup complexity and improving reproducibility.

---

## Installation

```bash
pipx install corellia-cli
```

> [!WARNING]
> Corellia is currently in early release.

### Prerequisites
- Python 3.12+
- pyenv
- Git (recommended)


### Frome source

```bash
git clone https://github.com/lorenzo-petrecca/Corellia.git
cd corellia
pipx install -e .
```

---

## Quick Start

### Create a project

```bash
core create
```

### Install dependencies

```bash
core sync
```

### Run scripts

```bash
core run <script>
```

### Build a package

```bash
core init-build
core build
```

---

## Core Concepts

* **Single source of truth** → `corellia.toml`
* **Deterministic environments** → pinned dependencies
* **Categories** → `package`, `app`, `deploy`
* **Frameworks** → optional extensions (e.g. Django)

---

## Example Project

```toml
[project]
name = "myproject"
version = "0.1.0"
python = "3.12"
category = "package"

[dependencies]
requests = "2.32.3"

[scripts.dev]
command = "python main.py"
mode = "strict"
```

---

## Documentation

Full documentation is available in the `/docs` directory.

---

## Roadmap

* app build support
* deploy workflows
* additional frameworks
* packaging improvements

---

## License

This project is licensed under the MIT License.

