Contributing to QDrant Loader

qdrant-loader/
├── packages/
│   ├── qdrant-loader/           # Core data ingestion package
│   │   ├── src/qdrant_loader/   # Source code
│   │   ├── tests/               # Package tests
│   │   ├── pyproject.toml       # Package configuration
│   │   └── README.md            # Package documentation
│   └── qdrant-loader-mcp-server/ # MCP server package
│       ├── src/qdrant_loader_mcp_server/
│       ├── tests/
│       ├── pyproject.toml
│       └── README.md
├── docs/                        # Documentation
├── website/                     # Documentation website generator
├── .github/workflows/           # CI/CD pipelines
├── pyproject.toml              # Workspace configuration
├── README.md                   # Main project README
└── CONTRIBUTING.md             # This file

# Create and switch to a new branch
git checkout -b feature/your-feature-name

# Or for bug fixes
git checkout -b fix/issue-description

# Run all tests
pytest

# Run tests for specific package
pytest packages/qdrant-loader/tests/
pytest packages/qdrant-loader-mcp-server/tests/

# Run with coverage
pytest --cov=packages --cov-report=html

# Run linting and formatting
black packages/
isort packages/
ruff check packages/
mypy packages/

# Stage your changes
git add .

# Commit with a descriptive message
git commit -m "feat: add support for new data source connector"

# Or for bug fixes
git commit -m "fix: resolve issue with file conversion timeout"

# Push your branch
git push origin feature/your-feature-name

# Create a pull request on GitHub
# Include a clear description of your changes

# Format code
black packages/

# Sort imports
isort packages/

# Lint code
ruff check packages/

# Type checking
mypy packages/

# Fix auto-fixable issues
ruff check --fix packages/

def process_document(content: str, metadata: Dict[str, Any]) -> ProcessedDocument:
    """Process a document with the given content and metadata.

    Args:
        content: The raw document content to process.
        metadata: Additional metadata about the document.

    Returns:
        A ProcessedDocument instance with chunked content and enriched metadata.

    Raises:
        ProcessingError: If the document cannot be processed.
    """
    # Implementation here

from typing import Dict, List, Optional, Union
from pathlib import Path

def load_config(config_path: Path) -> Dict[str, Any]:
    """Load configuration from a file."""
    pass

def process_files(files: List[Path], max_size: Optional[int] = None) -> List[str]:
    """Process a list of files."""
    pass

import pytest
from unittest.mock import Mock, patch
from qdrant_loader.processors import DocumentProcessor

class TestDocumentProcessor:
    """Test cases for DocumentProcessor."""

    def test_process_simple_document(self):
        """Test processing a simple text document."""
        processor = DocumentProcessor()
        content = "This is a test document."

        result = processor.process(content)

        assert result.chunks
        assert len(result.chunks) == 1
        assert result.chunks[0].content == content

    @patch('qdrant_loader.processors.external_service')
    def test_process_with_external_service(self, mock_service):
        """Test processing with mocked external service."""
        mock_service.return_value = "processed content"
        processor = DocumentProcessor()

        result = processor.process("input")

        mock_service.assert_called_once_with("input")
        assert result.content == "processed content"

# Run all tests
pytest

# Run with verbose output
pytest -v

# Run specific test file
pytest packages/qdrant-loader/tests/test_processors.py

# Run tests matching a pattern
pytest -k "test_document"

# Run with coverage
pytest --cov=packages --cov-report=html

# Run only fast tests (skip slow integration tests)
pytest -m "not slow"

# Use clear headings

## Structure content logically

### Include code examples

```bash
# Command examples should be copy-pastable
qdrant-loader --workspace . init

### Building Documentation Website

```bash
# Build the documentation website
cd website
python build.py --output ../dist

# Serve locally for testing
cd ../dist
python -m http.server 8000

## Description
Brief description of the changes and why they're needed.

## Type of Change
- [ ] Bug fix (non-breaking change that fixes an issue)
- [ ] New feature (non-breaking change that adds functionality)
- [ ] Breaking change (fix or feature that would cause existing functionality to not work as expected)
- [ ] Documentation update

## Testing
- [ ] Unit tests added/updated
- [ ] Integration tests added/updated
- [ ] Manual testing performed

## Checklist
- [ ] Code follows the project's style guidelines
- [ ] Self-review of code completed
- [ ] Code is commented, particularly in hard-to-understand areas
- [ ] Corresponding changes to documentation made
- [ ] Tests added that prove the fix is effective or feature works
- [ ] New and existing unit tests pass locally

## Bug Description
A clear and concise description of what the bug is.

## To Reproduce
Steps to reproduce the behavior:
1. Go to '...'
2. Click on '....'
3. Scroll down to '....'
4. See error

## Expected Behavior
A clear and concise description of what you expected to happen.

## Environment
- OS: [e.g. macOS 12.0, Ubuntu 20.04, Windows 10]
- Python version: [e.g. 3.12.2]
- QDrant Loader version: [e.g. 0.4.0b1]
- QDrant version: [e.g. 1.7.0]

## Additional Context
Add any other context about the problem here.

## Feature Description
A clear and concise description of what you want to happen.

## Problem Statement
What problem does this feature solve? What's the current limitation?

## Proposed Solution
Describe the solution you'd like to see implemented.

## Alternatives Considered
Describe any alternative solutions or features you've considered.

## Additional Context
Add any other context, mockups, or examples about the feature request here.

# Check release readiness
python release.py --dry-run

# Create a new release
python release.py