Skip to content

Latest commit

 

History

History
50 lines (38 loc) · 1.5 KB

CONTRIBUTING.md

File metadata and controls

50 lines (38 loc) · 1.5 KB

Contribution

All pull requests are welcome, however, do note that the maintainer of the project is a full time university student, thus may not be able to respond as fast as you may expect.

Notes

  1. If you are planning to introduce a big change in codebase, open an issue first for discussion, that waste of time would be avoided.

  2. The project is currently written in Python 3.10, with strict compliance to PEP-0008 in terms of formatting, and to PEP-0257 in regards of docstring formatting, with slight modification for sake of consistency:

The modifications include:

In lists, as well as declaration of variables, there is always indent after line break:

hello_world: list[str] = [
        "a", "b", "c",
        "d", "e", "f",
        ...,
    ]

# not this one
hello_world: list[str] = [
    "a", "b", "c",
    "d", "e", "f",
    ...,
]

"""However, in process calls, indent is not required"""
hello_from_long_function(
    "arguments", "argument_2", "argument_3"
)

Rules to type checking is provided by PEP-0484, and is checked by mypy, which requires type-setuptools and type-requests.

  1. Be sure to run the unit tests and test your code first before opening pull requests, the unit test can be invoked with pytest: python -m pytest tests/tests.py.

  2. Always comply to CODE_OF_CONDUCT.