smekcio / ksef-client-python
pythonmain6d3cf5445.9K linessynced 2d ago
Code health
6.9out of 10Good
This codebase scores 6.9 out of 10 on defect risk, which we rate good. It also scores maintainability 8.1 and static performance risk 10.0 out of 10. The three are scored separately and never blended into one number. The files you change most are the weak spot: 13 of 259 files are git hotspots, and they average 4.3.
- Lines of code
- 45.9K
Recent activity
All commitsCommits
No commits indexed yet.
Decisions
- Implement comprehensive API compliance verification in CIproposed · 2d ago
- Use pre-signed URLs without Bearer tokens for certain batch/export operationsproposed · 2d ago
- Refresh access token via Bearer refresh token in Authorization headerproposed · 2d ago
- Provide both synchronous and asynchronous client variants per subclientproposed · 2d ago
- Certificate-based token acquisition workflow (AuthCoordinator)proposed · 2d ago
- Use context manager to manage HTTP connectionsproposed · 2d ago
Needs attention
54 open- medium severity. ProposedImplement comprehensive API compliance verification in CIAuto-proposed decision awaiting review
- medium severity. ProposedUse pre-signed URLs without Bearer tokens for certain batch/export operationsAuto-proposed decision awaiting review
- medium severity. ProposedRefresh access token via Bearer refresh token in Authorization headerAuto-proposed decision awaiting review
- medium severity. ProposedProvide both synchronous and asynchronous client variants per subclientAuto-proposed decision awaiting review
- medium severity. ProposedCertificate-based token acquisition workflow (AuthCoordinator)Auto-proposed decision awaiting review
Where the risk concentrates
All 13 hotspotsRanked by prior bug fixes and change frequency, mined from full git history rather than from the code alone.
| File | Churn | Prior fixes | Maintainers | Commits 90d |
|---|---|---|---|---|
| test_documents_fa3.pytests | 99.5th | 10bug magnet | 1bus factor 1 | 23 |
| test_sdk_adapters.pytests/cli/unit | 99.0th | 6 | 3 | 7 |
| adapters.pysrc/ksef_client/cli/sdk | 98.5th | 6 | 3 | 4 |
| openapi_models.pysrc/ksef_client | 97.5th | 2 | 4 | 3 |
| workflows.pysrc/ksef_client/services | 97.1th | 2 | 4 | 4 |
Composition
Open the graphpython 76%markdown 19%yaml 3%json 1%toml 0%
Explore this codebase
- Docs310 pages across 32 modules
- ChatAsk this codebase a question and get an answer with its sources
- Files259 files with per-file docs, health and history
- ArchitectureDependency graph, layers, and 2 entry points
- Code healthPer-file scores, 740 open findings, coverage and refactoring targets
- Knowledge graphEntities, communities, and the paths between them
- Change couplingFiles that keep changing together, mined from commit history
- CommitsChange-risk ranked history with agent provenance
- ContributorsBus factor, per-file maintainers, and the human/agent split
- StatsSize class, origin, lifetime churn, rhythm and records
- CostsWhat indexing this snapshot cost, by model and by run