1
0

🤖 Repository layout updated to latest version

This commit was automatically generated by a script: https://gitfub.space/Jmaa/repo-manager
This commit is contained in:
Takunomi Automaticus, The 2nd 2025-04-09 21:42:25 +02:00
parent e9380a127a
commit f0a46e9e75
8 changed files with 50 additions and 7 deletions

View File

@ -3,7 +3,7 @@ on:
push:
tags:
- 'v[0-9]+.[0-9]+.[0-9]+'
paths-ignore: ["README.md", ".gitignore", "LICENSE", "ruff.toml"]
paths-ignore: ['README.md', '.gitignore', 'LICENSE', 'CONVENTIONS.md', 'ruff.toml']
jobs:
Package:

View File

@ -1,7 +1,7 @@
name: Python Ruff Code Quality
on:
push:
paths-ignore: ["README.md", ".gitignore", "LICENSE"]
paths-ignore: ['README.md', '.gitignore', 'LICENSE', 'CONVENTIONS.md', 'ruff.toml']
jobs:
ruff:

View File

@ -2,7 +2,7 @@ name: Run Python tests (through Pytest)
on:
push:
paths-ignore: ["README.md", ".gitignore", "LICENSE", "ruff.toml"]
paths-ignore: ['README.md', '.gitignore', 'LICENSE', 'CONVENTIONS.md', 'ruff.toml']
jobs:
Test:

View File

@ -2,7 +2,7 @@ name: Verify Python project can be installed, loaded and have version checked
on:
push:
paths-ignore: ["README.md", ".gitignore", "LICENSE", "ruff.toml"]
paths-ignore: ['README.md', '.gitignore', 'LICENSE', 'CONVENTIONS.md', 'ruff.toml']
jobs:
Test:

17
CONVENTIONS.md Normal file
View File

@ -0,0 +1,17 @@
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.
- 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.

View File

@ -1,6 +1,6 @@
MIT License
Copyright (c) 2024 Jon Michael Aanes
Copyright (c) 2024-2025 Jon Michael Aanes
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal

View File

@ -92,7 +92,9 @@ depo.get_amount_of_asset(BTC)
## Dependencies
All requirements can be installed easily using:
This project requires [Python](https://www.python.org/) 3.8 or newer.
All required libraries can be installed easily using:
```bash
pip install -r requirements.txt
@ -104,15 +106,38 @@ Full list of requirements:
- [krakenex](https://pypi.org/project/krakenex/)
- [frozendict](https://pypi.org/project/frozendict/)
- [fin-defs](https://gitfub.space/Jmaa/fin-defs)
- [pbc-client](https://gitfub.space/Jmaa/pbc-client)
- [dataclassabc](https://pypi.org/project/dataclassabc/)
## Contributing
Feel free to submit pull requests. Please follow the [Code Conventions](CONVENTIONS.md) when doing so.
### Testing
Testing requires the [pytest](https://docs.pytest.org/en/stable/) library.
Run tests with the following command:
```sh
pytest test
```
Test coverage can be run using the [`pytest-cov`](https://pypi.org/project/pytest-cov/) extension:
```sh
pytest --cov=fin_depo test
```
## License
```
MIT License
Copyright (c) 2024 Jon Michael Aanes
Copyright (c) 2024-2025 Jon Michael Aanes
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal

View File

@ -119,6 +119,7 @@ REQUIREMENTS_MAIN = [
'krakenex',
'frozendict',
'fin-defs @ git+https://gitfub.space/Jmaa/fin-defs.git',
'pbc-client @ git+https://gitfub.space/Jmaa/pbc-client.git',
'dataclassabc',
]
REQUIREMENTS_TEST = [