🐍 soigia
Tool framework cho Python — 132 tools (85 engines) để debug, investigate và phân tích code, dữ liệu, database, git.
✨ Tính năng
- 132 tools sẵn sàng — AST, call graph, code metrics, database, data profiling, git, network, pipeline…
- Tool nào cũng là CLI —
soigia <tool> [flags...], không cần nhớ cú pháp riêng - Dễ mở rộng — đăng ký tool tùy chỉnh bằng
@tooldecorator (Registry + Scanner) - Không phụ thuộc bên thứ ba, type-safe (
py.typed, PEP 561) - Tool Discovery —
soigia tool search "sql"tìm đúng tool trong 100ms (Exact + FTS5 + Ranker, tới 10k tools) - Debugging & Investigation Toolkit — tự khám phá/chạy/reproduce/fix project Python bất kỳ (xem Yêu cầu & Hiện trạng)
- Tài liệu kiến trúc chi tiết — layers, vòng đời tool, CLI dispatch, discovery subsystem… (xem Kiến trúc)
🚀 Cài đặt
pip install soigia
💻 CLI — bắt đầu nhanh
Một lệnh cho mọi việc:
soigia reader --path README.md # đọc file
soigia search diff # tìm tool theo từ khóa
soigia list # liệt kê toàn bộ tools
soigia info reader # thông tin chi tiết một tool
soigia fire env --include-env # chạy tool với flag lenient
soigia --help # trợ giúp đầy đủ
soigia <tool> --help hiển thị tham số riêng của từng tool.
🧰 Nhóm tool
| Nhóm | Ví dụ tool |
|---|---|
code-analysis |
ast-multi, call-graph, code-radon, code-metrics, impact-analysis |
data |
data-profiler, df-compare, detect-anomaly, data-quality |
database |
db-sniffer, execute-sql, db-compare, describe-table, duckdb-query |
debug |
parse-stacktrace, icecream-debug, live-debug, async-tracer |
file-system |
reader, finder, filesystem, edit-file, tree |
git |
git-diff, git-blame, git-history, git-log-advanced |
integration |
jira, confluence, google, network-snoop |
investigation |
investigate-exception, save-evidence, generate-report, root-cause-analysis |
runtime |
env, process, run-python, run-function |
test |
test-helper, mutation-test, coverage, test-generator |
utility |
console, converter, hash, json-query |
Ví dụ chạy tool trong nhóm:
soigia db-sniffer --db-path data.db --command tables
soigia compare-files --path-a a.txt --path-b b.txt
soigia tail-log --path app.log --n 50
🐍 Python API
import soigia
print(soigia.__version__) # 1.0.5
Mở rộng: package cung cấp ToolRegistry, Scanner và @tool decorator
(soigia.base.decorator) để đăng ký tool riêng — chạy soigia help để xem
thêm.
📄 License
1 maintainer
Metadata
1 maintainer
Release files for soigia 1.0.7
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| soigia-1.0.7.tar.gz | 423.4 kB | Without provenance | Details for soigia-1.0.7.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| soigia-1.0.7-py3-none-any.whl | Python 3 | none | any | Details for soigia-1.0.7-py3-none-any.whl |
Total release size: 851.9 kB
Release files / soigia-1.0.7.tar.gz
| Download URL | soigia-1.0.7.tar.gz |
|---|---|
| Size | 423.4 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
aeb33601bc8179db2cd5ef680a3959f34aecffa3def93a8252e9c1a754f24020
|
|
BLAKE2b-256 checksum How to use checksums |
cdbe40b802d40c349eab1d560c90f2108d9b6b074eb6acdafb1e427c1d7055e9
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.12.4
|
Release files / soigia-1.0.7-py3-none-any.whl
| Download URL | soigia-1.0.7-py3-none-any.whl |
|---|---|
| Size | 428.5 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
5fa7f38cab71b883f6887431d4e0d86a5cd79e2ca45630b3c63e36571ef36f2d
|
|
BLAKE2b-256 checksum How to use checksums |
b28cfc0e4b9021675f10108bbb8217087c0de5e577aaed6586e1af03b0516863
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.12.4
|
Security for soigia 1.0.7
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.
