Research-Stack/5-Applications/nodupe/wiki/Development/Setup.md

Development Setup

Prerequisites

• Python 3.9+
• Git
• pip

Local Development

Setup

# Clone repository
git clone https://github.com/allaunthefox/NoDupeLabs.git
cd NoDupeLabs

# Create venv
python -m venv .venv
source .venv/bin/activate

# Install in development mode
pip install -e .

# Install dev dependencies
pip install pytest pytest-cov

Running Tests

# Run all tests
pytest tests/ -v

# Run with coverage
pytest --cov=nodupe tests/

# Run specific test file
pytest tests/core/test_database.py -v

Code Quality

# Lint with pylint
pylint nodupe/

# Type checking
mypy nodupe/

Tooling

Development tools are in tools/:

# Fix docstrings
python tools/core/fix_docstrings.py nodupe/

# API check
python tools/core/api_check.py

Contributing

1. Fork the repository
2. Create a feature branch
3. Make changes with tests
4. Submit a pull request

Documentation

All functions have docstrings. Run the docstring fixer:

python tools/core/fix_docstrings.py --apply nodupe/

See Testing Guide for more on running tests.