Development

# Clone repository
git clone https://github.com/thettwe/my-spellchecker.git
cd my-spellchecker

# Create virtual environment
python3 -m venv venv
source venv/bin/activate  # Windows: venv\Scripts\activate

# Install development dependencies
pip install -e ".[dev]"

# Build Cython extensions
python setup.py build_ext --inplace

# All tests
pytest tests/

# With coverage
pytest tests/ --cov=src/myspellchecker

# Specific test file
pytest tests/test_syllable_validation.py

# By marker
pytest tests/ -m unit
pytest tests/ -m integration

# Format code
ruff format .

# Lint code
ruff check .

# Type checking
mypy src/myspellchecker

myspellchecker/
├── src/myspellchecker/    # Main package
│   ├── core/              # Core components
│   ├── algorithms/        # Algorithms
│   ├── providers/         # Dictionary providers
│   ├── data_pipeline/     # Build pipeline
│   ├── segmenters/        # Text segmentation
│   ├── tokenizers/        # Tokenization
│   ├── text/              # Text processing (normalize, stemmer)
│   ├── training/          # ML training
│   ├── grammar/           # Grammar checking
│   └── utils/             # Utilities
├── tests/                 # Test suite
│   ├── integration/       # Integration tests
│   ├── e2e/               # End-to-end tests
│   ├── fixtures/          # Test fixtures
│   └── test_*.py          # Unit tests (flat structure)
├── docs/                  # Documentation
├── examples/              # Example code
└── scripts/               # Development scripts

# Create feature branch
git checkout -b feature/my-feature

# Make changes and commit
git add .
git commit -m "feat: add my feature"

# Push and create PR
git push origin feature/my-feature

# Rebuild after changes
python setup.py build_ext --inplace

# Clean build
rm -rf build/ src/myspellchecker/**/*.cpp src/myspellchecker/**/*.so
python setup.py build_ext --inplace

# Python wrapper (normalize.py)
try:
    from .normalize_c import remove_zero_width_chars
except ImportError:
    def remove_zero_width_chars(text: str) -> str:
        # Pure Python fallback
        return ''.join(c for c in text if c not in ZERO_WIDTH)

# Unit test
@pytest.mark.unit
def test_syllable_validation():
    assert is_valid_syllable("မြန်")

# Integration test
@pytest.mark.integration
def test_full_pipeline():
    checker = SpellChecker()
    result = checker.check("test text")
    assert result is not None

# Slow test
@pytest.mark.slow
def test_large_corpus():
    # Long-running test
    pass

# By marker
pytest -m unit
pytest -m "not slow"

# By name
pytest -k "syllable"

# Single file
pytest tests/test_syllable_validation.py

# Single test
pytest tests/test_syllable_validation.py::test_valid_syllable

# conftest.py
@pytest.fixture
def spell_checker():
    """Create a SpellChecker instance."""
    return SpellChecker()

@pytest.fixture
def sample_text():
    """Sample Myanmar text."""
    return "မြန်မာစာ"

from myspellchecker.utils.logging_utils import configure_logging
configure_logging(level="DEBUG")

# Add breakpoint
import pdb; pdb.set_trace()

# Or use VS Code debugger

# Run all tests including accuracy benchmarks
pytest tests/ -v

# Run specific accuracy tests (once implemented)
pytest tests/test_accuracy_benchmarks.py -v

# Update version in pyproject.toml
# Update CHANGELOG.md
git add .
git commit -m "chore: bump version to X.Y.Z"
git tag vX.Y.Z
git push origin main --tags

# Build distribution
python -m build

# Check package
twine check dist/*

# Upload to PyPI
twine upload dist/*