lieplusplus-py 0.5.1

Swarm Systems Lab Python lieplusplus library

lieplusplus_py

Swarm Systems Lab Python lieplusplus library

⚠️ Warning: This project is a work in progress.

Installation

pip install lieplusplus_py

Usage

import lieplusplus

# Example usage
result = lieplusplus.hello()
print(result)

Development

This project follows the SSL Golden Path for streamlined Python development.

Quick Setup

# Clone the repository
git clone https://gitea.lyapunov.local/Swarm-Systems-Lab/lieplusplus_py
cd lieplusplus_py

# One-command setup (installs uv, creates .venv, installs dependencies)
just setup

# Verify everything works
just test

Common Commands

All project tasks are managed via just. Run just --list to see all available commands.

Essential commands:

just setup          # Initial environment setup
just test           # Run full test suite (what CI runs)
just test-fast      # Quick parallel tests (skip slow tests)
just lint           # Check code style
just typecheck      # Check types
just security       # Run security scans
just check-all      # Full CI simulation (run before pushing!)
just build          # Build package

just docs           # Start documentation server

Testing workflows:

just test-one test_name      # Run specific test
just test-multi-py           # Test on Python 3.10-3.14
uv run pytest -vv            # Verbose output
uv run pytest --pdb          # Debug on failure

Development Tools

• Package Manager: uv - Fast Rust-based Python package manager
• Task Runner: just - Command runner for project tasks
• Linting: ruff - Fast linter and formatter
• Type Checking: ty (mypy wrapper) - Static type analysis
• Testing: pytest with coverage and parallel execution
• Security: semgrep - Security vulnerability scanning

Project Structure

lieplusplus_py/
├── src/lieplusplus/     # Source code (importable package)
├── tests/                      # Test files (mirrors src structure)

├── docs/                       # Documentation (MkDocs)


├── pyproject.toml              # Project metadata and dependencies
├── justfile                    # Task definitions
└── uv.lock                     # Locked dependencies

Documentation

Full documentation is available at https://gitea.lyapunov.local/Swarm-Systems-Lab/lieplusplus_py/blob/main/docs

Build locally:

just docs        # Start server at http://localhost:8000 with live reload
just docs-build  # Build static documentation

Contributing

Contributions are welcome! Please see CONTRIBUTING.md for guidelines.

Before submitting a PR:

just check-all  # Runs lint, security, test, typecheck, pre-commit

License

MIT