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: push:
tags: tags:
- 'v[0-9]+.[0-9]+.[0-9]+' - '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: jobs:
Package: Package:

View File

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

View File

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

View File

@ -2,7 +2,7 @@ name: Verify Python project can be installed, loaded and have version checked
on: on:
push: push:
paths-ignore: ["README.md", ".gitignore", "LICENSE", "ruff.toml"] paths-ignore: ['README.md', '.gitignore', 'LICENSE', 'CONVENTIONS.md', 'ruff.toml']
jobs: jobs:
Test: 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 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 Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal of this software and associated documentation files (the "Software"), to deal

View File

@ -92,7 +92,9 @@ depo.get_amount_of_asset(BTC)
## Dependencies ## 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 ```bash
pip install -r requirements.txt pip install -r requirements.txt
@ -104,15 +106,38 @@ Full list of requirements:
- [krakenex](https://pypi.org/project/krakenex/) - [krakenex](https://pypi.org/project/krakenex/)
- [frozendict](https://pypi.org/project/frozendict/) - [frozendict](https://pypi.org/project/frozendict/)
- [fin-defs](https://gitfub.space/Jmaa/fin-defs) - [fin-defs](https://gitfub.space/Jmaa/fin-defs)
- [pbc-client](https://gitfub.space/Jmaa/pbc-client)
- [dataclassabc](https://pypi.org/project/dataclassabc/) - [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 ## License
``` ```
MIT 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 Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal of this software and associated documentation files (the "Software"), to deal

View File

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