Contributing Guide

Thank you for your interest in the NeoRuntime Platform Python SDK!

Development Environment Setup

  1. Clone the repository:

git clone https://github.com/camthink-ai/neoruntime-sdks.git
cd sdk-python
  1. Create a virtual environment:

python3 -m venv venv
source venv/bin/activate
  1. Install development dependencies:

pip install -e ".[dev]"

Code Standards

We use the following tools to ensure code quality:

  • black: Code formatting

  • flake8: Code linting

  • mypy: Type checking

Run checks:

# Format code
black neoruntime_ipc_sdk tests

# Lint code
flake8 neoruntime_ipc_sdk tests

# Type check
mypy neoruntime_ipc_sdk

Testing

Run all tests:

pytest tests/

Run specific tests:

pytest tests/test_inference.py

Generate coverage report:

pytest --cov=neoruntime_ipc_sdk --cov-report=html tests/

Submitting Code

  1. Create a new branch:

git checkout -b feature/my-feature
  1. Commit changes:

git add .
git commit -m "feat: add new feature"
  1. Push the branch:

git push origin feature/my-feature
  1. Create a Pull Request

Commit Message Convention

Use Conventional Commits format:

  • feat:: New feature

  • fix:: Bug fix

  • docs:: Documentation update

  • style:: Code formatting

  • refactor:: Code refactoring

  • test:: Testing related

  • chore:: Build/tooling related

Documentation

Build documentation:

cd docs
make html

View documentation:

open _build/html/index.html

Reporting Issues

If you find a bug or have a feature suggestion, please create an issue on GitHub:

https://github.com/camthink-ai/neoruntime-sdks/issues

License

This project is licensed under the MIT License.