Metadata-Version: 2.3
Name: sdci
Version: 0.2.1
Summary: SDCI - Sistema de Deploy Continuo Integrado - Integrated Continuous Deployment System - Sidecar Micro CD
Keywords: continuous-deployment,cd,deployment,server,cli,automation
Author: Jonhnatha Trigueiro
Author-email: Jonhnatha Trigueiro <joepreludian@gmail.com>
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Environment :: Web Environment
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: System Administrators
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Software Development :: Build Tools
Classifier: Topic :: System :: Software Distribution
Requires-Dist: click>=8.2.1
Requires-Dist: fastapi[standard]>=0.116.1
Requires-Dist: requests>=2.32.4
Requires-Python: >=3.13
Project-URL: Documentation, https://github.com/joepreludian/sdci#readme
Project-URL: Repository, https://github.com/joepreludian/sdci
Description-Content-Type: text/markdown

# 🚀 SDCI - Sistema de Deploy Continuo Integrado

SDCI (Sistema de Deploy Continuo Integrado - Integrated Continuous Deployment System) is a lightweight continuous deployment system consisting of a server and client tool. It allows you to run predefined tasks remotely through a simple command-line interface.

**⚠️ NOTE: This project is currently in ALPHA. A better documentation will be provided soon.**

## ✨ Features

- Server component built with FastAPI
- Command-line client tool for easy task execution
- Token-based authentication
- Real-time task output streaming
- Task status monitoring


## 📥 Installation

### Requirements

- Python 3.13 or higher

### Installing the client

```bash
pip install sdci
```

## 📖 Usage

### Starting the server

Run the server component:

```bash
python -m src.server
```

By default, the server runs on `0.0.0.0:8842`.

### Using the client

The client tool can be used to trigger tasks on the server:

```bash
sdci-cli run --token YOUR_TOKEN SERVER_URL TASK_NAME [PARAMETERS...]
```

Example:

```bash
sdci-cli run --token HAPPY123 http://localhost:8842 job_1 param1 param2 param3
```

### Parameters

- `--token`: Authentication token (required)
- `SERVER_URL`: URL of the SDCI server (required)
- `TASK_NAME`: Name of the task to run (required)
- `PARAMETERS`: Optional parameters to pass to the task

## 🖥️ Server

The SDCI server component is currently in development. The goal is to create a Docker image that will be used as a sidecard in production environments, making it easily deployable alongside your main applications.

### Docker Deployment

A Docker image will be provided that allows you to run the SDCI server with minimal configuration. This image is designed to work as a sidecard container in your production environment.

## 📁 Project Structure

- `src/server.py`: FastAPI server implementation
- `src/sdci/client.py`: Client implementation for communicating with the server
- `src/sdci/command.py`: CLI interface using Click
- `src/tasks/`: Directory containing task definitions as basic shell scripts.

### Project Structure Diagram

```mermaid
graph TD
    A[SDCI Project] --> B[src]
    A --> C[pyproject.toml]
    A --> D[README.md]

    B --> E[server.py]
    B --> F[sdci]
    B --> G[tasks]
    B --> H[log_conf.yaml]

    F --> I[client.py]
    F --> J[command.py]
    F --> K[runner.py]
    F --> L[exceptions.py]
    F --> M[__init__.py]

    G --> N[test_job_1.sh]

    %% Component relationships
    E -.uses.-> K
    I -.uses.-> E
    J -.uses.-> I
    K -.executes.-> N

    %% Class descriptions
    classDef server fill:#f9d,stroke:#333,stroke-width:2px
    classDef client fill:#bbf,stroke:#333,stroke-width:2px
    classDef runner fill:#bfb,stroke:#333,stroke-width:2px
    classDef tasks fill:#fbb,stroke:#333,stroke-width:2px
    classDef config fill:#ddd,stroke:#333,stroke-width:1px

    class E server
    class I,J client
    class K runner
    class N tasks
    class C,D,H,L,M config
```

The diagram above shows the structure of the SDCI project:

1. **Server Component** (`server.py`): The FastAPI server that handles task execution requests
2. **Client Components** (`client.py`, `command.py`): Handle communication with the server and provide CLI interface
3. **Runner Component** (`runner.py`): Manages the execution of shell script tasks
4. **Tasks** (`test_job_1.sh`): Shell scripts that define the actual tasks to be executed

## 👤 Author

- Jonhnatha Trigueiro <joepreludian@gmail.com>
