Discours Core

Core backend for Discours.io platform

Requirements

• Python 3.11+
• uv (Python package manager)

Installation

Install uv

# macOS/Linux
curl -LsSf https://astral.sh/uv/install.sh | sh

# Windows
powershell -c "irm https://astral.sh/uv/install.ps1 | iex"

Setup project

# Clone repository
git clone <repository-url>
cd discours-core

# Install dependencies
uv sync --dev

# Activate virtual environment
source .venv/bin/activate  # Linux/macOS
# or
.venv\Scripts\activate     # Windows

Development

Install dependencies

# Install all dependencies (including dev)
uv sync --dev

# Install only production dependencies
uv sync

# Install specific group
uv sync --group test
uv sync --group lint

Run tests

# Run all tests
uv run pytest

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

# Run with coverage
uv run pytest --cov=services,utils,orm,resolvers

Code quality

# Run ruff linter
uv run ruff check .

# Run ruff formatter
uv run ruff format .

# Run mypy type checker
uv run mypy .

Run application

# Run main application
uv run python main.py

# Run development server
uv run python dev.py

Project structure

discours-core/
├── auth/           # Authentication and authorization
├── cache/          # Caching system
├── orm/            # Database models
├── resolvers/      # GraphQL resolvers
├── services/       # Business logic services
├── utils/          # Utility functions
├── schema/         # GraphQL schema
├── tests/          # Test suite
└── docs/           # Documentation

Configuration

The project uses pyproject.toml for configuration:

• Dependencies: Defined in [project.dependencies] and [project.optional-dependencies]
• Build system: Uses hatchling for building packages
• Code quality: Configured with ruff and mypy
• Testing: Configured with pytest

CI/CD

The project includes GitHub Actions workflows for:

• Automated testing
• Code quality checks
• Deployment to staging and production servers

License

MIT License