1
0

Compare commits

..

No commits in common. "b05f889144b40099d2cfdf7cdecb928af612a700" and "662e03adb3a52260e23d0fcb7a0d33e5e51aa9bd" have entirely different histories.

2 changed files with 6 additions and 30 deletions

View File

@ -1,32 +1,8 @@
# Conventions
When writing code, you MUST follow these principles:
When contributing code to this project, you MUST follow the requirements
specified here.
## Code Conventions
When contributing code to this project, you MUST follow these principles:
- Code should be easy to read and understand.
- Keep the code as simple as possible. Avoid unnecessary complexity.
- Use meaningful names for variables, functions, etc. Names should reveal intent.
- Functions should be small and do one thing well. They should not exceed a few lines.
- Function names should describe the action being performed.
- No trailing whitespace.
- Use types everywhere possible.
- Only use comments when necessary, as they can become outdated. Instead, strive to make the code self-explanatory.
- When comments are used, they should add useful information that is not readily apparent from the code itself.
- Properly handle errors and exceptions to ensure the software's robustness.
- Use exceptions rather than error codes for handling errors.
- Consider security implications of the code. Implement security best practices to protect against vulnerabilities and attacks.
- Documentation should document semantics, not syntax.
- Prefer importing modules, not individual items from modules.
- Do not use f-strings in logging statements.
- Loop variables and walrus-expression-variables should be deleted when
unneeded to keep scope clean, and to avoid accidental use.
## Testing
When contributing test to this project, you MUST follow these principles:
- Do not use any testing libraries other than `pytest`.
- Mocking is the root of all evil. Writing your own stubs is much more
preferable.
- Dictionaries that do not change during the runtime of the program must be
placed in top-level scope.

View File

@ -1 +1 @@
__version__ = '0.1.50'
__version__ = '0.1.49'