Skip to content

Latest commit

 

History

History
117 lines (85 loc) · 2.99 KB

CONTRIBUTING.md

File metadata and controls

117 lines (85 loc) · 2.99 KB

Contributing to Klime Python SDK

Thank you for your interest in contributing to the Klime Python SDK!

Important: Repository Structure

This repository is a read-only mirror of our internal monorepo. We develop and maintain the SDK internally, then mirror releases to this public repository.

What This Means for Contributors

  • Pull requests are welcome and will be reviewed by our team
  • If accepted, we'll manually port your changes to our internal monorepo
  • Your changes will appear in this repository with the next release
  • You'll be credited as a co-author in the commit

How to Contribute

Reporting Bugs

  1. Check if the bug has already been reported in Issues
  2. If not, create a new issue with:
    • A clear, descriptive title
    • Steps to reproduce the bug
    • Expected vs actual behavior
    • Your environment (Python version, OS, etc.)
    • Any relevant code snippets or error messages

Suggesting Features

  1. Check if the feature has already been suggested in Issues
  2. Create a new issue describing:
    • The problem you're trying to solve
    • Your proposed solution
    • Any alternatives you've considered

Submitting Code Changes

  1. Fork this repository
  2. Create a feature branch (git checkout -b feat/amazing-feature)
  3. Make your changes
  4. Write or update tests as needed
  5. Ensure all tests pass (pytest)
  6. Commit using Conventional Commits: 
    feat: add new tracking method
fix: handle edge case in batch processing
docs: update README examples
  7. Push to your fork and open a Pull Request

Pull Request Guidelines

  • Provide a clear description of what the PR does
  • Reference any related issues
  • Include tests for new functionality
  • Update documentation if needed
  • Keep PRs focused - one feature or fix per PR

Development Setup

# Clone your fork
git clone https://github.com/YOUR_USERNAME/klime-python.git
cd klime-python

# Create a virtual environment
python -m venv .venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate

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

# Run tests
pytest

Project Structure

klime-python/
├── klime/
│   ├── __init__.py
│   ├── client.py      # Main client implementation
│   └── types.py       # Type definitions
├── tests/
├── pyproject.toml     # Project configuration
└── README.md

Code Style

  • We follow PEP 8 style guidelines
  • Use type hints for all function signatures
  • Use meaningful variable and function names
  • Add docstrings for public APIs

Running Tests

# Run all tests
pytest

# Run with coverage
pytest --cov=klime

# Run specific test file
pytest tests/test_client.py

Questions?

If you have questions about contributing, feel free to open an issue and we'll be happy to help!

License

By contributing, you agree that your contributions will be licensed under the MIT License.