Skip to content

Latest commit

 

History

History
61 lines (39 loc) · 1.53 KB

CONTRIBUTING.rst

File metadata and controls

61 lines (39 loc) · 1.53 KB

Contributing guidelines

  • PEP 8, when sensible.
  • Write tests and docs for new features.
  • Please update AUTHORS.rst when you contribute.
  • Max line is set to 100 characters.
  • Tests are not linted, but don't be terrible.

Imports should be ordered in pep8 style but ordered by line length.

# Good!
import json
import asyncio
import unittest

import pytest
from furl import furl

import aiohttpretty

# Bad
import pytest
import aiohttpretty
import unittest
import asyncio
import json

aiohttpretty expects pretty pull requests, clean commit histories, and meaningful commit messages.

  • Make sure to rebase (git rebase -i <commitsha>) to remove pointless commits. Pointless commits include but are not limited to:
    • Fix flake errors
    • Fix typo
    • Fix test
  • Follow the guidelines for commit messages in the above
    • Don't worry about new lines between bullet points

aiohttpretty uses semantic versioning <major>.<minor>.<patch>

  • Patches are reserved for hotfixes only
  • Minor versions are for adding new functionality or fields
  • Minor versions will not contain breaking changes to the existing API
    • Any changes must be backwards compatible
  • Major versions may contain breaking changes to the existing API