mirror of
https://github.com/kuhyx/utils.git
synced 2026-11-18 20:14:39 +01:00
Compare commits
509 Commits
gatelock-v
...
main
| Author | SHA1 | Date | |
|---|---|---|---|
| 073cc24468 | |||
| 15ef5b44f1 | |||
| bb2f92f459 | |||
| dc8a63beb2 | |||
| 48dc28ad97 | |||
| d0cfc2ca1f | |||
| 781b82863c | |||
| 422a5e53d9 | |||
| 3078d28fea | |||
| 6f4ca64218 | |||
| dfc5d07f52 | |||
| a22b412463 | |||
| 10e4656b04 | |||
| eb4bd14754 | |||
| 8ca05a6764 | |||
| 50781df0bc | |||
| 1ea7dfd6d5 | |||
| 62e7ff801e | |||
| da1d7c0692 | |||
| 6e3f86ef0d | |||
| dde5566b2c | |||
| b84a27eecf | |||
| f304eadc53 | |||
| f2150949a0 | |||
| 115e050110 | |||
| 905d13774a | |||
| 6d72a7c804 | |||
| 0d9974c194 | |||
| 44b80ee6cf | |||
| 1869fdee02 | |||
| 4531be3870 | |||
| db2650b9c9 | |||
| 65e72d8ded | |||
| 1194517702 | |||
| c29d0989dd | |||
| f21bfa7a5b | |||
| de9d41d6f0 | |||
| a9342e63e1 | |||
| 2cfbeb5e99 | |||
| 1962d30333 | |||
| 3174480624 | |||
| 3225af8365 | |||
| 6a40f7530b | |||
| edd0f7a788 | |||
| ba58ac41e9 | |||
| 90286f6cb2 | |||
| 9102c4b6ff | |||
| 47f2d239c4 | |||
| c8bb0808aa | |||
| e5990c9c15 | |||
| 84343aec2d | |||
| db1ce8c378 | |||
| 0ef5461805 | |||
| eb9bdc5796 | |||
| 307248b60b | |||
| 33791da6ff | |||
| eebeb0b510 | |||
| 2813a88db6 | |||
| cc09e56cd2 | |||
| 51e562a764 | |||
| b0fad2b2e5 | |||
| c83d41a594 | |||
| 2bbfbd9439 | |||
| 2d341dd41e | |||
| 3084080d74 | |||
| 9d6b17fd28 | |||
| ae56037e41 | |||
| eef7af4c86 | |||
| 9daa376254 | |||
| 17e300af0a | |||
| afcc1a47c7 | |||
| 0527bc680d | |||
| 21a0b5ce1c | |||
| 4c1ffd900b | |||
| 5a87868763 | |||
| fe4e34287a | |||
| 2f4f79bd6e | |||
| 51b747a364 | |||
| 89f464828a | |||
| eaf7282ac1 | |||
| 6641d85f05 | |||
| 46ab26fa15 | |||
| f71b0532fd | |||
| 3017bbf220 | |||
| fd81332f27 | |||
| ebedbf4b27 | |||
| d4fca83c9f | |||
| 3121639732 | |||
| 59b33949e4 | |||
| 027e67b197 | |||
| 8dfc4fb55f | |||
| 4fee294aa0 | |||
| 1a74345c40 | |||
| 71ea92f3c2 | |||
| 7f3f79f58d | |||
| 97d043d424 | |||
| 7af6afe51a | |||
| c2165e9fb8 | |||
| 26079c34c2 | |||
| 22fdf2c344 | |||
| de7d5d17eb | |||
| 640985a421 | |||
| 70c8aa8fbb | |||
| ba4dd58545 | |||
| b50e245ceb | |||
| 88e4be5042 | |||
| 737bf624ca | |||
| 716231a7f3 | |||
| 11cb1d81d9 | |||
| e0c9befdeb | |||
| 612b0b3c0a | |||
| f865508eb4 | |||
| 1fb04ce59d | |||
| 6f0070b353 | |||
| aec96eefd3 | |||
| 35569a6335 | |||
| a233268b66 | |||
| 20a825e249 | |||
| 2bbb428f2c | |||
| af3c98a50e | |||
| fd013abf67 | |||
| 0f332c9057 | |||
| 86b2621cd4 | |||
| fe1f4a22ab | |||
| db70ba204d | |||
| 5b36e84793 | |||
| ae29e67e28 | |||
| 4d75ce6d48 | |||
| 637428585c | |||
| c25ae4e0d1 | |||
| 98c013ea3f | |||
| 213537d0ef | |||
| 11c5b2e32b | |||
| c98da93339 | |||
| d45b1086c3 | |||
| 8398ca4823 | |||
| 087ed1c400 | |||
| e852e3ce48 | |||
| 6d80efb50a | |||
| cbcee98d94 | |||
| 82119bdd47 | |||
| d666e47e16 | |||
| 8a3076783e | |||
| 5d11f97093 | |||
| eb1c015315 | |||
| f99b77af89 | |||
| 1e96563522 | |||
| 28d3fb1361 | |||
| bce59127eb | |||
| 1bfacdf51f | |||
| c74815b8ab | |||
| dccfe14ae9 | |||
| 343f015c81 | |||
| decf5824e6 | |||
| 648bde44b1 | |||
| bbb7f0f0c0 | |||
| 4c417472ec | |||
| f9899b9c56 | |||
| 254c8ce240 | |||
| 5be9a22970 | |||
| 888e8ae57d | |||
| a27bbec59a | |||
| 1c9b47e35c | |||
| b3c9611af2 | |||
| def48e346b | |||
| a2e7334dfe | |||
| a4c7d29595 | |||
| 1b5515fd8b | |||
| 94518c8433 | |||
| ea5be2e879 | |||
| f93a24e283 | |||
| d0f928ae22 | |||
| 99f4e171e3 | |||
| 29ea6e2c50 | |||
| 2c926928dc | |||
| a78c1e971b | |||
| 2531f9eeb3 | |||
| f47ed80584 | |||
| 2a9732a312 | |||
| e06df74caf | |||
| 2d2d8a41f8 | |||
| 6343499ed1 | |||
| ebf7ca624e | |||
| c22b14389a | |||
| c0e902e5cc | |||
| 28c243d066 | |||
| 96a0d8af07 | |||
| b730cffaf4 | |||
| d1ca1e3d5b | |||
| 20b2cdbc04 | |||
| e74aa7b0ea | |||
| ea3f78b711 | |||
| cca7dd680f | |||
| 9980407095 | |||
| abc3ada6c3 | |||
| a0fb279b1b | |||
| 08a4010a16 | |||
| 9733a29a65 | |||
| 3afa269e2e | |||
| 00085a7de6 | |||
| 35f6f95956 | |||
| 2d97dc4b0e | |||
| 26c55675dd | |||
| eef2d46f32 | |||
| 49a401debd | |||
| 09a3a15d64 | |||
| f1378e97f1 | |||
| 2ec1c6e9b1 | |||
| 67f14588f7 | |||
| ef244889fd | |||
| d3f01c36e1 | |||
| 8b7105e20c | |||
| 7f2443ce48 | |||
| bd64b27109 | |||
| 0a51c9998d | |||
| 6f76ba7228 | |||
| c6838bc865 | |||
| 221c481644 | |||
| c490ba5992 | |||
| af8c6c78bf | |||
| 894d76f811 | |||
| ba34b603a1 | |||
| 0ecdc4e4be | |||
| e9bb43b8e8 | |||
| cd76eb0a95 | |||
| 21da7bcc90 | |||
| bce1f6d0cc | |||
| e376660ab0 | |||
| 6d96c58f01 | |||
| 3f7af48a2b | |||
| d5ba2360e4 | |||
| 96e52d6c2a | |||
| b164bf9592 | |||
| 62ff982956 | |||
| 0323f36f56 | |||
| d29c00d09d | |||
| 1b15430ad4 | |||
| cd2fb5ac12 | |||
| 7e3921ad66 | |||
| 5d8fe86d95 | |||
| 2d300815ea | |||
| fd6c772eaf | |||
| 6f4f739ed7 | |||
| a745d6bdf4 | |||
| 6bfee3312f | |||
| 32c8a54045 | |||
| 6641927dbe | |||
| 223b57eb87 | |||
| abda028b05 | |||
| df7330f015 | |||
| 7e453ae996 | |||
| e07c6a4606 | |||
| 957b4df642 | |||
| ac1aae4f7a | |||
| 4ccaba1bb3 | |||
| 4f7a7734ae | |||
| 5a8efc3f0a | |||
| 6c71d531bb | |||
| ba6f8b09fd | |||
| 60fba8a738 | |||
| 694c013b6b | |||
| aeac9caaa1 | |||
| 4bd6bce0df | |||
| 0af237af3d | |||
| d2376fcaa6 | |||
| 8ad5e75ab4 | |||
| a639416cf5 | |||
| eeac2c71c8 | |||
| 6a79b48214 | |||
| ff19b95aa7 | |||
| 1a8833eb9a | |||
| 3acf913b32 | |||
| 580d6e9727 | |||
| ba7ea0926f | |||
| 8f5cd3c5cd | |||
| 8cfa96d0ed | |||
| 6f8471196f | |||
| 64e7061084 | |||
| b28dfdeb60 | |||
| cb64e93b97 | |||
| c5b3fceeae | |||
| 0f9699d4f3 | |||
| 128ede438e | |||
| d531b733b8 | |||
| 78e92a7565 | |||
| 00bb6706fd | |||
| 96f3bb5326 | |||
| 949272778c | |||
| 4d00d6ccde | |||
| 94f6873148 | |||
| 930888bc15 | |||
| 07e191be7b | |||
| 0cb575d15f | |||
| 68ec316b28 | |||
| 8128851e0b | |||
| 1723df3885 | |||
| 8274a3e918 | |||
| a4ea305164 | |||
| 3b5c247f05 | |||
| c295db7a15 | |||
| ee276cd8e5 | |||
| 879265b966 | |||
| db69c7251b | |||
| 8a556f8d7d | |||
| a473e91485 | |||
| d56b936b48 | |||
| 6154dc09bf | |||
| 561714e8ad | |||
| c952cc13ef | |||
| be4269ab79 | |||
| 2c195cda4d | |||
| 2f7f609754 | |||
| 675b3859b3 | |||
| b42737f834 | |||
| 001670fcbc | |||
| 7096c102cd | |||
| dc6e47ca1b | |||
| d5b3f2cff3 | |||
| 94407268f0 | |||
| e56aec431c | |||
| 5446f4cdd0 | |||
| 7445768ec8 | |||
| bb0f773b7d | |||
| aa032c95e4 | |||
| ef69619597 | |||
| 92d7151bdf | |||
| 347d31ce4f | |||
| cb10b98d9b | |||
| 26ae580e01 | |||
| 75f4374657 | |||
| 109577e646 | |||
| 305e59b3e8 | |||
| b914cc87fb | |||
| 3565b281ca | |||
| 5fc792d791 | |||
| 1e35cd5ba2 | |||
| a59fa266c9 | |||
| 9c5e7632fb | |||
| a4a3e0a8e3 | |||
| 23f4322197 | |||
| 570f168a78 | |||
| d6b92cfd18 | |||
| da7fa911b2 | |||
| 98213cbc40 | |||
| 7a682a46f3 | |||
| 2e1f3da6cf | |||
| 49ce0b250c | |||
| 71a43d9658 | |||
| 51700aa89e | |||
| 978d32af3a | |||
| 1439c0f5c0 | |||
| c4a5db8ebc | |||
| 0e78c8b752 | |||
| 71133a808f | |||
| 81d2493476 | |||
| f83c6feeaa | |||
| 11c752fe65 | |||
| db65c208d9 | |||
| 1c98d39ddb | |||
| 704c67ebbd | |||
| 2a2f18ca56 | |||
| 777c7cb93a | |||
| 922fb36208 | |||
| 723ac95443 | |||
|
|
26d7507fff | ||
| d22417f41b | |||
| a10d190b65 | |||
| 6fd3b44e8c | |||
| a597104cf2 | |||
| 5ec35952d1 | |||
| 30bf1ebb43 | |||
| ab8227e23f | |||
| b9e2abad2d | |||
| cb3c985ee6 | |||
| 8bb4d3a60d | |||
| b4a5b4f899 | |||
| cf5982c9fa | |||
| 25ba142f94 | |||
| 4a39e2c0e1 | |||
| c6688a21f7 | |||
| 45b923dfac | |||
| 89399526f5 | |||
| 6c49f42c2f | |||
| 25698cd763 | |||
| a18e0da3a9 | |||
| 60571adb40 | |||
| efe77d4454 | |||
| 36234e980a | |||
| 4cb7abc3ac | |||
| 8465bec805 | |||
| 0b1f86ae2c | |||
| a2d672f7fd | |||
| 4c024a24f0 | |||
| db3d8f827f | |||
| 79130a6dd7 | |||
| 2298fd4ba2 | |||
| 6802e9c0da | |||
| 29f1389d5d | |||
| c7d2e43b6d | |||
| 4efd0f5038 | |||
| f7418969cf | |||
| fff46de4c5 | |||
| feaaf69103 | |||
| c89fee20ec | |||
| 7637e46c6f | |||
| 0861aebda9 | |||
| 6d64f9e3c9 | |||
| 1af1d3005b | |||
| d8e962fdf0 | |||
| 11fc417556 | |||
| 7dd0174fd4 | |||
| 0de2a96155 | |||
| e5a3d1eda7 | |||
| a7bccb34bb | |||
| e6c8d66a12 | |||
| d9011a05b7 | |||
| 53f281620e | |||
| e0eef3d906 | |||
| 9d638fb919 | |||
| 85684fdb00 | |||
| 44bc12b61a | |||
| 52048a41c1 | |||
| 4c734c1cea | |||
| 9f271b0d37 | |||
| 966ec60f17 | |||
| b9e2312779 | |||
| 06ca32ce6d | |||
| ea0dc9348c | |||
| 3589d166cd | |||
| f5f9db21dc | |||
| 40f94833c1 | |||
| 02659e0abf | |||
| 085d08b5c9 | |||
| 200432a2b4 | |||
| 9d897c13f4 | |||
| 389832314a | |||
| 408c7a2585 | |||
| 48f6c7420f | |||
| e651b1af17 | |||
| 940bf19d54 | |||
| 376e5d4634 | |||
| c3260c26f5 | |||
| 2005c40baa | |||
| c96d179fb7 | |||
| 1b8c99d2e1 | |||
| 62da2102d6 | |||
| 60b7f7c02f | |||
| 4468df0e13 | |||
| a4b72a21c8 | |||
| 7e7c34a073 | |||
| 24abb22de0 | |||
| 06aae48e24 | |||
| 1533eec081 | |||
| 35415de225 | |||
| f8dded33c7 | |||
| 682eaf6f8c | |||
| 254e3b00c7 | |||
| 14a50b44e2 | |||
| 795a8eae62 | |||
| 41f014e7a7 | |||
| 0dd4229432 | |||
| ccef40e817 | |||
| 5045f20c40 | |||
| 6714d13198 | |||
| eaa5683ff1 | |||
| 56d0c3d420 | |||
| 086791f4f9 | |||
| 133c210b2e | |||
| 2574b21acc | |||
| 03bf1ed08b | |||
| d25f2885da | |||
| d82107ab9a | |||
| c963cd88a8 | |||
| b9e54380db | |||
| b4f1b32cef | |||
| 480a8bdd82 | |||
| 3dab75fde5 | |||
| 522fa1dff0 | |||
| cae0870fd0 | |||
| e6c9af81e9 | |||
| ca81e091a1 | |||
| c54211f112 | |||
| c9bf289510 | |||
| 284aa1e360 | |||
| 23c693da4e | |||
| 92f55cee5a | |||
| 5f64a8959b | |||
| f902bbe0aa | |||
| 52186aa5a4 | |||
| cc19d568a3 | |||
| 6a080333c2 | |||
| a4165e0dc8 | |||
| 6eef99d661 | |||
| 493db693e1 | |||
| fc99eff005 | |||
| 6c9cc71ae1 | |||
| dd6e6d5571 | |||
| a89f152564 | |||
| cfc4c295e4 | |||
| 161eccd9a5 | |||
| 02e2e13790 | |||
| 28ced1d39a | |||
| ba549f8f05 | |||
| f0be8c5919 | |||
| 206740889c | |||
| 39e52d07c2 | |||
| 7327c287f4 | |||
| a9b65812d7 | |||
| a50d27688f |
34
.github/workflows/app-errors-tests.yml
vendored
Normal file
34
.github/workflows/app-errors-tests.yml
vendored
Normal file
@ -0,0 +1,34 @@
|
|||||||
|
name: app_errors tests
|
||||||
|
|
||||||
|
on:
|
||||||
|
push:
|
||||||
|
branches: [main]
|
||||||
|
# The workflow's own file counts as app_errors: editing only this file would
|
||||||
|
# otherwise trigger nothing, so a fix to the job itself could never prove
|
||||||
|
# itself.
|
||||||
|
paths: ['app_errors/**', '.github/workflows/app-errors-tests.yml']
|
||||||
|
pull_request:
|
||||||
|
branches: [main]
|
||||||
|
paths: ['app_errors/**', '.github/workflows/app-errors-tests.yml']
|
||||||
|
|
||||||
|
jobs:
|
||||||
|
test:
|
||||||
|
runs-on: ubuntu-latest
|
||||||
|
defaults:
|
||||||
|
run:
|
||||||
|
working-directory: app_errors
|
||||||
|
steps:
|
||||||
|
- uses: actions/checkout@v4
|
||||||
|
|
||||||
|
- name: Set up Python
|
||||||
|
uses: actions/setup-python@v5
|
||||||
|
with:
|
||||||
|
python-version: "3.x"
|
||||||
|
cache: pip
|
||||||
|
cache-dependency-path: app_errors/requirements.txt
|
||||||
|
|
||||||
|
- name: Install dependencies
|
||||||
|
run: pip install -r requirements.txt && pip install --no-deps -e .
|
||||||
|
|
||||||
|
- name: Run tests with coverage
|
||||||
|
run: python -m pytest -v
|
||||||
48
.github/workflows/crdt-sync-dart-tests.yml
vendored
Normal file
48
.github/workflows/crdt-sync-dart-tests.yml
vendored
Normal file
@ -0,0 +1,48 @@
|
|||||||
|
name: crdt_sync_dart tests
|
||||||
|
|
||||||
|
on:
|
||||||
|
push:
|
||||||
|
branches: [main]
|
||||||
|
paths: ['crdt_sync_dart/**']
|
||||||
|
pull_request:
|
||||||
|
branches: [main]
|
||||||
|
paths: ['crdt_sync_dart/**']
|
||||||
|
|
||||||
|
jobs:
|
||||||
|
test:
|
||||||
|
runs-on: ubuntu-latest
|
||||||
|
defaults:
|
||||||
|
run:
|
||||||
|
working-directory: crdt_sync_dart
|
||||||
|
|
||||||
|
steps:
|
||||||
|
- uses: actions/checkout@v4
|
||||||
|
|
||||||
|
# Pure Dart, no Flutter dependency -- so setup-dart, not flutter-action.
|
||||||
|
- name: Set up Dart
|
||||||
|
uses: dart-lang/setup-dart@v1
|
||||||
|
with:
|
||||||
|
sdk: stable
|
||||||
|
|
||||||
|
- name: Install dependencies
|
||||||
|
run: dart pub get
|
||||||
|
|
||||||
|
- name: Analyze
|
||||||
|
run: dart analyze --fatal-infos
|
||||||
|
|
||||||
|
- name: Run tests with coverage
|
||||||
|
run: dart test --coverage=coverage
|
||||||
|
|
||||||
|
# Unlike `flutter test --coverage`, `dart test --coverage` emits raw VM
|
||||||
|
# JSON and no lcov. Skipping this step leaves a stale lcov.info on disk
|
||||||
|
# that the gate below happily "passes" -- which is exactly how this
|
||||||
|
# package drifted to 96% while believing it was at 100%.
|
||||||
|
- name: Convert coverage to lcov
|
||||||
|
run: |
|
||||||
|
dart pub global activate coverage
|
||||||
|
dart pub global run coverage:format_coverage \
|
||||||
|
--lcov --in=coverage/test --out=coverage/lcov.info \
|
||||||
|
--report-on=lib --packages=.dart_tool/package_config.json
|
||||||
|
|
||||||
|
- name: Enforce 100% line coverage
|
||||||
|
run: scripts/check_coverage.sh coverage/lcov.info 100
|
||||||
36
.github/workflows/crdt-sync-flutter-tests.yml
vendored
Normal file
36
.github/workflows/crdt-sync-flutter-tests.yml
vendored
Normal file
@ -0,0 +1,36 @@
|
|||||||
|
name: crdt_sync_flutter tests
|
||||||
|
|
||||||
|
on:
|
||||||
|
push:
|
||||||
|
branches: [main]
|
||||||
|
paths: ['crdt_sync_flutter/**', 'crdt_sync_dart/**']
|
||||||
|
pull_request:
|
||||||
|
branches: [main]
|
||||||
|
paths: ['crdt_sync_flutter/**', 'crdt_sync_dart/**']
|
||||||
|
|
||||||
|
jobs:
|
||||||
|
test:
|
||||||
|
runs-on: ubuntu-latest
|
||||||
|
defaults:
|
||||||
|
run:
|
||||||
|
working-directory: crdt_sync_flutter
|
||||||
|
|
||||||
|
steps:
|
||||||
|
- uses: actions/checkout@v4
|
||||||
|
|
||||||
|
- name: Set up Flutter
|
||||||
|
uses: subosito/flutter-action@v2
|
||||||
|
with:
|
||||||
|
channel: stable
|
||||||
|
|
||||||
|
- name: Install dependencies
|
||||||
|
run: flutter pub get
|
||||||
|
|
||||||
|
- name: Analyze
|
||||||
|
run: flutter analyze
|
||||||
|
|
||||||
|
- name: Run tests with coverage
|
||||||
|
run: flutter test --coverage
|
||||||
|
|
||||||
|
- name: Enforce 100% line coverage
|
||||||
|
run: scripts/check_coverage.sh coverage/lcov.info 100
|
||||||
62
.github/workflows/crdt-sync-precommit.yml
vendored
62
.github/workflows/crdt-sync-precommit.yml
vendored
@ -3,10 +3,10 @@ name: crdt-sync pre-commit
|
|||||||
on:
|
on:
|
||||||
push:
|
push:
|
||||||
branches: [main]
|
branches: [main]
|
||||||
paths: ['crdt-sync/**']
|
paths: ['crdt-sync/**', '.github/workflows/crdt-sync-precommit.yml']
|
||||||
pull_request:
|
pull_request:
|
||||||
branches: [main]
|
branches: [main]
|
||||||
paths: ['crdt-sync/**']
|
paths: ['crdt-sync/**', '.github/workflows/crdt-sync-precommit.yml']
|
||||||
|
|
||||||
jobs:
|
jobs:
|
||||||
pre-commit:
|
pre-commit:
|
||||||
@ -15,10 +15,56 @@ jobs:
|
|||||||
- uses: actions/checkout@v4
|
- uses: actions/checkout@v4
|
||||||
- uses: actions/setup-python@v5
|
- uses: actions/setup-python@v5
|
||||||
with:
|
with:
|
||||||
python-version: "3.12"
|
python-version: "3.x"
|
||||||
- name: Install dependencies
|
# Only pre-commit itself. Every linting hook runs in its own isolated
|
||||||
working-directory: crdt-sync
|
# env -- ruff, mypy, pylint, bandit and codespell each come from their
|
||||||
run: pip install -r requirements.txt
|
# own repo+rev, and the local hooks need nothing beyond bash and
|
||||||
- uses: pre-commit/action@v3.0.1
|
# python3 -- so installing the full requirements.txt spent 9s a run on
|
||||||
|
# packages no pre-commit-stage hook imports. Verified by running all
|
||||||
|
# three configs green in a venv holding pre-commit and nothing else.
|
||||||
|
# The pin is read out of requirements.txt rather than repeated here, so
|
||||||
|
# it cannot drift from what the dependency-freshness gate governs.
|
||||||
|
- name: Install pre-commit
|
||||||
|
run: |
|
||||||
|
pip install "$(grep '^pre-commit==' crdt-sync/requirements.txt)"
|
||||||
|
|
||||||
|
# Keyed on THIS package's config. pre-commit/action@v3.0.1 caches on
|
||||||
|
# hashFiles('.pre-commit-config.yaml') -- the repo ROOT's -- so all three
|
||||||
|
# package jobs shared one key, raced to overwrite it with hook sets built
|
||||||
|
# from four different configs, and editing a per-package config did not
|
||||||
|
# invalidate it. The cache was therefore silently wrong rather than
|
||||||
|
# missing, and the hooks reinstalled from scratch on every run (38-49s).
|
||||||
|
- uses: actions/cache@v4
|
||||||
with:
|
with:
|
||||||
extra_args: --config crdt-sync/.pre-commit-config.yaml --all-files
|
path: ~/.cache/pre-commit
|
||||||
|
key: >-
|
||||||
|
pre-commit-crdt-sync-${{ env.pythonLocation }}-${{
|
||||||
|
hashFiles('crdt-sync/.pre-commit-config.yaml') }}
|
||||||
|
# Prefix fallback, or this fix would evaporate on the very
|
||||||
|
# event that motivated it: bumping a hook rev changes the
|
||||||
|
# exact key, and a total miss means reinstalling every hook
|
||||||
|
# again. pre-commit's store is keyed internally by hook
|
||||||
|
# repo+rev, so a superseded entry is ignored disk rather
|
||||||
|
# than a wrong hook, and cache still re-saves under the new
|
||||||
|
# exact key after a prefix-only hit.
|
||||||
|
restore-keys: pre-commit-crdt-sync-${{ env.pythonLocation }}-
|
||||||
|
# mypy re-analyses the stdlib and every third-party stub from scratch
|
||||||
|
# without this, which measured 10s of the hook step in CI against 0.25s
|
||||||
|
# warm locally -- a 19MB cache dir does the whole difference. Keyed on
|
||||||
|
# the config, not the sources: mypy's own cache metadata records the
|
||||||
|
# interpreter, the flag set and a hash per source file, so it re-checks
|
||||||
|
# what changed and cannot pass stale code. Deliberately NOT keyed on
|
||||||
|
# github.sha -- that re-saves 19MB x3 every commit and would evict the
|
||||||
|
# 68MB hook caches under the repo's 10GB LRU budget. A fixed key keeps
|
||||||
|
# the expensive part, the dependency analysis, which is what costs 10s.
|
||||||
|
- uses: actions/cache@v4
|
||||||
|
with:
|
||||||
|
path: .mypy_cache
|
||||||
|
key: >-
|
||||||
|
mypy-crdt-sync-${{ env.pythonLocation }}-${{
|
||||||
|
hashFiles('crdt-sync/.pre-commit-config.yaml') }}
|
||||||
|
restore-keys: mypy-crdt-sync-${{ env.pythonLocation }}-
|
||||||
|
- name: Run the hooks
|
||||||
|
run: >-
|
||||||
|
pre-commit run --config crdt-sync/.pre-commit-config.yaml
|
||||||
|
--all-files --show-diff-on-failure
|
||||||
|
|||||||
14
.github/workflows/crdt-sync-tests.yml
vendored
14
.github/workflows/crdt-sync-tests.yml
vendored
@ -3,10 +3,10 @@ name: crdt-sync tests
|
|||||||
on:
|
on:
|
||||||
push:
|
push:
|
||||||
branches: [main]
|
branches: [main]
|
||||||
paths: ['crdt-sync/**']
|
paths: ['crdt-sync/**', '.github/workflows/crdt-sync-tests.yml']
|
||||||
pull_request:
|
pull_request:
|
||||||
branches: [main]
|
branches: [main]
|
||||||
paths: ['crdt-sync/**']
|
paths: ['crdt-sync/**', '.github/workflows/crdt-sync-tests.yml']
|
||||||
|
|
||||||
jobs:
|
jobs:
|
||||||
test:
|
test:
|
||||||
@ -14,17 +14,15 @@ jobs:
|
|||||||
defaults:
|
defaults:
|
||||||
run:
|
run:
|
||||||
working-directory: crdt-sync
|
working-directory: crdt-sync
|
||||||
strategy:
|
|
||||||
matrix:
|
|
||||||
python-version: ["3.10", "3.11", "3.12"]
|
|
||||||
|
|
||||||
steps:
|
steps:
|
||||||
- uses: actions/checkout@v4
|
- uses: actions/checkout@v4
|
||||||
|
|
||||||
- name: Set up Python ${{ matrix.python-version }}
|
- name: Set up Python
|
||||||
uses: actions/setup-python@v5
|
uses: actions/setup-python@v5
|
||||||
with:
|
with:
|
||||||
python-version: ${{ matrix.python-version }}
|
python-version: "3.x"
|
||||||
|
cache: pip
|
||||||
|
cache-dependency-path: crdt-sync/requirements.txt
|
||||||
|
|
||||||
- name: Install dependencies
|
- name: Install dependencies
|
||||||
run: pip install -r requirements.txt
|
run: pip install -r requirements.txt
|
||||||
|
|||||||
36
.github/workflows/data-transfer-flutter-tests.yml
vendored
Normal file
36
.github/workflows/data-transfer-flutter-tests.yml
vendored
Normal file
@ -0,0 +1,36 @@
|
|||||||
|
name: data_transfer_flutter tests
|
||||||
|
|
||||||
|
on:
|
||||||
|
push:
|
||||||
|
branches: [main]
|
||||||
|
paths: ['data_transfer_flutter/**']
|
||||||
|
pull_request:
|
||||||
|
branches: [main]
|
||||||
|
paths: ['data_transfer_flutter/**']
|
||||||
|
|
||||||
|
jobs:
|
||||||
|
test:
|
||||||
|
runs-on: ubuntu-latest
|
||||||
|
defaults:
|
||||||
|
run:
|
||||||
|
working-directory: data_transfer_flutter
|
||||||
|
|
||||||
|
steps:
|
||||||
|
- uses: actions/checkout@v4
|
||||||
|
|
||||||
|
- name: Set up Flutter
|
||||||
|
uses: subosito/flutter-action@v2
|
||||||
|
with:
|
||||||
|
channel: stable
|
||||||
|
|
||||||
|
- name: Install dependencies
|
||||||
|
run: flutter pub get
|
||||||
|
|
||||||
|
- name: Analyze
|
||||||
|
run: flutter analyze
|
||||||
|
|
||||||
|
- name: Run tests with coverage
|
||||||
|
run: flutter test --coverage
|
||||||
|
|
||||||
|
- name: Enforce 100% line coverage
|
||||||
|
run: scripts/check_coverage.sh coverage/lcov.info 100
|
||||||
61
.github/workflows/dependency-freshness.yml
vendored
Normal file
61
.github/workflows/dependency-freshness.yml
vendored
Normal file
@ -0,0 +1,61 @@
|
|||||||
|
name: dependency freshness
|
||||||
|
|
||||||
|
# Every dependency on its ecosystem's newest STABLE release, enforced on push
|
||||||
|
# as well as at commit time. The local pre-commit hook only sees the manifests
|
||||||
|
# in a commit and can be skipped entirely by a fresh clone that never ran
|
||||||
|
# `pre-commit install`; this runs `--all` over the whole repo.
|
||||||
|
#
|
||||||
|
# `--strict` is CI-only. Offline the gate degrades to its cached answer and
|
||||||
|
# passes, because `--no-verify` is banned locally and a hook that hard-failed
|
||||||
|
# on a flaky connection would leave no way to commit. A runner is always
|
||||||
|
# online, so here an undeterminable answer is a real failure.
|
||||||
|
#
|
||||||
|
# Expect this to go red for reasons this repo's commit did not cause: an
|
||||||
|
# upstream release overnight is enough. That is the chosen behaviour -- the
|
||||||
|
# alternative is a gate that only notices staleness when someone remembers to
|
||||||
|
# look.
|
||||||
|
|
||||||
|
on:
|
||||||
|
push:
|
||||||
|
branches: [main]
|
||||||
|
pull_request:
|
||||||
|
workflow_dispatch:
|
||||||
|
|
||||||
|
jobs:
|
||||||
|
dependency-freshness:
|
||||||
|
name: dependencies on newest stable
|
||||||
|
runs-on: ubuntu-latest
|
||||||
|
steps:
|
||||||
|
- uses: actions/checkout@v4
|
||||||
|
|
||||||
|
# The gate lives in the shared utils repo so every repo resolves the
|
||||||
|
# same "latest stable" the same way. Checking it out beats vendoring a
|
||||||
|
# copy, which is exactly how a gate and its survey start disagreeing.
|
||||||
|
- name: Check out the shared gate
|
||||||
|
uses: actions/checkout@v4
|
||||||
|
with:
|
||||||
|
repository: kuhyx/utils
|
||||||
|
path: .utils
|
||||||
|
|
||||||
|
# Any recent Python runs the gate. The Python TARGET is python.org's
|
||||||
|
# newest release (registries/toolchain.python_latest), not this
|
||||||
|
# interpreter: when it was, "3.x" resolved to 3.15.0 on one runner and
|
||||||
|
# 3.14.8 on the next, and spellcode's allowlist flipped dead/required.
|
||||||
|
- name: Set up Python
|
||||||
|
uses: actions/setup-python@v5
|
||||||
|
with:
|
||||||
|
python-version: "3.x"
|
||||||
|
|
||||||
|
- name: Install the gate's two runtime dependencies
|
||||||
|
run: python -m pip install --upgrade pyyaml packaging
|
||||||
|
|
||||||
|
- name: Cache registry lookups
|
||||||
|
uses: actions/cache@v4
|
||||||
|
with:
|
||||||
|
path: ~/.cache/dep-freshness
|
||||||
|
key: dep-freshness-${{ hashFiles('**/pubspec.yaml', '**/pyproject.toml',
|
||||||
|
'**/requirements*.txt', '**/package.json', '**/Cargo.toml', '**/go.mod') }}
|
||||||
|
restore-keys: dep-freshness-
|
||||||
|
|
||||||
|
- name: Every dependency is on newest stable
|
||||||
|
run: bash .utils/scripts/check_dependency_freshness.sh --all --strict
|
||||||
36
.github/workflows/design-system-tests.yml
vendored
Normal file
36
.github/workflows/design-system-tests.yml
vendored
Normal file
@ -0,0 +1,36 @@
|
|||||||
|
name: design_system tests
|
||||||
|
|
||||||
|
on:
|
||||||
|
push:
|
||||||
|
branches: [main]
|
||||||
|
paths: ['design_system/**']
|
||||||
|
pull_request:
|
||||||
|
branches: [main]
|
||||||
|
paths: ['design_system/**']
|
||||||
|
|
||||||
|
jobs:
|
||||||
|
test:
|
||||||
|
runs-on: ubuntu-latest
|
||||||
|
defaults:
|
||||||
|
run:
|
||||||
|
working-directory: design_system
|
||||||
|
|
||||||
|
steps:
|
||||||
|
- uses: actions/checkout@v4
|
||||||
|
|
||||||
|
- name: Set up Flutter
|
||||||
|
uses: subosito/flutter-action@v2
|
||||||
|
with:
|
||||||
|
channel: stable
|
||||||
|
|
||||||
|
- name: Install dependencies
|
||||||
|
run: flutter pub get
|
||||||
|
|
||||||
|
- name: Analyze
|
||||||
|
run: flutter analyze
|
||||||
|
|
||||||
|
- name: Run tests with coverage
|
||||||
|
run: flutter test --coverage
|
||||||
|
|
||||||
|
- name: Enforce 100% line coverage
|
||||||
|
run: scripts/check_coverage.sh coverage/lcov.info 100
|
||||||
73
.github/workflows/earned-time-precommit.yml
vendored
Normal file
73
.github/workflows/earned-time-precommit.yml
vendored
Normal file
@ -0,0 +1,73 @@
|
|||||||
|
name: earned_time pre-commit
|
||||||
|
|
||||||
|
on:
|
||||||
|
push:
|
||||||
|
branches: [main]
|
||||||
|
# The workflow's own file counts as earned_time: editing only this file would
|
||||||
|
# otherwise trigger nothing, so a fix to the job itself could never prove
|
||||||
|
# itself.
|
||||||
|
paths: ['earned_time/**', '.github/workflows/earned-time-precommit.yml']
|
||||||
|
pull_request:
|
||||||
|
branches: [main]
|
||||||
|
paths: ['earned_time/**', '.github/workflows/earned-time-precommit.yml']
|
||||||
|
|
||||||
|
jobs:
|
||||||
|
pre-commit:
|
||||||
|
runs-on: ubuntu-latest
|
||||||
|
steps:
|
||||||
|
- uses: actions/checkout@v4
|
||||||
|
- uses: actions/setup-python@v5
|
||||||
|
with:
|
||||||
|
python-version: "3.x"
|
||||||
|
# Only pre-commit itself. Every linting hook runs in its own isolated
|
||||||
|
# env -- ruff, mypy, pylint, bandit and codespell each come from their
|
||||||
|
# own repo+rev, and the local hooks need nothing beyond bash and
|
||||||
|
# python3 -- so installing the full requirements.txt spent 9s a run on
|
||||||
|
# packages no pre-commit-stage hook imports. Verified by running all
|
||||||
|
# three configs green in a venv holding pre-commit and nothing else.
|
||||||
|
# The pin is read out of requirements.txt rather than repeated here, so
|
||||||
|
# it cannot drift from what the dependency-freshness gate governs.
|
||||||
|
- name: Install pre-commit
|
||||||
|
run: |
|
||||||
|
pip install "$(grep '^pre-commit==' earned_time/requirements.txt)"
|
||||||
|
|
||||||
|
# Keyed on THIS package's config. pre-commit/action@v3.0.1 caches on
|
||||||
|
# hashFiles('.pre-commit-config.yaml') -- the repo ROOT's -- so all three
|
||||||
|
# package jobs shared one key, raced to overwrite it with hook sets built
|
||||||
|
# from four different configs, and editing a per-package config did not
|
||||||
|
# invalidate it. The cache was therefore silently wrong rather than
|
||||||
|
# missing, and the hooks reinstalled from scratch on every run (38-49s).
|
||||||
|
- uses: actions/cache@v4
|
||||||
|
with:
|
||||||
|
path: ~/.cache/pre-commit
|
||||||
|
key: >-
|
||||||
|
pre-commit-earned_time-${{ env.pythonLocation }}-${{
|
||||||
|
hashFiles('earned_time/.pre-commit-config.yaml') }}
|
||||||
|
# Prefix fallback, or this fix would evaporate on the very
|
||||||
|
# event that motivated it: bumping a hook rev changes the
|
||||||
|
# exact key, and a total miss means reinstalling every hook
|
||||||
|
# again. pre-commit's store is keyed internally by hook
|
||||||
|
# repo+rev, so a superseded entry is ignored disk rather
|
||||||
|
# than a wrong hook, and cache still re-saves under the new
|
||||||
|
# exact key after a prefix-only hit.
|
||||||
|
restore-keys: pre-commit-earned_time-${{ env.pythonLocation }}-
|
||||||
|
# mypy re-analyses the stdlib and every third-party stub from scratch
|
||||||
|
# without this, which measured 10s of the hook step in CI against 0.25s
|
||||||
|
# warm locally -- a 19MB cache dir does the whole difference. Keyed on
|
||||||
|
# the config, not the sources: mypy's own cache metadata records the
|
||||||
|
# interpreter, the flag set and a hash per source file, so it re-checks
|
||||||
|
# what changed and cannot pass stale code. Deliberately NOT keyed on
|
||||||
|
# github.sha -- that re-saves 19MB x3 every commit and would evict the
|
||||||
|
# 68MB hook caches under the repo's 10GB LRU budget. A fixed key keeps
|
||||||
|
# the expensive part, the dependency analysis, which is what costs 10s.
|
||||||
|
- uses: actions/cache@v4
|
||||||
|
with:
|
||||||
|
path: .mypy_cache
|
||||||
|
key: >-
|
||||||
|
mypy-earned_time-${{ env.pythonLocation }}-${{
|
||||||
|
hashFiles('earned_time/.pre-commit-config.yaml') }}
|
||||||
|
restore-keys: mypy-earned_time-${{ env.pythonLocation }}-
|
||||||
|
- name: Run the hooks
|
||||||
|
run: >-
|
||||||
|
pre-commit run --config earned_time/.pre-commit-config.yaml
|
||||||
|
--all-files --show-diff-on-failure
|
||||||
36
.github/workflows/earned-time-tests.yml
vendored
Normal file
36
.github/workflows/earned-time-tests.yml
vendored
Normal file
@ -0,0 +1,36 @@
|
|||||||
|
name: earned_time tests
|
||||||
|
|
||||||
|
on:
|
||||||
|
push:
|
||||||
|
branches: [main]
|
||||||
|
# The workflow's own file counts as earned_time: editing only this file would
|
||||||
|
# otherwise trigger nothing, so a fix to the job itself could never prove
|
||||||
|
# itself.
|
||||||
|
paths: ['earned_time/**', '.github/workflows/earned-time-tests.yml']
|
||||||
|
pull_request:
|
||||||
|
branches: [main]
|
||||||
|
paths: ['earned_time/**', '.github/workflows/earned-time-tests.yml']
|
||||||
|
|
||||||
|
jobs:
|
||||||
|
test:
|
||||||
|
runs-on: ubuntu-latest
|
||||||
|
defaults:
|
||||||
|
run:
|
||||||
|
working-directory: earned_time
|
||||||
|
steps:
|
||||||
|
- uses: actions/checkout@v4
|
||||||
|
|
||||||
|
- name: Set up Python
|
||||||
|
uses: actions/setup-python@v5
|
||||||
|
with:
|
||||||
|
python-version: "3.x"
|
||||||
|
cache: pip
|
||||||
|
cache-dependency-path: earned_time/requirements.txt
|
||||||
|
|
||||||
|
- name: Install dependencies
|
||||||
|
run: pip install -r requirements.txt && pip install --no-deps -e .
|
||||||
|
|
||||||
|
# No display needed: earned_time is stdlib-only policy, imported
|
||||||
|
# headless by the root gaming daemon.
|
||||||
|
- name: Run tests with coverage
|
||||||
|
run: python -m pytest -v
|
||||||
34
.github/workflows/file-length.yml
vendored
Normal file
34
.github/workflows/file-length.yml
vendored
Normal file
@ -0,0 +1,34 @@
|
|||||||
|
name: file length
|
||||||
|
|
||||||
|
# The 250-line cap, enforced on push as well as in pre-commit
|
||||||
|
# (refactor_claude_todo.md, "make it permanent").
|
||||||
|
#
|
||||||
|
# Unlike the pre-commit hook, which only sees the files in a commit, this runs
|
||||||
|
# over the whole tree: the hook keeps a violation from being *introduced*, and
|
||||||
|
# this keeps one from surviving a path the hook never saw (a merge, a push
|
||||||
|
# from a machine without hooks installed, a rebase that resurrects a file).
|
||||||
|
#
|
||||||
|
# No paths filter on purpose. The cap applies to every file in the repo, so
|
||||||
|
# scoping this job to a subdirectory would be the one way to reintroduce the
|
||||||
|
# problem it exists to catch.
|
||||||
|
|
||||||
|
on:
|
||||||
|
push:
|
||||||
|
branches: [main]
|
||||||
|
pull_request:
|
||||||
|
branches: [main]
|
||||||
|
|
||||||
|
jobs:
|
||||||
|
file-length:
|
||||||
|
runs-on: ubuntu-latest
|
||||||
|
|
||||||
|
steps:
|
||||||
|
- uses: actions/checkout@v4
|
||||||
|
|
||||||
|
- name: Set up Python
|
||||||
|
uses: actions/setup-python@v5
|
||||||
|
with:
|
||||||
|
python-version: "3.x"
|
||||||
|
|
||||||
|
- name: Every file is at most 250 lines
|
||||||
|
run: bash scripts/check_file_length.sh --all
|
||||||
73
.github/workflows/focus-project-precommit.yml
vendored
Normal file
73
.github/workflows/focus-project-precommit.yml
vendored
Normal file
@ -0,0 +1,73 @@
|
|||||||
|
name: focus-project pre-commit
|
||||||
|
|
||||||
|
on:
|
||||||
|
push:
|
||||||
|
branches: [main]
|
||||||
|
# The workflow's own file counts as focus_project: editing only this file would
|
||||||
|
# otherwise trigger nothing, so a fix to the job itself could never prove
|
||||||
|
# itself.
|
||||||
|
paths: ['focus_project/**', '.github/workflows/focus-project-precommit.yml']
|
||||||
|
pull_request:
|
||||||
|
branches: [main]
|
||||||
|
paths: ['focus_project/**', '.github/workflows/focus-project-precommit.yml']
|
||||||
|
|
||||||
|
jobs:
|
||||||
|
pre-commit:
|
||||||
|
runs-on: ubuntu-latest
|
||||||
|
steps:
|
||||||
|
- uses: actions/checkout@v4
|
||||||
|
- uses: actions/setup-python@v5
|
||||||
|
with:
|
||||||
|
python-version: "3.x"
|
||||||
|
# Only pre-commit itself. Every linting hook runs in its own isolated
|
||||||
|
# env -- ruff, mypy, pylint, bandit and codespell each come from their
|
||||||
|
# own repo+rev, and the local hooks need nothing beyond bash and
|
||||||
|
# python3 -- so installing the full requirements.txt spent 9s a run on
|
||||||
|
# packages no pre-commit-stage hook imports. Verified by running all
|
||||||
|
# three configs green in a venv holding pre-commit and nothing else.
|
||||||
|
# The pin is read out of requirements.txt rather than repeated here, so
|
||||||
|
# it cannot drift from what the dependency-freshness gate governs.
|
||||||
|
- name: Install pre-commit
|
||||||
|
run: |
|
||||||
|
pip install "$(grep '^pre-commit==' focus_project/requirements.txt)"
|
||||||
|
|
||||||
|
# Keyed on THIS package's config. pre-commit/action@v3.0.1 caches on
|
||||||
|
# hashFiles('.pre-commit-config.yaml') -- the repo ROOT's -- so all three
|
||||||
|
# package jobs shared one key, raced to overwrite it with hook sets built
|
||||||
|
# from four different configs, and editing a per-package config did not
|
||||||
|
# invalidate it. The cache was therefore silently wrong rather than
|
||||||
|
# missing, and the hooks reinstalled from scratch on every run (38-49s).
|
||||||
|
- uses: actions/cache@v4
|
||||||
|
with:
|
||||||
|
path: ~/.cache/pre-commit
|
||||||
|
key: >-
|
||||||
|
pre-commit-focus-project-${{ env.pythonLocation }}-${{
|
||||||
|
hashFiles('focus_project/.pre-commit-config.yaml') }}
|
||||||
|
# Prefix fallback, or this fix would evaporate on the very
|
||||||
|
# event that motivated it: bumping a hook rev changes the
|
||||||
|
# exact key, and a total miss means reinstalling every hook
|
||||||
|
# again. pre-commit's store is keyed internally by hook
|
||||||
|
# repo+rev, so a superseded entry is ignored disk rather
|
||||||
|
# than a wrong hook, and cache still re-saves under the new
|
||||||
|
# exact key after a prefix-only hit.
|
||||||
|
restore-keys: pre-commit-focus-project-${{ env.pythonLocation }}-
|
||||||
|
# mypy re-analyses the stdlib and every third-party stub from scratch
|
||||||
|
# without this, which measured 10s of the hook step in CI against 0.25s
|
||||||
|
# warm locally -- a 19MB cache dir does the whole difference. Keyed on
|
||||||
|
# the config, not the sources: mypy's own cache metadata records the
|
||||||
|
# interpreter, the flag set and a hash per source file, so it re-checks
|
||||||
|
# what changed and cannot pass stale code. Deliberately NOT keyed on
|
||||||
|
# github.sha -- that re-saves 19MB x3 every commit and would evict the
|
||||||
|
# 68MB hook caches under the repo's 10GB LRU budget. A fixed key keeps
|
||||||
|
# the expensive part, the dependency analysis, which is what costs 10s.
|
||||||
|
- uses: actions/cache@v4
|
||||||
|
with:
|
||||||
|
path: .mypy_cache
|
||||||
|
key: >-
|
||||||
|
mypy-focus-project-${{ env.pythonLocation }}-${{
|
||||||
|
hashFiles('focus_project/.pre-commit-config.yaml') }}
|
||||||
|
restore-keys: mypy-focus-project-${{ env.pythonLocation }}-
|
||||||
|
- name: Run the hooks
|
||||||
|
run: >-
|
||||||
|
pre-commit run --config focus_project/.pre-commit-config.yaml
|
||||||
|
--all-files --show-diff-on-failure
|
||||||
34
.github/workflows/focus-project-tests.yml
vendored
Normal file
34
.github/workflows/focus-project-tests.yml
vendored
Normal file
@ -0,0 +1,34 @@
|
|||||||
|
name: focus-project tests
|
||||||
|
|
||||||
|
on:
|
||||||
|
push:
|
||||||
|
branches: [main]
|
||||||
|
# The workflow's own file counts as focus_project: editing only this file would
|
||||||
|
# otherwise trigger nothing, so a fix to the job itself could never prove
|
||||||
|
# itself.
|
||||||
|
paths: ['focus_project/**', '.github/workflows/focus-project-tests.yml']
|
||||||
|
pull_request:
|
||||||
|
branches: [main]
|
||||||
|
paths: ['focus_project/**', '.github/workflows/focus-project-tests.yml']
|
||||||
|
|
||||||
|
jobs:
|
||||||
|
test:
|
||||||
|
runs-on: ubuntu-latest
|
||||||
|
defaults:
|
||||||
|
run:
|
||||||
|
working-directory: focus_project
|
||||||
|
steps:
|
||||||
|
- uses: actions/checkout@v4
|
||||||
|
|
||||||
|
- name: Set up Python
|
||||||
|
uses: actions/setup-python@v5
|
||||||
|
with:
|
||||||
|
python-version: "3.x"
|
||||||
|
cache: pip
|
||||||
|
cache-dependency-path: focus_project/requirements.txt
|
||||||
|
|
||||||
|
- name: Install dependencies
|
||||||
|
run: pip install -r requirements.txt && pip install --no-deps -e .
|
||||||
|
|
||||||
|
- name: Run tests with coverage
|
||||||
|
run: python -m pytest -v
|
||||||
73
.github/workflows/freedays-precommit.yml
vendored
Normal file
73
.github/workflows/freedays-precommit.yml
vendored
Normal file
@ -0,0 +1,73 @@
|
|||||||
|
name: freedays pre-commit
|
||||||
|
|
||||||
|
on:
|
||||||
|
push:
|
||||||
|
branches: [main]
|
||||||
|
# The workflow's own file counts as freedays: editing only this file would
|
||||||
|
# otherwise trigger nothing, so a fix to the job itself could never prove
|
||||||
|
# itself.
|
||||||
|
paths: ['freedays/**', '.github/workflows/freedays-precommit.yml']
|
||||||
|
pull_request:
|
||||||
|
branches: [main]
|
||||||
|
paths: ['freedays/**', '.github/workflows/freedays-precommit.yml']
|
||||||
|
|
||||||
|
jobs:
|
||||||
|
pre-commit:
|
||||||
|
runs-on: ubuntu-latest
|
||||||
|
steps:
|
||||||
|
- uses: actions/checkout@v4
|
||||||
|
- uses: actions/setup-python@v5
|
||||||
|
with:
|
||||||
|
python-version: "3.x"
|
||||||
|
# Only pre-commit itself. Every linting hook runs in its own isolated
|
||||||
|
# env -- ruff, mypy, pylint, bandit and codespell each come from their
|
||||||
|
# own repo+rev, and the local hooks need nothing beyond bash and
|
||||||
|
# python3 -- so installing the full requirements.txt spent 9s a run on
|
||||||
|
# packages no pre-commit-stage hook imports. Verified by running all
|
||||||
|
# three configs green in a venv holding pre-commit and nothing else.
|
||||||
|
# The pin is read out of requirements.txt rather than repeated here, so
|
||||||
|
# it cannot drift from what the dependency-freshness gate governs.
|
||||||
|
- name: Install pre-commit
|
||||||
|
run: |
|
||||||
|
pip install "$(grep '^pre-commit==' freedays/requirements.txt)"
|
||||||
|
|
||||||
|
# Keyed on THIS package's config. pre-commit/action@v3.0.1 caches on
|
||||||
|
# hashFiles('.pre-commit-config.yaml') -- the repo ROOT's -- so all three
|
||||||
|
# package jobs shared one key, raced to overwrite it with hook sets built
|
||||||
|
# from four different configs, and editing a per-package config did not
|
||||||
|
# invalidate it. The cache was therefore silently wrong rather than
|
||||||
|
# missing, and the hooks reinstalled from scratch on every run (38-49s).
|
||||||
|
- uses: actions/cache@v4
|
||||||
|
with:
|
||||||
|
path: ~/.cache/pre-commit
|
||||||
|
key: >-
|
||||||
|
pre-commit-freedays-${{ env.pythonLocation }}-${{
|
||||||
|
hashFiles('freedays/.pre-commit-config.yaml') }}
|
||||||
|
# Prefix fallback, or this fix would evaporate on the very
|
||||||
|
# event that motivated it: bumping a hook rev changes the
|
||||||
|
# exact key, and a total miss means reinstalling every hook
|
||||||
|
# again. pre-commit's store is keyed internally by hook
|
||||||
|
# repo+rev, so a superseded entry is ignored disk rather
|
||||||
|
# than a wrong hook, and cache still re-saves under the new
|
||||||
|
# exact key after a prefix-only hit.
|
||||||
|
restore-keys: pre-commit-freedays-${{ env.pythonLocation }}-
|
||||||
|
# mypy re-analyses the stdlib and every third-party stub from scratch
|
||||||
|
# without this, which measured 10s of the hook step in CI against 0.25s
|
||||||
|
# warm locally -- a 19MB cache dir does the whole difference. Keyed on
|
||||||
|
# the config, not the sources: mypy's own cache metadata records the
|
||||||
|
# interpreter, the flag set and a hash per source file, so it re-checks
|
||||||
|
# what changed and cannot pass stale code. Deliberately NOT keyed on
|
||||||
|
# github.sha -- that re-saves 19MB x3 every commit and would evict the
|
||||||
|
# 68MB hook caches under the repo's 10GB LRU budget. A fixed key keeps
|
||||||
|
# the expensive part, the dependency analysis, which is what costs 10s.
|
||||||
|
- uses: actions/cache@v4
|
||||||
|
with:
|
||||||
|
path: .mypy_cache
|
||||||
|
key: >-
|
||||||
|
mypy-freedays-${{ env.pythonLocation }}-${{
|
||||||
|
hashFiles('freedays/.pre-commit-config.yaml') }}
|
||||||
|
restore-keys: mypy-freedays-${{ env.pythonLocation }}-
|
||||||
|
- name: Run the hooks
|
||||||
|
run: >-
|
||||||
|
pre-commit run --config freedays/.pre-commit-config.yaml
|
||||||
|
--all-files --show-diff-on-failure
|
||||||
44
.github/workflows/freedays-tests.yml
vendored
Normal file
44
.github/workflows/freedays-tests.yml
vendored
Normal file
@ -0,0 +1,44 @@
|
|||||||
|
name: freedays tests
|
||||||
|
|
||||||
|
on:
|
||||||
|
push:
|
||||||
|
branches: [main]
|
||||||
|
# The workflow's own file counts as freedays: editing only this file would
|
||||||
|
# otherwise trigger nothing, so a fix to the job itself could never prove
|
||||||
|
# itself.
|
||||||
|
paths: ['freedays/**', '.github/workflows/freedays-tests.yml']
|
||||||
|
pull_request:
|
||||||
|
branches: [main]
|
||||||
|
paths: ['freedays/**', '.github/workflows/freedays-tests.yml']
|
||||||
|
|
||||||
|
jobs:
|
||||||
|
test:
|
||||||
|
runs-on: ubuntu-latest
|
||||||
|
defaults:
|
||||||
|
run:
|
||||||
|
working-directory: freedays
|
||||||
|
steps:
|
||||||
|
- uses: actions/checkout@v4
|
||||||
|
|
||||||
|
- name: Set up Python
|
||||||
|
uses: actions/setup-python@v5
|
||||||
|
with:
|
||||||
|
python-version: "3.x"
|
||||||
|
cache: pip
|
||||||
|
cache-dependency-path: freedays/requirements.txt
|
||||||
|
|
||||||
|
# crdt-sync is a sibling in this repo, so it installs from the checkout
|
||||||
|
# rather than from a tag -- CI must test what is on this branch, not
|
||||||
|
# what was last released. Deliberately NOT gatelock: importing it pulls
|
||||||
|
# in tkinter, and this job has no display precisely because freedays
|
||||||
|
# must work without one.
|
||||||
|
- name: Install the sibling package
|
||||||
|
run: pip install ../crdt-sync
|
||||||
|
|
||||||
|
- name: Install dependencies
|
||||||
|
run: pip install -r requirements.txt && pip install --no-deps -e .
|
||||||
|
|
||||||
|
# No display needed: freedays draws nothing. It is policy, a JSON file
|
||||||
|
# and a CLI.
|
||||||
|
- name: Run tests with coverage
|
||||||
|
run: python -m pytest -v
|
||||||
71
.github/workflows/game-recording-precommit.yml
vendored
Normal file
71
.github/workflows/game-recording-precommit.yml
vendored
Normal file
@ -0,0 +1,71 @@
|
|||||||
|
name: game_recording pre-commit
|
||||||
|
|
||||||
|
on:
|
||||||
|
push:
|
||||||
|
branches: [main]
|
||||||
|
# The workflow's own file counts as game_recording: editing only this file used
|
||||||
|
# to trigger nothing, so a fix to the job itself could never prove itself.
|
||||||
|
paths: ['game_recording/**', '.github/workflows/game-recording-precommit.yml']
|
||||||
|
pull_request:
|
||||||
|
branches: [main]
|
||||||
|
paths: ['game_recording/**', '.github/workflows/game-recording-precommit.yml']
|
||||||
|
|
||||||
|
jobs:
|
||||||
|
pre-commit:
|
||||||
|
runs-on: ubuntu-latest
|
||||||
|
steps:
|
||||||
|
- uses: actions/checkout@v4
|
||||||
|
- uses: actions/setup-python@v5
|
||||||
|
with:
|
||||||
|
python-version: "3.x"
|
||||||
|
# Only pre-commit itself. Every linting hook runs in its own isolated
|
||||||
|
# env -- ruff, mypy, pylint, bandit and codespell each come from their
|
||||||
|
# own repo+rev, and the local hooks need nothing beyond bash and
|
||||||
|
# python3 -- so installing the full requirements.txt spent 9s a run on
|
||||||
|
# packages no pre-commit-stage hook imports. Verified by running this
|
||||||
|
# package's config green in a venv holding pre-commit and nothing else.
|
||||||
|
# The pin is read out of requirements.txt rather than repeated here, so
|
||||||
|
# it cannot drift from what the dependency-freshness gate governs.
|
||||||
|
- name: Install pre-commit
|
||||||
|
run: |
|
||||||
|
pip install "$(grep '^pre-commit==' game_recording/requirements.txt)"
|
||||||
|
|
||||||
|
# Keyed on THIS package's config. pre-commit/action@v3.0.1 caches on
|
||||||
|
# hashFiles('.pre-commit-config.yaml') -- the repo ROOT's -- so editing
|
||||||
|
# this package's config would not invalidate it, and other jobs in the
|
||||||
|
# repo that cache hooks under that key could overwrite it with a
|
||||||
|
# different hook set. A key from this config cannot go stale that way.
|
||||||
|
- uses: actions/cache@v4
|
||||||
|
with:
|
||||||
|
path: ~/.cache/pre-commit
|
||||||
|
key: >-
|
||||||
|
pre-commit-game-recording-${{ env.pythonLocation }}-${{
|
||||||
|
hashFiles('game_recording/.pre-commit-config.yaml') }}
|
||||||
|
# Prefix fallback, or this fix would evaporate on the very
|
||||||
|
# event that motivated it: bumping a hook rev changes the
|
||||||
|
# exact key, and a total miss means reinstalling every hook
|
||||||
|
# again. pre-commit's store is keyed internally by hook
|
||||||
|
# repo+rev, so a superseded entry is ignored disk rather
|
||||||
|
# than a wrong hook, and cache still re-saves under the new
|
||||||
|
# exact key after a prefix-only hit.
|
||||||
|
restore-keys: pre-commit-game-recording-${{ env.pythonLocation }}-
|
||||||
|
# mypy re-analyses the stdlib and every third-party stub from scratch
|
||||||
|
# without this, which measured 10s of the hook step in CI against 0.25s
|
||||||
|
# warm locally -- a 19MB cache dir does the whole difference. Keyed on
|
||||||
|
# the config, not the sources: mypy's own cache metadata records the
|
||||||
|
# interpreter, the flag set and a hash per source file, so it re-checks
|
||||||
|
# what changed and cannot pass stale code. Deliberately NOT keyed on
|
||||||
|
# github.sha -- that re-saves 19MB every commit and would evict the
|
||||||
|
# 68MB hook caches under the repo's 10GB LRU budget. A fixed key keeps
|
||||||
|
# the expensive part, the dependency analysis, which is what costs 10s.
|
||||||
|
- uses: actions/cache@v4
|
||||||
|
with:
|
||||||
|
path: .mypy_cache
|
||||||
|
key: >-
|
||||||
|
mypy-game-recording-${{ env.pythonLocation }}-${{
|
||||||
|
hashFiles('game_recording/.pre-commit-config.yaml') }}
|
||||||
|
restore-keys: mypy-game-recording-${{ env.pythonLocation }}-
|
||||||
|
- name: Run the hooks
|
||||||
|
run: >-
|
||||||
|
pre-commit run --config game_recording/.pre-commit-config.yaml
|
||||||
|
--all-files --show-diff-on-failure
|
||||||
35
.github/workflows/game-recording-tests.yml
vendored
Normal file
35
.github/workflows/game-recording-tests.yml
vendored
Normal file
@ -0,0 +1,35 @@
|
|||||||
|
name: game_recording tests
|
||||||
|
|
||||||
|
on:
|
||||||
|
push:
|
||||||
|
branches: [main]
|
||||||
|
# The workflow's own file counts as game_recording: editing only this file used
|
||||||
|
# to trigger nothing, so a fix to the job itself could never prove itself.
|
||||||
|
paths: ['game_recording/**', '.github/workflows/game-recording-tests.yml']
|
||||||
|
pull_request:
|
||||||
|
branches: [main]
|
||||||
|
paths: ['game_recording/**', '.github/workflows/game-recording-tests.yml']
|
||||||
|
|
||||||
|
jobs:
|
||||||
|
test:
|
||||||
|
runs-on: ubuntu-latest
|
||||||
|
defaults:
|
||||||
|
run:
|
||||||
|
working-directory: game_recording
|
||||||
|
steps:
|
||||||
|
- uses: actions/checkout@v4
|
||||||
|
|
||||||
|
- name: Set up Python
|
||||||
|
uses: actions/setup-python@v5
|
||||||
|
with:
|
||||||
|
python-version: "3.x"
|
||||||
|
|
||||||
|
# The finalize and library tests run the real ffmpeg and ffprobe.
|
||||||
|
- name: Install ffmpeg
|
||||||
|
run: sudo apt-get update && sudo apt-get install -y ffmpeg
|
||||||
|
|
||||||
|
- name: Install dependencies
|
||||||
|
run: pip install -r requirements.txt
|
||||||
|
|
||||||
|
- name: Run tests with coverage
|
||||||
|
run: python -m pytest -v --cov=game_recording
|
||||||
64
.github/workflows/gatelock-precommit.yml
vendored
64
.github/workflows/gatelock-precommit.yml
vendored
@ -3,10 +3,12 @@ name: gatelock pre-commit
|
|||||||
on:
|
on:
|
||||||
push:
|
push:
|
||||||
branches: [main]
|
branches: [main]
|
||||||
paths: ['gatelock/**']
|
# The workflow's own file counts as gatelock: editing only this file used
|
||||||
|
# to trigger nothing, so a fix to the job itself could never prove itself.
|
||||||
|
paths: ['gatelock/**', '.github/workflows/gatelock-precommit.yml']
|
||||||
pull_request:
|
pull_request:
|
||||||
branches: [main]
|
branches: [main]
|
||||||
paths: ['gatelock/**']
|
paths: ['gatelock/**', '.github/workflows/gatelock-precommit.yml']
|
||||||
|
|
||||||
jobs:
|
jobs:
|
||||||
pre-commit:
|
pre-commit:
|
||||||
@ -15,10 +17,56 @@ jobs:
|
|||||||
- uses: actions/checkout@v4
|
- uses: actions/checkout@v4
|
||||||
- uses: actions/setup-python@v5
|
- uses: actions/setup-python@v5
|
||||||
with:
|
with:
|
||||||
python-version: "3.12"
|
python-version: "3.x"
|
||||||
- name: Install dependencies
|
# Only pre-commit itself. Every linting hook runs in its own isolated
|
||||||
working-directory: gatelock
|
# env -- ruff, mypy, pylint, bandit and codespell each come from their
|
||||||
run: pip install -r requirements.txt
|
# own repo+rev, and the local hooks need nothing beyond bash and
|
||||||
- uses: pre-commit/action@v3.0.1
|
# python3 -- so installing the full requirements.txt spent 9s a run on
|
||||||
|
# packages no pre-commit-stage hook imports. Verified by running all
|
||||||
|
# three configs green in a venv holding pre-commit and nothing else.
|
||||||
|
# The pin is read out of requirements.txt rather than repeated here, so
|
||||||
|
# it cannot drift from what the dependency-freshness gate governs.
|
||||||
|
- name: Install pre-commit
|
||||||
|
run: |
|
||||||
|
pip install "$(grep '^pre-commit==' gatelock/requirements.txt)"
|
||||||
|
|
||||||
|
# Keyed on THIS package's config. pre-commit/action@v3.0.1 caches on
|
||||||
|
# hashFiles('.pre-commit-config.yaml') -- the repo ROOT's -- so all three
|
||||||
|
# package jobs shared one key, raced to overwrite it with hook sets built
|
||||||
|
# from four different configs, and editing a per-package config did not
|
||||||
|
# invalidate it. The cache was therefore silently wrong rather than
|
||||||
|
# missing, and the hooks reinstalled from scratch on every run (38-49s).
|
||||||
|
- uses: actions/cache@v4
|
||||||
with:
|
with:
|
||||||
extra_args: --config gatelock/.pre-commit-config.yaml --all-files
|
path: ~/.cache/pre-commit
|
||||||
|
key: >-
|
||||||
|
pre-commit-gatelock-${{ env.pythonLocation }}-${{
|
||||||
|
hashFiles('gatelock/.pre-commit-config.yaml') }}
|
||||||
|
# Prefix fallback, or this fix would evaporate on the very
|
||||||
|
# event that motivated it: bumping a hook rev changes the
|
||||||
|
# exact key, and a total miss means reinstalling every hook
|
||||||
|
# again. pre-commit's store is keyed internally by hook
|
||||||
|
# repo+rev, so a superseded entry is ignored disk rather
|
||||||
|
# than a wrong hook, and cache still re-saves under the new
|
||||||
|
# exact key after a prefix-only hit.
|
||||||
|
restore-keys: pre-commit-gatelock-${{ env.pythonLocation }}-
|
||||||
|
# mypy re-analyses the stdlib and every third-party stub from scratch
|
||||||
|
# without this, which measured 10s of the hook step in CI against 0.25s
|
||||||
|
# warm locally -- a 19MB cache dir does the whole difference. Keyed on
|
||||||
|
# the config, not the sources: mypy's own cache metadata records the
|
||||||
|
# interpreter, the flag set and a hash per source file, so it re-checks
|
||||||
|
# what changed and cannot pass stale code. Deliberately NOT keyed on
|
||||||
|
# github.sha -- that re-saves 19MB x3 every commit and would evict the
|
||||||
|
# 68MB hook caches under the repo's 10GB LRU budget. A fixed key keeps
|
||||||
|
# the expensive part, the dependency analysis, which is what costs 10s.
|
||||||
|
- uses: actions/cache@v4
|
||||||
|
with:
|
||||||
|
path: .mypy_cache
|
||||||
|
key: >-
|
||||||
|
mypy-gatelock-${{ env.pythonLocation }}-${{
|
||||||
|
hashFiles('gatelock/.pre-commit-config.yaml') }}
|
||||||
|
restore-keys: mypy-gatelock-${{ env.pythonLocation }}-
|
||||||
|
- name: Run the hooks
|
||||||
|
run: >-
|
||||||
|
pre-commit run --config gatelock/.pre-commit-config.yaml
|
||||||
|
--all-files --show-diff-on-failure
|
||||||
|
|||||||
34
.github/workflows/gatelock-tests.yml
vendored
34
.github/workflows/gatelock-tests.yml
vendored
@ -3,10 +3,12 @@ name: gatelock tests
|
|||||||
on:
|
on:
|
||||||
push:
|
push:
|
||||||
branches: [main]
|
branches: [main]
|
||||||
paths: ['gatelock/**']
|
# The workflow's own file counts as gatelock: editing only this file used
|
||||||
|
# to trigger nothing, so a fix to the job itself could never prove itself.
|
||||||
|
paths: ['gatelock/**', 'earned_time/**', 'freedays/**', 'sickdays/**', '.github/workflows/gatelock-tests.yml']
|
||||||
pull_request:
|
pull_request:
|
||||||
branches: [main]
|
branches: [main]
|
||||||
paths: ['gatelock/**']
|
paths: ['gatelock/**', 'earned_time/**', 'freedays/**', 'sickdays/**', '.github/workflows/gatelock-tests.yml']
|
||||||
|
|
||||||
jobs:
|
jobs:
|
||||||
test:
|
test:
|
||||||
@ -14,20 +16,34 @@ jobs:
|
|||||||
defaults:
|
defaults:
|
||||||
run:
|
run:
|
||||||
working-directory: gatelock
|
working-directory: gatelock
|
||||||
strategy:
|
|
||||||
matrix:
|
|
||||||
python-version: ["3.10", "3.11", "3.12"]
|
|
||||||
|
|
||||||
steps:
|
steps:
|
||||||
- uses: actions/checkout@v4
|
- uses: actions/checkout@v4
|
||||||
|
|
||||||
- name: Set up Python ${{ matrix.python-version }}
|
- name: Set up Python
|
||||||
uses: actions/setup-python@v5
|
uses: actions/setup-python@v5
|
||||||
with:
|
with:
|
||||||
python-version: ${{ matrix.python-version }}
|
python-version: "3.x"
|
||||||
|
cache: pip
|
||||||
|
cache-dependency-path: gatelock/requirements.txt
|
||||||
|
|
||||||
|
# The evening chain (gatelock.evening_chain) reads earned_time, freedays
|
||||||
|
# and sickdays; they are siblings in this repo, so CI installs the
|
||||||
|
# checkout, not a tag.
|
||||||
|
- name: Install the sibling packages
|
||||||
|
run: >-
|
||||||
|
pip install ../crdt-sync ../earned_time
|
||||||
|
&& pip install --no-deps ../freedays ../sickdays
|
||||||
|
|
||||||
- name: Install dependencies
|
- name: Install dependencies
|
||||||
run: pip install -r requirements.txt
|
run: pip install -r requirements.txt
|
||||||
|
|
||||||
|
# The viewport, fit-check and keyboard tests drive real Tk: focus
|
||||||
|
# delivery, canvas scrolling and widget heights are Tk's own behaviour,
|
||||||
|
# and mocking them is what let a viewport that scrolled itself pass
|
||||||
|
# every check for a week. Headless they skip, silently taking coverage
|
||||||
|
# with them -- so the runner gets a display instead.
|
||||||
|
- name: Install a virtual X display
|
||||||
|
run: sudo apt-get update && sudo apt-get install -y xvfb
|
||||||
|
|
||||||
- name: Run tests with coverage
|
- name: Run tests with coverage
|
||||||
run: python -m pytest -v
|
run: xvfb-run -a -s "-screen 0 1600x1200x24" python -m pytest -v
|
||||||
|
|||||||
36
.github/workflows/github-device-auth-tests.yml
vendored
Normal file
36
.github/workflows/github-device-auth-tests.yml
vendored
Normal file
@ -0,0 +1,36 @@
|
|||||||
|
name: github_device_auth tests
|
||||||
|
|
||||||
|
on:
|
||||||
|
push:
|
||||||
|
branches: [main]
|
||||||
|
paths: ['github_device_auth/**']
|
||||||
|
pull_request:
|
||||||
|
branches: [main]
|
||||||
|
paths: ['github_device_auth/**']
|
||||||
|
|
||||||
|
jobs:
|
||||||
|
test:
|
||||||
|
runs-on: ubuntu-latest
|
||||||
|
defaults:
|
||||||
|
run:
|
||||||
|
working-directory: github_device_auth
|
||||||
|
|
||||||
|
steps:
|
||||||
|
- uses: actions/checkout@v4
|
||||||
|
|
||||||
|
- name: Set up Flutter
|
||||||
|
uses: subosito/flutter-action@v2
|
||||||
|
with:
|
||||||
|
channel: stable
|
||||||
|
|
||||||
|
- name: Install dependencies
|
||||||
|
run: flutter pub get
|
||||||
|
|
||||||
|
- name: Analyze
|
||||||
|
run: flutter analyze
|
||||||
|
|
||||||
|
- name: Run tests with coverage
|
||||||
|
run: flutter test --coverage
|
||||||
|
|
||||||
|
- name: Enforce 100% line coverage
|
||||||
|
run: scripts/check_coverage.sh coverage/lcov.info 100
|
||||||
38
.github/workflows/godot-dev-tools-tests.yml
vendored
Normal file
38
.github/workflows/godot-dev-tools-tests.yml
vendored
Normal file
@ -0,0 +1,38 @@
|
|||||||
|
name: godot_dev_tools tests
|
||||||
|
|
||||||
|
on:
|
||||||
|
push:
|
||||||
|
branches: [main]
|
||||||
|
paths: ['godot_dev_tools/**', '.github/workflows/godot-dev-tools-tests.yml']
|
||||||
|
pull_request:
|
||||||
|
branches: [main]
|
||||||
|
paths: ['godot_dev_tools/**', '.github/workflows/godot-dev-tools-tests.yml']
|
||||||
|
|
||||||
|
env:
|
||||||
|
GODOT_VERSION: "4.7.2"
|
||||||
|
|
||||||
|
jobs:
|
||||||
|
test:
|
||||||
|
runs-on: ubuntu-latest
|
||||||
|
steps:
|
||||||
|
- uses: actions/checkout@v4
|
||||||
|
|
||||||
|
- uses: actions/setup-python@v5
|
||||||
|
with: { python-version: "3.15.2" }
|
||||||
|
|
||||||
|
- name: Install Godot
|
||||||
|
run: |
|
||||||
|
curl -fsSL -o godot.zip "https://github.com/godotengine/godot/releases/download/${GODOT_VERSION}-stable/Godot_v${GODOT_VERSION}-stable_linux.x86_64.zip"
|
||||||
|
unzip -q godot.zip
|
||||||
|
chmod +x "Godot_v${GODOT_VERSION}-stable_linux.x86_64"
|
||||||
|
sudo mv "Godot_v${GODOT_VERSION}-stable_linux.x86_64" /usr/local/bin/godot
|
||||||
|
rm godot.zip
|
||||||
|
|
||||||
|
- name: Install gdtoolkit (pinned)
|
||||||
|
run: pip install -r godot_dev_tools/requirements-dev.txt
|
||||||
|
|
||||||
|
- name: Lint (gdlint, gdformat)
|
||||||
|
run: godot_dev_tools/lint.sh
|
||||||
|
|
||||||
|
- name: GUT against the stub host (GUT is fetched at its pinned tag)
|
||||||
|
run: godot_dev_tools/test.sh
|
||||||
36
.github/workflows/google-account-token-tests.yml
vendored
Normal file
36
.github/workflows/google-account-token-tests.yml
vendored
Normal file
@ -0,0 +1,36 @@
|
|||||||
|
name: google_account_token tests
|
||||||
|
|
||||||
|
on:
|
||||||
|
push:
|
||||||
|
branches: [main]
|
||||||
|
paths: ['google_account_token/**']
|
||||||
|
pull_request:
|
||||||
|
branches: [main]
|
||||||
|
paths: ['google_account_token/**']
|
||||||
|
|
||||||
|
jobs:
|
||||||
|
test:
|
||||||
|
runs-on: ubuntu-latest
|
||||||
|
defaults:
|
||||||
|
run:
|
||||||
|
working-directory: google_account_token
|
||||||
|
|
||||||
|
steps:
|
||||||
|
- uses: actions/checkout@v4
|
||||||
|
|
||||||
|
- name: Set up Flutter
|
||||||
|
uses: subosito/flutter-action@v2
|
||||||
|
with:
|
||||||
|
channel: stable
|
||||||
|
|
||||||
|
- name: Install dependencies
|
||||||
|
run: flutter pub get
|
||||||
|
|
||||||
|
- name: Analyze
|
||||||
|
run: flutter analyze
|
||||||
|
|
||||||
|
- name: Run tests with coverage
|
||||||
|
run: flutter test --coverage
|
||||||
|
|
||||||
|
- name: Enforce 100% line coverage
|
||||||
|
run: scripts/check_coverage.sh coverage/lcov.info 100
|
||||||
73
.github/workflows/holds-precommit.yml
vendored
Normal file
73
.github/workflows/holds-precommit.yml
vendored
Normal file
@ -0,0 +1,73 @@
|
|||||||
|
name: holds pre-commit
|
||||||
|
|
||||||
|
on:
|
||||||
|
push:
|
||||||
|
branches: [main]
|
||||||
|
# The workflow's own file counts as holds: editing only this file would
|
||||||
|
# otherwise trigger nothing, so a fix to the job itself could never prove
|
||||||
|
# itself.
|
||||||
|
paths: ['holds/**', '.github/workflows/holds-precommit.yml']
|
||||||
|
pull_request:
|
||||||
|
branches: [main]
|
||||||
|
paths: ['holds/**', '.github/workflows/holds-precommit.yml']
|
||||||
|
|
||||||
|
jobs:
|
||||||
|
pre-commit:
|
||||||
|
runs-on: ubuntu-latest
|
||||||
|
steps:
|
||||||
|
- uses: actions/checkout@v4
|
||||||
|
- uses: actions/setup-python@v5
|
||||||
|
with:
|
||||||
|
python-version: "3.x"
|
||||||
|
# Only pre-commit itself. Every linting hook runs in its own isolated
|
||||||
|
# env -- ruff, mypy, pylint, bandit and codespell each come from their
|
||||||
|
# own repo+rev, and the local hooks need nothing beyond bash and
|
||||||
|
# python3 -- so installing the full requirements.txt spent 9s a run on
|
||||||
|
# packages no pre-commit-stage hook imports. Verified by running all
|
||||||
|
# three configs green in a venv holding pre-commit and nothing else.
|
||||||
|
# The pin is read out of requirements.txt rather than repeated here, so
|
||||||
|
# it cannot drift from what the dependency-freshness gate governs.
|
||||||
|
- name: Install pre-commit
|
||||||
|
run: |
|
||||||
|
pip install "$(grep '^pre-commit==' holds/requirements.txt)"
|
||||||
|
|
||||||
|
# Keyed on THIS package's config. pre-commit/action@v3.0.1 caches on
|
||||||
|
# hashFiles('.pre-commit-config.yaml') -- the repo ROOT's -- so all three
|
||||||
|
# package jobs shared one key, raced to overwrite it with hook sets built
|
||||||
|
# from four different configs, and editing a per-package config did not
|
||||||
|
# invalidate it. The cache was therefore silently wrong rather than
|
||||||
|
# missing, and the hooks reinstalled from scratch on every run (38-49s).
|
||||||
|
- uses: actions/cache@v4
|
||||||
|
with:
|
||||||
|
path: ~/.cache/pre-commit
|
||||||
|
key: >-
|
||||||
|
pre-commit-holds-${{ env.pythonLocation }}-${{
|
||||||
|
hashFiles('holds/.pre-commit-config.yaml') }}
|
||||||
|
# Prefix fallback, or this fix would evaporate on the very
|
||||||
|
# event that motivated it: bumping a hook rev changes the
|
||||||
|
# exact key, and a total miss means reinstalling every hook
|
||||||
|
# again. pre-commit's store is keyed internally by hook
|
||||||
|
# repo+rev, so a superseded entry is ignored disk rather
|
||||||
|
# than a wrong hook, and cache still re-saves under the new
|
||||||
|
# exact key after a prefix-only hit.
|
||||||
|
restore-keys: pre-commit-holds-${{ env.pythonLocation }}-
|
||||||
|
# mypy re-analyses the stdlib and every third-party stub from scratch
|
||||||
|
# without this, which measured 10s of the hook step in CI against 0.25s
|
||||||
|
# warm locally -- a 19MB cache dir does the whole difference. Keyed on
|
||||||
|
# the config, not the sources: mypy's own cache metadata records the
|
||||||
|
# interpreter, the flag set and a hash per source file, so it re-checks
|
||||||
|
# what changed and cannot pass stale code. Deliberately NOT keyed on
|
||||||
|
# github.sha -- that re-saves 19MB x3 every commit and would evict the
|
||||||
|
# 68MB hook caches under the repo's 10GB LRU budget. A fixed key keeps
|
||||||
|
# the expensive part, the dependency analysis, which is what costs 10s.
|
||||||
|
- uses: actions/cache@v4
|
||||||
|
with:
|
||||||
|
path: .mypy_cache
|
||||||
|
key: >-
|
||||||
|
mypy-holds-${{ env.pythonLocation }}-${{
|
||||||
|
hashFiles('holds/.pre-commit-config.yaml') }}
|
||||||
|
restore-keys: mypy-holds-${{ env.pythonLocation }}-
|
||||||
|
- name: Run the hooks
|
||||||
|
run: >-
|
||||||
|
pre-commit run --config holds/.pre-commit-config.yaml
|
||||||
|
--all-files --show-diff-on-failure
|
||||||
34
.github/workflows/holds-tests.yml
vendored
Normal file
34
.github/workflows/holds-tests.yml
vendored
Normal file
@ -0,0 +1,34 @@
|
|||||||
|
name: holds tests
|
||||||
|
|
||||||
|
on:
|
||||||
|
push:
|
||||||
|
branches: [main]
|
||||||
|
# The workflow's own file counts as holds: editing only this file would
|
||||||
|
# otherwise trigger nothing, so a fix to the job itself could never prove
|
||||||
|
# itself.
|
||||||
|
paths: ['holds/**', '.github/workflows/holds-tests.yml']
|
||||||
|
pull_request:
|
||||||
|
branches: [main]
|
||||||
|
paths: ['holds/**', '.github/workflows/holds-tests.yml']
|
||||||
|
|
||||||
|
jobs:
|
||||||
|
test:
|
||||||
|
runs-on: ubuntu-latest
|
||||||
|
defaults:
|
||||||
|
run:
|
||||||
|
working-directory: holds
|
||||||
|
steps:
|
||||||
|
- uses: actions/checkout@v4
|
||||||
|
|
||||||
|
- name: Set up Python
|
||||||
|
uses: actions/setup-python@v5
|
||||||
|
with:
|
||||||
|
python-version: "3.x"
|
||||||
|
cache: pip
|
||||||
|
cache-dependency-path: holds/requirements.txt
|
||||||
|
|
||||||
|
- name: Install dependencies
|
||||||
|
run: pip install -r requirements.txt && pip install --no-deps -e .
|
||||||
|
|
||||||
|
- name: Run tests with coverage
|
||||||
|
run: python -m pytest -v
|
||||||
73
.github/workflows/leetcode-coach-precommit.yml
vendored
Normal file
73
.github/workflows/leetcode-coach-precommit.yml
vendored
Normal file
@ -0,0 +1,73 @@
|
|||||||
|
name: leetcode-coach pre-commit
|
||||||
|
|
||||||
|
on:
|
||||||
|
push:
|
||||||
|
branches: [main]
|
||||||
|
# The workflow's own file counts as leetcode_coach: editing only this file would
|
||||||
|
# otherwise trigger nothing, so a fix to the job itself could never prove
|
||||||
|
# itself.
|
||||||
|
paths: ['leetcode_coach/**', '.github/workflows/leetcode-coach-precommit.yml']
|
||||||
|
pull_request:
|
||||||
|
branches: [main]
|
||||||
|
paths: ['leetcode_coach/**', '.github/workflows/leetcode-coach-precommit.yml']
|
||||||
|
|
||||||
|
jobs:
|
||||||
|
pre-commit:
|
||||||
|
runs-on: ubuntu-latest
|
||||||
|
steps:
|
||||||
|
- uses: actions/checkout@v4
|
||||||
|
- uses: actions/setup-python@v5
|
||||||
|
with:
|
||||||
|
python-version: "3.x"
|
||||||
|
# Only pre-commit itself. Every linting hook runs in its own isolated
|
||||||
|
# env -- ruff, mypy, pylint, bandit and codespell each come from their
|
||||||
|
# own repo+rev, and the local hooks need nothing beyond bash and
|
||||||
|
# python3 -- so installing the full requirements.txt spent 9s a run on
|
||||||
|
# packages no pre-commit-stage hook imports. Verified by running all
|
||||||
|
# three configs green in a venv holding pre-commit and nothing else.
|
||||||
|
# The pin is read out of requirements.txt rather than repeated here, so
|
||||||
|
# it cannot drift from what the dependency-freshness gate governs.
|
||||||
|
- name: Install pre-commit
|
||||||
|
run: |
|
||||||
|
pip install "$(grep '^pre-commit==' leetcode_coach/requirements.txt)"
|
||||||
|
|
||||||
|
# Keyed on THIS package's config. pre-commit/action@v3.0.1 caches on
|
||||||
|
# hashFiles('.pre-commit-config.yaml') -- the repo ROOT's -- so all three
|
||||||
|
# package jobs shared one key, raced to overwrite it with hook sets built
|
||||||
|
# from four different configs, and editing a per-package config did not
|
||||||
|
# invalidate it. The cache was therefore silently wrong rather than
|
||||||
|
# missing, and the hooks reinstalled from scratch on every run (38-49s).
|
||||||
|
- uses: actions/cache@v4
|
||||||
|
with:
|
||||||
|
path: ~/.cache/pre-commit
|
||||||
|
key: >-
|
||||||
|
pre-commit-leetcode-coach-${{ env.pythonLocation }}-${{
|
||||||
|
hashFiles('leetcode_coach/.pre-commit-config.yaml') }}
|
||||||
|
# Prefix fallback, or this fix would evaporate on the very
|
||||||
|
# event that motivated it: bumping a hook rev changes the
|
||||||
|
# exact key, and a total miss means reinstalling every hook
|
||||||
|
# again. pre-commit's store is keyed internally by hook
|
||||||
|
# repo+rev, so a superseded entry is ignored disk rather
|
||||||
|
# than a wrong hook, and cache still re-saves under the new
|
||||||
|
# exact key after a prefix-only hit.
|
||||||
|
restore-keys: pre-commit-leetcode-coach-${{ env.pythonLocation }}-
|
||||||
|
# mypy re-analyses the stdlib and every third-party stub from scratch
|
||||||
|
# without this, which measured 10s of the hook step in CI against 0.25s
|
||||||
|
# warm locally -- a 19MB cache dir does the whole difference. Keyed on
|
||||||
|
# the config, not the sources: mypy's own cache metadata records the
|
||||||
|
# interpreter, the flag set and a hash per source file, so it re-checks
|
||||||
|
# what changed and cannot pass stale code. Deliberately NOT keyed on
|
||||||
|
# github.sha -- that re-saves 19MB x3 every commit and would evict the
|
||||||
|
# 68MB hook caches under the repo's 10GB LRU budget. A fixed key keeps
|
||||||
|
# the expensive part, the dependency analysis, which is what costs 10s.
|
||||||
|
- uses: actions/cache@v4
|
||||||
|
with:
|
||||||
|
path: .mypy_cache
|
||||||
|
key: >-
|
||||||
|
mypy-leetcode-coach-${{ env.pythonLocation }}-${{
|
||||||
|
hashFiles('leetcode_coach/.pre-commit-config.yaml') }}
|
||||||
|
restore-keys: mypy-leetcode-coach-${{ env.pythonLocation }}-
|
||||||
|
- name: Run the hooks
|
||||||
|
run: >-
|
||||||
|
pre-commit run --config leetcode_coach/.pre-commit-config.yaml
|
||||||
|
--all-files --show-diff-on-failure
|
||||||
34
.github/workflows/leetcode-coach-tests.yml
vendored
Normal file
34
.github/workflows/leetcode-coach-tests.yml
vendored
Normal file
@ -0,0 +1,34 @@
|
|||||||
|
name: leetcode-coach tests
|
||||||
|
|
||||||
|
on:
|
||||||
|
push:
|
||||||
|
branches: [main]
|
||||||
|
# The workflow's own file counts as leetcode_coach: editing only this file would
|
||||||
|
# otherwise trigger nothing, so a fix to the job itself could never prove
|
||||||
|
# itself.
|
||||||
|
paths: ['leetcode_coach/**', '.github/workflows/leetcode-coach-tests.yml']
|
||||||
|
pull_request:
|
||||||
|
branches: [main]
|
||||||
|
paths: ['leetcode_coach/**', '.github/workflows/leetcode-coach-tests.yml']
|
||||||
|
|
||||||
|
jobs:
|
||||||
|
test:
|
||||||
|
runs-on: ubuntu-latest
|
||||||
|
defaults:
|
||||||
|
run:
|
||||||
|
working-directory: leetcode_coach
|
||||||
|
steps:
|
||||||
|
- uses: actions/checkout@v4
|
||||||
|
|
||||||
|
- name: Set up Python
|
||||||
|
uses: actions/setup-python@v5
|
||||||
|
with:
|
||||||
|
python-version: "3.x"
|
||||||
|
cache: pip
|
||||||
|
cache-dependency-path: leetcode_coach/requirements.txt
|
||||||
|
|
||||||
|
- name: Install dependencies
|
||||||
|
run: pip install -r requirements.txt && pip install --no-deps -e .
|
||||||
|
|
||||||
|
- name: Run tests with coverage
|
||||||
|
run: python -m pytest -v
|
||||||
33
.github/workflows/md-naming.yml
vendored
Normal file
33
.github/workflows/md-naming.yml
vendored
Normal file
@ -0,0 +1,33 @@
|
|||||||
|
name: md-naming
|
||||||
|
|
||||||
|
# The markdown namespaces (README / CLAUDE* / DOCS*, no TODO*), enforced on push as well as at commit time.
|
||||||
|
# The local pre-commit hook can be skipped (a fresh clone that never ran
|
||||||
|
# `pre-commit install` has no hooks at all), so the convention needs a second
|
||||||
|
# gate that no one can forget to install.
|
||||||
|
#
|
||||||
|
# Deliberately a SEPARATE workflow from any release job: a badly named doc
|
||||||
|
# should fail lint, not block publishing an artifact.
|
||||||
|
on:
|
||||||
|
push:
|
||||||
|
branches: [main]
|
||||||
|
pull_request:
|
||||||
|
workflow_dispatch:
|
||||||
|
|
||||||
|
jobs:
|
||||||
|
md-naming:
|
||||||
|
name: markdown naming convention
|
||||||
|
runs-on: ubuntu-latest
|
||||||
|
steps:
|
||||||
|
- uses: actions/checkout@v4
|
||||||
|
|
||||||
|
# The gate and its exemption list live in the shared utils repo so every
|
||||||
|
# repo enforces the same namespaces. Checking it out beats vendoring a
|
||||||
|
# copy here, which is exactly how a gate and a survey start disagreeing.
|
||||||
|
- name: Check out the shared gate
|
||||||
|
uses: actions/checkout@v4
|
||||||
|
with:
|
||||||
|
repository: kuhyx/utils
|
||||||
|
path: .utils
|
||||||
|
|
||||||
|
- name: Enforce the naming convention
|
||||||
|
run: bash .utils/scripts/check_md_naming.sh --all
|
||||||
31
.github/workflows/music-theory-tests.yml
vendored
Normal file
31
.github/workflows/music-theory-tests.yml
vendored
Normal file
@ -0,0 +1,31 @@
|
|||||||
|
name: music_theory tests
|
||||||
|
|
||||||
|
on:
|
||||||
|
push:
|
||||||
|
branches: [main]
|
||||||
|
# The workflow's own file counts as music_theory: editing only this file used
|
||||||
|
# to trigger nothing, so a fix to the job itself could never prove itself.
|
||||||
|
paths: ['music_theory/**', '.github/workflows/music-theory-tests.yml']
|
||||||
|
pull_request:
|
||||||
|
branches: [main]
|
||||||
|
paths: ['music_theory/**', '.github/workflows/music-theory-tests.yml']
|
||||||
|
|
||||||
|
jobs:
|
||||||
|
test:
|
||||||
|
runs-on: ubuntu-latest
|
||||||
|
defaults:
|
||||||
|
run:
|
||||||
|
working-directory: music_theory
|
||||||
|
steps:
|
||||||
|
- uses: actions/checkout@v4
|
||||||
|
|
||||||
|
- name: Set up Python
|
||||||
|
uses: actions/setup-python@v5
|
||||||
|
with:
|
||||||
|
python-version: "3.x"
|
||||||
|
|
||||||
|
- name: Install dependencies
|
||||||
|
run: pip install -r requirements.txt
|
||||||
|
|
||||||
|
- name: Run tests with coverage
|
||||||
|
run: python -m pytest -v --cov=music_theory
|
||||||
73
.github/workflows/omniroute_offload-precommit.yml
vendored
Normal file
73
.github/workflows/omniroute_offload-precommit.yml
vendored
Normal file
@ -0,0 +1,73 @@
|
|||||||
|
name: omniroute_offload pre-commit
|
||||||
|
|
||||||
|
on:
|
||||||
|
push:
|
||||||
|
branches: [main]
|
||||||
|
# The workflow's own file counts as omniroute_offload: editing only this file would
|
||||||
|
# otherwise trigger nothing, so a fix to the job itself could never prove
|
||||||
|
# itself.
|
||||||
|
paths: ['omniroute_offload/**', '.github/workflows/omniroute_offload-precommit.yml']
|
||||||
|
pull_request:
|
||||||
|
branches: [main]
|
||||||
|
paths: ['omniroute_offload/**', '.github/workflows/omniroute_offload-precommit.yml']
|
||||||
|
|
||||||
|
jobs:
|
||||||
|
pre-commit:
|
||||||
|
runs-on: ubuntu-latest
|
||||||
|
steps:
|
||||||
|
- uses: actions/checkout@v4
|
||||||
|
- uses: actions/setup-python@v5
|
||||||
|
with:
|
||||||
|
python-version: "3.x"
|
||||||
|
# Only pre-commit itself. Every linting hook runs in its own isolated
|
||||||
|
# env -- ruff, mypy, pylint, bandit and codespell each come from their
|
||||||
|
# own repo+rev, and the local hooks need nothing beyond bash and
|
||||||
|
# python3 -- so installing the full requirements.txt spent 9s a run on
|
||||||
|
# packages no pre-commit-stage hook imports. Verified by running all
|
||||||
|
# three configs green in a venv holding pre-commit and nothing else.
|
||||||
|
# The pin is read out of requirements.txt rather than repeated here, so
|
||||||
|
# it cannot drift from what the dependency-freshness gate governs.
|
||||||
|
- name: Install pre-commit
|
||||||
|
run: |
|
||||||
|
pip install "$(grep '^pre-commit==' omniroute_offload/requirements.txt)"
|
||||||
|
|
||||||
|
# Keyed on THIS package's config. pre-commit/action@v3.0.1 caches on
|
||||||
|
# hashFiles('.pre-commit-config.yaml') -- the repo ROOT's -- so all three
|
||||||
|
# package jobs shared one key, raced to overwrite it with hook sets built
|
||||||
|
# from four different configs, and editing a per-package config did not
|
||||||
|
# invalidate it. The cache was therefore silently wrong rather than
|
||||||
|
# missing, and the hooks reinstalled from scratch on every run (38-49s).
|
||||||
|
- uses: actions/cache@v4
|
||||||
|
with:
|
||||||
|
path: ~/.cache/pre-commit
|
||||||
|
key: >-
|
||||||
|
pre-commit-omniroute_offload-${{ env.pythonLocation }}-${{
|
||||||
|
hashFiles('omniroute_offload/.pre-commit-config.yaml') }}
|
||||||
|
# Prefix fallback, or this fix would evaporate on the very
|
||||||
|
# event that motivated it: bumping a hook rev changes the
|
||||||
|
# exact key, and a total miss means reinstalling every hook
|
||||||
|
# again. pre-commit's store is keyed internally by hook
|
||||||
|
# repo+rev, so a superseded entry is ignored disk rather
|
||||||
|
# than a wrong hook, and cache still re-saves under the new
|
||||||
|
# exact key after a prefix-only hit.
|
||||||
|
restore-keys: pre-commit-omniroute_offload-${{ env.pythonLocation }}-
|
||||||
|
# mypy re-analyses the stdlib and every third-party stub from scratch
|
||||||
|
# without this, which measured 10s of the hook step in CI against 0.25s
|
||||||
|
# warm locally -- a 19MB cache dir does the whole difference. Keyed on
|
||||||
|
# the config, not the sources: mypy's own cache metadata records the
|
||||||
|
# interpreter, the flag set and a hash per source file, so it re-checks
|
||||||
|
# what changed and cannot pass stale code. Deliberately NOT keyed on
|
||||||
|
# github.sha -- that re-saves 19MB x3 every commit and would evict the
|
||||||
|
# 68MB hook caches under the repo's 10GB LRU budget. A fixed key keeps
|
||||||
|
# the expensive part, the dependency analysis, which is what costs 10s.
|
||||||
|
- uses: actions/cache@v4
|
||||||
|
with:
|
||||||
|
path: .mypy_cache
|
||||||
|
key: >-
|
||||||
|
mypy-omniroute_offload-${{ env.pythonLocation }}-${{
|
||||||
|
hashFiles('omniroute_offload/.pre-commit-config.yaml') }}
|
||||||
|
restore-keys: mypy-omniroute_offload-${{ env.pythonLocation }}-
|
||||||
|
- name: Run the hooks
|
||||||
|
run: >-
|
||||||
|
pre-commit run --config omniroute_offload/.pre-commit-config.yaml
|
||||||
|
--all-files --show-diff-on-failure
|
||||||
38
.github/workflows/palette-drift.yml
vendored
Normal file
38
.github/workflows/palette-drift.yml
vendored
Normal file
@ -0,0 +1,38 @@
|
|||||||
|
name: palette drift
|
||||||
|
|
||||||
|
# Deliberately NOT path-filtered. Every other workflow here scopes itself to
|
||||||
|
# one package, which is right for tests but wrong for this check: drift is a
|
||||||
|
# disagreement *between* packages, so editing design_system alone has to be
|
||||||
|
# able to fail it. A `paths:` filter would let exactly the edit that causes
|
||||||
|
# drift be the one that skips the check.
|
||||||
|
on:
|
||||||
|
push:
|
||||||
|
branches: [main]
|
||||||
|
pull_request:
|
||||||
|
branches: [main]
|
||||||
|
|
||||||
|
jobs:
|
||||||
|
palette:
|
||||||
|
runs-on: ubuntu-latest
|
||||||
|
|
||||||
|
steps:
|
||||||
|
- uses: actions/checkout@v4
|
||||||
|
|
||||||
|
- uses: actions/setup-python@v5
|
||||||
|
with:
|
||||||
|
python-version: "3.x"
|
||||||
|
|
||||||
|
# Compares tokens.md (prose freeze), web_ui/src/tokens.css,
|
||||||
|
# design_system tokens.dart and gatelock's LockConfig. Fails on a hex
|
||||||
|
# that disagrees across stacks, and on a colour token that no stack's
|
||||||
|
# map accounts for.
|
||||||
|
- name: One palette across all four token sources
|
||||||
|
run: python3 unified-design-system/scripts/palette_check.py
|
||||||
|
|
||||||
|
- name: Categorical ramp still passes its constraints
|
||||||
|
run: python3 unified-design-system/scripts/ramp_check.py
|
||||||
|
|
||||||
|
# Spacing, radius, type, shadow and motion: palette_check.py parses
|
||||||
|
# hex only, so these scales were unguarded until structural_check.py.
|
||||||
|
- name: Structural scales agree across all token sources
|
||||||
|
run: python3 unified-design-system/scripts/structural_check.py
|
||||||
19
.github/workflows/repo-contract.yml
vendored
Normal file
19
.github/workflows/repo-contract.yml
vendored
Normal file
@ -0,0 +1,19 @@
|
|||||||
|
name: repo-contract
|
||||||
|
|
||||||
|
# utils owns the shared gate, so it runs its own copy directly (no shim, no
|
||||||
|
# second checkout). Other repos use repo_contract/templates/repo-contract.yml.
|
||||||
|
on:
|
||||||
|
push:
|
||||||
|
branches: [main]
|
||||||
|
pull_request:
|
||||||
|
workflow_dispatch:
|
||||||
|
|
||||||
|
jobs:
|
||||||
|
repo-contract:
|
||||||
|
name: repo contract
|
||||||
|
runs-on: ubuntu-latest
|
||||||
|
steps:
|
||||||
|
- uses: actions/checkout@v4
|
||||||
|
|
||||||
|
- name: Enforce the repo contract
|
||||||
|
run: bash scripts/check_repo_contract.sh
|
||||||
36
.github/workflows/rtdb-relay-dart-tests.yml
vendored
Normal file
36
.github/workflows/rtdb-relay-dart-tests.yml
vendored
Normal file
@ -0,0 +1,36 @@
|
|||||||
|
name: rtdb_relay dart tests
|
||||||
|
|
||||||
|
on:
|
||||||
|
push:
|
||||||
|
branches: [main]
|
||||||
|
paths: ['rtdb_relay/dart/**']
|
||||||
|
pull_request:
|
||||||
|
branches: [main]
|
||||||
|
paths: ['rtdb_relay/dart/**']
|
||||||
|
|
||||||
|
jobs:
|
||||||
|
test:
|
||||||
|
runs-on: ubuntu-latest
|
||||||
|
defaults:
|
||||||
|
run:
|
||||||
|
working-directory: rtdb_relay/dart
|
||||||
|
|
||||||
|
steps:
|
||||||
|
- uses: actions/checkout@v4
|
||||||
|
|
||||||
|
- name: Set up Flutter
|
||||||
|
uses: subosito/flutter-action@v2
|
||||||
|
with:
|
||||||
|
channel: stable
|
||||||
|
|
||||||
|
- name: Install dependencies
|
||||||
|
run: flutter pub get
|
||||||
|
|
||||||
|
- name: Analyze
|
||||||
|
run: flutter analyze
|
||||||
|
|
||||||
|
- name: Run tests with coverage
|
||||||
|
run: flutter test --coverage
|
||||||
|
|
||||||
|
- name: Enforce 100% line coverage
|
||||||
|
run: scripts/check_coverage.sh coverage/lcov.info 100
|
||||||
82
.github/workflows/shared-gates-tests.yml
vendored
Normal file
82
.github/workflows/shared-gates-tests.yml
vendored
Normal file
@ -0,0 +1,82 @@
|
|||||||
|
name: shared gate tests
|
||||||
|
|
||||||
|
# The gates in this repo are enforced in ~40 other repos, so a bug here is a
|
||||||
|
# bug everywhere at once. Until now `md_naming` had a test suite that no
|
||||||
|
# workflow ran; `dep_freshness` ships with one from day one.
|
||||||
|
#
|
||||||
|
# The dependency-freshness suite never touches the network -- every registry
|
||||||
|
# answer is a fixture, because the gate's worst failure mode (accepting a
|
||||||
|
# pre-release as "latest stable") fails GREEN and only a fixture can pin it.
|
||||||
|
|
||||||
|
on:
|
||||||
|
push:
|
||||||
|
branches: [main]
|
||||||
|
pull_request:
|
||||||
|
workflow_dispatch:
|
||||||
|
|
||||||
|
jobs:
|
||||||
|
shared-gate-tests:
|
||||||
|
name: gate unit tests
|
||||||
|
runs-on: ubuntu-latest
|
||||||
|
steps:
|
||||||
|
- uses: actions/checkout@v4
|
||||||
|
|
||||||
|
- name: Set up Python
|
||||||
|
uses: actions/setup-python@v5
|
||||||
|
with:
|
||||||
|
python-version: "3.x"
|
||||||
|
|
||||||
|
- name: Install test dependencies
|
||||||
|
run: python -m pip install --upgrade pytest pytest-cov pyyaml packaging
|
||||||
|
|
||||||
|
- name: dep_freshness — 100% branch coverage on the gate itself
|
||||||
|
run: |
|
||||||
|
PYTHONPATH=. python -m pytest dep_freshness/tests -q \
|
||||||
|
--cov=dep_freshness --cov-branch \
|
||||||
|
--cov-report=term-missing \
|
||||||
|
--cov-fail-under=99
|
||||||
|
|
||||||
|
- name: md_naming
|
||||||
|
run: PYTHONPATH=. python -m pytest md_naming/tests -q
|
||||||
|
|
||||||
|
# Whole package at 100% branch: the gate is enforced in every repo and
|
||||||
|
# now reads a per-repo `.file-length-exempt`, whose fail-closed rule is
|
||||||
|
# exactly the kind of branch a partial suite would leave green by accident.
|
||||||
|
- name: file_length — 100% branch coverage on the gate itself
|
||||||
|
run: |
|
||||||
|
PYTHONPATH=. python -m pytest file_length/tests -q \
|
||||||
|
--cov=file_length --cov-branch \
|
||||||
|
--cov-report=term-missing \
|
||||||
|
--cov-fail-under=100
|
||||||
|
|
||||||
|
- name: repo_contract — 100% branch coverage on the gate itself
|
||||||
|
run: |
|
||||||
|
PYTHONPATH=. python -m pytest repo_contract/tests -q \
|
||||||
|
--cov=repo_contract --cov-branch \
|
||||||
|
--cov-report=term-missing \
|
||||||
|
--cov-fail-under=100
|
||||||
|
|
||||||
|
# Every web repo's pre-commit and CI run this checker against its dist/,
|
||||||
|
# so a false green here ships an un-agent-ready site fleet-wide.
|
||||||
|
- name: agent_ready — 100% branch coverage on the checker
|
||||||
|
run: |
|
||||||
|
PYTHONPATH=. python -m pytest agent_ready/tests -q \
|
||||||
|
--cov=agent_ready --cov-branch \
|
||||||
|
--cov-report=term-missing \
|
||||||
|
--cov-fail-under=100
|
||||||
|
|
||||||
|
- name: coverage_gaps — 100% branch coverage on the lister
|
||||||
|
run: |
|
||||||
|
PYTHONPATH=. python -m pytest coverage_gaps/tests -q \
|
||||||
|
--cov=coverage_gaps --cov-branch \
|
||||||
|
--cov-report=term-missing \
|
||||||
|
--cov-fail-under=100
|
||||||
|
|
||||||
|
# gate_stamp.sh is the pre-push gate in every repo. Its tests drive real
|
||||||
|
# pre-commit in throwaway repos, and the hook-id helper runs under
|
||||||
|
# /usr/bin/python3 (the deployment interpreter), hence apt's PyYAML.
|
||||||
|
- name: gate_stamp (step / full --list)
|
||||||
|
run: |
|
||||||
|
sudo apt-get update -q && sudo apt-get install -y python3-yaml
|
||||||
|
python -m pip install --upgrade pre-commit
|
||||||
|
PYTHONPATH=. python -m pytest scripts/tests -q
|
||||||
73
.github/workflows/sickdays-precommit.yml
vendored
Normal file
73
.github/workflows/sickdays-precommit.yml
vendored
Normal file
@ -0,0 +1,73 @@
|
|||||||
|
name: sickdays pre-commit
|
||||||
|
|
||||||
|
on:
|
||||||
|
push:
|
||||||
|
branches: [main]
|
||||||
|
# The workflow's own file counts as sickdays: editing only this file would
|
||||||
|
# otherwise trigger nothing, so a fix to the job itself could never prove
|
||||||
|
# itself.
|
||||||
|
paths: ['sickdays/**', '.github/workflows/sickdays-precommit.yml']
|
||||||
|
pull_request:
|
||||||
|
branches: [main]
|
||||||
|
paths: ['sickdays/**', '.github/workflows/sickdays-precommit.yml']
|
||||||
|
|
||||||
|
jobs:
|
||||||
|
pre-commit:
|
||||||
|
runs-on: ubuntu-latest
|
||||||
|
steps:
|
||||||
|
- uses: actions/checkout@v4
|
||||||
|
- uses: actions/setup-python@v5
|
||||||
|
with:
|
||||||
|
python-version: "3.x"
|
||||||
|
# Only pre-commit itself. Every linting hook runs in its own isolated
|
||||||
|
# env -- ruff, mypy, pylint, bandit and codespell each come from their
|
||||||
|
# own repo+rev, and the local hooks need nothing beyond bash and
|
||||||
|
# python3 -- so installing the full requirements.txt spent 9s a run on
|
||||||
|
# packages no pre-commit-stage hook imports. Verified by running all
|
||||||
|
# three configs green in a venv holding pre-commit and nothing else.
|
||||||
|
# The pin is read out of requirements.txt rather than repeated here, so
|
||||||
|
# it cannot drift from what the dependency-freshness gate governs.
|
||||||
|
- name: Install pre-commit
|
||||||
|
run: |
|
||||||
|
pip install "$(grep '^pre-commit==' sickdays/requirements.txt)"
|
||||||
|
|
||||||
|
# Keyed on THIS package's config. pre-commit/action@v3.0.1 caches on
|
||||||
|
# hashFiles('.pre-commit-config.yaml') -- the repo ROOT's -- so all three
|
||||||
|
# package jobs shared one key, raced to overwrite it with hook sets built
|
||||||
|
# from four different configs, and editing a per-package config did not
|
||||||
|
# invalidate it. The cache was therefore silently wrong rather than
|
||||||
|
# missing, and the hooks reinstalled from scratch on every run (38-49s).
|
||||||
|
- uses: actions/cache@v4
|
||||||
|
with:
|
||||||
|
path: ~/.cache/pre-commit
|
||||||
|
key: >-
|
||||||
|
pre-commit-sickdays-${{ env.pythonLocation }}-${{
|
||||||
|
hashFiles('sickdays/.pre-commit-config.yaml') }}
|
||||||
|
# Prefix fallback, or this fix would evaporate on the very
|
||||||
|
# event that motivated it: bumping a hook rev changes the
|
||||||
|
# exact key, and a total miss means reinstalling every hook
|
||||||
|
# again. pre-commit's store is keyed internally by hook
|
||||||
|
# repo+rev, so a superseded entry is ignored disk rather
|
||||||
|
# than a wrong hook, and cache still re-saves under the new
|
||||||
|
# exact key after a prefix-only hit.
|
||||||
|
restore-keys: pre-commit-sickdays-${{ env.pythonLocation }}-
|
||||||
|
# mypy re-analyses the stdlib and every third-party stub from scratch
|
||||||
|
# without this, which measured 10s of the hook step in CI against 0.25s
|
||||||
|
# warm locally -- a 19MB cache dir does the whole difference. Keyed on
|
||||||
|
# the config, not the sources: mypy's own cache metadata records the
|
||||||
|
# interpreter, the flag set and a hash per source file, so it re-checks
|
||||||
|
# what changed and cannot pass stale code. Deliberately NOT keyed on
|
||||||
|
# github.sha -- that re-saves 19MB x3 every commit and would evict the
|
||||||
|
# 68MB hook caches under the repo's 10GB LRU budget. A fixed key keeps
|
||||||
|
# the expensive part, the dependency analysis, which is what costs 10s.
|
||||||
|
- uses: actions/cache@v4
|
||||||
|
with:
|
||||||
|
path: .mypy_cache
|
||||||
|
key: >-
|
||||||
|
mypy-sickdays-${{ env.pythonLocation }}-${{
|
||||||
|
hashFiles('sickdays/.pre-commit-config.yaml') }}
|
||||||
|
restore-keys: mypy-sickdays-${{ env.pythonLocation }}-
|
||||||
|
- name: Run the hooks
|
||||||
|
run: >-
|
||||||
|
pre-commit run --config sickdays/.pre-commit-config.yaml
|
||||||
|
--all-files --show-diff-on-failure
|
||||||
49
.github/workflows/sickdays-tests.yml
vendored
Normal file
49
.github/workflows/sickdays-tests.yml
vendored
Normal file
@ -0,0 +1,49 @@
|
|||||||
|
name: sickdays tests
|
||||||
|
|
||||||
|
on:
|
||||||
|
push:
|
||||||
|
branches: [main]
|
||||||
|
# The workflow's own file counts as sickdays: editing only this file would
|
||||||
|
# otherwise trigger nothing, so a fix to the job itself could never prove
|
||||||
|
# itself.
|
||||||
|
paths: ['sickdays/**', '.github/workflows/sickdays-tests.yml']
|
||||||
|
pull_request:
|
||||||
|
branches: [main]
|
||||||
|
paths: ['sickdays/**', '.github/workflows/sickdays-tests.yml']
|
||||||
|
|
||||||
|
jobs:
|
||||||
|
test:
|
||||||
|
runs-on: ubuntu-latest
|
||||||
|
defaults:
|
||||||
|
run:
|
||||||
|
working-directory: sickdays
|
||||||
|
steps:
|
||||||
|
- uses: actions/checkout@v4
|
||||||
|
|
||||||
|
- name: Set up Python
|
||||||
|
uses: actions/setup-python@v5
|
||||||
|
with:
|
||||||
|
python-version: "3.x"
|
||||||
|
cache: pip
|
||||||
|
cache-dependency-path: sickdays/requirements.txt
|
||||||
|
|
||||||
|
# crdt-sync and freedays are siblings in this repo, so they install from
|
||||||
|
# the checkout rather than from a tag -- CI must test what is on this
|
||||||
|
# branch, not what was last released. Deliberately NOT gatelock:
|
||||||
|
# importing it pulls in tkinter, and this job has no display precisely
|
||||||
|
# because sickdays must work without one.
|
||||||
|
- name: Install the sibling packages
|
||||||
|
run: pip install ../crdt-sync && pip install --no-deps ../freedays
|
||||||
|
|
||||||
|
- name: Install dependencies
|
||||||
|
run: pip install -r requirements.txt && pip install --no-deps -e .
|
||||||
|
|
||||||
|
# The library draws nothing, but sickdays.gui (0.3.0) does, and its
|
||||||
|
# tests drive real Tk: option names and Checkbutton/variable wiring are
|
||||||
|
# Tk's own behaviour. Headless they skip, taking coverage with them --
|
||||||
|
# so the runner gets a virtual display, as gatelock's does.
|
||||||
|
- name: Install a virtual X display
|
||||||
|
run: sudo apt-get update && sudo apt-get install -y xvfb
|
||||||
|
|
||||||
|
- name: Run tests with coverage
|
||||||
|
run: xvfb-run -a -s "-screen 0 1600x1200x24" python -m pytest -v
|
||||||
73
.github/workflows/sql-drills-precommit.yml
vendored
Normal file
73
.github/workflows/sql-drills-precommit.yml
vendored
Normal file
@ -0,0 +1,73 @@
|
|||||||
|
name: sql-drills pre-commit
|
||||||
|
|
||||||
|
on:
|
||||||
|
push:
|
||||||
|
branches: [main]
|
||||||
|
# The workflow's own file counts as sql_drills: editing only this file would
|
||||||
|
# otherwise trigger nothing, so a fix to the job itself could never prove
|
||||||
|
# itself.
|
||||||
|
paths: ['sql_drills/**', '.github/workflows/sql-drills-precommit.yml']
|
||||||
|
pull_request:
|
||||||
|
branches: [main]
|
||||||
|
paths: ['sql_drills/**', '.github/workflows/sql-drills-precommit.yml']
|
||||||
|
|
||||||
|
jobs:
|
||||||
|
pre-commit:
|
||||||
|
runs-on: ubuntu-latest
|
||||||
|
steps:
|
||||||
|
- uses: actions/checkout@v4
|
||||||
|
- uses: actions/setup-python@v5
|
||||||
|
with:
|
||||||
|
python-version: "3.x"
|
||||||
|
# Only pre-commit itself. Every linting hook runs in its own isolated
|
||||||
|
# env -- ruff, mypy, pylint, bandit and codespell each come from their
|
||||||
|
# own repo+rev, and the local hooks need nothing beyond bash and
|
||||||
|
# python3 -- so installing the full requirements.txt spent 9s a run on
|
||||||
|
# packages no pre-commit-stage hook imports. Verified by running all
|
||||||
|
# three configs green in a venv holding pre-commit and nothing else.
|
||||||
|
# The pin is read out of requirements.txt rather than repeated here, so
|
||||||
|
# it cannot drift from what the dependency-freshness gate governs.
|
||||||
|
- name: Install pre-commit
|
||||||
|
run: |
|
||||||
|
pip install "$(grep '^pre-commit==' sql_drills/requirements.txt)"
|
||||||
|
|
||||||
|
# Keyed on THIS package's config. pre-commit/action@v3.0.1 caches on
|
||||||
|
# hashFiles('.pre-commit-config.yaml') -- the repo ROOT's -- so all three
|
||||||
|
# package jobs shared one key, raced to overwrite it with hook sets built
|
||||||
|
# from four different configs, and editing a per-package config did not
|
||||||
|
# invalidate it. The cache was therefore silently wrong rather than
|
||||||
|
# missing, and the hooks reinstalled from scratch on every run (38-49s).
|
||||||
|
- uses: actions/cache@v4
|
||||||
|
with:
|
||||||
|
path: ~/.cache/pre-commit
|
||||||
|
key: >-
|
||||||
|
pre-commit-sql-drills-${{ env.pythonLocation }}-${{
|
||||||
|
hashFiles('sql_drills/.pre-commit-config.yaml') }}
|
||||||
|
# Prefix fallback, or this fix would evaporate on the very
|
||||||
|
# event that motivated it: bumping a hook rev changes the
|
||||||
|
# exact key, and a total miss means reinstalling every hook
|
||||||
|
# again. pre-commit's store is keyed internally by hook
|
||||||
|
# repo+rev, so a superseded entry is ignored disk rather
|
||||||
|
# than a wrong hook, and cache still re-saves under the new
|
||||||
|
# exact key after a prefix-only hit.
|
||||||
|
restore-keys: pre-commit-sql-drills-${{ env.pythonLocation }}-
|
||||||
|
# mypy re-analyses the stdlib and every third-party stub from scratch
|
||||||
|
# without this, which measured 10s of the hook step in CI against 0.25s
|
||||||
|
# warm locally -- a 19MB cache dir does the whole difference. Keyed on
|
||||||
|
# the config, not the sources: mypy's own cache metadata records the
|
||||||
|
# interpreter, the flag set and a hash per source file, so it re-checks
|
||||||
|
# what changed and cannot pass stale code. Deliberately NOT keyed on
|
||||||
|
# github.sha -- that re-saves 19MB x3 every commit and would evict the
|
||||||
|
# 68MB hook caches under the repo's 10GB LRU budget. A fixed key keeps
|
||||||
|
# the expensive part, the dependency analysis, which is what costs 10s.
|
||||||
|
- uses: actions/cache@v4
|
||||||
|
with:
|
||||||
|
path: .mypy_cache
|
||||||
|
key: >-
|
||||||
|
mypy-sql-drills-${{ env.pythonLocation }}-${{
|
||||||
|
hashFiles('sql_drills/.pre-commit-config.yaml') }}
|
||||||
|
restore-keys: mypy-sql-drills-${{ env.pythonLocation }}-
|
||||||
|
- name: Run the hooks
|
||||||
|
run: >-
|
||||||
|
pre-commit run --config sql_drills/.pre-commit-config.yaml
|
||||||
|
--all-files --show-diff-on-failure
|
||||||
34
.github/workflows/sql-drills-tests.yml
vendored
Normal file
34
.github/workflows/sql-drills-tests.yml
vendored
Normal file
@ -0,0 +1,34 @@
|
|||||||
|
name: sql-drills tests
|
||||||
|
|
||||||
|
on:
|
||||||
|
push:
|
||||||
|
branches: [main]
|
||||||
|
# The workflow's own file counts as sql_drills: editing only this file would
|
||||||
|
# otherwise trigger nothing, so a fix to the job itself could never prove
|
||||||
|
# itself.
|
||||||
|
paths: ['sql_drills/**', '.github/workflows/sql-drills-tests.yml']
|
||||||
|
pull_request:
|
||||||
|
branches: [main]
|
||||||
|
paths: ['sql_drills/**', '.github/workflows/sql-drills-tests.yml']
|
||||||
|
|
||||||
|
jobs:
|
||||||
|
test:
|
||||||
|
runs-on: ubuntu-latest
|
||||||
|
defaults:
|
||||||
|
run:
|
||||||
|
working-directory: sql_drills
|
||||||
|
steps:
|
||||||
|
- uses: actions/checkout@v4
|
||||||
|
|
||||||
|
- name: Set up Python
|
||||||
|
uses: actions/setup-python@v5
|
||||||
|
with:
|
||||||
|
python-version: "3.x"
|
||||||
|
cache: pip
|
||||||
|
cache-dependency-path: sql_drills/requirements.txt
|
||||||
|
|
||||||
|
- name: Install dependencies
|
||||||
|
run: pip install -r requirements.txt && pip install --no-deps -e .
|
||||||
|
|
||||||
|
- name: Run tests with coverage
|
||||||
|
run: python -m pytest -v
|
||||||
36
.github/workflows/sync-settings-ui-tests.yml
vendored
Normal file
36
.github/workflows/sync-settings-ui-tests.yml
vendored
Normal file
@ -0,0 +1,36 @@
|
|||||||
|
name: sync_settings_ui tests
|
||||||
|
|
||||||
|
on:
|
||||||
|
push:
|
||||||
|
branches: [main]
|
||||||
|
paths: ['sync_settings_ui/**']
|
||||||
|
pull_request:
|
||||||
|
branches: [main]
|
||||||
|
paths: ['sync_settings_ui/**']
|
||||||
|
|
||||||
|
jobs:
|
||||||
|
test:
|
||||||
|
runs-on: ubuntu-latest
|
||||||
|
defaults:
|
||||||
|
run:
|
||||||
|
working-directory: sync_settings_ui
|
||||||
|
|
||||||
|
steps:
|
||||||
|
- uses: actions/checkout@v4
|
||||||
|
|
||||||
|
- name: Set up Flutter
|
||||||
|
uses: subosito/flutter-action@v2
|
||||||
|
with:
|
||||||
|
channel: stable
|
||||||
|
|
||||||
|
- name: Install dependencies
|
||||||
|
run: flutter pub get
|
||||||
|
|
||||||
|
- name: Analyze
|
||||||
|
run: flutter analyze
|
||||||
|
|
||||||
|
- name: Run tests with coverage
|
||||||
|
run: flutter test --coverage
|
||||||
|
|
||||||
|
- name: Enforce 100% line coverage
|
||||||
|
run: scripts/check_coverage.sh coverage/lcov.info 100
|
||||||
37
.github/workflows/ts-config-tests.yml
vendored
Normal file
37
.github/workflows/ts-config-tests.yml
vendored
Normal file
@ -0,0 +1,37 @@
|
|||||||
|
name: ts_config tests
|
||||||
|
|
||||||
|
on:
|
||||||
|
push:
|
||||||
|
branches: [main]
|
||||||
|
paths: ['ts_config/**']
|
||||||
|
pull_request:
|
||||||
|
branches: [main]
|
||||||
|
paths: ['ts_config/**']
|
||||||
|
workflow_dispatch:
|
||||||
|
|
||||||
|
jobs:
|
||||||
|
test:
|
||||||
|
runs-on: ubuntu-latest
|
||||||
|
defaults:
|
||||||
|
run:
|
||||||
|
working-directory: ts_config
|
||||||
|
|
||||||
|
steps:
|
||||||
|
- uses: actions/checkout@v4
|
||||||
|
|
||||||
|
- uses: pnpm/action-setup@v4
|
||||||
|
with:
|
||||||
|
version: 12
|
||||||
|
|
||||||
|
- uses: actions/setup-node@v4
|
||||||
|
with:
|
||||||
|
node-version: "26.13.1"
|
||||||
|
|
||||||
|
- name: Install dependencies
|
||||||
|
run: pnpm install --frozen-lockfile
|
||||||
|
|
||||||
|
- name: Lint (the preset lints itself)
|
||||||
|
run: pnpm lint
|
||||||
|
|
||||||
|
- name: Fixture + factory tests with the 100% coverage gate
|
||||||
|
run: pnpm coverage
|
||||||
57
.github/workflows/ts-core-tests.yml
vendored
Normal file
57
.github/workflows/ts-core-tests.yml
vendored
Normal file
@ -0,0 +1,57 @@
|
|||||||
|
name: ts_core tests
|
||||||
|
|
||||||
|
on:
|
||||||
|
push:
|
||||||
|
branches: [main]
|
||||||
|
paths: ['ts_core/**', 'ts_config/**']
|
||||||
|
pull_request:
|
||||||
|
branches: [main]
|
||||||
|
paths: ['ts_core/**', 'ts_config/**']
|
||||||
|
workflow_dispatch:
|
||||||
|
|
||||||
|
jobs:
|
||||||
|
test:
|
||||||
|
runs-on: ubuntu-latest
|
||||||
|
defaults:
|
||||||
|
run:
|
||||||
|
working-directory: ts_core
|
||||||
|
|
||||||
|
steps:
|
||||||
|
- uses: actions/checkout@v4
|
||||||
|
|
||||||
|
- uses: pnpm/action-setup@v4
|
||||||
|
with:
|
||||||
|
version: 12
|
||||||
|
|
||||||
|
- uses: actions/setup-node@v4
|
||||||
|
with:
|
||||||
|
node-version: "26.13.1"
|
||||||
|
|
||||||
|
# The preset is a `link:../ts_config` dependency. pnpm links the
|
||||||
|
# directory but installs nothing inside it, and a flat config imports
|
||||||
|
# its plugins from the preset's own node_modules -- so without this
|
||||||
|
# step the lint dies on "Cannot find package '@eslint/js'".
|
||||||
|
- name: Install the shared lint preset's dependencies
|
||||||
|
run: pnpm install --frozen-lockfile
|
||||||
|
working-directory: ts_config
|
||||||
|
|
||||||
|
- name: Install dependencies
|
||||||
|
run: pnpm install --frozen-lockfile
|
||||||
|
|
||||||
|
- name: Lint
|
||||||
|
run: pnpm lint
|
||||||
|
|
||||||
|
- name: Run tests with the 100% coverage gate
|
||||||
|
run: pnpm coverage
|
||||||
|
|
||||||
|
# The tag ships a prebuilt dist/ because Vite does not transpile
|
||||||
|
# dependencies. A committed dist/ that does not match src/ would ship
|
||||||
|
# stale code to every consumer with no error anywhere, so rebuild and
|
||||||
|
# fail if the result differs from what is checked in.
|
||||||
|
- name: dist/ is in sync with src/
|
||||||
|
run: |
|
||||||
|
pnpm build
|
||||||
|
if ! git diff --exit-code -- dist; then
|
||||||
|
echo "::error::dist/ is stale — run 'pnpm build' in ts_core and commit the result."
|
||||||
|
exit 1
|
||||||
|
fi
|
||||||
61
.github/workflows/web-ui-tests.yml
vendored
Normal file
61
.github/workflows/web-ui-tests.yml
vendored
Normal file
@ -0,0 +1,61 @@
|
|||||||
|
name: web_ui tests
|
||||||
|
|
||||||
|
on:
|
||||||
|
push:
|
||||||
|
branches: [main]
|
||||||
|
paths: ['web_ui/**', 'ts_config/**']
|
||||||
|
pull_request:
|
||||||
|
branches: [main]
|
||||||
|
paths: ['web_ui/**', 'ts_config/**']
|
||||||
|
workflow_dispatch:
|
||||||
|
|
||||||
|
jobs:
|
||||||
|
test:
|
||||||
|
runs-on: ubuntu-latest
|
||||||
|
defaults:
|
||||||
|
run:
|
||||||
|
working-directory: web_ui
|
||||||
|
|
||||||
|
steps:
|
||||||
|
- uses: actions/checkout@v4
|
||||||
|
|
||||||
|
- uses: pnpm/action-setup@v4
|
||||||
|
with:
|
||||||
|
version: 12
|
||||||
|
|
||||||
|
- uses: actions/setup-node@v4
|
||||||
|
with:
|
||||||
|
node-version: "26.13.1"
|
||||||
|
|
||||||
|
# The preset is a `link:../ts_config` dependency. pnpm links the
|
||||||
|
# directory but installs nothing inside it, and a flat config imports
|
||||||
|
# its plugins from the preset's own node_modules -- so without this
|
||||||
|
# step the lint dies on "Cannot find package '@eslint/js'".
|
||||||
|
- name: Install the shared lint preset's dependencies
|
||||||
|
run: pnpm install --frozen-lockfile
|
||||||
|
working-directory: ts_config
|
||||||
|
|
||||||
|
- name: Install dependencies
|
||||||
|
run: pnpm install --frozen-lockfile
|
||||||
|
|
||||||
|
- name: Lint
|
||||||
|
run: pnpm lint
|
||||||
|
|
||||||
|
- name: Run tests with the 100% coverage gate
|
||||||
|
run: pnpm coverage
|
||||||
|
|
||||||
|
# The tag ships a prebuilt dist/ because Vite does not transpile
|
||||||
|
# dependencies. A committed dist/ that does not match src/ would ship
|
||||||
|
# stale code to every consumer with no error anywhere, so rebuild and
|
||||||
|
# fail if the result differs from what is checked in.
|
||||||
|
- name: dist/ is in sync with src/
|
||||||
|
run: |
|
||||||
|
pnpm build
|
||||||
|
if ! git diff --exit-code -- dist; then
|
||||||
|
echo "::error::dist/ is stale — run 'pnpm build' in web_ui and commit the result."
|
||||||
|
exit 1
|
||||||
|
fi
|
||||||
|
|
||||||
|
- name: Categorical ramp still passes its constraints
|
||||||
|
working-directory: .
|
||||||
|
run: python3 unified-design-system/scripts/ramp_check.py
|
||||||
25
.gitignore
vendored
Normal file
25
.gitignore
vendored
Normal file
@ -0,0 +1,25 @@
|
|||||||
|
# Python build/test artifacts, across every subproject in this monorepo.
|
||||||
|
__pycache__/
|
||||||
|
*.py[cod]
|
||||||
|
*.egg-info/
|
||||||
|
build/
|
||||||
|
dist/
|
||||||
|
.venv/
|
||||||
|
.mypy_cache/
|
||||||
|
.ruff_cache/
|
||||||
|
.pytest_cache/
|
||||||
|
|
||||||
|
# Coverage output. Each subproject writes these next to its own pyproject.toml,
|
||||||
|
# and a run from the repo root drops a pair here too.
|
||||||
|
.coverage
|
||||||
|
.coverage.*
|
||||||
|
coverage.lcov
|
||||||
|
htmlcov/
|
||||||
|
|
||||||
|
# Firebase CLI debug exhaust. Written next to whichever directory the CLI was
|
||||||
|
# invoked from (crdt-sync/ in practice), regenerated on every failed command,
|
||||||
|
# and never worth committing.
|
||||||
|
firebase-debug.log
|
||||||
|
firebase-debug.*.log
|
||||||
|
firestore-debug.log
|
||||||
|
database-debug.log
|
||||||
84
.pre-commit-config.yaml
Normal file
84
.pre-commit-config.yaml
Normal file
@ -0,0 +1,84 @@
|
|||||||
|
# Repo-wide gate for the shared 250-line file cap (refactor_claude_todo.md).
|
||||||
|
#
|
||||||
|
# A file that cannot be read in one piece forces re-reads and partial edits,
|
||||||
|
# which is the largest avoidable cost in an LLM-assisted workflow. A refactor
|
||||||
|
# without a gate silently regrows, so this is the part that makes it stick.
|
||||||
|
#
|
||||||
|
# Checks only the files in the commit, so an unrelated commit never breaks on
|
||||||
|
# a violation it did not introduce, and it FAILS (exit 1) rather than warning.
|
||||||
|
# No baseline and no allowlist -- those are suppressions.
|
||||||
|
#
|
||||||
|
# The subprojects (gatelock/, crdt-sync/, web_ui/, design_system/,
|
||||||
|
# sync_settings_ui/) each keep their own .pre-commit-config.yaml for their own
|
||||||
|
# linters, and carry this same hook so committing with one of those configs is
|
||||||
|
# gated too. This root config is what `pre-commit install` wires up, and it is
|
||||||
|
# the only one that covers the subprojects without a config of their own
|
||||||
|
# (guard-lib/, crdt_sync_dart/, file_length/, ...).
|
||||||
|
#
|
||||||
|
# The path is repo-relative on purpose. pre-commit always runs hooks from the
|
||||||
|
# git root, so this resolves the same locally and on a CI runner -- an absolute
|
||||||
|
# /home/... path exits 127 in Actions, which is how this was first written.
|
||||||
|
repos:
|
||||||
|
- repo: local
|
||||||
|
hooks:
|
||||||
|
- id: file-length-cap
|
||||||
|
name: file length <= 250 lines
|
||||||
|
entry: bash scripts/check_file_length.sh
|
||||||
|
language: system
|
||||||
|
pass_filenames: true
|
||||||
|
|
||||||
|
# Three markdown namespaces (README / CLAUDE* / DOCS*); TODO*.md is banned
|
||||||
|
# (tasks live in the todo app).
|
||||||
|
# Shared gate in ~/src/utils owns the namespaces and the exemption list, so
|
||||||
|
# one repo's idea of a valid name cannot drift from every other repo's.
|
||||||
|
# Since the 2026-09-11 reorganisation ~ holds eleven visible entries and
|
||||||
|
# home-tidy sweeps anything else to inbox/ within the hour. The migration's
|
||||||
|
# rewriter matched *literal* /home/kuhy/<name> strings, so paths assembled
|
||||||
|
# at run time survived it -- the todo wrapper exported to a dead ~/todo for
|
||||||
|
# a day while its MCP read ~/src/todo. This gate matches the shape, so it
|
||||||
|
# stays correct as repos come and go.
|
||||||
|
- id: home-path-layout
|
||||||
|
name: home-relative paths stay inside the ~ layout
|
||||||
|
entry: bash scripts/check_home_paths.sh
|
||||||
|
language: system
|
||||||
|
pass_filenames: true
|
||||||
|
|
||||||
|
- id: repo-contract
|
||||||
|
name: repo contract (CLAUDE.md Commands + test_changed)
|
||||||
|
entry: scripts/check_repo_contract.sh
|
||||||
|
language: system
|
||||||
|
pass_filenames: false
|
||||||
|
files: ^(CLAUDE\.md|AGENTS\.md|scripts/test_changed\.sh)$|(^|/)(AndroidManifest\.xml|build\.gradle(\.kts)?|strings\.xml|pubspec\.yaml|repo-contract\.toml|[^/]+\.desktop|assets/icon/[^/]+\.png)$
|
||||||
|
|
||||||
|
- id: md-naming
|
||||||
|
name: markdown naming convention
|
||||||
|
entry: scripts/check_md_naming.sh
|
||||||
|
language: system
|
||||||
|
files: \.(md|markdown)$
|
||||||
|
|
||||||
|
# Every dependency on its ecosystem's newest STABLE release, exact-pinned
|
||||||
|
# so the question is mechanically answerable at all.
|
||||||
|
#
|
||||||
|
# `files:` is what keeps this cheap: a commit touching only source makes
|
||||||
|
# ZERO network requests, and manifest commits mostly hit a 6h disk cache.
|
||||||
|
#
|
||||||
|
# Runs WITHOUT --strict on purpose. Offline it degrades to the cached
|
||||||
|
# answer and passes with a loud banner; `--no-verify` is banned here, so
|
||||||
|
# a hook that hard-failed on a flaky connection would leave no way to
|
||||||
|
# commit at all. CI, always online, is the strict authority.
|
||||||
|
#
|
||||||
|
# Scoped to manifests this branch changed (vs merge-base with main), so
|
||||||
|
# `--all-files` asks "did THIS change leave a stale pin?" and not "is
|
||||||
|
# every project in the monorepo current?". CI `--all --strict` keeps
|
||||||
|
# the repo-wide answer. See scripts/dep_freshness_changed.sh.
|
||||||
|
- id: dependency-freshness
|
||||||
|
name: dependencies on newest stable
|
||||||
|
entry: bash scripts/dep_freshness_changed.sh
|
||||||
|
language: system
|
||||||
|
pass_filenames: true
|
||||||
|
files: >-
|
||||||
|
(pubspec\.(yaml|lock)|pyproject\.toml|requirements.*\.txt|uv\.lock
|
||||||
|
|package\.json|package-lock\.json|pnpm-lock\.yaml
|
||||||
|
|Cargo\.(toml|lock)|go\.(mod|sum)
|
||||||
|
|\.fvmrc|\.nvmrc|\.python-version
|
||||||
|
|\.github/workflows/.*\.ya?ml)$
|
||||||
27
.pre-commit-hooks.yaml
Normal file
27
.pre-commit-hooks.yaml
Normal file
@ -0,0 +1,27 @@
|
|||||||
|
# Hooks other repos consume with `repo: https://github.com/kuhyx/utils`.
|
||||||
|
# All three are post-* stages, so each clone must install them (see
|
||||||
|
# todo_hooks/README.md). They never fail a git operation: the work has
|
||||||
|
# already happened, so server/gh trouble prints one warning and exits 0.
|
||||||
|
- id: todo-closer
|
||||||
|
name: close Todo trailer tasks
|
||||||
|
entry: scripts/todo_hooks.sh closer
|
||||||
|
language: script
|
||||||
|
stages: [post-commit]
|
||||||
|
always_run: true
|
||||||
|
pass_filenames: false
|
||||||
|
|
||||||
|
- id: todo-import-pr-merge
|
||||||
|
name: import PR Todo sections (pull)
|
||||||
|
entry: scripts/todo_hooks.sh import-pr post-merge
|
||||||
|
language: script
|
||||||
|
stages: [post-merge]
|
||||||
|
always_run: true
|
||||||
|
pass_filenames: false
|
||||||
|
|
||||||
|
- id: todo-import-pr-rewrite
|
||||||
|
name: import PR Todo sections (pull --rebase)
|
||||||
|
entry: scripts/todo_hooks.sh import-pr post-rewrite
|
||||||
|
language: script
|
||||||
|
stages: [post-rewrite]
|
||||||
|
always_run: true
|
||||||
|
pass_filenames: false
|
||||||
20
CLAUDE.md
Normal file
20
CLAUDE.md
Normal file
@ -0,0 +1,20 @@
|
|||||||
|
# utils
|
||||||
|
|
||||||
|
Monorepo of shared gates and libraries (app_errors, dep_freshness, file_length, md_naming,
|
||||||
|
repo_contract, coverage_gaps, crdt-sync, gatelock, freedays, sickdays, earned_time, music_theory, game_recording,
|
||||||
|
flutter_web_drive (headless Flutter-web E2E driver + MCP), ...).
|
||||||
|
`godot_dev_tools/` is a Godot addon (GDScript): `godot_dev_tools/test.sh` runs its GUT tests.
|
||||||
|
Python packages with a root-level `<pkg>/tests` run with `PYTHONPATH=.`;
|
||||||
|
subprojects with their own `pyproject.toml` run via `scripts/run_subproject_tests.sh <dir>`.
|
||||||
|
`scripts/check_repo_contract.sh` is the REAL shared gate (not a shim): never
|
||||||
|
overwrite it with `repo_contract/templates/check_repo_contract.shim.sh`.
|
||||||
|
|
||||||
|
## Commands
|
||||||
|
|
||||||
|
- run: n/a: collection of gates and libraries, no single entry point
|
||||||
|
- test: `PYTHONPATH=. python -m pytest -q agent_ready/tests coverage_gaps/tests dep_freshness/tests file_length/tests flutter_web_drive/tests home_paths/tests md_naming/tests repo_contract/tests scripts/tests unified-design-system/tests`
|
||||||
|
- test-changed: `scripts/test_changed.sh`
|
||||||
|
- lint: `ruff check agent_ready coverage_gaps flutter_web_drive repo_contract`
|
||||||
|
- coverage: `PYTHONPATH=. python -m pytest -q agent_ready/tests flutter_web_drive/tests repo_contract/tests unified-design-system/tests --cov=agent_ready --cov=flutter_web_drive --cov=repo_contract --cov=conformance --cov=conformance_diff --cov-branch --cov-report=xml --cov-fail-under=100`
|
||||||
|
- coverage-gaps: `coverage-gaps coverage.xml`
|
||||||
|
- deploy: `git -C ~/src/utils pull --ff-only && ~/src/utils/scripts/deploy.sh` (installs the sickdays CLI + launcher from the live checkout, then exits 1 unless every released library's version tag is on origin and matches HEAD and the live `sickdays` runs the text-free checkout; `--verify-only` for the health check alone)
|
||||||
61
DOCS-app-errors.md
Normal file
61
DOCS-app-errors.md
Normal file
@ -0,0 +1,61 @@
|
|||||||
|
# App errors and slow waits become board tickets
|
||||||
|
|
||||||
|
kuhy's rule (2026-11-17): every error, and every wait the user sees over 1 s, in
|
||||||
|
any of his apps is reported automatically. The board then turns each one into a
|
||||||
|
ticket that fixes itself. This doc covers the apps' half and the PC ingest. The
|
||||||
|
board's half is todoImplementer `DOCS-errors.md`, with the contract in
|
||||||
|
`contracts/app-error.schema.json`. The design is kartka's pipeline
|
||||||
|
(`~/src/kartka`, `docs/DOCS-error-reports.md`), made shared.
|
||||||
|
|
||||||
|
## Pipeline
|
||||||
|
|
||||||
|
1. **Apps report.** Each report is one *entry* (see `app_errors/README.md`):
|
||||||
|
- Flutter, `crdt_sync_flutter` 0.9.0: `installAppErrors` hooks
|
||||||
|
`FlutterError.onError` and `PlatformDispatcher.onError`. `WaitWatch` turns
|
||||||
|
a spinner shown over 1 s into `perf.slow`. The device deduplicates (30 s,
|
||||||
|
20 a minute) and redacts each report, and queues it in
|
||||||
|
`SharedPreferences`. It uploads to RTDB `/<app>/errors/<device>/<id>` with
|
||||||
|
the build (versionCode).
|
||||||
|
- Python/Tk, `gatelock` 0.15.0: `gatelock.error_report.install` hooks
|
||||||
|
`sys.excepthook`, `threading.excepthook` and Tk callback errors.
|
||||||
|
`watch_stalls(root, rep)` reports a frozen Tk loop over 1 s.
|
||||||
|
`rep.wait(...)` and `rep.begin(...)` time a wait.
|
||||||
|
- Godot, `godot_dev_tools` 0.2.0, `addons/app_errors`: an `OS.add_logger`
|
||||||
|
logger catches script errors and `push_error`. A frame over 1 s, or
|
||||||
|
`report_wait` over 1 s, becomes `perf.slow`. Headless runs and
|
||||||
|
`APP_ERRORS_OFF=1` write nothing, so a game's own test gates file no
|
||||||
|
tickets.
|
||||||
|
- PC apps (Tk and Godot) append to the local spool
|
||||||
|
`~/.local/state/app-errors-spool/<app>.jsonl`. They need no RTDB, because
|
||||||
|
the ingest runs on the same PC.
|
||||||
|
2. **The PC ingests.** `app-errors-ingest.timer` runs `app-errors ingest` every
|
||||||
|
5 min. It reads RTDB through an already seeded crdt-sync session
|
||||||
|
(`firebase_backup`) and reads the spool. It merges reports by signature
|
||||||
|
(Dart signatures are kartka-identical), deletes what it read, and writes
|
||||||
|
`~/.local/state/app-errors/<app>.json` as a contract `report`.
|
||||||
|
3. **The board files tickets.** It scans that folder every 60 s and makes one
|
||||||
|
ticket per `app:signature` (todoImplementer `DOCS-errors.md`).
|
||||||
|
|
||||||
|
`app-errors resolve <app> <signature>` sets `open: false`. A later report opens
|
||||||
|
the error again only when it is a regression: a newer build when both sides
|
||||||
|
know the build, else a report made after the resolve. The board never calls
|
||||||
|
`resolve` on its own, because folder sources have no resolve hook. It tracks
|
||||||
|
shipped fixes by `fixed_build`.
|
||||||
|
|
||||||
|
## Choices made (no questions asked, per the brief)
|
||||||
|
|
||||||
|
- kartka moved over on 2026-11-17: the shared ingest reads `/kartka` too
|
||||||
|
(it parses kartka's older entry shape: `sourceId`, per-entry `build`),
|
||||||
|
the board's `error_sources` is `[]` and `kartka-errors.timer` is retired.
|
||||||
|
Ticket ids stayed the same: all 134 stored kartka signatures recompute
|
||||||
|
identically.
|
||||||
|
- Tk and Godot use the local spool instead of RTDB: they only run on the PC.
|
||||||
|
- The Godot reporter is its own addon folder, mounted in every build. It is
|
||||||
|
not part of `dev_tools`, which only loads for `--dev` runs.
|
||||||
|
- Reporting is silent: no text, dialog or notification in any app.
|
||||||
|
|
||||||
|
## Install and check
|
||||||
|
|
||||||
|
`scripts/deploy.sh` runs `app_errors/install.sh`. That installs the venv and
|
||||||
|
`~/.local/bin/app-errors`, enables the timer, and checks that the timer is
|
||||||
|
active and the venv imports the live checkout.
|
||||||
110
README.md
110
README.md
@ -18,10 +18,45 @@ dependencies:
|
|||||||
crdt_sync:
|
crdt_sync:
|
||||||
git:
|
git:
|
||||||
url: https://github.com/kuhyx/utils
|
url: https://github.com/kuhyx/utils
|
||||||
ref: crdt_sync_dart-v0.2.0
|
ref: crdt_sync_dart-v0.10.0
|
||||||
path: crdt_sync_dart
|
path: crdt_sync_dart
|
||||||
```
|
```
|
||||||
|
|
||||||
|
## sync_settings_ui/
|
||||||
|
|
||||||
|
Shared Flutter "Sync settings" screen (pub package name: `sync_settings_ui`,
|
||||||
|
not published to pub.dev). Firebase sync (primary) plus an optional local
|
||||||
|
backup slot — no GitHub mirror UI. Pure UI + a `FirebaseSyncController`
|
||||||
|
service layer over injected closures (keystore/Google-plugin access stays
|
||||||
|
in each consuming app, exactly as before this package existed). Consumed by
|
||||||
|
`todo`, `diet_guard_app`, `workout_app`, `wake_alarm/phone_app`, and
|
||||||
|
`home_inventory`'s dedicated "Sync settings" route.
|
||||||
|
|
||||||
|
Consume via:
|
||||||
|
```yaml
|
||||||
|
dependencies:
|
||||||
|
sync_settings_ui:
|
||||||
|
git:
|
||||||
|
url: https://github.com/kuhyx/utils
|
||||||
|
ref: sync_settings_ui-v0.1.0
|
||||||
|
path: sync_settings_ui
|
||||||
|
```
|
||||||
|
|
||||||
|
## google_account_token/
|
||||||
|
|
||||||
|
Flutter plugin (Android only; other platforms return null): one-tap Google ID
|
||||||
|
token via `AccountManager`, replacing `google_sign_in` in the sync apps.
|
||||||
|
|
||||||
|
Consume via:
|
||||||
|
```yaml
|
||||||
|
dependencies:
|
||||||
|
google_account_token:
|
||||||
|
git:
|
||||||
|
url: https://github.com/kuhyx/utils
|
||||||
|
ref: google_account_token-v0.1.0
|
||||||
|
path: google_account_token
|
||||||
|
```
|
||||||
|
|
||||||
## crdt-sync/
|
## crdt-sync/
|
||||||
|
|
||||||
Python CRDT sync library (package: `crdt_sync`, not published to PyPI). Same
|
Python CRDT sync library (package: `crdt_sync`, not published to PyPI). Same
|
||||||
@ -42,6 +77,13 @@ watcher + pacman hooks). Not a package — installed by running
|
|||||||
Consumed by `steam-backlog-enforcer` (expects a `guard-lib/install.sh`
|
Consumed by `steam-backlog-enforcer` (expects a `guard-lib/install.sh`
|
||||||
sibling clone) and referenced by `screen-locker`.
|
sibling clone) and referenced by `screen-locker`.
|
||||||
|
|
||||||
|
## app_errors/
|
||||||
|
|
||||||
|
The PC ingest of the shared app error and slow-wait reporting: RTDB and local
|
||||||
|
spool reports in, todoImplementer board tickets out, on a systemd `--user`
|
||||||
|
timer. The reporters live in `crdt_sync_flutter`, `gatelock` and
|
||||||
|
`godot_dev_tools/addons/app_errors`. See [`DOCS-app-errors.md`](DOCS-app-errors.md).
|
||||||
|
|
||||||
## gatelock/
|
## gatelock/
|
||||||
|
|
||||||
Python lock-window + HMAC log-integrity backend (package: `gatelock`, not
|
Python lock-window + HMAC log-integrity backend (package: `gatelock`, not
|
||||||
@ -51,3 +93,69 @@ published to PyPI). Consumed via pip by `screen-locker`, `diet-guard`, and
|
|||||||
```
|
```
|
||||||
gatelock @ git+https://github.com/kuhyx/utils@gatelock-v0.1.0#subdirectory=gatelock
|
gatelock @ git+https://github.com/kuhyx/utils@gatelock-v0.1.0#subdirectory=gatelock
|
||||||
```
|
```
|
||||||
|
|
||||||
|
## music_theory/
|
||||||
|
|
||||||
|
Music theory from first principles as typed Python (package: `music_theory`,
|
||||||
|
not published to PyPI): pitch, tuning, scales, chords, progressions, a numpy
|
||||||
|
synth and a `Recipe` → WAV composer with a `degrade` transform. Follows Luke
|
||||||
|
Haas's "Music Theory for Programmers" section by section; `python -m
|
||||||
|
music_theory demo all --out DIR` renders one WAV per section. Consumed by
|
||||||
|
`roadside-assistance` for its three world-state music beds.
|
||||||
|
|
||||||
|
Consume via:
|
||||||
|
```
|
||||||
|
music_theory @ git+https://github.com/kuhyx/utils@music-theory-v0.1.0#subdirectory=music_theory
|
||||||
|
```
|
||||||
|
|
||||||
|
## game_recording/
|
||||||
|
|
||||||
|
Session recorder for a game (package: `game_recording`, stdlib only, not
|
||||||
|
published to PyPI): records a dev run from outside the game and stamps its
|
||||||
|
telemetry moments onto the video. A game configures it with one `Config`.
|
||||||
|
|
||||||
|
Consume via:
|
||||||
|
```
|
||||||
|
game_recording @ git+https://github.com/kuhyx/utils@game-recording-v0.1.0#subdirectory=game_recording
|
||||||
|
```
|
||||||
|
|
||||||
|
## unified-design-system/
|
||||||
|
|
||||||
|
Not a package — the frozen design tokens (colors, spacing, type, radius,
|
||||||
|
shadow policy) and per-stack (Flutter/web/Tkinter) implementation patterns
|
||||||
|
that keep every one of kuhy's repos visually identical, plus annotated
|
||||||
|
component references (`components.html`, `button.html`). Read
|
||||||
|
[`unified-design-system/README.md`](unified-design-system/README.md) and
|
||||||
|
`DOCS-tokens.md` before touching any theme/CSS/style file in any repo. The
|
||||||
|
`unified-design-system` Claude Code skill is a thin pointer here, not a
|
||||||
|
duplicate.
|
||||||
|
|
||||||
|
## ts_config/
|
||||||
|
|
||||||
|
`@kuhyx/ts-config` — the one lint / TypeScript bar every kuhyx TypeScript
|
||||||
|
repo extends (pnpm only, like `ts_core` and `web_ui`). A strict
|
||||||
|
`tsconfig.base.json`, ESLint flat-config presets (`defineConfig()` stacking
|
||||||
|
base / react / vitest / playwright / layer `boundaries()`), a type-free
|
||||||
|
`eslint/fast` subset for editor hooks, and Knip / jscpd / Stryker bases.
|
||||||
|
Plain JS, no build step; the git tag is the release. Every plugin is a
|
||||||
|
`dependency` of the package so consumers list none. A fixture repo with one
|
||||||
|
planted violation per rule family proves each gate bites.
|
||||||
|
|
||||||
|
```jsonc
|
||||||
|
"devDependencies": {
|
||||||
|
"@kuhyx/ts-config": "github:kuhyx/utils#ts_config-v0.1.0&path:/ts_config"
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
## godot_dev_tools/
|
||||||
|
|
||||||
|
Godot addon (`addons/dev_tools/`): the F12 dev feedback mode of kuhy's games
|
||||||
|
(annotate the frozen frame, save a bundle that `feedback_inbox` turns into a
|
||||||
|
task). A game mounts it at a pinned tag; the game's own code stays a small host
|
||||||
|
object. Read [`godot_dev_tools/README.md`](godot_dev_tools/README.md).
|
||||||
|
|
||||||
|
Consume via a shallow fetch of the tag, then mount the addon folder:
|
||||||
|
```
|
||||||
|
git clone --depth 1 --branch godot-dev-tools-v0.1.1 https://github.com/kuhyx/utils
|
||||||
|
# link or copy godot_dev_tools/addons/dev_tools to res://addons/dev_tools
|
||||||
|
```
|
||||||
|
|||||||
97
agent_ready/DOCS-spec-notes.md
Normal file
97
agent_ready/DOCS-spec-notes.md
Normal file
@ -0,0 +1,97 @@
|
|||||||
|
# AgentReady spec notes
|
||||||
|
|
||||||
|
These notes record what the checker implements and where each rule comes from.
|
||||||
|
Fetched 2026-10-22.
|
||||||
|
|
||||||
|
## Sources
|
||||||
|
|
||||||
|
- AgentReady v2.0 (October 2026, MIT):
|
||||||
|
<https://github.com/agentready-org/standard/blob/main/spec/spec.md>,
|
||||||
|
canonical site <https://agentready.org>.
|
||||||
|
- AI Catalog (the format behind `AR-FIND-04`):
|
||||||
|
<https://github.com/Agent-Card/ai-catalog/blob/main/specification/ai-catalog.md>.
|
||||||
|
AgentReady defines no catalog schema of its own ("AgentReady does not
|
||||||
|
introduce its own bespoke manifest"), so the checker uses this one.
|
||||||
|
- llms.txt: the spec's informative "llms.txt shape" example, and <https://llmstxt.org/>.
|
||||||
|
|
||||||
|
## Requirements (quoted from spec.md)
|
||||||
|
|
||||||
|
| ID | Level | Requirement | Checker |
|
||||||
|
|---|---|---|---|
|
||||||
|
| AR-FIND-01 | MUST | "The site **MUST NOT** block agent and crawler access to public content, in `robots.txt` or at the network layer." | robots.txt is 200 `text/plain` and not HTML. It has a `User-agent: *` group, and no group has a blanket `Disallow: /`. In url mode the homepage returns 200 with no challenge page for ClaudeBot, GPTBot, Claude-SearchBot, OAI-SearchBot, Claude-User and ChatGPT-User. |
|
||||||
|
| AR-FIND-02 | SHOULD | "Answers agents are expected to cite **SHOULD** be published on one canonical, current, first-party docs page." | SKIP (manual) |
|
||||||
|
| AR-FIND-03 | SHOULD | "The site **SHOULD** list its pages in a `sitemap.xml` referenced from `robots.txt`." | robots.txt has a `Sitemap:` line. The sitemap is XML (by content type in url mode), and every `<loc>` is on the site's own host. |
|
||||||
|
| AR-FIND-04 | MAY | "...publish an AI Catalog at `/.well-known/ai-catalog.json` listing every agent-facing resource it ships ... linked from the homepage head with `<link rel="ai-catalog">` and an HTTP `Link` header." | The catalog is valid (see the schema below) and lists `/llms.txt`. The homepage has `<link rel="ai-catalog">`. In url mode the homepage also sends a `Link: <...>; rel="ai-catalog"` header. |
|
||||||
|
| AR-READ-01 | MUST | "The answer **MUST** be present in the initial HTML — server-rendered or prerendered, not injected by a single-page app after load." | The homepage and each sitemap page return 200 `text/html` with at least `--min-text` characters of visible body text. A page that is byte-identical to the homepage fails. An empty sitemap is a FAIL. |
|
||||||
|
| AR-READ-02 | MUST | "...accurate HTTP status codes: `404` (or a valid redirect) for missing paths ... never a `200` for a missing page" | url mode: two random `/agentready-probe-<hex>` paths must end, after redirects, on a 404 or 410. dist mode: a `404.html` with text must exist. |
|
||||||
|
| AR-READ-03 | SHOULD | "The homepage **SHOULD** be served as raw HTML with real links to docs, product, and pricing." | The homepage HTML has at least one `<a href>` to another page on the site. |
|
||||||
|
| AR-READ-04 | SHOULD | "Docs pages **SHOULD** answer the tasks users bring to agents." | SKIP (manual) |
|
||||||
|
| AR-READ-05 | SHOULD | "Code snippets **SHOULD** be fenced and language-tagged." | Every `<pre><code>` carries `language-*`, `lang-*` or `data-language`. Every fence in a markdown mirror has an info string. |
|
||||||
|
| AR-READ-06 | SHOULD | "Discovery files (`llms.txt`, `.well-known/*`, `openapi.json`, `AGENTS.md`) **SHOULD** be linked from content agents already visit" | `/llms.txt` and the catalog (plus `/openapi.json` with `--act`) exist and are linked from the homepage, by `<link>` or `<a>`. |
|
||||||
|
| AR-READ-07 | SHOULD | "The site **SHOULD** ship an `llms.txt`: a lean, described index of its key pages." | 200 `text/plain` or `text/markdown`, not HTML. It needs an H1 first, a `>` summary, and an `## H2` with a `- [name](url)` list; other prose is allowed. Every on-site link resolves. |
|
||||||
|
| AR-READ-08 | SHOULD | "Key pages **SHOULD** carry JSON-LD — the homepage above all" | The homepage has a parseable `application/ld+json` block with `@context`. |
|
||||||
|
| AR-READ-09 | MAY | "Pages **MAY** advertise a markdown mirror via `<link rel="alternate" type="text/markdown">` or an equivalent HTTP `Link:` header." | Every checked page advertises a mirror. The mirror is 200 `text/markdown` or `text/plain`, and is not HTML. |
|
||||||
|
| AR-READ-10 | n/a | "`AR-READ-10` is retired." | not emitted |
|
||||||
|
| AR-READ-11 | SHOULD | "Pricing **SHOULD** be published on a first-party page" | SKIP (n/a: no paid plans) |
|
||||||
|
| AR-ACT-01 | SHOULD | auth completable by an agent; "OAuth 2.0 with discoverable metadata under `/.well-known`" | `--act`: either `oauth-protected-resource` has `resource`, or `oauth-authorization-server` has `issuer`. |
|
||||||
|
| AR-ACT-02 | SHOULD | "A public API **SHOULD** be described by a machine-readable OpenAPI contract." | `--act`: `/openapi.json` has `openapi` and `paths`, and every operation has an `operationId`. |
|
||||||
|
| AR-ACT-03 | SHOULD | "...expose an MCP server over Streamable HTTP at `/mcp`." | `--act`, url mode: a POST `initialize` gets a JSON-RPC result, or a 401 with `WWW-Authenticate`. |
|
||||||
|
| AR-ACT-04 | MAY | "An MCP server **MAY** ship a server card" | `--act`: the catalog has an `application/mcp-server-card+json` entry. |
|
||||||
|
| AR-ACT-05/06/08/09 | MAY/SHOULD | MCP Apps, SDKs+CLI, payments, NLWeb `/ask` | `--act`: SKIP (manual) |
|
||||||
|
| AR-ACT-07 | SHOULD | "...register WebMCP tools on `document.modelContext`." | `--act`: `modelContext` appears in the homepage HTML or in its same-site scripts. |
|
||||||
|
| AR-ACT-10 | MUST | "...**MUST** expose at least one interface an agent can act through: an MCP server (`AR-ACT-03`) or a CLI (`AR-ACT-06`)." | `--act`: same verdict as the `/mcp` probe. |
|
||||||
|
|
||||||
|
## kuhy's choices that are stricter than the spec
|
||||||
|
|
||||||
|
- Every in-scope item is required, whatever its strength. That includes the
|
||||||
|
MAY items (FIND-04, READ-09).
|
||||||
|
- The spec says a site "**MAY** block a training crawler". kuhy chose to allow
|
||||||
|
training crawlers too, so a blanket `Disallow` for GPTBot, ClaudeBot or any
|
||||||
|
other agent is a FAIL.
|
||||||
|
- The act stage is off by default. Turn it on with `--act` only for sites with
|
||||||
|
user actions. The spec allows this: "a purely informational site conforms on
|
||||||
|
`AR-FIND-*` and `AR-READ-*` alone".
|
||||||
|
|
||||||
|
## AI Catalog schema (ai-catalog.md, specVersion 1.0)
|
||||||
|
|
||||||
|
- The media type is `application/ai-catalog+json`. When fetched by link
|
||||||
|
discovery, plain `application/json` is also acceptable.
|
||||||
|
- At the top level, the object MUST have:
|
||||||
|
- `specVersion`: a string in "Major.Minor" form, for example `"1.0"`.
|
||||||
|
- `entries`: an array, which may be empty.
|
||||||
|
- The top level MAY have `host`, `extensions` and `signature`.
|
||||||
|
- If `host` is present, it MUST have `displayName`. It MAY have
|
||||||
|
`identifier`, `documentationUrl` and `logoUrl`.
|
||||||
|
- Each entry MUST have:
|
||||||
|
- `identifier`: a URI or URN. The recommended form is
|
||||||
|
`urn:air:{publisher}:{namespace}:{name}`.
|
||||||
|
- `type`: a media type, for example `application/mcp-server-card+json`.
|
||||||
|
- **exactly one** of `url` or `data`.
|
||||||
|
- `displayName` is optional on entries (ai-catalog ADR-0016).
|
||||||
|
- Link discovery uses `Link: <...>; rel="ai-catalog"` or
|
||||||
|
`<link rel="ai-catalog" href="..." type="application/ai-catalog+json">`.
|
||||||
|
|
||||||
|
Minimal valid example:
|
||||||
|
|
||||||
|
```json
|
||||||
|
{"specVersion": "1.0",
|
||||||
|
"host": {"displayName": "kuhy"},
|
||||||
|
"entries": [{"identifier": "urn:air:kuhy.duckdns.org:docs:llms",
|
||||||
|
"type": "text/plain", "url": "https://kuhy.duckdns.org/llms.txt"}]}
|
||||||
|
```
|
||||||
|
|
||||||
|
Agentic Resource Discovery v0.91 (<https://agenticresourcediscovery.org/spec>)
|
||||||
|
renamed the path to `/.well-known/ard.json` and the relation to `rel="ard"`.
|
||||||
|
It keeps `ai-catalog.json` only as an optional predecessor. AgentReady v2.0
|
||||||
|
still names `ai-catalog.json`, so that is the path the checker tests. It does
|
||||||
|
not test `ard.json`.
|
||||||
|
|
||||||
|
## llms.txt shape (spec.md, informative)
|
||||||
|
|
||||||
|
```md
|
||||||
|
# Acme
|
||||||
|
> Acme ships a payments API for developers.
|
||||||
|
|
||||||
|
## Docs
|
||||||
|
- [Quickstart](https://example.com/docs/quickstart): first charge in one request
|
||||||
|
```
|
||||||
93
agent_ready/README.md
Normal file
93
agent_ready/README.md
Normal file
@ -0,0 +1,93 @@
|
|||||||
|
# agent_ready
|
||||||
|
|
||||||
|
This tool checks kuhy's websites against [AgentReady](https://agentready.org)
|
||||||
|
v2.0. It runs every find and read item, and the act items when you pass `--act`.
|
||||||
|
It is Python 3 standard library only, with no dependencies.
|
||||||
|
`DOCS-spec-notes.md` maps each `AR-*` ID to the check that tests it.
|
||||||
|
|
||||||
|
## Usage
|
||||||
|
|
||||||
|
```sh
|
||||||
|
~/src/utils/agent_ready/check.sh dist <build-dir> [--act] [--min-text N] [--max-pages N]
|
||||||
|
~/src/utils/agent_ready/check.sh url <base-url> [--act] [--min-text N] [--max-pages N] [--timeout S] [--budget S]
|
||||||
|
```
|
||||||
|
|
||||||
|
The output is one line per check:
|
||||||
|
|
||||||
|
```text
|
||||||
|
PASS AR-FIND-03 sitemap lists 12 pages
|
||||||
|
FAIL AR-READ-02 soft 404, unknown paths must return 404: /agentready-probe-1a2b -> HTTP 200
|
||||||
|
SKIP AR-READ-11 pricing page: n/a for sites without paid plans
|
||||||
|
```
|
||||||
|
|
||||||
|
| exit | meaning |
|
||||||
|
|---|---|
|
||||||
|
| 0 | every check passed (SKIPs do not fail) |
|
||||||
|
| 1 | at least one FAIL, at any strength: MUST, SHOULD or MAY |
|
||||||
|
| 2 | usage error (bad arguments, missing directory, not an http(s) URL) |
|
||||||
|
| 3 | network undeterminable: the homepage was unreachable, or a fetch timed out or hit the 45 s budget, and nothing failed |
|
||||||
|
|
||||||
|
## Pre-commit and CI (dist mode)
|
||||||
|
|
||||||
|
Point the checker at the build output after the build step. Dist mode checks
|
||||||
|
that each file exists and is well-formed:
|
||||||
|
|
||||||
|
- robots.txt
|
||||||
|
- sitemap.xml
|
||||||
|
- llms.txt
|
||||||
|
- the AI Catalog
|
||||||
|
- 404.html
|
||||||
|
- the text in every sitemap page's HTML
|
||||||
|
- each page's markdown mirror
|
||||||
|
|
||||||
|
```yaml
|
||||||
|
# .github/workflows/*.yml, after the build
|
||||||
|
- run: ~/src/utils/agent_ready/check.sh dist dist/
|
||||||
|
```
|
||||||
|
|
||||||
|
```yaml
|
||||||
|
# .pre-commit-config.yaml (local hook; build first, e.g. in a wrapper script)
|
||||||
|
- id: agent-ready
|
||||||
|
name: AgentReady (build output)
|
||||||
|
entry: bash -c 'pnpm build >/dev/null && ~/src/utils/agent_ready/check.sh dist dist'
|
||||||
|
language: system
|
||||||
|
pass_filenames: false
|
||||||
|
```
|
||||||
|
|
||||||
|
Dist mode cannot check HTTP behaviour: content types, the `Link` header, real
|
||||||
|
404 status, or responses to agent user-agents. Those checks print as SKIP, or
|
||||||
|
the check falls back to "404.html exists".
|
||||||
|
|
||||||
|
## Post-deploy (url mode)
|
||||||
|
|
||||||
|
Run this once the deploy is live:
|
||||||
|
|
||||||
|
```sh
|
||||||
|
~/src/utils/agent_ready/check.sh url https://kuhy.duckdns.org
|
||||||
|
```
|
||||||
|
|
||||||
|
Url mode checks status codes **and** content types. A server that answers
|
||||||
|
every path with `200 text/html` (an SPA fallback) fails on robots.txt, the
|
||||||
|
sitemap, llms.txt, the catalog and the 404 probe. A status-only check would
|
||||||
|
pass it. Url mode also checks that:
|
||||||
|
|
||||||
|
- `/agentready-probe-<random>` ends on a 404, after following redirects.
|
||||||
|
- No sitemap page is byte-identical to the homepage shell.
|
||||||
|
- The homepage answers 200 to ClaudeBot, GPTBot and the other agent
|
||||||
|
user-agents.
|
||||||
|
|
||||||
|
## Tests
|
||||||
|
|
||||||
|
```sh
|
||||||
|
~/.claude/scripts/capped.sh python -m pytest ~/src/utils/agent_ready/tests -q
|
||||||
|
```
|
||||||
|
|
||||||
|
The test fixtures are generated in `tmp_path` by `tests/sitegen.py`, so there
|
||||||
|
are no static mirror `.md` files to trip the markdown-naming gate. The good
|
||||||
|
and bad build trees are served by loopback `http.server` instances in four
|
||||||
|
shapes:
|
||||||
|
|
||||||
|
- compliant
|
||||||
|
- SPA fallback
|
||||||
|
- JSON 404 on every path
|
||||||
|
- 403 to GPTBot
|
||||||
1
agent_ready/__init__.py
Normal file
1
agent_ready/__init__.py
Normal file
@ -0,0 +1 @@
|
|||||||
|
"""AgentReady (agentready.org v2.0) compliance checker for kuhy's websites."""
|
||||||
188
agent_ready/backends.py
Normal file
188
agent_ready/backends.py
Normal file
@ -0,0 +1,188 @@
|
|||||||
|
"""Two backends behind one ``get(path)``: a build directory and a live site.
|
||||||
|
|
||||||
|
DirSite answers like a plain static host (index.html for ``/x/``, a 404 for
|
||||||
|
anything missing), so the find/read checks are written once for both modes.
|
||||||
|
"""
|
||||||
|
|
||||||
|
from __future__ import annotations
|
||||||
|
|
||||||
|
import http.client
|
||||||
|
import threading
|
||||||
|
import time
|
||||||
|
import urllib.error
|
||||||
|
import urllib.request
|
||||||
|
from concurrent.futures import ThreadPoolExecutor
|
||||||
|
from dataclasses import dataclass, field
|
||||||
|
from pathlib import Path
|
||||||
|
from urllib.parse import unquote, urljoin, urlsplit
|
||||||
|
|
||||||
|
from agent_ready.report import Undeterminable
|
||||||
|
|
||||||
|
DEFAULT_UA = "Claude-User/1.0 (+agentready-check)"
|
||||||
|
MAX_BODY = 5 * 1024 * 1024
|
||||||
|
_EXT_MIME = {
|
||||||
|
".html": "text/html",
|
||||||
|
".md": "text/markdown",
|
||||||
|
".txt": "text/plain",
|
||||||
|
".xml": "application/xml",
|
||||||
|
".json": "application/json",
|
||||||
|
}
|
||||||
|
|
||||||
|
|
||||||
|
@dataclass(frozen=True)
|
||||||
|
class Response:
|
||||||
|
"""A fetched resource: final status, bare media type, headers, body."""
|
||||||
|
|
||||||
|
status: int
|
||||||
|
ctype: str
|
||||||
|
body: bytes
|
||||||
|
headers: dict[str, str] = field(default_factory=dict)
|
||||||
|
|
||||||
|
@property
|
||||||
|
def text(self) -> str:
|
||||||
|
"""Body decoded as UTF-8 (lenient)."""
|
||||||
|
return self.body.decode("utf-8", "replace")
|
||||||
|
|
||||||
|
|
||||||
|
class Site:
|
||||||
|
"""Common URL handling; subclasses implement ``_fetch``."""
|
||||||
|
|
||||||
|
live = False
|
||||||
|
|
||||||
|
def __init__(self, origin: str) -> None:
|
||||||
|
self.origin = origin.rstrip("/")
|
||||||
|
self._cache: dict[tuple[str, str], Response | Undeterminable] = {}
|
||||||
|
self._lock = threading.Lock()
|
||||||
|
|
||||||
|
def to_path(self, url: str, base: str = "/") -> str | None:
|
||||||
|
"""Site path for a URL or relative href; None when off-site."""
|
||||||
|
absolute = urljoin(self.origin + base, url.strip())
|
||||||
|
parts = urlsplit(absolute)
|
||||||
|
if (
|
||||||
|
parts.scheme not in ("http", "https")
|
||||||
|
or parts.netloc != urlsplit(self.origin).netloc
|
||||||
|
):
|
||||||
|
return None
|
||||||
|
return parts.path or "/"
|
||||||
|
|
||||||
|
def get(self, path: str, ua: str = DEFAULT_UA) -> Response:
|
||||||
|
"""Fetch ``path`` (memoized, including network failures)."""
|
||||||
|
key = (path, ua)
|
||||||
|
with self._lock:
|
||||||
|
hit = self._cache.get(key)
|
||||||
|
if hit is None:
|
||||||
|
try:
|
||||||
|
hit = self._fetch(path, ua)
|
||||||
|
except Undeterminable as exc:
|
||||||
|
hit = exc
|
||||||
|
with self._lock:
|
||||||
|
self._cache[key] = hit
|
||||||
|
if isinstance(hit, Undeterminable):
|
||||||
|
raise hit
|
||||||
|
return hit
|
||||||
|
|
||||||
|
def prefetch(self, paths: list[str], uas: tuple[str, ...] = (DEFAULT_UA,)) -> None:
|
||||||
|
"""Warm the cache for every (path, ua) pair; parallel for live sites."""
|
||||||
|
if not self.live:
|
||||||
|
return
|
||||||
|
pairs = [(p, ua) for p in dict.fromkeys(paths) for ua in uas]
|
||||||
|
with ThreadPoolExecutor(max_workers=8) as pool:
|
||||||
|
list(pool.map(lambda pair: self._safe_get(*pair), pairs))
|
||||||
|
|
||||||
|
def _safe_get(self, path: str, ua: str) -> None:
|
||||||
|
try:
|
||||||
|
self.get(path, ua)
|
||||||
|
except Undeterminable:
|
||||||
|
pass
|
||||||
|
|
||||||
|
def _fetch(self, path: str, ua: str) -> Response:
|
||||||
|
raise NotImplementedError
|
||||||
|
|
||||||
|
|
||||||
|
class DirSite(Site):
|
||||||
|
"""A build output directory served the way a static host serves it."""
|
||||||
|
|
||||||
|
def __init__(self, root: Path) -> None:
|
||||||
|
super().__init__("https://dist.invalid")
|
||||||
|
self.root = root.resolve()
|
||||||
|
|
||||||
|
def file_for(self, path: str) -> Path | None:
|
||||||
|
"""The file a static host would serve for ``path``."""
|
||||||
|
rel = unquote(path.split("?", 1)[0]).lstrip("/")
|
||||||
|
base = (self.root / rel).resolve()
|
||||||
|
if not base.is_relative_to(self.root):
|
||||||
|
return None
|
||||||
|
cands = (
|
||||||
|
[base / "index.html"]
|
||||||
|
if path.endswith("/") or not rel
|
||||||
|
else [base, base.with_name(base.name + ".html"), base / "index.html"]
|
||||||
|
)
|
||||||
|
return next((c for c in cands if c.is_file()), None)
|
||||||
|
|
||||||
|
def _fetch(self, path: str, ua: str) -> Response:
|
||||||
|
target = self.file_for(path)
|
||||||
|
if target is None:
|
||||||
|
fallback = self.root / "404.html"
|
||||||
|
body = fallback.read_bytes() if fallback.is_file() else b""
|
||||||
|
return Response(404, "text/html", body)
|
||||||
|
return Response(
|
||||||
|
200,
|
||||||
|
_EXT_MIME.get(target.suffix, "application/octet-stream"),
|
||||||
|
target.read_bytes(),
|
||||||
|
)
|
||||||
|
|
||||||
|
|
||||||
|
class HttpSite(Site):
|
||||||
|
"""A live site. Follows redirects; HTTP errors are responses, not raises."""
|
||||||
|
|
||||||
|
live = True
|
||||||
|
|
||||||
|
def __init__(self, base: str, timeout: float = 8.0, budget: float = 45.0) -> None:
|
||||||
|
parts = urlsplit(base)
|
||||||
|
super().__init__(f"{parts.scheme}://{parts.netloc}")
|
||||||
|
self.timeout = timeout
|
||||||
|
self.deadline = time.monotonic() + budget
|
||||||
|
|
||||||
|
def _remaining(self) -> float:
|
||||||
|
left = self.deadline - time.monotonic()
|
||||||
|
if left < 1:
|
||||||
|
raise Undeterminable("overall time budget used up")
|
||||||
|
return min(self.timeout, left)
|
||||||
|
|
||||||
|
def _fetch(self, path: str, ua: str) -> Response:
|
||||||
|
return self.request(path, ua)
|
||||||
|
|
||||||
|
def request(
|
||||||
|
self,
|
||||||
|
path: str,
|
||||||
|
ua: str = DEFAULT_UA,
|
||||||
|
data: bytes | None = None,
|
||||||
|
headers: dict[str, str] | None = None,
|
||||||
|
) -> Response:
|
||||||
|
"""Uncached GET (or POST when ``data`` is given)."""
|
||||||
|
req = urllib.request.Request(
|
||||||
|
self.origin + path,
|
||||||
|
data=data,
|
||||||
|
headers={"User-Agent": ua, "Accept": "*/*", **(headers or {})},
|
||||||
|
)
|
||||||
|
try:
|
||||||
|
with urllib.request.urlopen(req, timeout=self._remaining()) as resp:
|
||||||
|
return _response(resp.status, resp.headers, resp.read(MAX_BODY))
|
||||||
|
except urllib.error.HTTPError as exc:
|
||||||
|
return _response(exc.code, exc.headers, exc.read(MAX_BODY))
|
||||||
|
except (
|
||||||
|
urllib.error.URLError,
|
||||||
|
TimeoutError,
|
||||||
|
OSError,
|
||||||
|
http.client.HTTPException,
|
||||||
|
) as exc:
|
||||||
|
raise Undeterminable(f"{path}: {getattr(exc, 'reason', exc)}") from exc
|
||||||
|
|
||||||
|
|
||||||
|
def _response(status: int, headers: http.client.HTTPMessage, body: bytes) -> Response:
|
||||||
|
"""Normalise headers: lowercase keys, repeated headers joined by ', '."""
|
||||||
|
flat: dict[str, str] = {}
|
||||||
|
for key in set(headers.keys()):
|
||||||
|
flat[key.lower()] = ", ".join(headers.get_all(key) or [])
|
||||||
|
ctype = flat.get("content-type", "").split(";", 1)[0].strip().lower()
|
||||||
|
return Response(status, ctype, body, flat)
|
||||||
137
agent_ready/check.py
Executable file
137
agent_ready/check.py
Executable file
@ -0,0 +1,137 @@
|
|||||||
|
#!/usr/bin/env python3
|
||||||
|
"""AgentReady compliance checker (agentready.org spec v2.0).
|
||||||
|
|
||||||
|
check.py dist <build-dir> [--act] # pre-commit / CI: build output
|
||||||
|
check.py url <base-url> [--act] # post-deploy: the live site
|
||||||
|
|
||||||
|
Prints ``PASS|FAIL|SKIP AR-XXX-NN <msg>`` per check. Exit 0 all pass, 1 any
|
||||||
|
FAIL (every in-scope item is required, whatever its MUST/SHOULD/MAY
|
||||||
|
strength), 2 usage error, 3 network undeterminable.
|
||||||
|
"""
|
||||||
|
|
||||||
|
from __future__ import annotations
|
||||||
|
|
||||||
|
import argparse
|
||||||
|
import sys
|
||||||
|
from collections.abc import Callable
|
||||||
|
from pathlib import Path
|
||||||
|
from urllib.parse import urlsplit
|
||||||
|
|
||||||
|
if __package__ in (None, ""): # run as a plain script: make the package importable
|
||||||
|
sys.path.insert(0, str(Path(__file__).resolve().parents[1]))
|
||||||
|
|
||||||
|
from agent_ready import checks_find, checks_read
|
||||||
|
from agent_ready.backends import DirSite, HttpSite, Site
|
||||||
|
from agent_ready.checks_act import run_act
|
||||||
|
from agent_ready.context import HOME, Ctx
|
||||||
|
from agent_ready.report import (
|
||||||
|
EXIT_NETWORK,
|
||||||
|
EXIT_USAGE,
|
||||||
|
Report,
|
||||||
|
Undeterminable,
|
||||||
|
)
|
||||||
|
|
||||||
|
# (AR id used when a network failure aborts the check, check function)
|
||||||
|
CHECKS: list[tuple[str, Callable[[Ctx], None]]] = [
|
||||||
|
("AR-FIND-01", checks_find.check_robots),
|
||||||
|
("AR-FIND-01", checks_find.check_agent_access),
|
||||||
|
("AR-FIND-03", checks_find.check_sitemap),
|
||||||
|
("AR-FIND-04", checks_find.check_catalog),
|
||||||
|
("AR-READ-01", checks_read.check_pages),
|
||||||
|
("AR-READ-02", checks_read.check_status_codes),
|
||||||
|
("AR-READ-03", checks_read.check_homepage),
|
||||||
|
("AR-READ-06", checks_read.check_discovery_links),
|
||||||
|
("AR-READ-07", checks_read.check_llms),
|
||||||
|
("AR-FIND-02", checks_read.skip_manual),
|
||||||
|
("AR-ACT-10", run_act),
|
||||||
|
]
|
||||||
|
|
||||||
|
|
||||||
|
def parse_args(argv: list[str] | None) -> argparse.Namespace:
|
||||||
|
"""Parse the command line (argparse exits 2 on usage errors)."""
|
||||||
|
parser = argparse.ArgumentParser(
|
||||||
|
prog="agent_ready", description=__doc__.split("\n\n")[0]
|
||||||
|
)
|
||||||
|
sub = parser.add_subparsers(dest="mode", required=True)
|
||||||
|
for mode, target in (
|
||||||
|
("dist", "build output directory"),
|
||||||
|
("url", "base URL, e.g. https://example.org"),
|
||||||
|
):
|
||||||
|
cmd = sub.add_parser(mode, help=f"check a {target}")
|
||||||
|
cmd.add_argument("target", help=target)
|
||||||
|
cmd.add_argument(
|
||||||
|
"--act",
|
||||||
|
action="store_true",
|
||||||
|
help="also check the act stage (OpenAPI, MCP, auth)",
|
||||||
|
)
|
||||||
|
cmd.add_argument(
|
||||||
|
"--min-text",
|
||||||
|
type=int,
|
||||||
|
default=100,
|
||||||
|
help="min visible chars per page (default 100)",
|
||||||
|
)
|
||||||
|
cmd.add_argument(
|
||||||
|
"--max-pages",
|
||||||
|
type=int,
|
||||||
|
default=40,
|
||||||
|
help="url mode: max pages to fetch (default 40; dist checks all)",
|
||||||
|
)
|
||||||
|
url = sub.choices["url"]
|
||||||
|
url.add_argument(
|
||||||
|
"--timeout",
|
||||||
|
type=float,
|
||||||
|
default=8.0,
|
||||||
|
help="per-request timeout in s (default 8)",
|
||||||
|
)
|
||||||
|
url.add_argument(
|
||||||
|
"--budget",
|
||||||
|
type=float,
|
||||||
|
default=45.0,
|
||||||
|
help="overall network budget in s (default 45)",
|
||||||
|
)
|
||||||
|
return parser.parse_args(argv)
|
||||||
|
|
||||||
|
|
||||||
|
def make_site(args: argparse.Namespace) -> Site | None:
|
||||||
|
"""Build the backend, or report a usage error and return None."""
|
||||||
|
if args.mode == "dist":
|
||||||
|
root = Path(args.target)
|
||||||
|
if not root.is_dir():
|
||||||
|
print(f"agent_ready: not a directory: {root}", file=sys.stderr)
|
||||||
|
return None
|
||||||
|
return DirSite(root)
|
||||||
|
parts = urlsplit(args.target)
|
||||||
|
if parts.scheme not in ("http", "https") or not parts.netloc:
|
||||||
|
print(f"agent_ready: not an http(s) URL: {args.target}", file=sys.stderr)
|
||||||
|
return None
|
||||||
|
return HttpSite(args.target, timeout=args.timeout, budget=args.budget)
|
||||||
|
|
||||||
|
|
||||||
|
def main(argv: list[str] | None = None) -> int:
|
||||||
|
"""Run every check and return the exit code."""
|
||||||
|
args = parse_args(argv)
|
||||||
|
site = make_site(args)
|
||||||
|
if site is None:
|
||||||
|
return EXIT_USAGE
|
||||||
|
report = Report(out=sys.stdout)
|
||||||
|
ctx = Ctx(
|
||||||
|
site=site,
|
||||||
|
report=report,
|
||||||
|
min_text=args.min_text,
|
||||||
|
max_pages=args.max_pages,
|
||||||
|
act=args.act,
|
||||||
|
)
|
||||||
|
try:
|
||||||
|
site.get(HOME)
|
||||||
|
except Undeterminable as exc:
|
||||||
|
report.skip(
|
||||||
|
"AR-FIND-01", f"undeterminable (network): homepage unreachable: {exc}"
|
||||||
|
)
|
||||||
|
return EXIT_NETWORK
|
||||||
|
for ar_id, check in CHECKS:
|
||||||
|
report.guard(ar_id, lambda check=check: check(ctx))
|
||||||
|
return report.exit_code()
|
||||||
|
|
||||||
|
|
||||||
|
if __name__ == "__main__":
|
||||||
|
sys.exit(main())
|
||||||
10
agent_ready/check.sh
Executable file
10
agent_ready/check.sh
Executable file
@ -0,0 +1,10 @@
|
|||||||
|
#!/bin/bash
|
||||||
|
# Thin wrapper: run the AgentReady checker from any cwd.
|
||||||
|
# check.sh dist <build-dir> [--act]
|
||||||
|
# check.sh url <base-url> [--act]
|
||||||
|
# Exit codes: 0 all pass, 1 any FAIL, 2 usage error, 3 network undeterminable.
|
||||||
|
set -euo pipefail
|
||||||
|
|
||||||
|
HERE="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
|
||||||
|
readonly HERE
|
||||||
|
PYTHONPATH="$(dirname "$HERE")${PYTHONPATH:+:$PYTHONPATH}" exec python3 -m agent_ready.check "$@"
|
||||||
156
agent_ready/checks_act.py
Normal file
156
agent_ready/checks_act.py
Normal file
@ -0,0 +1,156 @@
|
|||||||
|
"""Act stage: AR-ACT-01..10. Opt-in (``--act``): only for sites with user actions."""
|
||||||
|
|
||||||
|
from __future__ import annotations
|
||||||
|
|
||||||
|
import json
|
||||||
|
|
||||||
|
from agent_ready import formats
|
||||||
|
from agent_ready.backends import HttpSite
|
||||||
|
from agent_ready.context import CATALOG, Ctx
|
||||||
|
|
||||||
|
_INIT = {
|
||||||
|
"jsonrpc": "2.0",
|
||||||
|
"id": 1,
|
||||||
|
"method": "initialize",
|
||||||
|
"params": {
|
||||||
|
"protocolVersion": "2025-06-18",
|
||||||
|
"capabilities": {},
|
||||||
|
"clientInfo": {"name": "agentready-check", "version": "1"},
|
||||||
|
},
|
||||||
|
}
|
||||||
|
|
||||||
|
|
||||||
|
def _json(ctx: Ctx, path: str) -> object | None:
|
||||||
|
"""Parsed JSON at ``path`` when it is 200 and parses, else None."""
|
||||||
|
resp = ctx.site.get(path)
|
||||||
|
if resp.status != 200:
|
||||||
|
return None
|
||||||
|
try:
|
||||||
|
return json.loads(resp.body)
|
||||||
|
except ValueError:
|
||||||
|
return None
|
||||||
|
|
||||||
|
|
||||||
|
def check_auth(ctx: Ctx) -> None:
|
||||||
|
"""AR-ACT-01: OAuth metadata (RFC 9728 ``resource`` or RFC 8414 ``issuer``)."""
|
||||||
|
prm = _json(ctx, "/.well-known/oauth-protected-resource")
|
||||||
|
asm = _json(ctx, "/.well-known/oauth-authorization-server")
|
||||||
|
ok = (isinstance(prm, dict) and "resource" in prm) or (
|
||||||
|
isinstance(asm, dict) and "issuer" in asm
|
||||||
|
)
|
||||||
|
ctx.report.verdict(
|
||||||
|
"AR-ACT-01",
|
||||||
|
[]
|
||||||
|
if ok
|
||||||
|
else [
|
||||||
|
"no OAuth metadata under /.well-known (oauth-protected-resource / oauth-authorization-server)"
|
||||||
|
],
|
||||||
|
"OAuth metadata discoverable under /.well-known",
|
||||||
|
)
|
||||||
|
|
||||||
|
|
||||||
|
def check_openapi(ctx: Ctx) -> None:
|
||||||
|
"""AR-ACT-02: /openapi.json with paths and an operationId on every operation."""
|
||||||
|
doc = _json(ctx, "/openapi.json")
|
||||||
|
if not isinstance(doc, dict) or not isinstance(doc.get("openapi"), str):
|
||||||
|
ctx.report.fail("AR-ACT-02", "/openapi.json missing or not an OpenAPI document")
|
||||||
|
return
|
||||||
|
paths = doc.get("paths") if isinstance(doc.get("paths"), dict) else {}
|
||||||
|
ops = [
|
||||||
|
op
|
||||||
|
for item in paths.values()
|
||||||
|
if isinstance(item, dict)
|
||||||
|
for m, op in item.items()
|
||||||
|
if m in ("get", "post", "put", "patch", "delete")
|
||||||
|
]
|
||||||
|
missing = sum(
|
||||||
|
1 for op in ops if not (isinstance(op, dict) and op.get("operationId"))
|
||||||
|
)
|
||||||
|
problems = ["no operations in paths"] if not ops else []
|
||||||
|
if missing:
|
||||||
|
problems.append(f"{missing} operations lack operationId")
|
||||||
|
ctx.report.verdict(
|
||||||
|
"AR-ACT-02", problems, f"/openapi.json describes {len(ops)} operations"
|
||||||
|
)
|
||||||
|
|
||||||
|
|
||||||
|
def _mcp_ok(ctx: Ctx) -> bool | None:
|
||||||
|
"""True if /mcp answers initialize (or is OAuth-gated); None in dist mode."""
|
||||||
|
if not isinstance(ctx.site, HttpSite):
|
||||||
|
return None
|
||||||
|
headers = {
|
||||||
|
"Content-Type": "application/json",
|
||||||
|
"Accept": "application/json, text/event-stream",
|
||||||
|
}
|
||||||
|
resp = ctx.site.request("/mcp", data=json.dumps(_INIT).encode(), headers=headers)
|
||||||
|
if resp.status == 401:
|
||||||
|
return "www-authenticate" in resp.headers
|
||||||
|
return resp.status == 200 and '"jsonrpc"' in resp.text and '"result"' in resp.text
|
||||||
|
|
||||||
|
|
||||||
|
def check_mcp(ctx: Ctx) -> None:
|
||||||
|
"""AR-ACT-03 MCP at /mcp, AR-ACT-04 server card, AR-ACT-10 an interface exists."""
|
||||||
|
ok = _mcp_ok(ctx)
|
||||||
|
if ok is None:
|
||||||
|
ctx.report.skip("AR-ACT-03", "/mcp is a server endpoint: check in url mode")
|
||||||
|
ctx.report.skip("AR-ACT-10", "MCP/CLI interface: check in url mode")
|
||||||
|
else:
|
||||||
|
ctx.report.verdict(
|
||||||
|
"AR-ACT-03",
|
||||||
|
[]
|
||||||
|
if ok
|
||||||
|
else [
|
||||||
|
"/mcp does not answer an MCP initialize (nor 401 + WWW-Authenticate)"
|
||||||
|
],
|
||||||
|
"/mcp answers MCP initialize",
|
||||||
|
)
|
||||||
|
ctx.report.verdict(
|
||||||
|
"AR-ACT-10",
|
||||||
|
[]
|
||||||
|
if ok
|
||||||
|
else ["no MCP server at /mcp; a CLI (AR-ACT-06) cannot be auto-detected"],
|
||||||
|
"agents can act through /mcp",
|
||||||
|
)
|
||||||
|
cards = [
|
||||||
|
t
|
||||||
|
for t in formats.catalog_types(_json(ctx, CATALOG))
|
||||||
|
if t == "application/mcp-server-card+json"
|
||||||
|
]
|
||||||
|
ctx.report.verdict(
|
||||||
|
"AR-ACT-04",
|
||||||
|
[] if cards else ["AI Catalog lists no application/mcp-server-card+json entry"],
|
||||||
|
"AI Catalog lists an MCP server card",
|
||||||
|
)
|
||||||
|
|
||||||
|
|
||||||
|
def check_webmcp(ctx: Ctx) -> None:
|
||||||
|
"""AR-ACT-07: WebMCP tools registered on document.modelContext."""
|
||||||
|
resp, page = ctx.home()
|
||||||
|
sources = [resp.text]
|
||||||
|
for src in page.scripts[:10]:
|
||||||
|
path = ctx.site.to_path(src)
|
||||||
|
if path:
|
||||||
|
sources.append(ctx.site.get(path).text)
|
||||||
|
found = any("modelContext" in s for s in sources)
|
||||||
|
ctx.report.verdict(
|
||||||
|
"AR-ACT-07",
|
||||||
|
[] if found else ["no document.modelContext usage in homepage HTML/scripts"],
|
||||||
|
"homepage registers WebMCP tools",
|
||||||
|
)
|
||||||
|
|
||||||
|
|
||||||
|
def run_act(ctx: Ctx) -> None:
|
||||||
|
"""All act checks, or one SKIP line when the stage is off."""
|
||||||
|
if not ctx.act:
|
||||||
|
ctx.report.skip(
|
||||||
|
"AR-ACT-10", "act stage off (pass --act for sites with user actions)"
|
||||||
|
)
|
||||||
|
return
|
||||||
|
ctx.report.guard("AR-ACT-01", lambda: check_auth(ctx))
|
||||||
|
ctx.report.guard("AR-ACT-02", lambda: check_openapi(ctx))
|
||||||
|
ctx.report.guard("AR-ACT-03", lambda: check_mcp(ctx))
|
||||||
|
ctx.report.guard("AR-ACT-07", lambda: check_webmcp(ctx))
|
||||||
|
ctx.report.skip("AR-ACT-05", "MCP Apps ui:// view: manual review")
|
||||||
|
ctx.report.skip("AR-ACT-06", "SDKs on npm/PyPI and a CLI: manual review")
|
||||||
|
ctx.report.skip("AR-ACT-08", "agent payments: n/a unless the product charges")
|
||||||
|
ctx.report.skip("AR-ACT-09", "NLWeb /ask endpoint: manual review")
|
||||||
186
agent_ready/checks_find.py
Normal file
186
agent_ready/checks_find.py
Normal file
@ -0,0 +1,186 @@
|
|||||||
|
"""Find stage: AR-FIND-01..04 (robots.txt, agent access, sitemap, AI Catalog)."""
|
||||||
|
|
||||||
|
from __future__ import annotations
|
||||||
|
|
||||||
|
import json
|
||||||
|
from urllib.parse import urlsplit
|
||||||
|
|
||||||
|
from agent_ready import formats
|
||||||
|
from agent_ready.context import CATALOG, HOME, LLMS, Ctx, link_header_href
|
||||||
|
from agent_ready.report import summarize
|
||||||
|
|
||||||
|
# Training, search-index and user-initiated fetchers named in the spec's
|
||||||
|
# crawl-policy notes. Real UA strings for the two training crawlers.
|
||||||
|
AGENT_UAS = {
|
||||||
|
"ClaudeBot": "Mozilla/5.0 AppleWebKit/537.36 (KHTML, like Gecko; compatible; ClaudeBot/1.0; +claudebot@anthropic.com)",
|
||||||
|
"GPTBot": "Mozilla/5.0 AppleWebKit/537.36 (KHTML, like Gecko; compatible; GPTBot/1.1; +https://openai.com/gptbot)",
|
||||||
|
"Claude-SearchBot": "Claude-SearchBot/1.0",
|
||||||
|
"OAI-SearchBot": "OAI-SearchBot/1.0; +https://openai.com/searchbot",
|
||||||
|
"Claude-User": "Claude-User/1.0",
|
||||||
|
"ChatGPT-User": "ChatGPT-User/1.0; +https://openai.com/bot",
|
||||||
|
}
|
||||||
|
_CHALLENGE = (
|
||||||
|
"just a moment",
|
||||||
|
"cf-chl",
|
||||||
|
"challenge-platform",
|
||||||
|
"attention required",
|
||||||
|
"captcha",
|
||||||
|
)
|
||||||
|
XML_TYPES = ("application/xml", "text/xml", "application/rss+xml")
|
||||||
|
|
||||||
|
|
||||||
|
def check_robots(ctx: Ctx) -> None:
|
||||||
|
"""AR-FIND-01: robots.txt exists, is plain text and blocks no agent."""
|
||||||
|
resp = ctx.site.get("/robots.txt")
|
||||||
|
if resp.status != 200:
|
||||||
|
ctx.report.fail("AR-FIND-01", f"/robots.txt: HTTP {resp.status}")
|
||||||
|
return
|
||||||
|
problems = ctx.type_problem(resp, ("text/plain",), "/robots.txt")
|
||||||
|
if formats.looks_like_html(resp.text):
|
||||||
|
ctx.report.fail(
|
||||||
|
"AR-FIND-01",
|
||||||
|
"; ".join([*problems, "/robots.txt body is an HTML page (SPA fallback?)"]),
|
||||||
|
)
|
||||||
|
return
|
||||||
|
ctx.robots_text = resp.text
|
||||||
|
groups = formats.parse_robots(resp.text)
|
||||||
|
if not formats.has_wildcard_group(groups):
|
||||||
|
problems.append("no 'User-agent: *' group (spec: one rule for all agents)")
|
||||||
|
blocked = formats.blocked_agents(groups)
|
||||||
|
if blocked:
|
||||||
|
problems.append(f"blanket Disallow for: {', '.join(blocked)}")
|
||||||
|
ctx.report.verdict(
|
||||||
|
"AR-FIND-01",
|
||||||
|
problems,
|
||||||
|
"robots.txt is plain text, has a * group and blocks no agent",
|
||||||
|
)
|
||||||
|
|
||||||
|
|
||||||
|
def check_agent_access(ctx: Ctx) -> None:
|
||||||
|
"""AR-FIND-01 (bot protection): homepage is 200 for each agent UA (url mode)."""
|
||||||
|
if not ctx.live:
|
||||||
|
ctx.report.skip("AR-FIND-01", "agent user-agent fetches need url mode")
|
||||||
|
return
|
||||||
|
base, _ = ctx.home()
|
||||||
|
ctx.site.prefetch([HOME], tuple(AGENT_UAS.values()))
|
||||||
|
bad = []
|
||||||
|
for name, ua in AGENT_UAS.items():
|
||||||
|
resp = ctx.site.get(HOME, ua)
|
||||||
|
lowered = resp.text[:20000].lower()
|
||||||
|
if resp.status != 200:
|
||||||
|
bad.append(f"{name} HTTP {resp.status}")
|
||||||
|
elif resp.body != base.body and any(m in lowered for m in _CHALLENGE):
|
||||||
|
bad.append(f"{name} got a challenge page")
|
||||||
|
ctx.report.verdict("AR-FIND-01", bad, f"homepage 200 for {', '.join(AGENT_UAS)}")
|
||||||
|
|
||||||
|
|
||||||
|
def _sitemap_paths(ctx: Ctx) -> list[str]:
|
||||||
|
"""Sitemap locations from robots.txt (also fixes the dist-mode origin)."""
|
||||||
|
urls = formats.robots_sitemaps(ctx.robots_text or "")
|
||||||
|
if urls and not ctx.live:
|
||||||
|
parts = urlsplit(urls[0])
|
||||||
|
ctx.site.origin = f"{parts.scheme}://{parts.netloc}"
|
||||||
|
paths = [p for u in urls if (p := ctx.site.to_path(u))]
|
||||||
|
if ctx.robots_text is None:
|
||||||
|
ctx.report.fail("AR-FIND-03", "no valid robots.txt to reference the sitemap")
|
||||||
|
elif not urls:
|
||||||
|
ctx.report.fail("AR-FIND-03", "robots.txt has no 'Sitemap:' line")
|
||||||
|
elif not paths:
|
||||||
|
ctx.report.fail(
|
||||||
|
"AR-FIND-03", f"robots.txt Sitemap is on another host: {urls[0]}"
|
||||||
|
)
|
||||||
|
else:
|
||||||
|
ctx.report.ok("AR-FIND-03", f"robots.txt references {summarize(urls)}")
|
||||||
|
return paths or ["/sitemap.xml"]
|
||||||
|
|
||||||
|
|
||||||
|
def _read_sitemap(ctx: Ctx, path: str, problems: list[str]) -> tuple[str, list[str]]:
|
||||||
|
"""Fetch and parse one sitemap; record problems; return (kind, locs)."""
|
||||||
|
resp = ctx.site.get(path)
|
||||||
|
if resp.status != 200:
|
||||||
|
problems.append(f"{path}: HTTP {resp.status}")
|
||||||
|
return "", []
|
||||||
|
problems.extend(ctx.type_problem(resp, XML_TYPES, path))
|
||||||
|
try:
|
||||||
|
return formats.parse_sitemap(resp.body)
|
||||||
|
except ValueError as exc:
|
||||||
|
problems.append(f"{path}: {exc}")
|
||||||
|
return "", []
|
||||||
|
|
||||||
|
|
||||||
|
def check_sitemap(ctx: Ctx) -> None:
|
||||||
|
"""AR-FIND-03: sitemap referenced from robots.txt, valid XML, on-site <loc>s."""
|
||||||
|
problems: list[str] = []
|
||||||
|
locs: list[str] = []
|
||||||
|
for path in _sitemap_paths(ctx)[:5]:
|
||||||
|
kind, found = _read_sitemap(ctx, path, problems)
|
||||||
|
if kind == "sitemapindex":
|
||||||
|
for child in [p for u in found[:10] if (p := ctx.site.to_path(u))]:
|
||||||
|
locs += _read_sitemap(ctx, child, problems)[1]
|
||||||
|
else:
|
||||||
|
locs += found
|
||||||
|
if locs and not ctx.live and ctx.site.origin.endswith("dist.invalid"):
|
||||||
|
parts = urlsplit(locs[0])
|
||||||
|
ctx.site.origin = f"{parts.scheme}://{parts.netloc}"
|
||||||
|
pages = [p for loc in locs if (p := ctx.site.to_path(loc))]
|
||||||
|
if len(pages) < len(locs):
|
||||||
|
problems.append(
|
||||||
|
f"{len(locs) - len(pages)} <loc> URLs are not on {ctx.site.origin}"
|
||||||
|
)
|
||||||
|
if not locs and not problems:
|
||||||
|
problems.append("sitemap has no <loc> entries")
|
||||||
|
ctx.sitemap_pages = list(dict.fromkeys(pages))
|
||||||
|
ctx.report.verdict(
|
||||||
|
"AR-FIND-03", problems, f"sitemap lists {len(ctx.sitemap_pages)} pages"
|
||||||
|
)
|
||||||
|
|
||||||
|
|
||||||
|
def check_catalog(ctx: Ctx) -> None:
|
||||||
|
"""AR-FIND-04: valid AI Catalog, lists llms.txt, linked from homepage head."""
|
||||||
|
resp = ctx.site.get(CATALOG)
|
||||||
|
problems: list[str] = []
|
||||||
|
if resp.status != 200:
|
||||||
|
problems.append(f"{CATALOG}: HTTP {resp.status}")
|
||||||
|
else:
|
||||||
|
problems += ctx.type_problem(
|
||||||
|
resp, ("application/ai-catalog+json", "application/json"), CATALOG
|
||||||
|
)
|
||||||
|
try:
|
||||||
|
doc = json.loads(resp.body)
|
||||||
|
except ValueError:
|
||||||
|
doc = None
|
||||||
|
problems.append(f"{CATALOG} is not JSON")
|
||||||
|
if doc is not None:
|
||||||
|
problems += formats.catalog_problems(doc)
|
||||||
|
listed = {ctx.site.to_path(u) for u in formats.catalog_urls(doc)}
|
||||||
|
if ctx.exists(LLMS) and LLMS not in listed:
|
||||||
|
problems.append("catalog has no entry for /llms.txt")
|
||||||
|
ctx.report.verdict("AR-FIND-04", problems, f"{CATALOG} is a valid AI Catalog")
|
||||||
|
home, scan = ctx.home()
|
||||||
|
href = scan.link_href("ai-catalog")
|
||||||
|
ok = href is not None and ctx.site.to_path(href) == CATALOG
|
||||||
|
ctx.report.verdict(
|
||||||
|
"AR-FIND-04",
|
||||||
|
[]
|
||||||
|
if ok
|
||||||
|
else [
|
||||||
|
'homepage head lacks <link rel="ai-catalog" href="/.well-known/ai-catalog.json">'
|
||||||
|
],
|
||||||
|
"homepage head links the catalog",
|
||||||
|
)
|
||||||
|
if not ctx.live:
|
||||||
|
ctx.report.skip(
|
||||||
|
"AR-FIND-04", "HTTP Link header can only be checked in url mode"
|
||||||
|
)
|
||||||
|
return
|
||||||
|
header = link_header_href(home, "ai-catalog")
|
||||||
|
ok = header is not None and ctx.site.to_path(header) == CATALOG
|
||||||
|
ctx.report.verdict(
|
||||||
|
"AR-FIND-04",
|
||||||
|
[]
|
||||||
|
if ok
|
||||||
|
else [
|
||||||
|
'homepage response lacks HTTP header Link: <...ai-catalog.json>; rel="ai-catalog"'
|
||||||
|
],
|
||||||
|
"homepage sends the ai-catalog Link header",
|
||||||
|
)
|
||||||
212
agent_ready/checks_read.py
Normal file
212
agent_ready/checks_read.py
Normal file
@ -0,0 +1,212 @@
|
|||||||
|
"""Read stage: AR-READ-01..09 and 11 (AR-READ-10 is retired in spec v2.0)."""
|
||||||
|
|
||||||
|
from __future__ import annotations
|
||||||
|
|
||||||
|
import secrets
|
||||||
|
|
||||||
|
from agent_ready import formats
|
||||||
|
from agent_ready.context import CATALOG, HOME, LLMS, TEXT_TYPES, Ctx, link_header_href
|
||||||
|
from agent_ready.htmlscan import scan
|
||||||
|
from agent_ready.report import summarize
|
||||||
|
|
||||||
|
|
||||||
|
def _pages(ctx: Ctx) -> list[str]:
|
||||||
|
"""Homepage plus sitemap pages, capped. An empty sitemap is a READ-01 FAIL."""
|
||||||
|
if not ctx.sitemap_pages:
|
||||||
|
ctx.report.fail(
|
||||||
|
"AR-READ-01", "sitemap yielded no pages; only the homepage was checked"
|
||||||
|
)
|
||||||
|
every = list(dict.fromkeys([HOME, *ctx.sitemap_pages]))
|
||||||
|
pages = ctx.cap(every)
|
||||||
|
if len(pages) < len(every):
|
||||||
|
ctx.report.skip(
|
||||||
|
"AR-READ-01",
|
||||||
|
f"checked {len(pages)} of {len(every)} pages (--max-pages); rest unchecked",
|
||||||
|
)
|
||||||
|
ctx.site.prefetch(pages)
|
||||||
|
return pages
|
||||||
|
|
||||||
|
|
||||||
|
def _mirror_href(ctx: Ctx, path: str) -> str | None:
|
||||||
|
"""Markdown mirror advertised by <link rel=alternate type=text/markdown> or Link header."""
|
||||||
|
resp, page = ctx.page(path)
|
||||||
|
href = page.link_href("alternate", "text/markdown")
|
||||||
|
if href is None and ctx.live:
|
||||||
|
href = link_header_href(resp, "alternate", "text/markdown")
|
||||||
|
return href
|
||||||
|
|
||||||
|
|
||||||
|
def check_pages(ctx: Ctx) -> None:
|
||||||
|
"""AR-READ-01 text in initial HTML, AR-READ-05 tagged code, AR-READ-09 mirrors."""
|
||||||
|
pages = _pages(ctx)
|
||||||
|
home, _ = ctx.home()
|
||||||
|
no_text: list[str] = []
|
||||||
|
untagged: list[str] = []
|
||||||
|
blocks = 0
|
||||||
|
for path in pages:
|
||||||
|
resp, page = ctx.page(path)
|
||||||
|
if resp.status != 200:
|
||||||
|
no_text.append(f"{path} (HTTP {resp.status})")
|
||||||
|
continue
|
||||||
|
if ctx.type_problem(resp, ("text/html",), path):
|
||||||
|
no_text.append(f"{path} ({resp.ctype or 'no content-type'})")
|
||||||
|
elif path != HOME and resp.body == home.body:
|
||||||
|
no_text.append(f"{path} (byte-identical to the homepage shell)")
|
||||||
|
elif len(page.text) < ctx.min_text:
|
||||||
|
no_text.append(f"{path} ({len(page.text)} chars of text < {ctx.min_text})")
|
||||||
|
blocks += page.code_blocks
|
||||||
|
if page.untagged_code:
|
||||||
|
untagged.append(f"{path} ({page.untagged_code} untagged <pre><code>)")
|
||||||
|
ctx.report.verdict(
|
||||||
|
"AR-READ-01",
|
||||||
|
["answer not in initial HTML: " + summarize(no_text)] if no_text else [],
|
||||||
|
f"{len(pages)} pages carry >= {ctx.min_text} chars of text without JS",
|
||||||
|
)
|
||||||
|
md_untagged = _check_mirrors(ctx, pages)
|
||||||
|
untagged += md_untagged
|
||||||
|
ctx.report.verdict(
|
||||||
|
"AR-READ-05",
|
||||||
|
["code without a language tag: " + summarize(untagged)] if untagged else [],
|
||||||
|
f"{blocks} HTML code blocks (plus mirror fences) all language-tagged",
|
||||||
|
)
|
||||||
|
|
||||||
|
|
||||||
|
def _check_mirrors(ctx: Ctx, pages: list[str]) -> list[str]:
|
||||||
|
"""AR-READ-09 for every page; returns mirrors with untagged fences (READ-05)."""
|
||||||
|
bad: list[str] = []
|
||||||
|
untagged: list[str] = []
|
||||||
|
targets: dict[str, str] = {}
|
||||||
|
for path in pages:
|
||||||
|
if ctx.site.get(path).status != 200:
|
||||||
|
continue
|
||||||
|
href = _mirror_href(ctx, path)
|
||||||
|
target = ctx.site.to_path(href, path) if href else None
|
||||||
|
if target is None:
|
||||||
|
bad.append(f"{path} (no text/markdown alternate link)")
|
||||||
|
else:
|
||||||
|
targets[path] = target
|
||||||
|
ctx.site.prefetch(list(targets.values()))
|
||||||
|
for path, target in targets.items():
|
||||||
|
resp = ctx.site.get(target)
|
||||||
|
if resp.status != 200:
|
||||||
|
bad.append(f"{target} (HTTP {resp.status})")
|
||||||
|
elif (
|
||||||
|
ctx.type_problem(resp, TEXT_TYPES, target)
|
||||||
|
or formats.looks_like_html(resp.text)
|
||||||
|
or not resp.text.strip()
|
||||||
|
):
|
||||||
|
bad.append(f"{target} (not markdown: {resp.ctype or 'empty'})")
|
||||||
|
elif n := formats.untagged_fences(resp.text):
|
||||||
|
untagged.append(f"{target} ({n} untagged fences)")
|
||||||
|
ctx.report.verdict(
|
||||||
|
"AR-READ-09",
|
||||||
|
["markdown mirror missing/broken: " + summarize(bad)] if bad else [],
|
||||||
|
f"{len(targets)} pages advertise a working markdown mirror",
|
||||||
|
)
|
||||||
|
return untagged
|
||||||
|
|
||||||
|
|
||||||
|
def check_status_codes(ctx: Ctx) -> None:
|
||||||
|
"""AR-READ-02: unknown paths are a real 404 (url) / a 404.html exists (dist)."""
|
||||||
|
if not ctx.live:
|
||||||
|
resp = ctx.site.get(f"/agentready-probe-{secrets.token_hex(6)}")
|
||||||
|
text = scan(resp.text).text if resp.body else ""
|
||||||
|
ok = resp.status == 404 and len(text) >= 10
|
||||||
|
ctx.report.verdict(
|
||||||
|
"AR-READ-02",
|
||||||
|
[] if ok else ["no 404.html with real text in the build output"],
|
||||||
|
"404.html exists for unknown paths",
|
||||||
|
)
|
||||||
|
return
|
||||||
|
token = secrets.token_hex(6)
|
||||||
|
probes = [f"/agentready-probe-{token}", f"/agentready-probe-{token}/page.html"]
|
||||||
|
ctx.site.prefetch(probes)
|
||||||
|
bad = [
|
||||||
|
f"{p} -> HTTP {s}"
|
||||||
|
for p in probes
|
||||||
|
if (s := ctx.site.get(p).status) not in (404, 410)
|
||||||
|
]
|
||||||
|
ctx.report.verdict(
|
||||||
|
"AR-READ-02",
|
||||||
|
["soft 404, unknown paths must return 404: " + ", ".join(bad)] if bad else [],
|
||||||
|
"unknown paths return 404",
|
||||||
|
)
|
||||||
|
|
||||||
|
|
||||||
|
def check_homepage(ctx: Ctx) -> None:
|
||||||
|
"""AR-READ-03 real links on the homepage, AR-READ-08 JSON-LD on it."""
|
||||||
|
resp, page = ctx.home()
|
||||||
|
links = {
|
||||||
|
p
|
||||||
|
for a in page.anchors
|
||||||
|
if not a.startswith(("#", "javascript:", "mailto:"))
|
||||||
|
and (p := ctx.site.to_path(a))
|
||||||
|
and p != HOME
|
||||||
|
}
|
||||||
|
ok = resp.status == 200 and bool(links)
|
||||||
|
ctx.report.verdict(
|
||||||
|
"AR-READ-03",
|
||||||
|
[] if ok else ["homepage HTML has no <a href> links to other pages"],
|
||||||
|
f"homepage links {len(links)} pages in raw HTML",
|
||||||
|
)
|
||||||
|
problems = []
|
||||||
|
if not page.jsonld_ok:
|
||||||
|
problems.append(
|
||||||
|
'homepage has no <script type="application/ld+json"> with @context'
|
||||||
|
)
|
||||||
|
if page.jsonld_bad:
|
||||||
|
problems.append(
|
||||||
|
f"{page.jsonld_bad} JSON-LD blocks fail to parse or lack @context"
|
||||||
|
)
|
||||||
|
ctx.report.verdict(
|
||||||
|
"AR-READ-08", problems, f"homepage carries {page.jsonld_ok} JSON-LD blocks"
|
||||||
|
)
|
||||||
|
|
||||||
|
|
||||||
|
def check_discovery_links(ctx: Ctx) -> None:
|
||||||
|
"""AR-READ-06: discovery files are linked from the homepage."""
|
||||||
|
_, page = ctx.home()
|
||||||
|
linked = {
|
||||||
|
ctx.site.to_path(h)
|
||||||
|
for h in [*page.anchors, *(href for _, _, href in page.links)]
|
||||||
|
}
|
||||||
|
files = [LLMS, CATALOG] + (["/openapi.json"] if ctx.act else [])
|
||||||
|
for path in files:
|
||||||
|
problems = []
|
||||||
|
if not ctx.exists(path):
|
||||||
|
problems.append(f"{path} does not exist")
|
||||||
|
if path not in linked:
|
||||||
|
problems.append(f"{path} is not linked from the homepage (<link> or <a>)")
|
||||||
|
ctx.report.verdict(
|
||||||
|
"AR-READ-06", problems, f"{path} exists and is linked from the homepage"
|
||||||
|
)
|
||||||
|
|
||||||
|
|
||||||
|
def check_llms(ctx: Ctx) -> None:
|
||||||
|
"""AR-READ-07: llms.txt in the spec shape, every on-site link resolving."""
|
||||||
|
resp = ctx.site.get(LLMS)
|
||||||
|
if resp.status != 200:
|
||||||
|
ctx.report.fail("AR-READ-07", f"{LLMS}: HTTP {resp.status}")
|
||||||
|
return
|
||||||
|
problems = ctx.type_problem(resp, TEXT_TYPES, LLMS) + formats.llms_problems(
|
||||||
|
resp.text
|
||||||
|
)
|
||||||
|
if not formats.looks_like_html(resp.text):
|
||||||
|
paths = [
|
||||||
|
p for u in formats.llms_links(resp.text) if (p := ctx.site.to_path(u, LLMS))
|
||||||
|
]
|
||||||
|
paths = ctx.cap(paths)
|
||||||
|
ctx.site.prefetch(paths)
|
||||||
|
broken = [p for p in paths if ctx.site.get(p).status != 200]
|
||||||
|
if broken:
|
||||||
|
problems.append("broken links: " + summarize(broken))
|
||||||
|
ctx.report.verdict("AR-READ-07", problems, f"{LLMS} has H1, summary and link lists")
|
||||||
|
|
||||||
|
|
||||||
|
def skip_manual(ctx: Ctx) -> None:
|
||||||
|
"""Items with no mechanical check (reported, never silently dropped)."""
|
||||||
|
ctx.report.skip(
|
||||||
|
"AR-FIND-02", "first-party docs page answering user questions: manual review"
|
||||||
|
)
|
||||||
|
ctx.report.skip("AR-READ-04", "docs pages answer users' tasks: manual review")
|
||||||
|
ctx.report.skip("AR-READ-11", "pricing page: n/a for sites without paid plans")
|
||||||
85
agent_ready/context.py
Normal file
85
agent_ready/context.py
Normal file
@ -0,0 +1,85 @@
|
|||||||
|
"""Shared state for one checker run (site, report, options, discoveries)."""
|
||||||
|
|
||||||
|
from __future__ import annotations
|
||||||
|
|
||||||
|
import re
|
||||||
|
from dataclasses import dataclass, field
|
||||||
|
|
||||||
|
from agent_ready.backends import Response, Site
|
||||||
|
from agent_ready.formats import looks_like_html
|
||||||
|
from agent_ready.htmlscan import PageScan, scan
|
||||||
|
from agent_ready.report import Report
|
||||||
|
|
||||||
|
HOME = "/"
|
||||||
|
LLMS = "/llms.txt"
|
||||||
|
CATALOG = "/.well-known/ai-catalog.json"
|
||||||
|
TEXT_TYPES = ("text/plain", "text/markdown")
|
||||||
|
|
||||||
|
|
||||||
|
@dataclass
|
||||||
|
class Ctx:
|
||||||
|
"""Everything a check needs; filled in as checks discover the site."""
|
||||||
|
|
||||||
|
site: Site
|
||||||
|
report: Report
|
||||||
|
min_text: int = 100
|
||||||
|
max_pages: int = 40
|
||||||
|
act: bool = False
|
||||||
|
robots_text: str | None = None
|
||||||
|
sitemap_pages: list[str] = field(default_factory=list)
|
||||||
|
_scans: dict[str, PageScan] = field(default_factory=dict)
|
||||||
|
|
||||||
|
@property
|
||||||
|
def live(self) -> bool:
|
||||||
|
"""True in url mode (headers and content types are real)."""
|
||||||
|
return self.site.live
|
||||||
|
|
||||||
|
def cap(self, items: list[str]) -> list[str]:
|
||||||
|
"""Apply --max-pages in url mode only; dist mode is free, so check everything."""
|
||||||
|
return items[: self.max_pages] if self.live else items
|
||||||
|
|
||||||
|
def page(self, path: str) -> tuple[Response, PageScan]:
|
||||||
|
"""Fetch and scan an HTML page (scan memoized)."""
|
||||||
|
resp = self.site.get(path)
|
||||||
|
if path not in self._scans:
|
||||||
|
self._scans[path] = scan(resp.text) if resp.status == 200 else PageScan()
|
||||||
|
return resp, self._scans[path]
|
||||||
|
|
||||||
|
def home(self) -> tuple[Response, PageScan]:
|
||||||
|
"""The homepage and its scan."""
|
||||||
|
return self.page(HOME)
|
||||||
|
|
||||||
|
def type_problem(
|
||||||
|
self, resp: Response, allowed: tuple[str, ...], what: str
|
||||||
|
) -> list[str]:
|
||||||
|
"""Content-type problem for live responses (dist mode has none)."""
|
||||||
|
if (
|
||||||
|
not self.live
|
||||||
|
or resp.ctype in allowed
|
||||||
|
or any(a.endswith("+xml") and resp.ctype.endswith("+xml") for a in allowed)
|
||||||
|
):
|
||||||
|
return []
|
||||||
|
return [
|
||||||
|
f"{what} served as {resp.ctype or 'no content-type'}, want {' or '.join(allowed)}"
|
||||||
|
]
|
||||||
|
|
||||||
|
def exists(self, path: str) -> bool:
|
||||||
|
"""True when ``path`` is 200 and, for a non-page file, not an HTML fallback."""
|
||||||
|
resp = self.site.get(path)
|
||||||
|
is_page = path.endswith(("/", ".html"))
|
||||||
|
return resp.status == 200 and (is_page or not looks_like_html(resp.text))
|
||||||
|
|
||||||
|
|
||||||
|
def link_header_href(resp: Response, rel: str, mime: str | None = None) -> str | None:
|
||||||
|
"""href of the first RFC 8288 ``Link`` header value with ``rel`` (and type)."""
|
||||||
|
for part in re.split(r",\s*(?=<)", resp.headers.get("link", "")):
|
||||||
|
match = re.match(r"\s*<([^>]*)>(.*)", part)
|
||||||
|
if not match:
|
||||||
|
continue
|
||||||
|
params = match.group(2).lower()
|
||||||
|
rels = re.search(r'rel="?([^";]+)"?', params)
|
||||||
|
if not rels or rel not in rels.group(1).split():
|
||||||
|
continue
|
||||||
|
if mime is None or re.search(rf'type="?{re.escape(mime)}"?', params):
|
||||||
|
return match.group(1)
|
||||||
|
return None
|
||||||
213
agent_ready/formats.py
Normal file
213
agent_ready/formats.py
Normal file
@ -0,0 +1,213 @@
|
|||||||
|
"""Validators for the file formats AgentReady points at.
|
||||||
|
|
||||||
|
robots.txt (RFC 9309), sitemap.xml (sitemaps.org), llms.txt (agentready
|
||||||
|
spec "llms.txt shape" / llmstxt.org) and the AI Catalog
|
||||||
|
(github.com/Agent-Card/ai-catalog, specification/ai-catalog.md).
|
||||||
|
"""
|
||||||
|
|
||||||
|
from __future__ import annotations
|
||||||
|
|
||||||
|
import re
|
||||||
|
import xml.etree.ElementTree as ET
|
||||||
|
from dataclasses import dataclass, field
|
||||||
|
|
||||||
|
_LINK_ITEM = re.compile(r"^\s*[-*]\s+\[[^\]]+\]\(([^)\s]+)\)")
|
||||||
|
_FENCE = re.compile(r"^\s{0,3}(```+|~~~+)\s*(\S*)")
|
||||||
|
_SPEC_VERSION = re.compile(r"^\d+\.\d+$")
|
||||||
|
|
||||||
|
|
||||||
|
def looks_like_html(text: str) -> bool:
|
||||||
|
"""True when a supposedly plain-text/XML/JSON body is an HTML page."""
|
||||||
|
head = text.lstrip()[:200].lower()
|
||||||
|
return head.startswith(("<!doctype html", "<html")) or "<head" in head
|
||||||
|
|
||||||
|
|
||||||
|
# --------------------------------------------------------------- robots.txt
|
||||||
|
@dataclass
|
||||||
|
class RobotsGroup:
|
||||||
|
"""One ``User-agent`` group and its rules, in file order."""
|
||||||
|
|
||||||
|
agents: list[str] = field(default_factory=list)
|
||||||
|
rules: list[tuple[str, str]] = field(default_factory=list)
|
||||||
|
|
||||||
|
|
||||||
|
def parse_robots(text: str) -> list[RobotsGroup]:
|
||||||
|
"""Parse robots.txt into groups (consecutive User-agent lines share one)."""
|
||||||
|
groups: list[RobotsGroup] = []
|
||||||
|
current: RobotsGroup | None = None
|
||||||
|
for raw in text.splitlines():
|
||||||
|
line = raw.split("#", 1)[0].strip()
|
||||||
|
if ":" not in line:
|
||||||
|
continue
|
||||||
|
key, value = (part.strip() for part in line.split(":", 1))
|
||||||
|
key = key.lower()
|
||||||
|
if key == "user-agent":
|
||||||
|
if current is None or current.rules:
|
||||||
|
current = RobotsGroup()
|
||||||
|
groups.append(current)
|
||||||
|
current.agents.append(value.lower())
|
||||||
|
elif key in ("allow", "disallow") and current is not None:
|
||||||
|
current.rules.append((key, value))
|
||||||
|
return groups
|
||||||
|
|
||||||
|
|
||||||
|
def has_wildcard_group(groups: list[RobotsGroup]) -> bool:
|
||||||
|
"""True when a ``User-agent: *`` group exists (one rule for all agents)."""
|
||||||
|
return any("*" in g.agents for g in groups)
|
||||||
|
|
||||||
|
|
||||||
|
def blocked_agents(groups: list[RobotsGroup]) -> list[str]:
|
||||||
|
"""Agents whose group disallows the whole site (``/`` or ``/*``).
|
||||||
|
|
||||||
|
An empty ``Disallow:`` allows everything; an ``Allow: /`` in the same
|
||||||
|
group wins over the blanket disallow (longest-match tie goes to allow).
|
||||||
|
"""
|
||||||
|
blocked: list[str] = []
|
||||||
|
for group in groups:
|
||||||
|
disallow_all = any(k == "disallow" and v in ("/", "/*") for k, v in group.rules)
|
||||||
|
allow_all = any(k == "allow" and v in ("/", "/*") for k, v in group.rules)
|
||||||
|
if disallow_all and not allow_all:
|
||||||
|
blocked.extend(group.agents)
|
||||||
|
return blocked
|
||||||
|
|
||||||
|
|
||||||
|
def robots_sitemaps(text: str) -> list[str]:
|
||||||
|
"""Return every ``Sitemap:`` URL."""
|
||||||
|
out = []
|
||||||
|
for raw in text.splitlines():
|
||||||
|
key, _, value = raw.partition(":")
|
||||||
|
if key.strip().lower() == "sitemap" and value.strip():
|
||||||
|
out.append(value.strip())
|
||||||
|
return out
|
||||||
|
|
||||||
|
|
||||||
|
# -------------------------------------------------------------- sitemap.xml
|
||||||
|
def parse_sitemap(body: bytes) -> tuple[str, list[str]]:
|
||||||
|
"""Return (root kind ``urlset``/``sitemapindex``, list of <loc> values).
|
||||||
|
|
||||||
|
Raises ValueError for anything that is not a sitemap document.
|
||||||
|
"""
|
||||||
|
try:
|
||||||
|
root = ET.fromstring(body)
|
||||||
|
except ET.ParseError as exc:
|
||||||
|
raise ValueError(f"not XML: {exc}") from exc
|
||||||
|
kind = root.tag.rsplit("}", 1)[-1]
|
||||||
|
if kind not in ("urlset", "sitemapindex"):
|
||||||
|
raise ValueError(f"root element <{kind}> is not <urlset>/<sitemapindex>")
|
||||||
|
locs = [
|
||||||
|
(el.text or "").strip()
|
||||||
|
for el in root.iter()
|
||||||
|
if el.tag.rsplit("}", 1)[-1] == "loc"
|
||||||
|
]
|
||||||
|
return kind, [loc for loc in locs if loc]
|
||||||
|
|
||||||
|
|
||||||
|
# ----------------------------------------------------------------- llms.txt
|
||||||
|
def llms_problems(text: str) -> list[str]:
|
||||||
|
"""Check llms.txt shape: H1 first, blockquote summary, H2 link lists."""
|
||||||
|
if looks_like_html(text):
|
||||||
|
return ["body is an HTML page, not llms.txt markdown"]
|
||||||
|
lines = [ln for ln in text.splitlines() if ln.strip()]
|
||||||
|
problems = []
|
||||||
|
if not lines or not re.match(r"^# \S", lines[0]):
|
||||||
|
problems.append("first line must be an H1 title ('# Name')")
|
||||||
|
if not any(ln.startswith(">") for ln in lines[:4]):
|
||||||
|
problems.append("missing blockquote summary ('> ...') after the H1")
|
||||||
|
in_h2 = False
|
||||||
|
links = 0
|
||||||
|
for ln in lines:
|
||||||
|
if ln.startswith("## "):
|
||||||
|
in_h2 = True
|
||||||
|
elif in_h2 and _LINK_ITEM.match(ln):
|
||||||
|
links += 1
|
||||||
|
if links == 0:
|
||||||
|
problems.append("no '## Section' with a '- [name](url): notes' link list")
|
||||||
|
return problems
|
||||||
|
|
||||||
|
|
||||||
|
def llms_links(text: str) -> list[str]:
|
||||||
|
"""Return every link-list URL in llms.txt, in order."""
|
||||||
|
return [m.group(1) for ln in text.splitlines() if (m := _LINK_ITEM.match(ln))]
|
||||||
|
|
||||||
|
|
||||||
|
# --------------------------------------------------------------- ai-catalog
|
||||||
|
def catalog_problems(doc: object) -> list[str]:
|
||||||
|
"""Validate an AI Catalog (Level 1 + Host Info if present)."""
|
||||||
|
if not isinstance(doc, dict):
|
||||||
|
return ["top level must be a JSON object"]
|
||||||
|
problems = []
|
||||||
|
version = doc.get("specVersion")
|
||||||
|
if not isinstance(version, str):
|
||||||
|
problems.append("missing string specVersion")
|
||||||
|
elif not _SPEC_VERSION.match(version):
|
||||||
|
problems.append(f"specVersion {version!r} is not 'Major.Minor'")
|
||||||
|
host = doc.get("host")
|
||||||
|
if host is not None and not (
|
||||||
|
isinstance(host, dict) and isinstance(host.get("displayName"), str)
|
||||||
|
):
|
||||||
|
problems.append("host.displayName (string) is required when host is present")
|
||||||
|
entries = doc.get("entries")
|
||||||
|
if not isinstance(entries, list):
|
||||||
|
return [*problems, "missing entries array"]
|
||||||
|
for i, entry in enumerate(entries):
|
||||||
|
problems.extend(f"entries[{i}]: {p}" for p in _entry_problems(entry))
|
||||||
|
return problems
|
||||||
|
|
||||||
|
|
||||||
|
def _entry_problems(entry: object) -> list[str]:
|
||||||
|
"""Problems with one Catalog Entry."""
|
||||||
|
if not isinstance(entry, dict):
|
||||||
|
return ["must be an object"]
|
||||||
|
problems = [
|
||||||
|
f"missing string {k}"
|
||||||
|
for k in ("identifier", "type")
|
||||||
|
if not isinstance(entry.get(k), str)
|
||||||
|
]
|
||||||
|
if ("url" in entry) == ("data" in entry):
|
||||||
|
problems.append("must carry exactly one of url/data")
|
||||||
|
return problems
|
||||||
|
|
||||||
|
|
||||||
|
def catalog_urls(doc: object) -> list[str]:
|
||||||
|
"""Every entry ``url`` in a catalog (empty for invalid docs)."""
|
||||||
|
if not isinstance(doc, dict) or not isinstance(doc.get("entries"), list):
|
||||||
|
return []
|
||||||
|
return [
|
||||||
|
e["url"]
|
||||||
|
for e in doc["entries"]
|
||||||
|
if isinstance(e, dict) and isinstance(e.get("url"), str)
|
||||||
|
]
|
||||||
|
|
||||||
|
|
||||||
|
def catalog_types(doc: object) -> list[str]:
|
||||||
|
"""Every entry ``type`` in a catalog."""
|
||||||
|
if not isinstance(doc, dict) or not isinstance(doc.get("entries"), list):
|
||||||
|
return []
|
||||||
|
return [
|
||||||
|
e["type"]
|
||||||
|
for e in doc["entries"]
|
||||||
|
if isinstance(e, dict) and isinstance(e.get("type"), str)
|
||||||
|
]
|
||||||
|
|
||||||
|
|
||||||
|
# ----------------------------------------------------------------- markdown
|
||||||
|
def untagged_fences(text: str) -> int:
|
||||||
|
"""Count opening code fences with no language info string."""
|
||||||
|
count = 0
|
||||||
|
open_fence = ""
|
||||||
|
for line in text.splitlines():
|
||||||
|
match = _FENCE.match(line)
|
||||||
|
if not match:
|
||||||
|
continue
|
||||||
|
marker, info = match.groups()
|
||||||
|
if open_fence:
|
||||||
|
if (
|
||||||
|
marker[0] == open_fence[0]
|
||||||
|
and len(marker) >= len(open_fence)
|
||||||
|
and not info
|
||||||
|
):
|
||||||
|
open_fence = ""
|
||||||
|
continue
|
||||||
|
open_fence = marker
|
||||||
|
count += not info
|
||||||
|
return count
|
||||||
121
agent_ready/htmlscan.py
Normal file
121
agent_ready/htmlscan.py
Normal file
@ -0,0 +1,121 @@
|
|||||||
|
"""One-pass HTML scan: visible body text, links, JSON-LD and code blocks."""
|
||||||
|
|
||||||
|
from __future__ import annotations
|
||||||
|
|
||||||
|
import json
|
||||||
|
import re
|
||||||
|
from dataclasses import dataclass, field
|
||||||
|
from html.parser import HTMLParser
|
||||||
|
|
||||||
|
_HIDDEN = {"script", "style", "noscript", "template", "svg", "head", "title"}
|
||||||
|
_LANG = re.compile(r"\b(language|lang)-\S+")
|
||||||
|
|
||||||
|
|
||||||
|
@dataclass
|
||||||
|
class PageScan:
|
||||||
|
"""What an agent that does not run JavaScript sees in a page."""
|
||||||
|
|
||||||
|
text: str = ""
|
||||||
|
links: list[tuple[set[str], str, str]] = field(default_factory=list)
|
||||||
|
anchors: list[str] = field(default_factory=list)
|
||||||
|
scripts: list[str] = field(default_factory=list)
|
||||||
|
jsonld_ok: int = 0
|
||||||
|
jsonld_bad: int = 0
|
||||||
|
code_blocks: int = 0
|
||||||
|
untagged_code: int = 0
|
||||||
|
|
||||||
|
def link_href(self, rel: str, mime: str | None = None) -> str | None:
|
||||||
|
"""First ``<link>`` href with ``rel`` (and ``type`` if given)."""
|
||||||
|
for rels, typ, href in self.links:
|
||||||
|
if rel in rels and (mime is None or typ == mime):
|
||||||
|
return href
|
||||||
|
return None
|
||||||
|
|
||||||
|
|
||||||
|
def _tagged(attrs: dict[str, str]) -> bool:
|
||||||
|
"""True when an element carries a code-language marker."""
|
||||||
|
return bool(_LANG.search(attrs.get("class", ""))) or bool(
|
||||||
|
attrs.get("data-language") or attrs.get("data-lang")
|
||||||
|
)
|
||||||
|
|
||||||
|
|
||||||
|
class _Scanner(HTMLParser):
|
||||||
|
def __init__(self) -> None:
|
||||||
|
super().__init__(convert_charrefs=True)
|
||||||
|
self.out = PageScan()
|
||||||
|
self._hidden: list[str] = []
|
||||||
|
self._text: list[str] = []
|
||||||
|
self._pre: list[list[bool]] = [] # [pre_tagged, code_seen]
|
||||||
|
self._ld: list[str] | None = None
|
||||||
|
|
||||||
|
def handle_starttag(
|
||||||
|
self, tag: str, attr_list: list[tuple[str, str | None]]
|
||||||
|
) -> None:
|
||||||
|
attrs = {k: v or "" for k, v in attr_list}
|
||||||
|
if tag == "body": # </head> is optional in HTML; <body> always ends it
|
||||||
|
self._hidden = [h for h in self._hidden if h not in ("head", "title")]
|
||||||
|
if tag == "link" and attrs.get("href"):
|
||||||
|
rels = set(attrs.get("rel", "").lower().split())
|
||||||
|
self.out.links.append((rels, attrs.get("type", "").lower(), attrs["href"]))
|
||||||
|
elif tag == "a" and attrs.get("href"):
|
||||||
|
self.out.anchors.append(attrs["href"])
|
||||||
|
elif tag == "script":
|
||||||
|
if attrs.get("src"):
|
||||||
|
self.out.scripts.append(attrs["src"])
|
||||||
|
if attrs.get("type", "").lower() == "application/ld+json":
|
||||||
|
self._ld = []
|
||||||
|
elif tag == "pre":
|
||||||
|
self._pre.append([_tagged(attrs), False])
|
||||||
|
elif tag == "code" and self._pre and not self._pre[-1][1]:
|
||||||
|
self._pre[-1][1] = True
|
||||||
|
self.out.code_blocks += 1
|
||||||
|
self.out.untagged_code += not (self._pre[-1][0] or _tagged(attrs))
|
||||||
|
if tag in _HIDDEN:
|
||||||
|
self._hidden.append(tag)
|
||||||
|
|
||||||
|
def handle_endtag(self, tag: str) -> None:
|
||||||
|
if tag == "script" and self._ld is not None:
|
||||||
|
self._finish_ld("".join(self._ld))
|
||||||
|
self._ld = None
|
||||||
|
if tag == "pre" and self._pre:
|
||||||
|
self._pre.pop()
|
||||||
|
if tag in _HIDDEN and tag in self._hidden:
|
||||||
|
while self._hidden and self._hidden.pop() != tag:
|
||||||
|
pass
|
||||||
|
|
||||||
|
def handle_data(self, data: str) -> None:
|
||||||
|
if self._ld is not None:
|
||||||
|
self._ld.append(data)
|
||||||
|
elif not self._hidden:
|
||||||
|
self._text.append(data)
|
||||||
|
|
||||||
|
def _finish_ld(self, raw: str) -> None:
|
||||||
|
try:
|
||||||
|
doc = json.loads(raw)
|
||||||
|
except ValueError:
|
||||||
|
self.out.jsonld_bad += 1
|
||||||
|
return
|
||||||
|
nodes = doc if isinstance(doc, list) else [doc]
|
||||||
|
ok = (
|
||||||
|
all(
|
||||||
|
isinstance(n, dict) and ("@context" in n or "@graph" in n)
|
||||||
|
for n in nodes
|
||||||
|
)
|
||||||
|
and nodes
|
||||||
|
)
|
||||||
|
if ok:
|
||||||
|
self.out.jsonld_ok += 1
|
||||||
|
else:
|
||||||
|
self.out.jsonld_bad += 1
|
||||||
|
|
||||||
|
def result(self) -> PageScan:
|
||||||
|
self.out.text = re.sub(r"\s+", " ", " ".join(self._text)).strip()
|
||||||
|
return self.out
|
||||||
|
|
||||||
|
|
||||||
|
def scan(html: str) -> PageScan:
|
||||||
|
"""Scan an HTML document."""
|
||||||
|
parser = _Scanner()
|
||||||
|
parser.feed(html)
|
||||||
|
parser.close()
|
||||||
|
return parser.result()
|
||||||
73
agent_ready/report.py
Normal file
73
agent_ready/report.py
Normal file
@ -0,0 +1,73 @@
|
|||||||
|
"""Result lines (``PASS|FAIL|SKIP AR-XXX-NN msg``) and the exit-code policy."""
|
||||||
|
|
||||||
|
from __future__ import annotations
|
||||||
|
|
||||||
|
import sys
|
||||||
|
from collections.abc import Callable
|
||||||
|
from dataclasses import dataclass, field
|
||||||
|
from typing import TextIO
|
||||||
|
|
||||||
|
EXIT_OK, EXIT_FAIL, EXIT_USAGE, EXIT_NETWORK = 0, 1, 2, 3
|
||||||
|
|
||||||
|
|
||||||
|
class Undeterminable(Exception):
|
||||||
|
"""A network-level failure (refused, timeout, deadline): no verdict."""
|
||||||
|
|
||||||
|
|
||||||
|
@dataclass
|
||||||
|
class Report:
|
||||||
|
"""Collects check lines and decides the exit code.
|
||||||
|
|
||||||
|
Every in-scope item is required for kuhy's sites, so a FAIL of any
|
||||||
|
strength (MUST/SHOULD/MAY) fails the run. SKIP never fails it.
|
||||||
|
"""
|
||||||
|
|
||||||
|
out: TextIO = field(default_factory=lambda: sys.stdout)
|
||||||
|
fails: int = 0
|
||||||
|
undetermined: int = 0
|
||||||
|
|
||||||
|
def emit(self, status: str, ar_id: str, msg: str) -> None:
|
||||||
|
"""Print one result line."""
|
||||||
|
if status == "FAIL":
|
||||||
|
self.fails += 1
|
||||||
|
print(f"{status} {ar_id} {msg}", file=self.out, flush=True)
|
||||||
|
|
||||||
|
def ok(self, ar_id: str, msg: str) -> None:
|
||||||
|
"""Emit PASS."""
|
||||||
|
self.emit("PASS", ar_id, msg)
|
||||||
|
|
||||||
|
def fail(self, ar_id: str, msg: str) -> None:
|
||||||
|
"""Emit FAIL."""
|
||||||
|
self.emit("FAIL", ar_id, msg)
|
||||||
|
|
||||||
|
def skip(self, ar_id: str, msg: str) -> None:
|
||||||
|
"""Emit SKIP."""
|
||||||
|
self.emit("SKIP", ar_id, msg)
|
||||||
|
|
||||||
|
def verdict(self, ar_id: str, problems: list[str], pass_msg: str) -> bool:
|
||||||
|
"""FAIL with the problems joined, or PASS with ``pass_msg``."""
|
||||||
|
if problems:
|
||||||
|
self.fail(ar_id, "; ".join(problems))
|
||||||
|
return False
|
||||||
|
self.ok(ar_id, pass_msg)
|
||||||
|
return True
|
||||||
|
|
||||||
|
def guard(self, ar_id: str, fn: Callable[[], object]) -> None:
|
||||||
|
"""Run a check; a network failure becomes an undeterminable SKIP."""
|
||||||
|
try:
|
||||||
|
fn()
|
||||||
|
except Undeterminable as exc:
|
||||||
|
self.undetermined += 1
|
||||||
|
self.skip(ar_id, f"undeterminable (network): {exc}")
|
||||||
|
|
||||||
|
def exit_code(self) -> int:
|
||||||
|
"""0 all pass, 1 any fail, 3 nothing failed but something undeterminable."""
|
||||||
|
if self.fails:
|
||||||
|
return EXIT_FAIL
|
||||||
|
return EXIT_NETWORK if self.undetermined else EXIT_OK
|
||||||
|
|
||||||
|
|
||||||
|
def summarize(items: list[str], limit: int = 4) -> str:
|
||||||
|
"""Join up to ``limit`` items and note how many more there were."""
|
||||||
|
head = ", ".join(items[:limit])
|
||||||
|
return head + (f" (+{len(items) - limit} more)" if len(items) > limit else "")
|
||||||
0
agent_ready/tests/__init__.py
Normal file
0
agent_ready/tests/__init__.py
Normal file
136
agent_ready/tests/conftest.py
Normal file
136
agent_ready/tests/conftest.py
Normal file
@ -0,0 +1,136 @@
|
|||||||
|
"""Fixtures: generated site trees and loopback HTTP servers that serve them."""
|
||||||
|
|
||||||
|
from __future__ import annotations
|
||||||
|
|
||||||
|
import socket
|
||||||
|
import threading
|
||||||
|
from collections.abc import Callable, Iterator
|
||||||
|
from http.server import BaseHTTPRequestHandler, ThreadingHTTPServer
|
||||||
|
from pathlib import Path
|
||||||
|
|
||||||
|
import pytest
|
||||||
|
|
||||||
|
from agent_ready.tests import sitegen
|
||||||
|
|
||||||
|
_MIME = {
|
||||||
|
".html": "text/html; charset=utf-8",
|
||||||
|
".md": "text/markdown; charset=utf-8",
|
||||||
|
".txt": "text/plain; charset=utf-8",
|
||||||
|
".xml": "application/xml",
|
||||||
|
".json": "application/json",
|
||||||
|
}
|
||||||
|
|
||||||
|
|
||||||
|
def _resolve(root: Path, path: str) -> Path | None:
|
||||||
|
"""Map a URL path to a file the way a static host does."""
|
||||||
|
rel = path.split("?", 1)[0].lstrip("/")
|
||||||
|
cand = root / rel
|
||||||
|
if path.endswith("/"):
|
||||||
|
cand = cand / "index.html"
|
||||||
|
return cand if cand.is_file() else None
|
||||||
|
|
||||||
|
|
||||||
|
def make_handler(root: Path, mode: str, block_ua: str) -> type[BaseHTTPRequestHandler]:
|
||||||
|
"""Build a handler class.
|
||||||
|
|
||||||
|
``mode`` is ``good`` (real 404s), ``spa`` (200 index.html for every path,
|
||||||
|
the kuhy.duckdns.org trap) or ``json404`` (every non-root path is a JSON
|
||||||
|
404, the popes.kuhy.duckdns.org shape).
|
||||||
|
"""
|
||||||
|
|
||||||
|
class Handler(BaseHTTPRequestHandler):
|
||||||
|
def log_message(self, *args: object) -> None: # silence test output
|
||||||
|
return
|
||||||
|
|
||||||
|
def _send(
|
||||||
|
self,
|
||||||
|
status: int,
|
||||||
|
ctype: str,
|
||||||
|
body: bytes,
|
||||||
|
extra: dict[str, str] | None = None,
|
||||||
|
) -> None:
|
||||||
|
self.send_response(status)
|
||||||
|
self.send_header("Content-Type", ctype)
|
||||||
|
self.send_header("Content-Length", str(len(body)))
|
||||||
|
for key, value in (extra or {}).items():
|
||||||
|
self.send_header(key, value)
|
||||||
|
self.end_headers()
|
||||||
|
self.wfile.write(body)
|
||||||
|
|
||||||
|
def do_GET(self) -> None:
|
||||||
|
if block_ua and block_ua in self.headers.get("User-Agent", ""):
|
||||||
|
self._send(403, "text/html", b"<html>Just a moment...</html>")
|
||||||
|
return
|
||||||
|
origin = f"http://{self.headers['Host']}"
|
||||||
|
if mode == "spa" or (mode == "json404" and self.path == "/"):
|
||||||
|
body = (root / "index.html").read_bytes()
|
||||||
|
self._send(200, "text/html; charset=utf-8", body)
|
||||||
|
return
|
||||||
|
target = None if mode == "json404" else _resolve(root, self.path)
|
||||||
|
if target is None:
|
||||||
|
if mode == "json404":
|
||||||
|
self._send(404, "application/json", b'{"detail":"Not Found"}')
|
||||||
|
else:
|
||||||
|
self._send(404, "text/html", (root / "404.html").read_bytes())
|
||||||
|
return
|
||||||
|
if target.name == "ai-catalog.json":
|
||||||
|
ctype = "application/ai-catalog+json"
|
||||||
|
else:
|
||||||
|
ctype = _MIME.get(target.suffix, "application/octet-stream")
|
||||||
|
body = target.read_bytes().replace(sitegen.ORIGIN.encode(), origin.encode())
|
||||||
|
extra = {}
|
||||||
|
if self.path == "/":
|
||||||
|
extra["Link"] = '</.well-known/ai-catalog.json>; rel="ai-catalog"'
|
||||||
|
self._send(200, ctype, body, extra)
|
||||||
|
|
||||||
|
def do_POST(self) -> None:
|
||||||
|
"""Minimal MCP: answer initialize at /mcp in good mode only."""
|
||||||
|
self.rfile.read(int(self.headers.get("Content-Length", 0)))
|
||||||
|
if mode == "good" and self.path == "/mcp":
|
||||||
|
self._send(
|
||||||
|
200, "application/json", b'{"jsonrpc":"2.0","id":1,"result":{}}'
|
||||||
|
)
|
||||||
|
else:
|
||||||
|
self._send(200, "text/html", (root / "index.html").read_bytes())
|
||||||
|
|
||||||
|
return Handler
|
||||||
|
|
||||||
|
|
||||||
|
@pytest.fixture
|
||||||
|
def good_dir(tmp_path: Path) -> Path:
|
||||||
|
"""A compliant build output."""
|
||||||
|
return sitegen.build_good(tmp_path / "good")
|
||||||
|
|
||||||
|
|
||||||
|
@pytest.fixture
|
||||||
|
def bad_dir(tmp_path: Path) -> Path:
|
||||||
|
"""A build output failing every find/read item."""
|
||||||
|
return sitegen.build_bad(tmp_path / "bad")
|
||||||
|
|
||||||
|
|
||||||
|
@pytest.fixture
|
||||||
|
def serve() -> Iterator[Callable[..., str]]:
|
||||||
|
"""Start loopback servers on demand; return their base URL."""
|
||||||
|
servers: list[ThreadingHTTPServer] = []
|
||||||
|
|
||||||
|
def start(root: Path, mode: str = "good", block_ua: str = "") -> str:
|
||||||
|
server = ThreadingHTTPServer(
|
||||||
|
("127.0.0.1", 0), make_handler(root, mode, block_ua)
|
||||||
|
)
|
||||||
|
threading.Thread(target=server.serve_forever, daemon=True).start()
|
||||||
|
servers.append(server)
|
||||||
|
return f"http://127.0.0.1:{server.server_address[1]}"
|
||||||
|
|
||||||
|
yield start
|
||||||
|
for server in servers:
|
||||||
|
server.shutdown()
|
||||||
|
server.server_close()
|
||||||
|
|
||||||
|
|
||||||
|
@pytest.fixture
|
||||||
|
def dead_url() -> str:
|
||||||
|
"""A loopback URL with nothing listening (connection refused)."""
|
||||||
|
with socket.socket() as sock:
|
||||||
|
sock.bind(("127.0.0.1", 0))
|
||||||
|
port = sock.getsockname()[1]
|
||||||
|
return f"http://127.0.0.1:{port}"
|
||||||
80
agent_ready/tests/fakes.py
Normal file
80
agent_ready/tests/fakes.py
Normal file
@ -0,0 +1,80 @@
|
|||||||
|
"""In-memory sites and CLI helpers for tests that need exact responses."""
|
||||||
|
|
||||||
|
from __future__ import annotations
|
||||||
|
|
||||||
|
import io
|
||||||
|
|
||||||
|
import pytest
|
||||||
|
|
||||||
|
from agent_ready.backends import DEFAULT_UA, HttpSite, Response, Site
|
||||||
|
from agent_ready.check import main
|
||||||
|
from agent_ready.context import Ctx
|
||||||
|
from agent_ready.report import Report
|
||||||
|
|
||||||
|
HTML = "text/html"
|
||||||
|
_MISSING = Response(404, HTML, b"")
|
||||||
|
|
||||||
|
|
||||||
|
def resp(body: str, ctype: str = HTML, status: int = 200, **headers: str) -> Response:
|
||||||
|
"""Build a Response; ``headers`` keys are already lowercase names."""
|
||||||
|
return Response(status, ctype, body.encode(), dict(headers))
|
||||||
|
|
||||||
|
|
||||||
|
class FakeSite(Site):
|
||||||
|
"""A dist-like (``live=False``) site answering from a dict."""
|
||||||
|
|
||||||
|
def __init__(self, pages: dict[str, Response]) -> None:
|
||||||
|
super().__init__("https://fake.test")
|
||||||
|
self.pages = pages
|
||||||
|
|
||||||
|
def _fetch(self, path: str, ua: str) -> Response:
|
||||||
|
return self.pages.get(path, _MISSING)
|
||||||
|
|
||||||
|
|
||||||
|
class FakeHttp(HttpSite):
|
||||||
|
"""A live site with no sockets: per-path (and per-UA) canned responses."""
|
||||||
|
|
||||||
|
def __init__(
|
||||||
|
self,
|
||||||
|
pages: dict[str, Response],
|
||||||
|
ua_pages: dict[tuple[str, str], Response] | None = None,
|
||||||
|
mcp: Response | None = None,
|
||||||
|
) -> None:
|
||||||
|
super().__init__("https://fake.test")
|
||||||
|
self.pages = pages
|
||||||
|
self.ua_pages = ua_pages or {}
|
||||||
|
self.mcp = mcp or _MISSING
|
||||||
|
|
||||||
|
def _fetch(self, path: str, ua: str) -> Response:
|
||||||
|
return self.ua_pages.get((path, ua)) or self.pages.get(path, _MISSING)
|
||||||
|
|
||||||
|
def request(
|
||||||
|
self,
|
||||||
|
path: str,
|
||||||
|
ua: str = DEFAULT_UA,
|
||||||
|
data: bytes | None = None,
|
||||||
|
headers: dict[str, str] | None = None,
|
||||||
|
) -> Response:
|
||||||
|
"""The canned MCP answer, whatever the request."""
|
||||||
|
return self.mcp
|
||||||
|
|
||||||
|
|
||||||
|
def make_ctx(site: Site, *, act: bool = False) -> tuple[Ctx, io.StringIO]:
|
||||||
|
"""A Ctx writing to a StringIO; returns it with that buffer."""
|
||||||
|
out = io.StringIO()
|
||||||
|
return Ctx(site=site, report=Report(out=out), act=act), out
|
||||||
|
|
||||||
|
|
||||||
|
def run_main(capsys: pytest.CaptureFixture[str], *argv: str) -> tuple[int, list[str]]:
|
||||||
|
"""Run the CLI in-process; return exit code and output lines."""
|
||||||
|
code = main(list(argv))
|
||||||
|
return code, capsys.readouterr().out.splitlines()
|
||||||
|
|
||||||
|
|
||||||
|
def lines_for(lines: list[str], ar_id: str, status: str = "") -> list[str]:
|
||||||
|
"""Output lines for ``ar_id`` (optionally only one status)."""
|
||||||
|
return [
|
||||||
|
ln
|
||||||
|
for ln in lines
|
||||||
|
if ln.split()[1] == ar_id and (not status or ln.startswith(status))
|
||||||
|
]
|
||||||
153
agent_ready/tests/sitegen.py
Normal file
153
agent_ready/tests/sitegen.py
Normal file
@ -0,0 +1,153 @@
|
|||||||
|
"""Build good and bad site trees in a temp dir (no static fixture files).
|
||||||
|
|
||||||
|
Generated at test time on purpose: mirror files such as ``index.md`` would
|
||||||
|
otherwise trip the repo's markdown-naming gate.
|
||||||
|
"""
|
||||||
|
|
||||||
|
from __future__ import annotations
|
||||||
|
|
||||||
|
import json
|
||||||
|
from pathlib import Path
|
||||||
|
|
||||||
|
ORIGIN = "https://example.test"
|
||||||
|
|
||||||
|
_TEXT = (
|
||||||
|
"Dice roller for tabletop games. Roll any combination of polyhedral dice, "
|
||||||
|
"keep the highest, and read the full breakdown of every throw. This text "
|
||||||
|
"is in the initial HTML so an agent that never runs JavaScript can read it."
|
||||||
|
)
|
||||||
|
|
||||||
|
_LD = json.dumps(
|
||||||
|
{
|
||||||
|
"@context": "https://schema.org",
|
||||||
|
"@type": "WebSite",
|
||||||
|
"name": "Dice",
|
||||||
|
"url": ORIGIN,
|
||||||
|
}
|
||||||
|
)
|
||||||
|
|
||||||
|
CATALOG = {
|
||||||
|
"specVersion": "1.0",
|
||||||
|
"host": {"displayName": "kuhy", "identifier": "did:web:example.test"},
|
||||||
|
"entries": [
|
||||||
|
{
|
||||||
|
"identifier": "urn:air:example.test:docs:llms",
|
||||||
|
"displayName": "llms.txt",
|
||||||
|
"type": "text/plain",
|
||||||
|
"url": f"{ORIGIN}/llms.txt",
|
||||||
|
}
|
||||||
|
],
|
||||||
|
}
|
||||||
|
|
||||||
|
LLMS = f"""# Dice
|
||||||
|
> A dice roller for tabletop games.
|
||||||
|
|
||||||
|
Plain prose is allowed between sections.
|
||||||
|
|
||||||
|
## Pages
|
||||||
|
- [Home]({ORIGIN}/): what the roller does
|
||||||
|
- [About]({ORIGIN}/about/): who made it
|
||||||
|
"""
|
||||||
|
|
||||||
|
ROBOTS = f"""# robots.txt
|
||||||
|
User-agent: *
|
||||||
|
Disallow: /search/
|
||||||
|
|
||||||
|
Sitemap: {ORIGIN}/sitemap.xml
|
||||||
|
"""
|
||||||
|
|
||||||
|
SITEMAP = f"""<?xml version="1.0" encoding="UTF-8"?>
|
||||||
|
<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
|
||||||
|
<url><loc>{ORIGIN}/</loc></url>
|
||||||
|
<url><loc>{ORIGIN}/about/</loc></url>
|
||||||
|
</urlset>
|
||||||
|
"""
|
||||||
|
|
||||||
|
|
||||||
|
def page(title: str, mirror: str, *, home: bool = False) -> str:
|
||||||
|
"""Return a server-rendered HTML page with every read-stage feature."""
|
||||||
|
head = [
|
||||||
|
f"<title>{title}</title>",
|
||||||
|
f'<link rel="alternate" type="text/markdown" href="{mirror}">',
|
||||||
|
]
|
||||||
|
if home:
|
||||||
|
head += [
|
||||||
|
'<link rel="ai-catalog" href="/.well-known/ai-catalog.json" type="application/ai-catalog+json">',
|
||||||
|
'<link rel="alternate" type="text/plain" href="/llms.txt">',
|
||||||
|
f'<script type="application/ld+json">{_LD}</script>',
|
||||||
|
]
|
||||||
|
return (
|
||||||
|
'<!doctype html><html lang="en"><head>' + "".join(head) + "</head><body>"
|
||||||
|
f"<h1>{title}</h1><p>{_TEXT}</p>"
|
||||||
|
'<pre><code class="language-python">print("d20")</code></pre>'
|
||||||
|
'<nav><a href="/">Home</a> <a href="/about/">About</a> <a href="/llms.txt">llms.txt</a></nav>'
|
||||||
|
"</body></html>"
|
||||||
|
)
|
||||||
|
|
||||||
|
|
||||||
|
def mirror(title: str) -> str:
|
||||||
|
"""Return a markdown mirror with a language-tagged fence."""
|
||||||
|
return f"# {title}\n\n{_TEXT}\n\n```python\nprint('d20')\n```\n"
|
||||||
|
|
||||||
|
|
||||||
|
def write(root: Path, rel: str, text: str) -> None:
|
||||||
|
"""Write ``text`` to ``root/rel``, creating parent dirs."""
|
||||||
|
path = root / rel
|
||||||
|
path.parent.mkdir(parents=True, exist_ok=True)
|
||||||
|
path.write_text(text, encoding="utf-8")
|
||||||
|
|
||||||
|
|
||||||
|
def build_good(root: Path) -> Path:
|
||||||
|
"""Create a fully compliant build output under ``root``."""
|
||||||
|
write(root, "index.html", page("Dice", "/index.md", home=True))
|
||||||
|
write(root, "index.md", mirror("Dice"))
|
||||||
|
write(root, "about/index.html", page("About", "/about/index.md"))
|
||||||
|
write(root, "about/index.md", mirror("About"))
|
||||||
|
write(
|
||||||
|
root,
|
||||||
|
"404.html",
|
||||||
|
"<!doctype html><html><body><h1>Not found</h1><p>No page at this address.</p></body></html>",
|
||||||
|
)
|
||||||
|
write(root, "robots.txt", ROBOTS)
|
||||||
|
write(root, "sitemap.xml", SITEMAP)
|
||||||
|
write(root, "llms.txt", LLMS)
|
||||||
|
write(root, ".well-known/ai-catalog.json", json.dumps(CATALOG))
|
||||||
|
return root
|
||||||
|
|
||||||
|
|
||||||
|
SHELL = '<!doctype html><html><head><title>App</title></head><body><div id="root"></div><script src="/app.js"></script></body></html>'
|
||||||
|
|
||||||
|
|
||||||
|
def build_bad(root: Path) -> Path:
|
||||||
|
"""Create a build output that violates every find/read item."""
|
||||||
|
write(root, "index.html", SHELL)
|
||||||
|
write(root, "about/index.html", SHELL)
|
||||||
|
write(
|
||||||
|
root,
|
||||||
|
"robots.txt",
|
||||||
|
"User-agent: *\nDisallow:\n\nUser-agent: GPTBot\nDisallow: /\n",
|
||||||
|
)
|
||||||
|
write(root, "sitemap.xml", "<html>not xml")
|
||||||
|
write(root, "llms.txt", "# Dice\n\n## Pages\n- [About](/about/)\n")
|
||||||
|
write(
|
||||||
|
root,
|
||||||
|
".well-known/ai-catalog.json",
|
||||||
|
json.dumps({"entries": [{"identifier": "x"}]}),
|
||||||
|
)
|
||||||
|
return root
|
||||||
|
|
||||||
|
|
||||||
|
def add_pages(root: Path, count: int, *, broken_last: bool = False) -> None:
|
||||||
|
"""Add ``count`` more sitemap pages; the last one an empty shell if asked."""
|
||||||
|
urls = []
|
||||||
|
for i in range(count):
|
||||||
|
title = f"Post {i}"
|
||||||
|
html = (
|
||||||
|
SHELL if broken_last and i == count - 1 else page(title, f"/p{i}/index.md")
|
||||||
|
)
|
||||||
|
write(root, f"p{i}/index.html", html)
|
||||||
|
write(root, f"p{i}/index.md", mirror(title))
|
||||||
|
urls.append(f" <url><loc>{ORIGIN}/p{i}/</loc></url>\n")
|
||||||
|
write(
|
||||||
|
root, "sitemap.xml", SITEMAP.replace("</urlset>", "".join(urls) + "</urlset>")
|
||||||
|
)
|
||||||
75
agent_ready/tests/test_backends.py
Normal file
75
agent_ready/tests/test_backends.py
Normal file
@ -0,0 +1,75 @@
|
|||||||
|
"""Backend edge cases: URL mapping, memoized failures, traversal, deadline."""
|
||||||
|
|
||||||
|
from __future__ import annotations
|
||||||
|
|
||||||
|
from pathlib import Path
|
||||||
|
|
||||||
|
import pytest
|
||||||
|
|
||||||
|
from agent_ready.backends import DirSite, HttpSite, Response, Site
|
||||||
|
from agent_ready.report import Undeterminable
|
||||||
|
from agent_ready.tests.fakes import FakeHttp, resp
|
||||||
|
|
||||||
|
|
||||||
|
class FlakySite(Site):
|
||||||
|
"""Raises Undeterminable on every fetch and counts the attempts."""
|
||||||
|
|
||||||
|
live = True
|
||||||
|
|
||||||
|
def __init__(self) -> None:
|
||||||
|
super().__init__("https://flaky.test")
|
||||||
|
self.attempts = 0
|
||||||
|
|
||||||
|
def _fetch(self, path: str, ua: str) -> Response:
|
||||||
|
self.attempts += 1
|
||||||
|
raise Undeterminable(f"{path}: boom")
|
||||||
|
|
||||||
|
|
||||||
|
def test_to_path_rejects_offsite_and_non_http(tmp_path: Path) -> None:
|
||||||
|
site = DirSite(tmp_path)
|
||||||
|
assert site.to_path("https://other.test/x") is None
|
||||||
|
assert site.to_path("mailto:a@b.test") is None
|
||||||
|
assert site.to_path("/rel/") == "/rel/"
|
||||||
|
assert site.to_path("https://dist.invalid") == "/"
|
||||||
|
|
||||||
|
|
||||||
|
def test_failures_are_memoized() -> None:
|
||||||
|
site = FlakySite()
|
||||||
|
for _ in range(2):
|
||||||
|
with pytest.raises(Undeterminable, match="boom"):
|
||||||
|
site.get("/x")
|
||||||
|
assert site.attempts == 1
|
||||||
|
|
||||||
|
|
||||||
|
def test_prefetch_swallows_failures_then_get_raises() -> None:
|
||||||
|
site = FlakySite()
|
||||||
|
site.prefetch(["/a", "/b", "/a"])
|
||||||
|
assert site.attempts == 2
|
||||||
|
with pytest.raises(Undeterminable):
|
||||||
|
site.get("/a")
|
||||||
|
|
||||||
|
|
||||||
|
def test_base_fetch_is_abstract() -> None:
|
||||||
|
with pytest.raises(NotImplementedError):
|
||||||
|
Site("https://x.test")._fetch("/", "ua")
|
||||||
|
|
||||||
|
|
||||||
|
def test_dist_never_serves_outside_root(tmp_path: Path) -> None:
|
||||||
|
root = tmp_path / "dist"
|
||||||
|
root.mkdir()
|
||||||
|
(tmp_path / "secret.txt").write_text("nope")
|
||||||
|
site = DirSite(root)
|
||||||
|
assert site.file_for("/../secret.txt") is None
|
||||||
|
assert site.get("/../secret.txt").status == 404
|
||||||
|
|
||||||
|
|
||||||
|
def test_exhausted_budget_is_undeterminable() -> None:
|
||||||
|
site = HttpSite("https://budget.test/anything", budget=0)
|
||||||
|
with pytest.raises(Undeterminable, match="time budget"):
|
||||||
|
site.get("/")
|
||||||
|
|
||||||
|
|
||||||
|
def test_fake_http_serves_canned_pages() -> None:
|
||||||
|
site = FakeHttp({"/": resp("hi")})
|
||||||
|
assert site.get("/").text == "hi"
|
||||||
|
assert site.get("/nope").status == 404
|
||||||
153
agent_ready/tests/test_checks_dist.py
Normal file
153
agent_ready/tests/test_checks_dist.py
Normal file
@ -0,0 +1,153 @@
|
|||||||
|
"""Dist-mode scenarios: one mutation of the good tree per failing branch."""
|
||||||
|
|
||||||
|
from __future__ import annotations
|
||||||
|
|
||||||
|
import json
|
||||||
|
from pathlib import Path
|
||||||
|
|
||||||
|
import pytest
|
||||||
|
|
||||||
|
from agent_ready.tests import sitegen
|
||||||
|
from agent_ready.tests.fakes import lines_for, run_main
|
||||||
|
|
||||||
|
OPENAPI_OP = {"get": {"operationId": "ping"}}
|
||||||
|
|
||||||
|
|
||||||
|
def test_robots_without_wildcard_group(
|
||||||
|
capsys: pytest.CaptureFixture[str], good_dir: Path
|
||||||
|
) -> None:
|
||||||
|
robots = f"User-agent: Foo\nDisallow: /x\n\nSitemap: {sitegen.ORIGIN}/sitemap.xml\n"
|
||||||
|
sitegen.write(good_dir, "robots.txt", robots)
|
||||||
|
_, lines = run_main(capsys, "dist", str(good_dir))
|
||||||
|
assert "no 'User-agent: *' group" in lines_for(lines, "AR-FIND-01", "FAIL")[0]
|
||||||
|
|
||||||
|
|
||||||
|
def test_sitemap_found_without_robots_reference_sets_origin(
|
||||||
|
capsys: pytest.CaptureFixture[str], good_dir: Path
|
||||||
|
) -> None:
|
||||||
|
sitegen.write(good_dir, "robots.txt", "User-agent: *\nDisallow:\n")
|
||||||
|
code, lines = run_main(capsys, "dist", str(good_dir))
|
||||||
|
assert code == 1
|
||||||
|
assert "no 'Sitemap:' line" in lines_for(lines, "AR-FIND-03", "FAIL")[0]
|
||||||
|
assert lines_for(lines, "AR-FIND-03", "FAIL")[1:] == []
|
||||||
|
assert lines_for(lines, "AR-READ-01", "PASS")
|
||||||
|
|
||||||
|
|
||||||
|
def test_sitemap_index_follows_children(
|
||||||
|
capsys: pytest.CaptureFixture[str], good_dir: Path
|
||||||
|
) -> None:
|
||||||
|
child = f"{sitegen.ORIGIN}/sitemap-pages.xml"
|
||||||
|
index = (
|
||||||
|
'<?xml version="1.0"?><sitemapindex '
|
||||||
|
'xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">'
|
||||||
|
f"<sitemap><loc>{child}</loc></sitemap></sitemapindex>"
|
||||||
|
)
|
||||||
|
sitegen.write(good_dir, "sitemap-pages.xml", sitegen.SITEMAP)
|
||||||
|
sitegen.write(good_dir, "sitemap.xml", index)
|
||||||
|
code, lines = run_main(capsys, "dist", str(good_dir))
|
||||||
|
assert code == 0, lines
|
||||||
|
assert "lists 2 pages" in lines_for(lines, "AR-FIND-03", "PASS")[-1]
|
||||||
|
|
||||||
|
|
||||||
|
def test_sitemap_with_offsite_locs_and_none_at_all(
|
||||||
|
capsys: pytest.CaptureFixture[str], good_dir: Path
|
||||||
|
) -> None:
|
||||||
|
urlset = '<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">{}</urlset>'
|
||||||
|
off = urlset.format("<url><loc>https://other.test/x/</loc></url>")
|
||||||
|
sitegen.write(good_dir, "sitemap.xml", off)
|
||||||
|
_, lines = run_main(capsys, "dist", str(good_dir))
|
||||||
|
assert "1 <loc> URLs are not on" in lines_for(lines, "AR-FIND-03", "FAIL")[0]
|
||||||
|
sitegen.write(good_dir, "sitemap.xml", urlset.format(""))
|
||||||
|
_, lines = run_main(capsys, "dist", str(good_dir))
|
||||||
|
assert "no <loc> entries" in lines_for(lines, "AR-FIND-03", "FAIL")[0]
|
||||||
|
assert "sitemap yielded no pages" in lines_for(lines, "AR-READ-01", "FAIL")[0]
|
||||||
|
|
||||||
|
|
||||||
|
def test_sitemap_pages_missing_or_copies_of_the_shell(
|
||||||
|
capsys: pytest.CaptureFixture[str], good_dir: Path
|
||||||
|
) -> None:
|
||||||
|
home = (good_dir / "index.html").read_text()
|
||||||
|
sitegen.write(good_dir, "dup/index.html", home)
|
||||||
|
extra = "".join(
|
||||||
|
f"<url><loc>{sitegen.ORIGIN}/{p}/</loc></url>" for p in ("dup", "gone")
|
||||||
|
)
|
||||||
|
sitemap = (good_dir / "sitemap.xml").read_text()
|
||||||
|
sitegen.write(
|
||||||
|
good_dir, "sitemap.xml", sitemap.replace("</urlset>", extra + "</urlset>")
|
||||||
|
)
|
||||||
|
code, lines = run_main(capsys, "dist", str(good_dir))
|
||||||
|
assert code == 1
|
||||||
|
problem = lines_for(lines, "AR-READ-01", "FAIL")[0]
|
||||||
|
assert "/gone/ (HTTP 404)" in problem
|
||||||
|
assert "/dup/ (byte-identical to the homepage shell)" in problem
|
||||||
|
|
||||||
|
|
||||||
|
def test_markdown_mirror_with_untagged_fence(
|
||||||
|
capsys: pytest.CaptureFixture[str], good_dir: Path
|
||||||
|
) -> None:
|
||||||
|
sitegen.write(good_dir, "about/index.md", "# About\n\n```\nplain\n```\n")
|
||||||
|
_, lines = run_main(capsys, "dist", str(good_dir))
|
||||||
|
assert "about/index.md (1 untagged fences)" in lines_for(lines, "AR-READ-05")[0]
|
||||||
|
|
||||||
|
|
||||||
|
def test_llms_with_broken_link(
|
||||||
|
capsys: pytest.CaptureFixture[str], good_dir: Path
|
||||||
|
) -> None:
|
||||||
|
llms = (good_dir / "llms.txt").read_text() + "- [Gone](/gone/): missing\n"
|
||||||
|
sitegen.write(good_dir, "llms.txt", llms)
|
||||||
|
_, lines = run_main(capsys, "dist", str(good_dir))
|
||||||
|
assert "broken links: /gone/" in lines_for(lines, "AR-READ-07", "FAIL")[0]
|
||||||
|
|
||||||
|
|
||||||
|
def test_homepage_with_unparseable_json_ld(
|
||||||
|
capsys: pytest.CaptureFixture[str], good_dir: Path
|
||||||
|
) -> None:
|
||||||
|
home = (good_dir / "index.html").read_text()
|
||||||
|
sitegen.write(good_dir, "index.html", home.replace('"@context"', "@context"))
|
||||||
|
_, lines = run_main(capsys, "dist", str(good_dir))
|
||||||
|
assert "1 JSON-LD blocks fail" in lines_for(lines, "AR-READ-08", "FAIL")[-1]
|
||||||
|
|
||||||
|
|
||||||
|
def test_webmcp_found_in_linked_script(
|
||||||
|
capsys: pytest.CaptureFixture[str], good_dir: Path
|
||||||
|
) -> None:
|
||||||
|
home = (good_dir / "index.html").read_text()
|
||||||
|
scripts = '<script src="https://cdn.other.test/x.js"></script><script src="/app.js"></script>'
|
||||||
|
sitegen.write(good_dir, "index.html", home.replace("</body>", scripts + "</body>"))
|
||||||
|
sitegen.write(good_dir, "app.js", "document.modelContext.registerTool({});")
|
||||||
|
_, lines = run_main(capsys, "dist", str(good_dir), "--act")
|
||||||
|
assert lines_for(lines, "AR-ACT-07", "PASS")
|
||||||
|
|
||||||
|
|
||||||
|
@pytest.mark.parametrize(
|
||||||
|
("doc", "status", "needle"),
|
||||||
|
[
|
||||||
|
({"openapi": "3.1.0", "paths": {"/p": OPENAPI_OP}}, "PASS", "1 operations"),
|
||||||
|
(
|
||||||
|
{"openapi": "3.1.0", "paths": {"/p": {"get": {}}}},
|
||||||
|
"FAIL",
|
||||||
|
"lack operationId",
|
||||||
|
),
|
||||||
|
({"openapi": "3.1.0", "paths": {}}, "FAIL", "no operations in paths"),
|
||||||
|
({"openapi": "3.1.0", "paths": 5}, "FAIL", "no operations in paths"),
|
||||||
|
(
|
||||||
|
{
|
||||||
|
"openapi": "3.1.0",
|
||||||
|
"paths": {"/a": "x", "/b": {"parameters": [], "get": 1}},
|
||||||
|
},
|
||||||
|
"FAIL",
|
||||||
|
"1 operations lack",
|
||||||
|
),
|
||||||
|
],
|
||||||
|
)
|
||||||
|
def test_openapi_document_shapes(
|
||||||
|
capsys: pytest.CaptureFixture[str],
|
||||||
|
good_dir: Path,
|
||||||
|
doc: dict[str, object],
|
||||||
|
status: str,
|
||||||
|
needle: str,
|
||||||
|
) -> None:
|
||||||
|
sitegen.write(good_dir, "openapi.json", json.dumps(doc))
|
||||||
|
_, lines = run_main(capsys, "dist", str(good_dir), "--act")
|
||||||
|
found = lines_for(lines, "AR-ACT-02", status)
|
||||||
|
assert found and needle in found[0], lines_for(lines, "AR-ACT-02")
|
||||||
83
agent_ready/tests/test_checks_live.py
Normal file
83
agent_ready/tests/test_checks_live.py
Normal file
@ -0,0 +1,83 @@
|
|||||||
|
"""Live-mode checks driven by canned responses (no sockets, no network)."""
|
||||||
|
|
||||||
|
from __future__ import annotations
|
||||||
|
|
||||||
|
import pytest
|
||||||
|
|
||||||
|
from agent_ready import checks_act, checks_find, checks_read
|
||||||
|
from agent_ready.backends import Response
|
||||||
|
from agent_ready.tests import sitegen
|
||||||
|
from agent_ready.tests.fakes import FakeHttp, make_ctx, resp
|
||||||
|
|
||||||
|
LONG = "Readable text for agents that never run JavaScript. " * 4
|
||||||
|
MD_LINK = '</index.md>; rel="alternate"; type="text/markdown"'
|
||||||
|
|
||||||
|
|
||||||
|
def _home(*, ctype: str = "text/html", **headers: str) -> Response:
|
||||||
|
return resp(f"<html><body><p>{LONG}</p></body></html>", ctype, **headers)
|
||||||
|
|
||||||
|
|
||||||
|
def test_challenge_page_for_one_agent_is_reported() -> None:
|
||||||
|
challenge = resp("<html>Just a moment...</html>")
|
||||||
|
ua = checks_find.AGENT_UAS["GPTBot"]
|
||||||
|
site = FakeHttp({"/": _home()}, ua_pages={("/", ua): challenge})
|
||||||
|
ctx, out = make_ctx(site)
|
||||||
|
checks_find.check_agent_access(ctx)
|
||||||
|
assert out.getvalue().startswith("FAIL AR-FIND-01 GPTBot got a challenge page")
|
||||||
|
|
||||||
|
|
||||||
|
def test_sitemap_on_another_host_is_a_failure() -> None:
|
||||||
|
robots = "User-agent: *\nDisallow:\nSitemap: https://other.test/sitemap.xml\n"
|
||||||
|
site = FakeHttp({"/robots.txt": resp(robots, "text/plain")})
|
||||||
|
ctx, out = make_ctx(site)
|
||||||
|
checks_find.check_robots(ctx)
|
||||||
|
ctx.sitemap_pages = []
|
||||||
|
assert checks_find._sitemap_paths(ctx) == ["/sitemap.xml"]
|
||||||
|
assert (
|
||||||
|
"Sitemap is on another host: https://other.test/sitemap.xml" in out.getvalue()
|
||||||
|
)
|
||||||
|
|
||||||
|
|
||||||
|
def test_markdown_mirror_advertised_only_by_link_header() -> None:
|
||||||
|
site = FakeHttp(
|
||||||
|
{
|
||||||
|
"/": _home(link=MD_LINK),
|
||||||
|
"/index.md": resp(sitegen.mirror("Home"), "text/markdown"),
|
||||||
|
}
|
||||||
|
)
|
||||||
|
ctx, out = make_ctx(site)
|
||||||
|
checks_read.check_pages(ctx)
|
||||||
|
assert (
|
||||||
|
"PASS AR-READ-09 1 pages advertise a working markdown mirror" in out.getvalue()
|
||||||
|
)
|
||||||
|
|
||||||
|
|
||||||
|
def test_page_served_with_wrong_content_type() -> None:
|
||||||
|
ctx, out = make_ctx(FakeHttp({"/": _home(ctype="text/plain")}))
|
||||||
|
checks_read.check_pages(ctx)
|
||||||
|
assert (
|
||||||
|
"FAIL AR-READ-01 answer not in initial HTML: / (text/plain)" in out.getvalue()
|
||||||
|
)
|
||||||
|
|
||||||
|
|
||||||
|
def _mcp(status: int, **headers: str) -> Response:
|
||||||
|
return Response(status, "application/json", b"{}", dict(headers))
|
||||||
|
|
||||||
|
|
||||||
|
@pytest.mark.parametrize(
|
||||||
|
("answer", "status"),
|
||||||
|
[
|
||||||
|
(_mcp(401, **{"www-authenticate": "Bearer"}), "PASS"),
|
||||||
|
(_mcp(401), "FAIL"),
|
||||||
|
],
|
||||||
|
)
|
||||||
|
def test_mcp_behind_oauth_needs_www_authenticate(answer: Response, status: str) -> None:
|
||||||
|
ctx, out = make_ctx(FakeHttp({}, mcp=answer), act=True)
|
||||||
|
checks_act.check_mcp(ctx)
|
||||||
|
assert f"{status} AR-ACT-03" in out.getvalue()
|
||||||
|
|
||||||
|
|
||||||
|
def test_act_off_reports_a_single_skip() -> None:
|
||||||
|
ctx, out = make_ctx(FakeHttp({}))
|
||||||
|
checks_act.run_act(ctx)
|
||||||
|
assert out.getvalue().startswith("SKIP AR-ACT-10 act stage off")
|
||||||
202
agent_ready/tests/test_cli.py
Normal file
202
agent_ready/tests/test_cli.py
Normal file
@ -0,0 +1,202 @@
|
|||||||
|
"""End-to-end tests of ``check.py`` in dist and url mode."""
|
||||||
|
|
||||||
|
from __future__ import annotations
|
||||||
|
|
||||||
|
import re
|
||||||
|
import runpy
|
||||||
|
import subprocess
|
||||||
|
import sys
|
||||||
|
from collections.abc import Callable
|
||||||
|
from pathlib import Path
|
||||||
|
|
||||||
|
import pytest
|
||||||
|
|
||||||
|
from agent_ready.check import main
|
||||||
|
from agent_ready.tests import sitegen
|
||||||
|
|
||||||
|
LINE = re.compile(r"^(PASS|FAIL|SKIP) AR-(FIND|READ|ACT)-\d\d \S")
|
||||||
|
PKG = Path(__file__).resolve().parents[1]
|
||||||
|
|
||||||
|
|
||||||
|
def run(capsys: pytest.CaptureFixture[str], *argv: str) -> tuple[int, list[str]]:
|
||||||
|
"""Run the CLI in-process; return exit code and output lines."""
|
||||||
|
code = main(list(argv))
|
||||||
|
lines = capsys.readouterr().out.splitlines()
|
||||||
|
bad = [ln for ln in lines if not LINE.match(ln)]
|
||||||
|
assert not bad, bad
|
||||||
|
return code, lines
|
||||||
|
|
||||||
|
|
||||||
|
def statuses(lines: list[str], ar_id: str) -> set[str]:
|
||||||
|
"""Return the set of statuses reported for ``ar_id``."""
|
||||||
|
return {ln.split()[0] for ln in lines if ln.split()[1] == ar_id}
|
||||||
|
|
||||||
|
|
||||||
|
def test_dist_good_passes(capsys: pytest.CaptureFixture[str], good_dir: Path) -> None:
|
||||||
|
code, lines = run(capsys, "dist", str(good_dir))
|
||||||
|
assert code == 0, "\n".join(lines)
|
||||||
|
assert not [ln for ln in lines if ln.startswith("FAIL")]
|
||||||
|
for ar_id in (
|
||||||
|
"AR-FIND-01",
|
||||||
|
"AR-FIND-03",
|
||||||
|
"AR-FIND-04",
|
||||||
|
"AR-READ-01",
|
||||||
|
"AR-READ-02",
|
||||||
|
"AR-READ-07",
|
||||||
|
"AR-READ-09",
|
||||||
|
):
|
||||||
|
found = statuses(lines, ar_id)
|
||||||
|
assert "PASS" in found and "FAIL" not in found, ar_id
|
||||||
|
assert statuses(lines, "AR-READ-11") == {"SKIP"}
|
||||||
|
assert statuses(lines, "AR-ACT-10") == {"SKIP"}
|
||||||
|
|
||||||
|
|
||||||
|
def test_dist_bad_fails_every_item(
|
||||||
|
capsys: pytest.CaptureFixture[str], bad_dir: Path
|
||||||
|
) -> None:
|
||||||
|
code, lines = run(capsys, "dist", str(bad_dir))
|
||||||
|
assert code == 1
|
||||||
|
for ar_id in (
|
||||||
|
"AR-FIND-01",
|
||||||
|
"AR-FIND-03",
|
||||||
|
"AR-FIND-04",
|
||||||
|
"AR-READ-01",
|
||||||
|
"AR-READ-02",
|
||||||
|
"AR-READ-03",
|
||||||
|
"AR-READ-06",
|
||||||
|
"AR-READ-07",
|
||||||
|
"AR-READ-08",
|
||||||
|
"AR-READ-09",
|
||||||
|
):
|
||||||
|
assert "FAIL" in statuses(lines, ar_id), ar_id
|
||||||
|
assert any("gptbot" in ln for ln in lines if "AR-FIND-01" in ln)
|
||||||
|
|
||||||
|
|
||||||
|
def test_dist_untagged_code_fails(
|
||||||
|
capsys: pytest.CaptureFixture[str], good_dir: Path
|
||||||
|
) -> None:
|
||||||
|
about = good_dir / "about/index.html"
|
||||||
|
about.write_text(about.read_text().replace(' class="language-python"', ""))
|
||||||
|
code, lines = run(capsys, "dist", str(good_dir))
|
||||||
|
assert code == 1
|
||||||
|
assert "FAIL" in statuses(lines, "AR-READ-05")
|
||||||
|
|
||||||
|
|
||||||
|
def test_dist_act_opt_in(capsys: pytest.CaptureFixture[str], good_dir: Path) -> None:
|
||||||
|
code, lines = run(capsys, "dist", str(good_dir), "--act")
|
||||||
|
assert code == 1
|
||||||
|
assert "FAIL" in statuses(lines, "AR-ACT-02")
|
||||||
|
|
||||||
|
|
||||||
|
def test_usage_errors(capsys: pytest.CaptureFixture[str], tmp_path: Path) -> None:
|
||||||
|
assert main(["dist", str(tmp_path / "missing")]) == 2
|
||||||
|
assert main(["url", "not-a-url"]) == 2
|
||||||
|
with pytest.raises(SystemExit) as exc:
|
||||||
|
main([])
|
||||||
|
assert exc.value.code == 2
|
||||||
|
|
||||||
|
|
||||||
|
def test_url_good_passes(
|
||||||
|
capsys: pytest.CaptureFixture[str], good_dir: Path, serve: Callable[..., str]
|
||||||
|
) -> None:
|
||||||
|
code, lines = run(capsys, "url", serve(good_dir))
|
||||||
|
assert code == 0, "\n".join(lines)
|
||||||
|
assert statuses(lines, "AR-READ-02") == {"PASS"}
|
||||||
|
|
||||||
|
|
||||||
|
def test_url_spa_fallback_fails(
|
||||||
|
capsys: pytest.CaptureFixture[str], good_dir: Path, serve: Callable[..., str]
|
||||||
|
) -> None:
|
||||||
|
"""Every path 200 text/html: a status-only check would wrongly pass."""
|
||||||
|
code, lines = run(capsys, "url", serve(good_dir, "spa"))
|
||||||
|
assert code == 1
|
||||||
|
for ar_id in (
|
||||||
|
"AR-FIND-01",
|
||||||
|
"AR-FIND-03",
|
||||||
|
"AR-FIND-04",
|
||||||
|
"AR-READ-01",
|
||||||
|
"AR-READ-02",
|
||||||
|
"AR-READ-07",
|
||||||
|
"AR-READ-09",
|
||||||
|
):
|
||||||
|
assert "FAIL" in statuses(lines, ar_id), ar_id
|
||||||
|
assert any("text/html" in ln for ln in lines if "AR-FIND-01" in ln)
|
||||||
|
assert any(
|
||||||
|
"does not exist" in ln for ln in lines if "AR-READ-06" in ln
|
||||||
|
) # HTML fallback != file
|
||||||
|
|
||||||
|
|
||||||
|
def test_url_json_404(
|
||||||
|
capsys: pytest.CaptureFixture[str], good_dir: Path, serve: Callable[..., str]
|
||||||
|
) -> None:
|
||||||
|
code, lines = run(capsys, "url", serve(good_dir, "json404"))
|
||||||
|
assert code == 1
|
||||||
|
assert statuses(lines, "AR-READ-02") == {"PASS"}
|
||||||
|
assert "FAIL" in statuses(lines, "AR-FIND-01")
|
||||||
|
|
||||||
|
|
||||||
|
def test_url_blocked_agent(
|
||||||
|
capsys: pytest.CaptureFixture[str], good_dir: Path, serve: Callable[..., str]
|
||||||
|
) -> None:
|
||||||
|
code, lines = run(capsys, "url", serve(good_dir, block_ua="GPTBot"))
|
||||||
|
assert code == 1
|
||||||
|
assert any(ln.startswith("FAIL AR-FIND-01") and "GPTBot" in ln for ln in lines)
|
||||||
|
|
||||||
|
|
||||||
|
def test_url_unreachable_is_3(
|
||||||
|
capsys: pytest.CaptureFixture[str], dead_url: str
|
||||||
|
) -> None:
|
||||||
|
assert main(["url", dead_url]) == 3
|
||||||
|
|
||||||
|
|
||||||
|
def test_entry_points_from_other_cwd(good_dir: Path, tmp_path: Path) -> None:
|
||||||
|
for cmd in (
|
||||||
|
["bash", str(PKG / "check.sh")],
|
||||||
|
[sys.executable, str(PKG / "check.py")],
|
||||||
|
):
|
||||||
|
proc = subprocess.run(
|
||||||
|
[*cmd, "dist", str(good_dir)],
|
||||||
|
cwd=tmp_path,
|
||||||
|
capture_output=True,
|
||||||
|
text=True,
|
||||||
|
check=False,
|
||||||
|
)
|
||||||
|
assert proc.returncode == 0, proc.stdout + proc.stderr
|
||||||
|
|
||||||
|
|
||||||
|
def test_dist_checks_every_page_url_caps_visibly(
|
||||||
|
capsys: pytest.CaptureFixture[str], good_dir: Path, serve: Callable[..., str]
|
||||||
|
) -> None:
|
||||||
|
"""Dist mode ignores --max-pages; url mode names the cap instead of hiding it."""
|
||||||
|
sitegen.add_pages(good_dir, 6, broken_last=True)
|
||||||
|
code, lines = run(capsys, "dist", str(good_dir), "--max-pages", "3")
|
||||||
|
assert code == 1
|
||||||
|
assert any(ln.startswith("FAIL AR-READ-01") and "/p5/" in ln for ln in lines)
|
||||||
|
code, lines = run(capsys, "url", serve(good_dir), "--max-pages", "3")
|
||||||
|
assert any(ln.startswith("SKIP AR-READ-01 checked 3 of 8 pages") for ln in lines), (
|
||||||
|
lines
|
||||||
|
)
|
||||||
|
|
||||||
|
|
||||||
|
def test_url_act_mcp(
|
||||||
|
capsys: pytest.CaptureFixture[str], good_dir: Path, serve: Callable[..., str]
|
||||||
|
) -> None:
|
||||||
|
_, lines = run(capsys, "url", serve(good_dir), "--act")
|
||||||
|
assert statuses(lines, "AR-ACT-03") == {"PASS"}
|
||||||
|
assert statuses(lines, "AR-ACT-10") == {"PASS"}
|
||||||
|
assert "FAIL" in statuses(lines, "AR-ACT-07")
|
||||||
|
code, lines = run(capsys, "url", serve(good_dir, "spa"), "--act")
|
||||||
|
assert code == 1
|
||||||
|
assert statuses(lines, "AR-ACT-03") == {"FAIL"}
|
||||||
|
assert statuses(lines, "AR-ACT-10") == {"FAIL"}
|
||||||
|
|
||||||
|
|
||||||
|
def test_script_entry_point_in_process(good_dir: Path) -> None:
|
||||||
|
"""Run check.py as ``__main__`` here so the guard lines count for coverage."""
|
||||||
|
argv = ["check.py", "dist", str(good_dir)]
|
||||||
|
with pytest.MonkeyPatch.context() as patch:
|
||||||
|
patch.setattr(sys, "argv", argv)
|
||||||
|
patch.setattr(sys, "path", list(sys.path)) # check.py prepends to it
|
||||||
|
with pytest.raises(SystemExit) as exc:
|
||||||
|
runpy.run_path(str(PKG / "check.py"), run_name="__main__")
|
||||||
|
assert exc.value.code == 0
|
||||||
186
agent_ready/tests/test_formats.py
Normal file
186
agent_ready/tests/test_formats.py
Normal file
@ -0,0 +1,186 @@
|
|||||||
|
"""Unit tests for the format validators and the HTML scanner."""
|
||||||
|
|
||||||
|
from __future__ import annotations
|
||||||
|
|
||||||
|
import pytest
|
||||||
|
|
||||||
|
from agent_ready import formats, htmlscan
|
||||||
|
from agent_ready.tests import sitegen
|
||||||
|
|
||||||
|
# Verbatim from spec/spec.md "llms.txt shape (informative)".
|
||||||
|
SPEC_LLMS = """# Acme
|
||||||
|
> Acme ships a payments API for developers.
|
||||||
|
|
||||||
|
## Docs
|
||||||
|
- [Quickstart](https://example.com/docs/quickstart): first charge in one request
|
||||||
|
- [Authentication](https://example.com/docs/auth): API keys, scopes, rotation
|
||||||
|
|
||||||
|
## API
|
||||||
|
- [OpenAPI](https://example.com/openapi.json): full request and response contract
|
||||||
|
"""
|
||||||
|
|
||||||
|
# Shape of https://vercel.com/.well-known/ai-catalog.json (2026-10-22), trimmed.
|
||||||
|
VERCEL_CATALOG = {
|
||||||
|
"specVersion": "1.0",
|
||||||
|
"host": {"displayName": "Vercel", "identifier": "https://vercel.com"},
|
||||||
|
"entries": [
|
||||||
|
{
|
||||||
|
"identifier": "urn:air:vercel.com:api:rest",
|
||||||
|
"displayName": "Vercel REST API",
|
||||||
|
"type": "application/json",
|
||||||
|
"url": "https://vercel.com/openapi.json",
|
||||||
|
"tags": ["api"],
|
||||||
|
}
|
||||||
|
],
|
||||||
|
}
|
||||||
|
|
||||||
|
|
||||||
|
def test_llms_spec_example_is_valid() -> None:
|
||||||
|
assert formats.llms_problems(SPEC_LLMS) == []
|
||||||
|
|
||||||
|
|
||||||
|
def test_llms_allows_prose_and_plain_bullets() -> None:
|
||||||
|
text = SPEC_LLMS.replace(
|
||||||
|
"## API", "Version: v2.0\n\n## Notes\n- plain bullet\n\n## API"
|
||||||
|
)
|
||||||
|
assert formats.llms_problems(text) == []
|
||||||
|
|
||||||
|
|
||||||
|
@pytest.mark.parametrize(
|
||||||
|
("mutate", "needle"),
|
||||||
|
[
|
||||||
|
(lambda t: t.replace("# Acme\n", ""), "H1"),
|
||||||
|
(
|
||||||
|
lambda t: t.replace("> Acme ships a payments API for developers.\n", ""),
|
||||||
|
"blockquote",
|
||||||
|
),
|
||||||
|
(lambda t: "# Acme\n> summary\n\nno sections\n", "link list"),
|
||||||
|
(lambda t: "<!doctype html><html></html>", "HTML"),
|
||||||
|
],
|
||||||
|
)
|
||||||
|
def test_llms_rejects(mutate: object, needle: str) -> None:
|
||||||
|
problems = formats.llms_problems(mutate(SPEC_LLMS)) # type: ignore[operator]
|
||||||
|
assert any(needle in p for p in problems), problems
|
||||||
|
|
||||||
|
|
||||||
|
def test_llms_links() -> None:
|
||||||
|
assert formats.llms_links(SPEC_LLMS)[0] == "https://example.com/docs/quickstart"
|
||||||
|
|
||||||
|
|
||||||
|
def test_catalog_valid_examples() -> None:
|
||||||
|
assert formats.catalog_problems(VERCEL_CATALOG) == []
|
||||||
|
assert formats.catalog_problems(sitegen.CATALOG) == []
|
||||||
|
minimal = {
|
||||||
|
"specVersion": "1.0",
|
||||||
|
"entries": [{"identifier": "a", "type": "t", "data": {}}],
|
||||||
|
}
|
||||||
|
assert formats.catalog_problems(minimal) == []
|
||||||
|
|
||||||
|
|
||||||
|
@pytest.mark.parametrize(
|
||||||
|
("doc", "needle"),
|
||||||
|
[
|
||||||
|
([], "object"),
|
||||||
|
({"entries": []}, "specVersion"),
|
||||||
|
({"specVersion": "1", "entries": []}, "Major.Minor"),
|
||||||
|
({"specVersion": "1.0"}, "entries"),
|
||||||
|
({"specVersion": "1.0", "entries": [{"type": "t", "url": "u"}]}, "identifier"),
|
||||||
|
({"specVersion": "1.0", "entries": [{"identifier": "i", "url": "u"}]}, "type"),
|
||||||
|
(
|
||||||
|
{
|
||||||
|
"specVersion": "1.0",
|
||||||
|
"entries": [{"identifier": "i", "type": "t", "url": "u", "data": 1}],
|
||||||
|
},
|
||||||
|
"exactly one",
|
||||||
|
),
|
||||||
|
({"specVersion": "1.0", "entries": [], "host": {}}, "host.displayName"),
|
||||||
|
],
|
||||||
|
)
|
||||||
|
def test_catalog_rejects(doc: object, needle: str) -> None:
|
||||||
|
assert any(needle in p for p in formats.catalog_problems(doc)), (
|
||||||
|
formats.catalog_problems(doc)
|
||||||
|
)
|
||||||
|
|
||||||
|
|
||||||
|
def test_robots_blanket_blocks() -> None:
|
||||||
|
text = "User-agent: *\nDisallow:\n\nUser-Agent: GPTBot\nUser-agent: CCBot\nDisallow: /*\n"
|
||||||
|
groups = formats.parse_robots(text)
|
||||||
|
assert formats.has_wildcard_group(groups)
|
||||||
|
assert formats.blocked_agents(groups) == ["gptbot", "ccbot"]
|
||||||
|
|
||||||
|
|
||||||
|
def test_robots_partial_disallow_and_allow_override() -> None:
|
||||||
|
text = "User-agent: *\nDisallow: /search/\n\nUser-agent: ClaudeBot\nDisallow: /\nAllow: /\n"
|
||||||
|
assert formats.blocked_agents(formats.parse_robots(text)) == []
|
||||||
|
assert formats.robots_sitemaps("Sitemap: https://x.test/s.xml\n") == [
|
||||||
|
"https://x.test/s.xml"
|
||||||
|
]
|
||||||
|
|
||||||
|
|
||||||
|
def test_sitemap_parse() -> None:
|
||||||
|
kind, locs = formats.parse_sitemap(sitegen.SITEMAP.encode())
|
||||||
|
assert kind == "urlset"
|
||||||
|
assert locs == ["https://example.test/", "https://example.test/about/"]
|
||||||
|
with pytest.raises(ValueError):
|
||||||
|
formats.parse_sitemap(b"<html>not xml")
|
||||||
|
|
||||||
|
|
||||||
|
def test_untagged_fences() -> None:
|
||||||
|
assert formats.untagged_fences("```python\nx\n```\n") == 0
|
||||||
|
assert formats.untagged_fences("```\nx\n```\n~~~\ny\n~~~\n") == 2
|
||||||
|
|
||||||
|
|
||||||
|
def test_htmlscan_good_home() -> None:
|
||||||
|
scan = htmlscan.scan(sitegen.page("Dice", "/index.md", home=True))
|
||||||
|
assert len(scan.text) > 150
|
||||||
|
assert scan.code_blocks == 1 and scan.untagged_code == 0
|
||||||
|
assert scan.link_href("alternate", "text/markdown") == "/index.md"
|
||||||
|
assert scan.link_href("ai-catalog") == "/.well-known/ai-catalog.json"
|
||||||
|
assert "/about/" in scan.anchors
|
||||||
|
assert scan.jsonld_ok == 1
|
||||||
|
|
||||||
|
|
||||||
|
def test_htmlscan_shell_has_no_text() -> None:
|
||||||
|
scan = htmlscan.scan(sitegen.SHELL)
|
||||||
|
assert scan.text.strip() == "" # <title> is head, not body text
|
||||||
|
assert scan.anchors == []
|
||||||
|
bare = htmlscan.scan(
|
||||||
|
'<pre><code>x</code></pre><script type="application/ld+json">{bad</script>'
|
||||||
|
)
|
||||||
|
assert bare.untagged_code == 1 and bare.jsonld_bad == 1
|
||||||
|
|
||||||
|
|
||||||
|
def test_sitemap_wrong_root_is_rejected() -> None:
|
||||||
|
with pytest.raises(ValueError, match="not <urlset>"):
|
||||||
|
formats.parse_sitemap(b"<feed><loc>https://x.test/</loc></feed>")
|
||||||
|
|
||||||
|
|
||||||
|
def test_catalog_entry_must_be_an_object() -> None:
|
||||||
|
doc = {"specVersion": "1.0", "entries": ["nope"]}
|
||||||
|
assert formats.catalog_problems(doc) == ["entries[0]: must be an object"]
|
||||||
|
|
||||||
|
|
||||||
|
def test_catalog_accessors_tolerate_invalid_docs() -> None:
|
||||||
|
for doc in ([], {"entries": "x"}):
|
||||||
|
assert formats.catalog_urls(doc) == []
|
||||||
|
assert formats.catalog_types(doc) == []
|
||||||
|
assert formats.catalog_urls(sitegen.CATALOG) == [f"{sitegen.ORIGIN}/llms.txt"]
|
||||||
|
|
||||||
|
|
||||||
|
def test_fence_inside_fence_is_not_a_new_block() -> None:
|
||||||
|
nested = "````md\n```\ninner\n```\n````\n"
|
||||||
|
assert formats.untagged_fences(nested) == 0
|
||||||
|
assert formats.untagged_fences("```python\n~~~\n```\n```\nz\n```\n") == 1
|
||||||
|
|
||||||
|
|
||||||
|
def test_htmlscan_jsonld_without_context_is_bad() -> None:
|
||||||
|
scan = htmlscan.scan(
|
||||||
|
'<script type="application/ld+json">{"name": "x"}</script>'
|
||||||
|
'<script type="application/ld+json">[]</script>'
|
||||||
|
)
|
||||||
|
assert scan.jsonld_ok == 0 and scan.jsonld_bad == 2
|
||||||
|
|
||||||
|
|
||||||
|
def test_htmlscan_unclosed_inner_hidden_tag_closes_with_outer() -> None:
|
||||||
|
scan = htmlscan.scan("<body><template><noscript>x</template><p>visible</p></body>")
|
||||||
|
assert scan.text == "visible"
|
||||||
54
agent_ready/tests/test_report_ctx.py
Normal file
54
agent_ready/tests/test_report_ctx.py
Normal file
@ -0,0 +1,54 @@
|
|||||||
|
"""Report policy, Link-header parsing and context helpers."""
|
||||||
|
|
||||||
|
from __future__ import annotations
|
||||||
|
|
||||||
|
import io
|
||||||
|
|
||||||
|
from agent_ready.backends import Response
|
||||||
|
from agent_ready.context import link_header_href
|
||||||
|
from agent_ready.report import Report, Undeterminable, summarize
|
||||||
|
from agent_ready.tests.fakes import FakeSite, make_ctx, resp
|
||||||
|
|
||||||
|
|
||||||
|
def _boom() -> None:
|
||||||
|
raise Undeterminable("refused")
|
||||||
|
|
||||||
|
|
||||||
|
def test_guard_turns_network_failure_into_skip_and_exit_3() -> None:
|
||||||
|
out = io.StringIO()
|
||||||
|
report = Report(out=out)
|
||||||
|
report.guard("AR-FIND-01", _boom)
|
||||||
|
assert out.getvalue() == "SKIP AR-FIND-01 undeterminable (network): refused\n"
|
||||||
|
assert report.exit_code() == 3
|
||||||
|
report.fail("AR-FIND-01", "x")
|
||||||
|
assert report.exit_code() == 1
|
||||||
|
|
||||||
|
|
||||||
|
def test_summarize_notes_the_overflow() -> None:
|
||||||
|
assert summarize(["a", "b"]) == "a, b"
|
||||||
|
assert summarize(list("abcdef")) == "a, b, c, d (+2 more)"
|
||||||
|
|
||||||
|
|
||||||
|
def _linked(link: str) -> Response:
|
||||||
|
return Response(200, "text/html", b"", {"link": link})
|
||||||
|
|
||||||
|
|
||||||
|
def test_link_header_skips_unusable_values() -> None:
|
||||||
|
header = (
|
||||||
|
"garbage, </no-rel>; type=x, </other>; rel=preload, "
|
||||||
|
'</a.md>; rel="alternate"; type="text/plain", '
|
||||||
|
'</b.md>; rel="alternate"; type="text/markdown"'
|
||||||
|
)
|
||||||
|
assert link_header_href(_linked(header), "alternate", "text/markdown") == "/b.md"
|
||||||
|
assert link_header_href(_linked(header), "alternate") == "/a.md"
|
||||||
|
assert link_header_href(_linked(header), "ai-catalog") is None
|
||||||
|
assert link_header_href(_linked(""), "alternate") is None
|
||||||
|
|
||||||
|
|
||||||
|
def test_exists_rejects_html_fallback_for_files() -> None:
|
||||||
|
ctx, _ = make_ctx(
|
||||||
|
FakeSite({"/f.txt": resp("<html><head></head>"), "/p/": resp("<html>")})
|
||||||
|
)
|
||||||
|
assert not ctx.exists("/f.txt")
|
||||||
|
assert ctx.exists("/p/")
|
||||||
|
assert not ctx.exists("/missing.txt")
|
||||||
52
app_errors/README.md
Normal file
52
app_errors/README.md
Normal file
@ -0,0 +1,52 @@
|
|||||||
|
# app_errors
|
||||||
|
|
||||||
|
The PC side of kuhy's app error and slow-wait reporting. Every app reports
|
||||||
|
errors, and every wait the user sees over 1 s (`perf.slow`). This ingest merges
|
||||||
|
the reports by signature and writes `~/.local/state/app-errors/<app>.json` in
|
||||||
|
the todoImplementer `contracts/app-error.schema.json` `report` shape. The board
|
||||||
|
reads that folder and turns each open error into a self-fixing ticket
|
||||||
|
(todoImplementer `DOCS-errors.md`).
|
||||||
|
|
||||||
|
Generalised from kartka's `tools/errors`. Dart signatures are byte-identical to
|
||||||
|
kartka's. See `DOCS-app-errors.md` at the repo root for the whole pipeline.
|
||||||
|
|
||||||
|
## Where reports come from
|
||||||
|
|
||||||
|
| Reporter | Runs on | Writes |
|
||||||
|
|---|---|---|
|
||||||
|
| `crdt_sync_flutter` `installErrorReporting` | phone, desktop, web | RTDB `/<app>/errors/<device>/<id>` |
|
||||||
|
| `gatelock.error_report.install` | PC (Tk) | spool `~/.local/state/app-errors-spool/<app>.jsonl` |
|
||||||
|
| Godot `addons/app_errors` (`godot_dev_tools/`) | PC | the same spool |
|
||||||
|
|
||||||
|
The ingest skips `kartka` in RTDB, because kartka still runs its own ingest.
|
||||||
|
|
||||||
|
## Entry (one report, every language)
|
||||||
|
|
||||||
|
`at` (ISO UTC), `kind` (`uncaught.flutter`, `uncaught.python`, `uncaught.gdscript`,
|
||||||
|
`ui.snackbar`, `perf.slow`, ...), `error`, `stack` (list of frames), plus these
|
||||||
|
optional fields:
|
||||||
|
|
||||||
|
- `repo` (`owner/name`, default `kuhyx/<app>`)
|
||||||
|
- `mark` (the substring that marks the app's own frames: `package:todo/`,
|
||||||
|
`leetcode_guard/`, `res://`)
|
||||||
|
- `route`
|
||||||
|
- `operation`, `durationMs`, `waitId` and `still` (slow waits)
|
||||||
|
- `build` (versionCode, 0 when unknown) and `version`
|
||||||
|
|
||||||
|
## Commands
|
||||||
|
|
||||||
|
```bash
|
||||||
|
app-errors ingest # what the timer runs every 5 min
|
||||||
|
app-errors ingest --keep # leave RTDB entries in place
|
||||||
|
app-errors ingest --no-rtdb # local spool only
|
||||||
|
app-errors resolve <app> <signature> # mark it fixed; a newer build reopens it
|
||||||
|
```
|
||||||
|
|
||||||
|
`app_errors/install.sh` installs the venv
|
||||||
|
(`~/.local/share/app-errors/venv`), the `app-errors` link and
|
||||||
|
`app-errors-ingest.timer`. `scripts/deploy.sh` runs it.
|
||||||
|
|
||||||
|
RTDB access reuses an already seeded crdt-sync session (`--session`, default
|
||||||
|
`firebase_backup`), so the ingest needs no sign-in of its own.
|
||||||
|
|
||||||
|
Tests: `cd app_errors && python -m pytest` (100 % branch coverage).
|
||||||
2
app_errors/app_errors/__init__.py
Normal file
2
app_errors/app_errors/__init__.py
Normal file
@ -0,0 +1,2 @@
|
|||||||
|
# Copyright (c) 2026 Krzysztof Rudnicki
|
||||||
|
"""Shared app error and slow-wait ingest: RTDB and spool reports in, board tickets out."""
|
||||||
66
app_errors/app_errors/cli.py
Normal file
66
app_errors/app_errors/cli.py
Normal file
@ -0,0 +1,66 @@
|
|||||||
|
# Copyright (c) 2026 Krzysztof Rudnicki
|
||||||
|
"""``app-errors``: ``ingest`` (what the timer runs) and ``resolve <app> <signature>``."""
|
||||||
|
|
||||||
|
from __future__ import annotations
|
||||||
|
|
||||||
|
import argparse
|
||||||
|
import datetime as dt
|
||||||
|
import sys
|
||||||
|
from typing import TYPE_CHECKING
|
||||||
|
|
||||||
|
from app_errors import ingest, store
|
||||||
|
from app_errors.rtdb import DEFAULT_SESSION, RtdbError, open_rtdb
|
||||||
|
|
||||||
|
if TYPE_CHECKING:
|
||||||
|
from collections.abc import Sequence
|
||||||
|
|
||||||
|
|
||||||
|
def _parser() -> argparse.ArgumentParser:
|
||||||
|
parser = argparse.ArgumentParser(prog="app-errors", description=__doc__)
|
||||||
|
sub = parser.add_subparsers(dest="command", required=True)
|
||||||
|
run = sub.add_parser("ingest", help="read RTDB and the spool, write the board reports")
|
||||||
|
run.add_argument("--keep", action="store_true", help="leave RTDB entries in place")
|
||||||
|
run.add_argument("--no-rtdb", action="store_true", help="read the local spool only")
|
||||||
|
run.add_argument("--session", default=DEFAULT_SESSION, help="seeded crdt-sync credential store")
|
||||||
|
res = sub.add_parser("resolve", help="mark an error fixed (a newer build reopens it)")
|
||||||
|
res.add_argument("app")
|
||||||
|
res.add_argument("signature")
|
||||||
|
return parser
|
||||||
|
|
||||||
|
|
||||||
|
def _ingest(args: argparse.Namespace) -> int:
|
||||||
|
db, error = None, None
|
||||||
|
if not args.no_rtdb:
|
||||||
|
try:
|
||||||
|
db = open_rtdb(args.session)
|
||||||
|
except RtdbError as e:
|
||||||
|
error = str(e)
|
||||||
|
summary = ingest.run(ingest.default_paths(), db, keep=args.keep)
|
||||||
|
error = error or summary.rtdb_error
|
||||||
|
print(f"app-errors: {summary.merged} new") # noqa: T201 -- terminal-only CLI
|
||||||
|
if error:
|
||||||
|
print(f"app-errors: RTDB: {error}", file=sys.stderr) # noqa: T201
|
||||||
|
return 1
|
||||||
|
return 0
|
||||||
|
|
||||||
|
|
||||||
|
def _resolve(args: argparse.Namespace) -> int:
|
||||||
|
paths = ingest.default_paths()
|
||||||
|
state = store.load(paths.state)
|
||||||
|
now = dt.datetime.now(dt.UTC).strftime("%Y-%m-%dT%H:%M:%S.%fZ")
|
||||||
|
if not store.resolve(state, args.app, args.signature, now=now):
|
||||||
|
print(f"app-errors: unknown error {args.app} {args.signature}", file=sys.stderr) # noqa: T201
|
||||||
|
return 1
|
||||||
|
store.save(paths.state, state)
|
||||||
|
store.write_reports(paths.reports, state)
|
||||||
|
return 0
|
||||||
|
|
||||||
|
|
||||||
|
def main(argv: Sequence[str] | None = None) -> int:
|
||||||
|
"""Run the CLI; return the exit code."""
|
||||||
|
args = _parser().parse_args(argv)
|
||||||
|
return _ingest(args) if args.command == "ingest" else _resolve(args)
|
||||||
|
|
||||||
|
|
||||||
|
if __name__ == "__main__": # pragma: no cover
|
||||||
|
sys.exit(main())
|
||||||
96
app_errors/app_errors/ingest.py
Normal file
96
app_errors/app_errors/ingest.py
Normal file
@ -0,0 +1,96 @@
|
|||||||
|
# Copyright (c) 2026 Krzysztof Rudnicki
|
||||||
|
"""One ingest pass: RTDB and the local spool in, the board's reports out.
|
||||||
|
|
||||||
|
In: RTDB ``/<app>/errors/<device>/<id>`` and the spool. Out:
|
||||||
|
``<state>/app-errors/<app>.json``, the board's contract report.
|
||||||
|
|
||||||
|
RTDB entries are deleted once the state holding them is saved (``keep``
|
||||||
|
leaves them; ``seen`` stops a second count). kartka is skipped: it still runs
|
||||||
|
its own ingest (``~/src/kartka/tools/errors``), which the board reads through
|
||||||
|
its ``kartka`` adapter, and two readers of ``/kartka/errors`` would race.
|
||||||
|
"""
|
||||||
|
|
||||||
|
from __future__ import annotations
|
||||||
|
|
||||||
|
from dataclasses import dataclass
|
||||||
|
import os
|
||||||
|
from pathlib import Path
|
||||||
|
from typing import TYPE_CHECKING
|
||||||
|
|
||||||
|
from app_errors import spool, store
|
||||||
|
from app_errors.rtdb import RtdbError
|
||||||
|
|
||||||
|
if TYPE_CHECKING:
|
||||||
|
from app_errors.rtdb import Rtdb
|
||||||
|
|
||||||
|
#: Apps with their own ingest, never read here (kartka moved over 2026-11-17).
|
||||||
|
SKIP_APPS: frozenset[str] = frozenset()
|
||||||
|
|
||||||
|
|
||||||
|
@dataclass(frozen=True)
|
||||||
|
class Paths:
|
||||||
|
"""Where the ingest keeps its state, writes reports and reads the spool."""
|
||||||
|
|
||||||
|
state: Path
|
||||||
|
reports: Path
|
||||||
|
spool: Path
|
||||||
|
|
||||||
|
|
||||||
|
@dataclass(frozen=True)
|
||||||
|
class Summary:
|
||||||
|
"""What one pass did."""
|
||||||
|
|
||||||
|
merged: int
|
||||||
|
rtdb_error: str | None
|
||||||
|
|
||||||
|
|
||||||
|
def default_paths() -> Paths:
|
||||||
|
"""Return the paths under ``$XDG_STATE_HOME`` (default ``~/.local/state``)."""
|
||||||
|
base = Path(os.environ.get("XDG_STATE_HOME") or Path.home() / ".local" / "state")
|
||||||
|
return Paths(
|
||||||
|
base / "app-errors-ingest" / "state.json",
|
||||||
|
base / "app-errors",
|
||||||
|
base / "app-errors-spool",
|
||||||
|
)
|
||||||
|
|
||||||
|
|
||||||
|
def _rtdb_entries(
|
||||||
|
db: Rtdb,
|
||||||
|
) -> tuple[list[tuple[str, str, object]], dict[str, dict[str, object]]]:
|
||||||
|
"""Return (app, device/id, entry) for every RTDB report, and the deletes that consume them."""
|
||||||
|
found: list[tuple[str, str, object]] = []
|
||||||
|
deletes: dict[str, dict[str, object]] = {}
|
||||||
|
top = db.get("", shallow=True)
|
||||||
|
for app in sorted(top) if isinstance(top, dict) else []:
|
||||||
|
if app in SKIP_APPS or not store.APP_NAME.match(app):
|
||||||
|
continue
|
||||||
|
devices = db.get(f"{app}/errors")
|
||||||
|
for device, entries in devices.items() if isinstance(devices, dict) else []:
|
||||||
|
for entry_id, entry in entries.items() if isinstance(entries, dict) else []:
|
||||||
|
found.append((app, f"{device}/{entry_id}", entry))
|
||||||
|
deletes.setdefault(app, {})[f"{device}/{entry_id}"] = None
|
||||||
|
return found, deletes
|
||||||
|
|
||||||
|
|
||||||
|
def run(paths: Paths, db: Rtdb | None, *, keep: bool = False) -> Summary:
|
||||||
|
"""Ingest everything once; RTDB failures are returned, the spool still goes in."""
|
||||||
|
state = store.load(paths.state)
|
||||||
|
merged = 0
|
||||||
|
rtdb_error = None
|
||||||
|
deletes: dict[str, dict[str, object]] = {}
|
||||||
|
if db is not None:
|
||||||
|
try:
|
||||||
|
found, deletes = _rtdb_entries(db)
|
||||||
|
except RtdbError as e:
|
||||||
|
found, rtdb_error = [], str(e)
|
||||||
|
merged += sum(store.merge(state, app, key, entry) for app, key, entry in found)
|
||||||
|
merged += sum(store.merge(state, line.app, line.id, line.entry) for line in spool.drain(paths.spool))
|
||||||
|
store.save(paths.state, state)
|
||||||
|
store.write_reports(paths.reports, state)
|
||||||
|
if db is not None and not keep:
|
||||||
|
try:
|
||||||
|
for app, paths_gone in deletes.items():
|
||||||
|
db.patch(f"{app}/errors", paths_gone)
|
||||||
|
except RtdbError as e:
|
||||||
|
rtdb_error = str(e)
|
||||||
|
return Summary(merged, rtdb_error)
|
||||||
0
app_errors/app_errors/py.typed
Normal file
0
app_errors/app_errors/py.typed
Normal file
104
app_errors/app_errors/rtdb.py
Normal file
104
app_errors/app_errors/rtdb.py
Normal file
@ -0,0 +1,104 @@
|
|||||||
|
# Copyright (c) 2026 Krzysztof Rudnicki
|
||||||
|
"""A minimal RTDB REST client on a seeded crdt-sync Google session.
|
||||||
|
|
||||||
|
Ported from kartka's ``tools/errors`` (``kartka_errors.rtdb``), plus
|
||||||
|
``shallow`` reads to list the apps. The sync account is Google-only, so the
|
||||||
|
session is an already seeded ``~/.config/<store>/firebase_auth.json`` (crdt-
|
||||||
|
sync's ``tool.seed_session`` writes one; it refreshes itself). The request URL
|
||||||
|
carries the ID token (``?auth=``), so no error raised here ever includes it.
|
||||||
|
"""
|
||||||
|
|
||||||
|
from __future__ import annotations
|
||||||
|
|
||||||
|
from collections.abc import Callable
|
||||||
|
import json
|
||||||
|
from typing import Protocol
|
||||||
|
import urllib.error
|
||||||
|
import urllib.request
|
||||||
|
|
||||||
|
#: The credential store read by default: the backup timer's, a PC-side reader
|
||||||
|
#: of the same database (any seeded store of the sync account works).
|
||||||
|
DEFAULT_SESSION = "firebase_backup"
|
||||||
|
#: Per-request timeout, seconds (token refresh has its own, below).
|
||||||
|
TIMEOUT = 15.0
|
||||||
|
TOKEN_TIMEOUT = 8.0
|
||||||
|
|
||||||
|
type Opener = Callable[..., object]
|
||||||
|
|
||||||
|
|
||||||
|
class RtdbError(RuntimeError):
|
||||||
|
"""An RTDB request failed, or there is no session (the message never names the URL)."""
|
||||||
|
|
||||||
|
|
||||||
|
class Rtdb(Protocol):
|
||||||
|
"""Read and multi-path write access to RTDB."""
|
||||||
|
|
||||||
|
def get(self, path: str, *, shallow: bool = False) -> object:
|
||||||
|
"""Return the decoded JSON at ``path`` (None when absent)."""
|
||||||
|
...
|
||||||
|
|
||||||
|
def patch(self, path: str, data: dict[str, object]) -> None:
|
||||||
|
"""Apply a multi-path update of ``path`` (a None value deletes)."""
|
||||||
|
...
|
||||||
|
|
||||||
|
|
||||||
|
class RestRtdb:
|
||||||
|
"""RTDB over REST with ``?auth=<id token>``."""
|
||||||
|
|
||||||
|
def __init__(
|
||||||
|
self,
|
||||||
|
database_url: str,
|
||||||
|
id_token: Callable[[], str],
|
||||||
|
opener: Opener = urllib.request.urlopen,
|
||||||
|
) -> None:
|
||||||
|
"""Talk to ``database_url`` with tokens from ``id_token``."""
|
||||||
|
self._url = database_url.rstrip("/")
|
||||||
|
self._id_token = id_token
|
||||||
|
self._open = opener
|
||||||
|
|
||||||
|
def _send(self, method: str, path: str, body: bytes | None, query: str = "") -> object:
|
||||||
|
try:
|
||||||
|
token = self._id_token()
|
||||||
|
except Exception as e: # noqa: BLE001 -- any refresh failure, typed only
|
||||||
|
msg = f"RTDB {method} {path}: token refresh failed ({type(e).__name__})"
|
||||||
|
raise RtdbError(msg) from None
|
||||||
|
req = urllib.request.Request( # noqa: S310 -- https only, built here
|
||||||
|
f"{self._url}/{path}.json?auth={token}{query}",
|
||||||
|
data=body,
|
||||||
|
method=method,
|
||||||
|
headers={"Content-Type": "application/json"},
|
||||||
|
)
|
||||||
|
try:
|
||||||
|
with self._open(req, timeout=TIMEOUT) as res: # type: ignore[attr-defined]
|
||||||
|
return json.loads(res.read() or b"null")
|
||||||
|
except urllib.error.HTTPError as e:
|
||||||
|
msg = f"RTDB {method} {path}: HTTP {e.code}"
|
||||||
|
raise RtdbError(msg) from None
|
||||||
|
except (urllib.error.URLError, OSError, ValueError) as e:
|
||||||
|
msg = f"RTDB {method} {path}: {type(e).__name__}"
|
||||||
|
raise RtdbError(msg) from None
|
||||||
|
|
||||||
|
def get(self, path: str, *, shallow: bool = False) -> object:
|
||||||
|
"""GET ``path``; raises :class:`RtdbError` on any failure."""
|
||||||
|
return self._send("GET", path, None, "&shallow=true" if shallow else "")
|
||||||
|
|
||||||
|
def patch(self, path: str, data: dict[str, object]) -> None:
|
||||||
|
"""PATCH ``data`` into ``path``; raises :class:`RtdbError`."""
|
||||||
|
self._send("PATCH", path, json.dumps(data).encode())
|
||||||
|
|
||||||
|
|
||||||
|
def open_rtdb(session: str = DEFAULT_SESSION) -> RestRtdb:
|
||||||
|
"""Return the client on the seeded ``session``; :class:`RtdbError` without one."""
|
||||||
|
import crdt_sync # noqa: PLC0415 -- only the RTDB path needs it; spool-only runs stay stdlib
|
||||||
|
|
||||||
|
try:
|
||||||
|
config = crdt_sync.FirebaseConfig.load()
|
||||||
|
except Exception as e: # noqa: BLE001 -- a missing or broken config, typed only
|
||||||
|
msg = f"no Firebase config ({type(e).__name__})"
|
||||||
|
raise RtdbError(msg) from None
|
||||||
|
store = crdt_sync.credential_store_for(session)
|
||||||
|
auth = crdt_sync.FirebaseTokenProvider(config.api_key, store, timeout_seconds=TOKEN_TIMEOUT)
|
||||||
|
if not auth.has_session():
|
||||||
|
msg = f"no seeded sign-in session '{session}'; seed one with crdt-sync's tool.seed_session --app {session}"
|
||||||
|
raise RtdbError(msg)
|
||||||
|
return RestRtdb(config.database_url, auth.id_token)
|
||||||
128
app_errors/app_errors/signature.py
Normal file
128
app_errors/app_errors/signature.py
Normal file
@ -0,0 +1,128 @@
|
|||||||
|
# Copyright (c) 2026 Krzysztof Rudnicki
|
||||||
|
"""Group error reports: one signature per bug, however often it fires.
|
||||||
|
|
||||||
|
Ported from kartka's ``tools/errors`` (``kartka_errors.signature``) and kept
|
||||||
|
byte-identical for Dart entries, so kartka's existing tickets keep their ids
|
||||||
|
when it moves onto this ingest. Generalised in one place only: which stack
|
||||||
|
frames belong to the app. An entry's ``mark`` names them (``package:todo/``
|
||||||
|
for Dart, ``leetcode_guard/`` for Python, ``res://`` for GDScript); without
|
||||||
|
one it is ``package:<app>/``.
|
||||||
|
|
||||||
|
A signature is the error type, the message with its volatile parts (numbers,
|
||||||
|
ids, URLs) masked, and where it happened: the first app frame without line
|
||||||
|
numbers (so an edit elsewhere in the file does not split it), else the route,
|
||||||
|
else the entry kind. A slow wait is its route + operation, never its time.
|
||||||
|
"""
|
||||||
|
|
||||||
|
from __future__ import annotations
|
||||||
|
|
||||||
|
from dataclasses import dataclass
|
||||||
|
import hashlib
|
||||||
|
import re
|
||||||
|
from typing import TYPE_CHECKING
|
||||||
|
|
||||||
|
if TYPE_CHECKING:
|
||||||
|
from collections.abc import Mapping, Sequence
|
||||||
|
|
||||||
|
#: The longest normalised message kept in a signature.
|
||||||
|
MAX_MESSAGE = 160
|
||||||
|
#: The entry kind of a user-visible wait over a second.
|
||||||
|
SLOW_KIND = "perf.slow"
|
||||||
|
|
||||||
|
_TYPE = re.compile(r"^(?:Unhandled error: )?([A-Z][\w$]*(?:Exception|Error))\b")
|
||||||
|
#: Dart errors whose ``toString`` does not name their type.
|
||||||
|
_DART_PREFIXES = {
|
||||||
|
"Bad state": "StateError",
|
||||||
|
"Invalid argument": "ArgumentError",
|
||||||
|
"Unsupported operation": "UnsupportedError",
|
||||||
|
"Null check operator": "TypeError",
|
||||||
|
"Concurrent modification": "ConcurrentModificationError",
|
||||||
|
}
|
||||||
|
_URL = re.compile(r"(https?://\S+|<url>)")
|
||||||
|
_UUID = re.compile(r"\b[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}\b", re.IGNORECASE)
|
||||||
|
_HEX = re.compile(r"\b(?=[0-9a-f]*\d)[0-9a-f]{8,}\b", re.IGNORECASE)
|
||||||
|
_NUMBER = re.compile(r"\b\d+(\.\d+)?\b")
|
||||||
|
_SPACE = re.compile(r"\s+")
|
||||||
|
_FRAME = re.compile(r"^#\d+\s+")
|
||||||
|
_LINE_COL = re.compile(r"(\.(?:dart|py|gd))(:\d+)+")
|
||||||
|
#: Frames of the reporting plumbing itself, never the bug's location.
|
||||||
|
_PLUMBING = (
|
||||||
|
"package:kartka/app/error_hooks.dart",
|
||||||
|
"package:kartka/core/diagnostics/",
|
||||||
|
"package:crdt_sync_flutter/src/errors/",
|
||||||
|
"gatelock/error_report.py",
|
||||||
|
"res://addons/app_errors/",
|
||||||
|
)
|
||||||
|
|
||||||
|
|
||||||
|
@dataclass(frozen=True)
|
||||||
|
class Signature:
|
||||||
|
"""What groups reports of one bug."""
|
||||||
|
|
||||||
|
id: str
|
||||||
|
type: str
|
||||||
|
message: str
|
||||||
|
where: str
|
||||||
|
|
||||||
|
|
||||||
|
def error_type(error: str, kind: str) -> str:
|
||||||
|
"""Return the exception type named by ``error``, else ``kind``."""
|
||||||
|
if match := _TYPE.match(error):
|
||||||
|
return match[1]
|
||||||
|
for prefix, name in _DART_PREFIXES.items():
|
||||||
|
if error.startswith(prefix):
|
||||||
|
return name
|
||||||
|
return kind
|
||||||
|
|
||||||
|
|
||||||
|
def normalise(message: str) -> str:
|
||||||
|
"""Return ``message`` with URLs, uuids, long hex and numbers masked, trimmed."""
|
||||||
|
text = _URL.sub("<url>", message)
|
||||||
|
text = _UUID.sub("<uuid>", text)
|
||||||
|
text = _HEX.sub("<hex>", text)
|
||||||
|
text = _NUMBER.sub("<n>", text)
|
||||||
|
return _SPACE.sub(" ", text).strip()[:MAX_MESSAGE]
|
||||||
|
|
||||||
|
|
||||||
|
def top_frame(stack: Sequence[str], mark: str) -> str | None:
|
||||||
|
"""Return the first frame containing ``mark`` outside the reporting plumbing."""
|
||||||
|
for frame in stack:
|
||||||
|
if mark in frame and not any(p in frame for p in _PLUMBING):
|
||||||
|
return _LINE_COL.sub(r"\1", _FRAME.sub("", frame.strip()))
|
||||||
|
return None
|
||||||
|
|
||||||
|
|
||||||
|
def mark_of(entry: Mapping[str, object], app: str) -> str:
|
||||||
|
"""Return the substring that marks the app's own frames in ``entry``."""
|
||||||
|
mark = entry.get("mark")
|
||||||
|
return mark if isinstance(mark, str) and mark else f"package:{app}/"
|
||||||
|
|
||||||
|
|
||||||
|
def strings(value: object) -> list[str]:
|
||||||
|
"""Return ``value`` as a list of strings; empty when it is not a list."""
|
||||||
|
return [str(v) for v in value] if isinstance(value, list) else []
|
||||||
|
|
||||||
|
|
||||||
|
def _digest(text: str) -> str:
|
||||||
|
return hashlib.sha1(text.encode()).hexdigest()[:10] # noqa: S324 -- a grouping key, not security
|
||||||
|
|
||||||
|
|
||||||
|
def signature(entry: Mapping[str, object], *, app: str) -> Signature:
|
||||||
|
"""Return the signature of one report of ``app``."""
|
||||||
|
kind = str(entry.get("kind", "?"))
|
||||||
|
if kind == SLOW_KIND:
|
||||||
|
operation = str(entry.get("operation") or "?")
|
||||||
|
where = f"route {entry.get('route') or '?'}"
|
||||||
|
return Signature(
|
||||||
|
_digest(f"{SLOW_KIND}|{where}|{operation}"),
|
||||||
|
SLOW_KIND,
|
||||||
|
f"slow wait: {operation}",
|
||||||
|
where,
|
||||||
|
)
|
||||||
|
error = str(entry.get("error", ""))
|
||||||
|
frame = top_frame(strings(entry.get("stack")), mark_of(entry, app))
|
||||||
|
route = entry.get("route")
|
||||||
|
where = frame or (f"route {route}" if route else f"kind {kind}")
|
||||||
|
kind_type = error_type(error, kind)
|
||||||
|
message = normalise(error)
|
||||||
|
return Signature(_digest(f"{kind_type}|{message}|{where}"), kind_type, message, where)
|
||||||
66
app_errors/app_errors/spool.py
Normal file
66
app_errors/app_errors/spool.py
Normal file
@ -0,0 +1,66 @@
|
|||||||
|
# Copyright (c) 2026 Krzysztof Rudnicki
|
||||||
|
"""The local spool: how PC apps (Tk gate windows, Godot games) report.
|
||||||
|
|
||||||
|
They run on the PC the ingest runs on, so they need no RTDB: each report is
|
||||||
|
one JSON line appended to ``<spool>/<app>.jsonl`` (the writers are
|
||||||
|
``gatelock.error_report`` and the Godot ``app_errors`` addon; this module is
|
||||||
|
the reference writer and the reader). The ingest claims a file by renaming it
|
||||||
|
to ``.jsonl.ingesting`` before reading, so a line appended meanwhile lands in
|
||||||
|
a fresh file and is never lost. The spool sits beside, not inside, the
|
||||||
|
board's ``app-errors/`` folder, which reads every ``*.json`` there.
|
||||||
|
"""
|
||||||
|
|
||||||
|
from __future__ import annotations
|
||||||
|
|
||||||
|
from dataclasses import dataclass
|
||||||
|
import hashlib
|
||||||
|
import json
|
||||||
|
from typing import TYPE_CHECKING
|
||||||
|
|
||||||
|
from app_errors.store import APP_NAME
|
||||||
|
|
||||||
|
if TYPE_CHECKING:
|
||||||
|
from collections.abc import Iterator, Mapping
|
||||||
|
from pathlib import Path
|
||||||
|
|
||||||
|
SUFFIX = ".jsonl"
|
||||||
|
CLAIMED = ".jsonl.ingesting"
|
||||||
|
|
||||||
|
|
||||||
|
@dataclass(frozen=True)
|
||||||
|
class Line:
|
||||||
|
"""One spooled report: its app, a stable id and the decoded entry."""
|
||||||
|
|
||||||
|
app: str
|
||||||
|
id: str
|
||||||
|
entry: object
|
||||||
|
|
||||||
|
|
||||||
|
def append(folder: Path, app: str, entry: Mapping[str, object]) -> None:
|
||||||
|
"""Append ``entry`` as one line to ``app``'s spool file."""
|
||||||
|
folder.mkdir(parents=True, exist_ok=True)
|
||||||
|
with (folder / f"{app}{SUFFIX}").open("a", encoding="utf-8") as f:
|
||||||
|
f.write(json.dumps(entry, sort_keys=True) + "\n")
|
||||||
|
|
||||||
|
|
||||||
|
def _claim(folder: Path) -> list[Path]:
|
||||||
|
for path in folder.glob(f"*{SUFFIX}"):
|
||||||
|
path.replace(path.with_name(path.name.removesuffix(SUFFIX) + CLAIMED))
|
||||||
|
return sorted(folder.glob(f"*{CLAIMED}"))
|
||||||
|
|
||||||
|
|
||||||
|
def drain(folder: Path) -> Iterator[Line]:
|
||||||
|
"""Yield every spooled line, then delete the files it came from."""
|
||||||
|
if not folder.is_dir():
|
||||||
|
return
|
||||||
|
for path in _claim(folder):
|
||||||
|
app = path.name.removesuffix(CLAIMED)
|
||||||
|
if APP_NAME.match(app):
|
||||||
|
for text in path.read_text(encoding="utf-8").splitlines():
|
||||||
|
try:
|
||||||
|
entry = json.loads(text)
|
||||||
|
except ValueError:
|
||||||
|
continue
|
||||||
|
digest = hashlib.sha1(text.encode()).hexdigest()[:20] # noqa: S324 -- an id, not security
|
||||||
|
yield Line(app, f"spool/{digest}", entry)
|
||||||
|
path.unlink()
|
||||||
207
app_errors/app_errors/store.py
Normal file
207
app_errors/app_errors/store.py
Normal file
@ -0,0 +1,207 @@
|
|||||||
|
# Copyright (c) 2026 Krzysztof Rudnicki
|
||||||
|
"""The local record of every report ingested, grouped by app and signature.
|
||||||
|
|
||||||
|
It is the source of truth once RTDB entries and spool lines are consumed:
|
||||||
|
``seen`` makes a re-read count nothing twice, and each signature keeps its
|
||||||
|
count, first and last time, newest build and its resolution. :func:`report`
|
||||||
|
turns one app's records into the todoImplementer ``app-error`` contract
|
||||||
|
(``contracts/app-error.schema.json``, ``report``).
|
||||||
|
|
||||||
|
Resolve and reopen: ``resolve`` stores the time and the newest build seen. A
|
||||||
|
later report reopens the error only when it is a regression: a newer build
|
||||||
|
when both sides know the build, else a report made after the resolve.
|
||||||
|
"""
|
||||||
|
|
||||||
|
from __future__ import annotations
|
||||||
|
|
||||||
|
import json
|
||||||
|
import os
|
||||||
|
from pathlib import Path
|
||||||
|
import re
|
||||||
|
import tempfile
|
||||||
|
from typing import TYPE_CHECKING, NotRequired, TypedDict, cast
|
||||||
|
|
||||||
|
from app_errors.signature import SLOW_KIND, mark_of, signature, strings, top_frame
|
||||||
|
|
||||||
|
if TYPE_CHECKING:
|
||||||
|
from collections.abc import Mapping
|
||||||
|
|
||||||
|
#: Entry ids remembered for dedup (oldest dropped first).
|
||||||
|
MAX_SEEN = 5000
|
||||||
|
#: An app name the board accepts (the contract's ``app`` pattern).
|
||||||
|
APP_NAME = re.compile(r"^[a-z0-9][a-z0-9_-]*$")
|
||||||
|
_REPO = re.compile(r"^[^/\s]+/[^/\s]+$")
|
||||||
|
|
||||||
|
|
||||||
|
class Resolved(TypedDict):
|
||||||
|
"""When the error was marked fixed, and the newest build seen then."""
|
||||||
|
|
||||||
|
at: str
|
||||||
|
build: int
|
||||||
|
|
||||||
|
|
||||||
|
class Rec(TypedDict):
|
||||||
|
"""Everything known about one signature of one app."""
|
||||||
|
|
||||||
|
signature: str
|
||||||
|
repo: str
|
||||||
|
kind: str
|
||||||
|
message: str
|
||||||
|
top_frame: str | None
|
||||||
|
route: str | None
|
||||||
|
count: int
|
||||||
|
first_seen: str
|
||||||
|
last_seen: str
|
||||||
|
build: int
|
||||||
|
version_name: str | None
|
||||||
|
longest_ms: NotRequired[int]
|
||||||
|
resolved: Resolved | None
|
||||||
|
|
||||||
|
|
||||||
|
class State(TypedDict):
|
||||||
|
"""The whole state file."""
|
||||||
|
|
||||||
|
version: int
|
||||||
|
seen: dict[str, str]
|
||||||
|
apps: dict[str, dict[str, Rec]]
|
||||||
|
|
||||||
|
|
||||||
|
def empty() -> State:
|
||||||
|
"""Return a state that knows nothing."""
|
||||||
|
return {"version": 1, "seen": {}, "apps": {}}
|
||||||
|
|
||||||
|
|
||||||
|
def load(path: Path) -> State:
|
||||||
|
"""Return the state at ``path``; empty when missing or unreadable."""
|
||||||
|
try:
|
||||||
|
data = json.loads(path.read_text())
|
||||||
|
except OSError, ValueError:
|
||||||
|
return empty()
|
||||||
|
if not isinstance(data, dict) or data.get("version") != 1:
|
||||||
|
return empty()
|
||||||
|
return cast("State", data)
|
||||||
|
|
||||||
|
|
||||||
|
def _atomic_write(path: Path, text: str) -> None:
|
||||||
|
path.parent.mkdir(parents=True, exist_ok=True)
|
||||||
|
fd, tmp = tempfile.mkstemp(dir=path.parent, prefix=f".{path.stem}-")
|
||||||
|
with os.fdopen(fd, "w") as f:
|
||||||
|
f.write(text)
|
||||||
|
Path(tmp).replace(path)
|
||||||
|
|
||||||
|
|
||||||
|
def save(path: Path, state: State) -> None:
|
||||||
|
"""Write ``state`` atomically (temp file + rename)."""
|
||||||
|
_atomic_write(path, json.dumps(state, indent=1, sort_keys=True))
|
||||||
|
|
||||||
|
|
||||||
|
def _int(value: object) -> int:
|
||||||
|
return value if isinstance(value, int) and not isinstance(value, bool) and value >= 0 else 0
|
||||||
|
|
||||||
|
|
||||||
|
def _str(value: object) -> str | None:
|
||||||
|
return value if isinstance(value, str) and value else None
|
||||||
|
|
||||||
|
|
||||||
|
def _reopens(resolved: Resolved, at: str, build: int) -> bool:
|
||||||
|
if build and resolved["build"]:
|
||||||
|
return build > resolved["build"]
|
||||||
|
return at > resolved["at"]
|
||||||
|
|
||||||
|
|
||||||
|
def merge(state: State, app: str, entry_id: str, raw: object) -> bool:
|
||||||
|
"""Count one report ``raw`` of ``app`` under its signature; False when seen or not a report."""
|
||||||
|
if not isinstance(raw, dict):
|
||||||
|
return False
|
||||||
|
entry = cast("Mapping[str, object]", raw)
|
||||||
|
at, kind = entry.get("at"), entry.get("kind")
|
||||||
|
if not isinstance(at, str) or not at or not isinstance(kind, str) or not kind:
|
||||||
|
return False
|
||||||
|
key = f"{app}/{entry_id}"
|
||||||
|
if key in state["seen"]:
|
||||||
|
return False
|
||||||
|
state["seen"][key] = at
|
||||||
|
while len(state["seen"]) > MAX_SEEN:
|
||||||
|
del state["seen"][next(iter(state["seen"]))]
|
||||||
|
sig = signature(entry, app=app)
|
||||||
|
build = _int(entry.get("build"))
|
||||||
|
recs = state["apps"].setdefault(app, {})
|
||||||
|
rec = recs.get(sig.id)
|
||||||
|
if rec is None:
|
||||||
|
repo = _str(entry.get("repo"))
|
||||||
|
rec = recs[sig.id] = {
|
||||||
|
"signature": sig.id,
|
||||||
|
"repo": repo if repo and _REPO.match(repo) else f"kuhyx/{app}",
|
||||||
|
"kind": kind,
|
||||||
|
"message": sig.message,
|
||||||
|
"top_frame": top_frame(strings(entry.get("stack")), mark_of(entry, app)),
|
||||||
|
"route": _str(entry.get("route")),
|
||||||
|
"count": 0,
|
||||||
|
"first_seen": at,
|
||||||
|
"last_seen": at,
|
||||||
|
"build": 0,
|
||||||
|
"version_name": None,
|
||||||
|
"resolved": None,
|
||||||
|
}
|
||||||
|
rec["count"] += 1
|
||||||
|
rec["first_seen"] = min(rec["first_seen"], at)
|
||||||
|
rec["last_seen"] = max(rec["last_seen"], at)
|
||||||
|
if build >= rec["build"]:
|
||||||
|
rec["build"] = build
|
||||||
|
rec["version_name"] = _str(entry.get("version")) or rec["version_name"]
|
||||||
|
if kind == SLOW_KIND:
|
||||||
|
rec["longest_ms"] = max(rec.get("longest_ms", 0), _int(entry.get("durationMs")))
|
||||||
|
resolved = rec["resolved"]
|
||||||
|
if resolved is not None and _reopens(resolved, at, build):
|
||||||
|
rec["resolved"] = None
|
||||||
|
return True
|
||||||
|
|
||||||
|
|
||||||
|
def resolve(state: State, app: str, sig: str, *, now: str) -> bool:
|
||||||
|
"""Mark ``app``'s ``sig`` fixed as of ``now``; False when there is no such error."""
|
||||||
|
rec = state["apps"].get(app, {}).get(sig)
|
||||||
|
if rec is None:
|
||||||
|
return False
|
||||||
|
rec["resolved"] = {"at": now, "build": rec["build"]}
|
||||||
|
return True
|
||||||
|
|
||||||
|
|
||||||
|
def _detail(rec: Rec) -> str | None:
|
||||||
|
route = f"route {rec['route']}" if rec["route"] else None
|
||||||
|
if rec["kind"] == SLOW_KIND:
|
||||||
|
longest = f"longest wait {rec.get('longest_ms', 0)} ms"
|
||||||
|
return f"{longest}, {route}" if route else longest
|
||||||
|
return route
|
||||||
|
|
||||||
|
|
||||||
|
def report(state: State, app: str) -> dict[str, object]:
|
||||||
|
"""Return ``app``'s records as a contract ``report``."""
|
||||||
|
errors = [
|
||||||
|
{
|
||||||
|
"app": app,
|
||||||
|
"repo": rec["repo"],
|
||||||
|
"signature": rec["signature"],
|
||||||
|
"kind": rec["kind"],
|
||||||
|
"message": rec["message"],
|
||||||
|
"top_frame": rec["top_frame"],
|
||||||
|
"count": rec["count"],
|
||||||
|
"first_seen": rec["first_seen"],
|
||||||
|
"last_seen": rec["last_seen"],
|
||||||
|
"build": rec["build"],
|
||||||
|
"version_name": rec["version_name"],
|
||||||
|
"detail": _detail(rec),
|
||||||
|
"open": rec["resolved"] is None,
|
||||||
|
}
|
||||||
|
for rec in sorted(state["apps"].get(app, {}).values(), key=lambda r: r["signature"])
|
||||||
|
]
|
||||||
|
return {"version": 1, "errors": errors}
|
||||||
|
|
||||||
|
|
||||||
|
def write_reports(folder: Path, state: State) -> list[Path]:
|
||||||
|
"""Write ``<folder>/<app>.json`` for every app with records; return the paths."""
|
||||||
|
written = []
|
||||||
|
for app in sorted(state["apps"]):
|
||||||
|
path = folder / f"{app}.json"
|
||||||
|
_atomic_write(path, json.dumps(report(state, app), indent=1))
|
||||||
|
written.append(path)
|
||||||
|
return written
|
||||||
0
app_errors/app_errors/tests/__init__.py
Normal file
0
app_errors/app_errors/tests/__init__.py
Normal file
74
app_errors/app_errors/tests/data/app-error.schema.json
Normal file
74
app_errors/app_errors/tests/data/app-error.schema.json
Normal file
@ -0,0 +1,74 @@
|
|||||||
|
{
|
||||||
|
"$schema": "https://json-schema.org/draft/2020-12/schema",
|
||||||
|
"$id": "https://todoimplementer.local/contracts/app-error.schema.json",
|
||||||
|
"title": "App errors",
|
||||||
|
"description": "What an app writes for the errors loop (DOCS-errors.md): `~/.local/state/app-errors/<app>.json` is a `report`; kartka's own state.json is mapped to the same `record` by an adapter. One record per identical error (signature).",
|
||||||
|
"$defs": {
|
||||||
|
"record": {
|
||||||
|
"type": "object",
|
||||||
|
"description": "One identical error or slow wait. The loop makes one ticket per `app:signature`.",
|
||||||
|
"properties": {
|
||||||
|
"app": { "type": "string", "pattern": "^[a-z0-9][a-z0-9_-]*$" },
|
||||||
|
"repo": { "type": "string", "pattern": "^[^/\\s]+/[^/\\s]+$", "description": "owner/name of the repo that holds the fix." },
|
||||||
|
"signature": { "type": "string", "minLength": 1, "pattern": "^\\S+$", "description": "Stable id of the error: the same error always gets the same one." },
|
||||||
|
"kind": { "type": "string", "minLength": 1, "description": "crash, ui.error, perf.slow, ..." },
|
||||||
|
"message": { "type": "string", "description": "Masked message (no secrets, no user data)." },
|
||||||
|
"top_frame": { "type": ["string", "null"] },
|
||||||
|
"count": { "type": "integer", "minimum": 1 },
|
||||||
|
"first_seen": { "type": "string", "minLength": 1 },
|
||||||
|
"last_seen": { "type": "string", "minLength": 1 },
|
||||||
|
"build": { "type": "integer", "minimum": 0, "description": "Monotonic build of the newest report (Android versionCode); 0 when the source does not know it." },
|
||||||
|
"version_name": { "type": ["string", "null"] },
|
||||||
|
"detail": { "type": ["string", "null"], "description": "Free text: durations, route." },
|
||||||
|
"open": { "type": "boolean", "description": "False once the source marks the error resolved; default true." }
|
||||||
|
},
|
||||||
|
"required": ["app", "repo", "signature", "kind", "message", "count", "first_seen", "last_seen", "build"],
|
||||||
|
"additionalProperties": false
|
||||||
|
},
|
||||||
|
"report": {
|
||||||
|
"type": "object",
|
||||||
|
"properties": {
|
||||||
|
"version": { "const": 1 },
|
||||||
|
"errors": { "type": "array", "items": { "$ref": "#/$defs/record" } }
|
||||||
|
},
|
||||||
|
"required": ["version", "errors"],
|
||||||
|
"additionalProperties": false
|
||||||
|
},
|
||||||
|
"source": {
|
||||||
|
"type": "object",
|
||||||
|
"description": "One entry of settings.json `error_sources`. `resolve` and `build` are argv lists; `{signature}`, `{repo_dir}` and `{commit}` are replaced.",
|
||||||
|
"properties": {
|
||||||
|
"app": { "type": "string", "pattern": "^[a-z0-9][a-z0-9_-]*$" },
|
||||||
|
"repo": { "type": "string", "pattern": "^[^/\\s]+/[^/\\s]+$" },
|
||||||
|
"adapter": { "enum": ["kartka", "contract"] },
|
||||||
|
"path": { "type": "string", "minLength": 1 },
|
||||||
|
"resolve": { "type": "array", "items": { "type": "string" } },
|
||||||
|
"build": { "type": "array", "items": { "type": "string" } }
|
||||||
|
},
|
||||||
|
"required": ["app", "repo", "adapter", "path"],
|
||||||
|
"additionalProperties": false
|
||||||
|
},
|
||||||
|
"ledger": {
|
||||||
|
"type": "object",
|
||||||
|
"description": "`<run root>/app-errors.json`: what the loop knows per `app:signature`.",
|
||||||
|
"additionalProperties": { "$ref": "#/$defs/entry" }
|
||||||
|
},
|
||||||
|
"entry": {
|
||||||
|
"type": "object",
|
||||||
|
"properties": {
|
||||||
|
"state": { "enum": ["ticket", "shipped", "fixed"] },
|
||||||
|
"repo": { "type": "string" },
|
||||||
|
"title": { "type": "string" },
|
||||||
|
"count": { "type": "integer", "minimum": 0 },
|
||||||
|
"starts": { "type": "integer", "minimum": 0 },
|
||||||
|
"commit": { "type": "string" },
|
||||||
|
"shipped_at": { "type": "number" },
|
||||||
|
"fixed_build": { "type": "integer", "minimum": 0 },
|
||||||
|
"installed_at": { "type": "number" },
|
||||||
|
"missing": { "type": "integer", "minimum": 0, "description": "Ticks the part was not on the board (a Ship may be closing it)." }
|
||||||
|
},
|
||||||
|
"required": ["state", "repo", "title", "count", "starts"],
|
||||||
|
"additionalProperties": false
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
175
app_errors/app_errors/tests/test_ingest.py
Normal file
175
app_errors/app_errors/tests/test_ingest.py
Normal file
@ -0,0 +1,175 @@
|
|||||||
|
"""The ingest: RTDB and local spools in, one board report per app out."""
|
||||||
|
|
||||||
|
from __future__ import annotations
|
||||||
|
|
||||||
|
import json
|
||||||
|
from pathlib import Path
|
||||||
|
|
||||||
|
import pytest
|
||||||
|
|
||||||
|
from app_errors import cli, ingest, spool
|
||||||
|
from app_errors.rtdb import RtdbError
|
||||||
|
|
||||||
|
|
||||||
|
class FakeRtdb:
|
||||||
|
"""An in-memory RTDB: ``get`` honours ``shallow``, ``patch`` deletes on None."""
|
||||||
|
|
||||||
|
def __init__(self, data: dict[str, object]) -> None:
|
||||||
|
self.data = data
|
||||||
|
self.patches: list[tuple[str, dict[str, object]]] = []
|
||||||
|
self.fail = False
|
||||||
|
|
||||||
|
def _at(self, path: str) -> object:
|
||||||
|
node: object = self.data
|
||||||
|
for part in [p for p in path.split("/") if p]:
|
||||||
|
if not isinstance(node, dict) or part not in node:
|
||||||
|
return None
|
||||||
|
node = node[part]
|
||||||
|
return node
|
||||||
|
|
||||||
|
def get(self, path: str, *, shallow: bool = False) -> object:
|
||||||
|
if self.fail:
|
||||||
|
raise RtdbError("down")
|
||||||
|
node = self._at(path)
|
||||||
|
if shallow and isinstance(node, dict):
|
||||||
|
return dict.fromkeys(node, True)
|
||||||
|
return node
|
||||||
|
|
||||||
|
def patch(self, path: str, data: dict[str, object]) -> None:
|
||||||
|
self.patches.append((path, data))
|
||||||
|
for key, value in data.items():
|
||||||
|
parts = [p for p in f"{path}/{key}".split("/") if p]
|
||||||
|
node = self.data
|
||||||
|
for part in parts[:-1]:
|
||||||
|
node = node.setdefault(part, {}) # type: ignore[assignment]
|
||||||
|
if value is None:
|
||||||
|
node.pop(parts[-1], None)
|
||||||
|
else:
|
||||||
|
node[parts[-1]] = value
|
||||||
|
|
||||||
|
|
||||||
|
def _crash(at: str) -> dict[str, object]:
|
||||||
|
return {
|
||||||
|
"repo": "kuhyx/todo",
|
||||||
|
"at": at,
|
||||||
|
"kind": "uncaught.flutter",
|
||||||
|
"error": "Bad state: x",
|
||||||
|
"build": 3,
|
||||||
|
}
|
||||||
|
|
||||||
|
|
||||||
|
@pytest.fixture
|
||||||
|
def dirs(tmp_path: Path) -> ingest.Paths:
|
||||||
|
return ingest.Paths(
|
||||||
|
state=tmp_path / "ingest" / "state.json",
|
||||||
|
reports=tmp_path / "app-errors",
|
||||||
|
spool=tmp_path / "app-errors-spool",
|
||||||
|
)
|
||||||
|
|
||||||
|
|
||||||
|
def test_rtdb_entries_become_reports_and_are_deleted(dirs: ingest.Paths) -> None:
|
||||||
|
db = FakeRtdb({
|
||||||
|
"todo": {"errors": {"dev1": {"e1": _crash("2026-11-17T10:00:00Z"), "e2": _crash("2026-11-17T10:00:01Z")}}},
|
||||||
|
# kartka's own pre-0.9 uploader shape: sourceId, build per entry.
|
||||||
|
"kartka": {"errors": {"dev": {"k": {**_crash("2026-11-17T10:00:00Z"), "sourceId": "mangadex", "build": 556}}}},
|
||||||
|
"other": {"data": 1},
|
||||||
|
}) # fmt: skip
|
||||||
|
summary = ingest.run(dirs, db)
|
||||||
|
assert summary.merged == 3
|
||||||
|
report = json.loads((dirs.reports / "todo.json").read_text())
|
||||||
|
assert report["errors"][0]["count"] == 2
|
||||||
|
kartka = json.loads((dirs.reports / "kartka.json").read_text()) # kartka moved over 2026-11-17
|
||||||
|
assert kartka["errors"][0]["build"] == 556
|
||||||
|
assert db.data["todo"] == {"errors": {"dev1": {}}} # ingested entries are removed from RTDB
|
||||||
|
assert db.data["kartka"] == {"errors": {"dev": {}}}
|
||||||
|
|
||||||
|
|
||||||
|
def test_keep_leaves_rtdb_and_still_counts_once(dirs: ingest.Paths) -> None:
|
||||||
|
db = FakeRtdb({"todo": {"errors": {"d": {"e": _crash("2026-11-17T10:00:00Z")}}}})
|
||||||
|
ingest.run(dirs, db, keep=True)
|
||||||
|
ingest.run(dirs, db, keep=True)
|
||||||
|
report = json.loads((dirs.reports / "todo.json").read_text())
|
||||||
|
assert report["errors"][0]["count"] == 1
|
||||||
|
assert db.patches == []
|
||||||
|
|
||||||
|
|
||||||
|
def test_rtdb_down_still_ingests_spool(dirs: ingest.Paths) -> None:
|
||||||
|
spool.append(dirs.spool, "tk-app", {"repo": "kuhyx/tk", "at": "2026-11-17T10:00:00Z",
|
||||||
|
"kind": "uncaught.python", "error": "ValueError: x"}) # fmt: skip
|
||||||
|
db = FakeRtdb({})
|
||||||
|
db.fail = True
|
||||||
|
summary = ingest.run(dirs, db)
|
||||||
|
assert summary.merged == 1
|
||||||
|
assert summary.rtdb_error == "down"
|
||||||
|
assert json.loads((dirs.reports / "tk-app.json").read_text())["errors"][0]["repo"] == "kuhyx/tk"
|
||||||
|
assert list(dirs.spool.glob("*")) == [] # the spool is consumed
|
||||||
|
|
||||||
|
|
||||||
|
def test_no_rtdb_at_all(dirs: ingest.Paths) -> None:
|
||||||
|
assert ingest.run(dirs, None).merged == 0
|
||||||
|
|
||||||
|
|
||||||
|
def test_spool_bad_lines_and_bad_names_are_skipped(dirs: ingest.Paths) -> None:
|
||||||
|
dirs.spool.mkdir(parents=True)
|
||||||
|
(dirs.spool / "ok.jsonl").write_text('not json\n{"at": "2026-11-17T10:00:00Z", "kind": "k", "error": "e"}\n[]\n')
|
||||||
|
(dirs.spool / "Bad Name.jsonl").write_text('{"at": "x", "kind": "k", "error": "e"}\n')
|
||||||
|
assert ingest.run(dirs, None).merged == 1
|
||||||
|
|
||||||
|
|
||||||
|
def test_leftover_claimed_spool_is_ingested(dirs: ingest.Paths) -> None:
|
||||||
|
dirs.spool.mkdir(parents=True)
|
||||||
|
(dirs.spool / "ok.jsonl.ingesting").write_text('{"at": "2026-11-17T10:00:00Z", "kind": "k", "error": "e"}\n')
|
||||||
|
assert ingest.run(dirs, None).merged == 1
|
||||||
|
assert list(dirs.spool.glob("*")) == []
|
||||||
|
|
||||||
|
|
||||||
|
def test_rtdb_odd_shapes_are_skipped(dirs: ingest.Paths) -> None:
|
||||||
|
db = FakeRtdb(
|
||||||
|
{
|
||||||
|
"todo": {"errors": {"d": "nope", "e": {"x": "nope"}}},
|
||||||
|
"bad key!": {"errors": {}},
|
||||||
|
}
|
||||||
|
)
|
||||||
|
assert ingest.run(dirs, db).merged == 0
|
||||||
|
|
||||||
|
|
||||||
|
def test_cli_ingest_and_resolve(dirs: ingest.Paths, monkeypatch: pytest.MonkeyPatch,
|
||||||
|
capsys: pytest.CaptureFixture[str]) -> None: # fmt: skip
|
||||||
|
monkeypatch.setattr(ingest, "default_paths", lambda: dirs)
|
||||||
|
spool.append(dirs.spool, "tk", {"at": "2026-11-17T10:00:00Z", "kind": "k", "error": "e"})
|
||||||
|
assert cli.main(["ingest", "--no-rtdb"]) == 0
|
||||||
|
sig = json.loads((dirs.reports / "tk.json").read_text())["errors"][0]["signature"]
|
||||||
|
assert cli.main(["resolve", "tk", sig]) == 0
|
||||||
|
assert json.loads((dirs.reports / "tk.json").read_text())["errors"][0]["open"] is False
|
||||||
|
assert cli.main(["resolve", "tk", "missing"]) == 1
|
||||||
|
assert "unknown" in capsys.readouterr().err
|
||||||
|
|
||||||
|
|
||||||
|
def test_cli_ingest_rtdb_session_missing(dirs: ingest.Paths, monkeypatch: pytest.MonkeyPatch,
|
||||||
|
capsys: pytest.CaptureFixture[str]) -> None: # fmt: skip
|
||||||
|
monkeypatch.setattr(ingest, "default_paths", lambda: dirs)
|
||||||
|
|
||||||
|
def no_session(_app: str) -> FakeRtdb:
|
||||||
|
raise RtdbError("no session")
|
||||||
|
|
||||||
|
monkeypatch.setattr(cli, "open_rtdb", no_session)
|
||||||
|
spool.append(dirs.spool, "tk", {"at": "2026-11-17T10:00:00Z", "kind": "k", "error": "e"})
|
||||||
|
assert cli.main(["ingest"]) == 1 # the spool still went in, but RTDB is reported broken
|
||||||
|
assert (dirs.reports / "tk.json").exists()
|
||||||
|
assert "no session" in capsys.readouterr().err
|
||||||
|
|
||||||
|
|
||||||
|
def test_cli_ingest_with_rtdb(dirs: ingest.Paths, monkeypatch: pytest.MonkeyPatch) -> None:
|
||||||
|
monkeypatch.setattr(ingest, "default_paths", lambda: dirs)
|
||||||
|
db = FakeRtdb({"todo": {"errors": {"d": {"e": _crash("2026-11-17T10:00:00Z")}}}})
|
||||||
|
monkeypatch.setattr(cli, "open_rtdb", lambda _app: db)
|
||||||
|
assert cli.main(["ingest", "--keep", "--session", "x"]) == 0
|
||||||
|
assert (dirs.reports / "todo.json").exists()
|
||||||
|
|
||||||
|
|
||||||
|
def test_default_paths_follow_xdg(monkeypatch: pytest.MonkeyPatch, tmp_path: Path) -> None:
|
||||||
|
monkeypatch.setenv("XDG_STATE_HOME", str(tmp_path))
|
||||||
|
paths = ingest.default_paths()
|
||||||
|
assert paths.reports == tmp_path / "app-errors"
|
||||||
|
assert paths.spool == tmp_path / "app-errors-spool"
|
||||||
|
assert paths.state == tmp_path / "app-errors-ingest" / "state.json"
|
||||||
140
app_errors/app_errors/tests/test_rtdb.py
Normal file
140
app_errors/app_errors/tests/test_rtdb.py
Normal file
@ -0,0 +1,140 @@
|
|||||||
|
"""The REST client: URLs, shallow reads, typed errors that never name the token."""
|
||||||
|
|
||||||
|
from __future__ import annotations
|
||||||
|
|
||||||
|
import email.message
|
||||||
|
import io
|
||||||
|
import json
|
||||||
|
from pathlib import Path
|
||||||
|
import sys
|
||||||
|
import types
|
||||||
|
from typing import cast
|
||||||
|
import urllib.error
|
||||||
|
import urllib.request
|
||||||
|
|
||||||
|
import pytest
|
||||||
|
|
||||||
|
from app_errors import ingest, rtdb, store
|
||||||
|
from app_errors.rtdb import RestRtdb, RtdbError
|
||||||
|
|
||||||
|
|
||||||
|
class _Res(io.BytesIO):
|
||||||
|
def __enter__(self) -> _Res:
|
||||||
|
return self
|
||||||
|
|
||||||
|
def __exit__(self, *_: object) -> None:
|
||||||
|
self.close()
|
||||||
|
|
||||||
|
|
||||||
|
def test_get_and_patch_build_urls() -> None:
|
||||||
|
seen: list[tuple[str, str, object]] = []
|
||||||
|
|
||||||
|
def opener(req: urllib.request.Request, timeout: float) -> _Res:
|
||||||
|
seen.append((req.get_method(), req.full_url, req.data))
|
||||||
|
return _Res(b'{"a": true}')
|
||||||
|
|
||||||
|
db = RestRtdb("https://db.example/", lambda: "TOK", opener)
|
||||||
|
assert db.get("", shallow=True) == {"a": True}
|
||||||
|
db.patch("todo/errors", {"d/e": None})
|
||||||
|
assert seen[0][:2] == ("GET", "https://db.example/.json?auth=TOK&shallow=true")
|
||||||
|
assert seen[1][0] == "PATCH"
|
||||||
|
assert json.loads(cast("bytes", seen[1][2])) == {"d/e": None}
|
||||||
|
|
||||||
|
|
||||||
|
def test_empty_body_is_none() -> None:
|
||||||
|
assert RestRtdb("https://x", lambda: "t", lambda req, timeout: _Res(b"")).get("p") is None
|
||||||
|
|
||||||
|
|
||||||
|
@pytest.mark.parametrize(
|
||||||
|
"exc",
|
||||||
|
[
|
||||||
|
urllib.error.HTTPError("u", 401, "no", email.message.Message(), None),
|
||||||
|
urllib.error.URLError("down"),
|
||||||
|
OSError("x"),
|
||||||
|
],
|
||||||
|
)
|
||||||
|
def test_failures_are_typed_and_tokenless(exc: Exception) -> None:
|
||||||
|
def opener(req: urllib.request.Request, timeout: float) -> _Res:
|
||||||
|
raise exc
|
||||||
|
|
||||||
|
with pytest.raises(RtdbError) as info:
|
||||||
|
RestRtdb("https://x", lambda: "SECRET", opener).get("p")
|
||||||
|
assert "SECRET" not in str(info.value)
|
||||||
|
|
||||||
|
|
||||||
|
def test_token_failure_is_typed() -> None:
|
||||||
|
def boom() -> str:
|
||||||
|
raise ValueError("SECRET")
|
||||||
|
|
||||||
|
with pytest.raises(RtdbError, match="token refresh failed"):
|
||||||
|
RestRtdb("https://x", boom).get("p")
|
||||||
|
|
||||||
|
|
||||||
|
def _fake_crdt(monkeypatch: pytest.MonkeyPatch, *, session: bool, config_ok: bool = True) -> None:
|
||||||
|
mod = types.ModuleType("crdt_sync")
|
||||||
|
|
||||||
|
class Config:
|
||||||
|
api_key, database_url = "k", "https://db"
|
||||||
|
|
||||||
|
@staticmethod
|
||||||
|
def load() -> Config:
|
||||||
|
if not config_ok:
|
||||||
|
raise FileNotFoundError("cfg")
|
||||||
|
return Config()
|
||||||
|
|
||||||
|
class Provider:
|
||||||
|
def __init__(self, *_: object, **__: object) -> None: ...
|
||||||
|
def has_session(self) -> bool:
|
||||||
|
return session
|
||||||
|
|
||||||
|
def id_token(self) -> str:
|
||||||
|
return "t"
|
||||||
|
|
||||||
|
mod.FirebaseConfig = Config # type: ignore[attr-defined]
|
||||||
|
mod.FirebaseTokenProvider = Provider # type: ignore[attr-defined]
|
||||||
|
mod.credential_store_for = lambda name: name # type: ignore[attr-defined]
|
||||||
|
monkeypatch.setitem(sys.modules, "crdt_sync", mod)
|
||||||
|
|
||||||
|
|
||||||
|
def test_open_rtdb(monkeypatch: pytest.MonkeyPatch) -> None:
|
||||||
|
_fake_crdt(monkeypatch, session=True)
|
||||||
|
assert isinstance(rtdb.open_rtdb("s"), RestRtdb)
|
||||||
|
_fake_crdt(monkeypatch, session=False)
|
||||||
|
with pytest.raises(RtdbError, match="no seeded"):
|
||||||
|
rtdb.open_rtdb("s")
|
||||||
|
_fake_crdt(monkeypatch, session=True, config_ok=False)
|
||||||
|
with pytest.raises(RtdbError, match="no Firebase config"):
|
||||||
|
rtdb.open_rtdb("s")
|
||||||
|
|
||||||
|
|
||||||
|
class _PatchFails:
|
||||||
|
def get(self, path: str, *, shallow: bool = False) -> object:
|
||||||
|
if shallow:
|
||||||
|
return {"todo": True}
|
||||||
|
return {"d": {"e": {"at": "2026-11-17T10:00:00Z", "kind": "k", "error": "x"}}}
|
||||||
|
|
||||||
|
def patch(self, path: str, data: dict[str, object]) -> None:
|
||||||
|
raise RtdbError("patch down")
|
||||||
|
|
||||||
|
|
||||||
|
def test_delete_failure_is_reported_after_save(tmp_path: Path) -> None:
|
||||||
|
paths = ingest.Paths(tmp_path / "s.json", tmp_path / "r", tmp_path / "sp")
|
||||||
|
summary = ingest.run(paths, _PatchFails())
|
||||||
|
assert summary == ingest.Summary(1, "patch down")
|
||||||
|
assert (tmp_path / "r" / "todo.json").exists()
|
||||||
|
|
||||||
|
|
||||||
|
def test_old_state_version_and_seen_trim(tmp_path: Path, monkeypatch: pytest.MonkeyPatch) -> None:
|
||||||
|
path = tmp_path / "s.json"
|
||||||
|
path.write_text('{"version": 0}')
|
||||||
|
assert store.load(path) == store.empty()
|
||||||
|
monkeypatch.setattr(store, "MAX_SEEN", 2)
|
||||||
|
state = store.empty()
|
||||||
|
for i in range(3):
|
||||||
|
store.merge(
|
||||||
|
state,
|
||||||
|
"a",
|
||||||
|
str(i),
|
||||||
|
{"at": f"2026-11-17T10:00:0{i}Z", "kind": "k", "error": "x"},
|
||||||
|
)
|
||||||
|
assert list(state["seen"]) == ["a/1", "a/2"]
|
||||||
89
app_errors/app_errors/tests/test_signature.py
Normal file
89
app_errors/app_errors/tests/test_signature.py
Normal file
@ -0,0 +1,89 @@
|
|||||||
|
"""Signatures: one per bug, kartka-identical for Dart, generalised for Python and GDScript."""
|
||||||
|
|
||||||
|
from __future__ import annotations
|
||||||
|
|
||||||
|
from app_errors.signature import normalise, signature, top_frame
|
||||||
|
|
||||||
|
|
||||||
|
def test_dart_crash_matches_kartka_vector() -> None:
|
||||||
|
# Vector from kartka_errors.signature (kartka 2026-11-17): moving kartka
|
||||||
|
# onto this ingest must not rename its open tickets.
|
||||||
|
entry = {
|
||||||
|
"kind": "uncaught.flutter",
|
||||||
|
"error": "Bad state: no element 42",
|
||||||
|
"stack": [
|
||||||
|
"#0 List.first (dart:core/list.dart:12:3)",
|
||||||
|
"#1 Reader.open (package:kartka/reader/reader.dart:88:7)",
|
||||||
|
],
|
||||||
|
}
|
||||||
|
sig = signature(entry, app="kartka")
|
||||||
|
assert sig.id == "ffcd864656"
|
||||||
|
assert sig.type == "StateError"
|
||||||
|
assert sig.where == "Reader.open (package:kartka/reader/reader.dart)"
|
||||||
|
|
||||||
|
|
||||||
|
def test_slow_wait_matches_kartka_vector() -> None:
|
||||||
|
entry = {
|
||||||
|
"kind": "perf.slow",
|
||||||
|
"operation": "reader.open",
|
||||||
|
"route": "/reader/:id",
|
||||||
|
"durationMs": 2100,
|
||||||
|
}
|
||||||
|
sig = signature(entry, app="kartka")
|
||||||
|
assert sig.id == "29a53e8824"
|
||||||
|
assert sig.message == "slow wait: reader.open"
|
||||||
|
|
||||||
|
|
||||||
|
def test_slow_wait_ignores_duration() -> None:
|
||||||
|
one = {"kind": "perf.slow", "operation": "load", "durationMs": 1100}
|
||||||
|
two = {"kind": "perf.slow", "operation": "load", "durationMs": 9000}
|
||||||
|
assert signature(one, app="a").id == signature(two, app="a").id
|
||||||
|
|
||||||
|
|
||||||
|
def test_mark_picks_app_frame_and_skips_plumbing() -> None:
|
||||||
|
stack = [
|
||||||
|
"#0 ErrorReporter.report (package:crdt_sync_flutter/src/errors/error_reporter.dart:5:1)",
|
||||||
|
"#1 Home.build (package:todo/home.dart:10:2)",
|
||||||
|
]
|
||||||
|
assert top_frame(stack, "package:todo/") == "Home.build (package:todo/home.dart)"
|
||||||
|
|
||||||
|
|
||||||
|
def test_python_frame_line_numbers_dropped() -> None:
|
||||||
|
entry = {
|
||||||
|
"kind": "uncaught.python",
|
||||||
|
"error": "ValueError: bad 12",
|
||||||
|
"stack": [
|
||||||
|
"gatelock/error_report.py:40 in hook",
|
||||||
|
"leetcode_guard/ui.py:123 in solve",
|
||||||
|
],
|
||||||
|
"mark": "leetcode_guard/",
|
||||||
|
}
|
||||||
|
sig = signature(entry, app="leetcode-guard")
|
||||||
|
assert sig.where == "leetcode_guard/ui.py in solve"
|
||||||
|
assert sig.type == "ValueError"
|
||||||
|
assert sig.message == "ValueError: bad <n>"
|
||||||
|
|
||||||
|
|
||||||
|
def test_godot_frame_and_kind_fallback() -> None:
|
||||||
|
entry = {
|
||||||
|
"kind": "uncaught.gdscript",
|
||||||
|
"error": "Invalid access to property 'x'",
|
||||||
|
"stack": [
|
||||||
|
"res://addons/app_errors/error_reporter.gd:9 in _log",
|
||||||
|
"res://scripts/car.gd:77 in _ready",
|
||||||
|
],
|
||||||
|
"mark": "res://",
|
||||||
|
}
|
||||||
|
sig = signature(entry, app="car-rental-sim")
|
||||||
|
assert sig.where == "res://scripts/car.gd in _ready"
|
||||||
|
assert sig.type == "uncaught.gdscript"
|
||||||
|
|
||||||
|
|
||||||
|
def test_no_frame_falls_back_to_route_then_kind() -> None:
|
||||||
|
assert signature({"kind": "ui.snackbar", "error": "x", "route": "/a"}, app="a").where == "route /a"
|
||||||
|
assert signature({"kind": "ui.snackbar", "error": "x"}, app="a").where == "kind ui.snackbar"
|
||||||
|
|
||||||
|
|
||||||
|
def test_normalise_masks_volatile_parts() -> None:
|
||||||
|
text = "GET https://x.y/z 3f2a9c1d00ff 123e4567-e89b-12d3-a456-426614174000 took 15 s"
|
||||||
|
assert normalise(text) == "GET <url> <hex> <uuid> took <n> s"
|
||||||
144
app_errors/app_errors/tests/test_store.py
Normal file
144
app_errors/app_errors/tests/test_store.py
Normal file
@ -0,0 +1,144 @@
|
|||||||
|
"""The merged state: counts, builds, resolve and reopen, and the board report."""
|
||||||
|
|
||||||
|
from __future__ import annotations
|
||||||
|
|
||||||
|
import json
|
||||||
|
from pathlib import Path
|
||||||
|
|
||||||
|
import jsonschema
|
||||||
|
|
||||||
|
from app_errors import store
|
||||||
|
|
||||||
|
SCHEMA = json.loads((Path(__file__).parent / "data" / "app-error.schema.json").read_text())
|
||||||
|
|
||||||
|
|
||||||
|
def _crash(at: str, build: int = 7, **extra: object) -> dict[str, object]:
|
||||||
|
return {
|
||||||
|
"app": "todo",
|
||||||
|
"repo": "kuhyx/todo",
|
||||||
|
"at": at,
|
||||||
|
"kind": "uncaught.flutter",
|
||||||
|
"error": "Bad state: boom",
|
||||||
|
"stack": ["#0 Home.build (package:todo/home.dart:3:1)"],
|
||||||
|
"build": build,
|
||||||
|
"version": "1.0.0",
|
||||||
|
**extra,
|
||||||
|
}
|
||||||
|
|
||||||
|
|
||||||
|
def _report(state: store.State, app: str) -> dict[str, object]:
|
||||||
|
report = store.report(state, app)
|
||||||
|
jsonschema.Draft202012Validator({**SCHEMA, "$ref": "#/$defs/report"}).validate(report)
|
||||||
|
return report
|
||||||
|
|
||||||
|
|
||||||
|
def test_ten_identical_errors_are_one_record_with_count_ten() -> None:
|
||||||
|
state = store.empty()
|
||||||
|
for i in range(10):
|
||||||
|
assert store.merge(state, "todo", f"dev/{i}", _crash(f"2026-11-17T10:00:{i:02d}Z"))
|
||||||
|
errors = _report(state, "todo")["errors"]
|
||||||
|
assert isinstance(errors, list)
|
||||||
|
assert len(errors) == 1
|
||||||
|
rec = errors[0]
|
||||||
|
assert rec["count"] == 10
|
||||||
|
assert rec["first_seen"] == "2026-11-17T10:00:00Z"
|
||||||
|
assert rec["last_seen"] == "2026-11-17T10:00:09Z"
|
||||||
|
assert rec["build"] == 7
|
||||||
|
assert rec["version_name"] == "1.0.0"
|
||||||
|
assert rec["open"] is True
|
||||||
|
assert rec["repo"] == "kuhyx/todo"
|
||||||
|
|
||||||
|
|
||||||
|
def test_same_entry_id_counts_once() -> None:
|
||||||
|
state = store.empty()
|
||||||
|
assert store.merge(state, "todo", "dev/a", _crash("2026-11-17T10:00:00Z"))
|
||||||
|
assert not store.merge(state, "todo", "dev/a", _crash("2026-11-17T10:00:00Z"))
|
||||||
|
assert state["apps"]["todo"][next(iter(state["apps"]["todo"]))]["count"] == 1
|
||||||
|
|
||||||
|
|
||||||
|
def test_newest_build_wins() -> None:
|
||||||
|
state = store.empty()
|
||||||
|
store.merge(state, "todo", "a", _crash("2026-11-17T10:00:00Z", build=9))
|
||||||
|
store.merge(state, "todo", "b", _crash("2026-11-17T11:00:00Z", build=4))
|
||||||
|
assert _report(state, "todo")["errors"][0]["build"] == 9 # type: ignore[index]
|
||||||
|
|
||||||
|
|
||||||
|
def test_slow_wait_detail_names_longest_wait() -> None:
|
||||||
|
state = store.empty()
|
||||||
|
for i, ms in enumerate((1500, 2100)):
|
||||||
|
store.merge(
|
||||||
|
state,
|
||||||
|
"todo",
|
||||||
|
f"w{i}",
|
||||||
|
{"app": "todo", "repo": "kuhyx/todo", "at": f"2026-11-17T10:00:0{i}Z", "kind": "perf.slow",
|
||||||
|
"error": f"list.load waited {ms} ms", "operation": "list.load", "route": "/", "durationMs": ms},
|
||||||
|
) # fmt: skip
|
||||||
|
rec = _report(state, "todo")["errors"][0] # type: ignore[index]
|
||||||
|
assert rec["kind"] == "perf.slow"
|
||||||
|
assert rec["count"] == 2
|
||||||
|
assert "2100 ms" in rec["detail"]
|
||||||
|
assert rec["build"] == 0
|
||||||
|
|
||||||
|
|
||||||
|
def test_resolve_closes_and_older_build_does_not_reopen() -> None:
|
||||||
|
state = store.empty()
|
||||||
|
store.merge(state, "todo", "a", _crash("2026-11-17T10:00:00Z", build=7))
|
||||||
|
sig = _report(state, "todo")["errors"][0]["signature"] # type: ignore[index]
|
||||||
|
assert store.resolve(state, "todo", sig, now="2026-11-17T12:00:00Z")
|
||||||
|
assert _report(state, "todo")["errors"][0]["open"] is False # type: ignore[index]
|
||||||
|
store.merge(state, "todo", "b", _crash("2026-11-17T13:00:00Z", build=7))
|
||||||
|
assert _report(state, "todo")["errors"][0]["open"] is False # type: ignore[index]
|
||||||
|
store.merge(state, "todo", "c", _crash("2026-11-17T14:00:00Z", build=8))
|
||||||
|
assert _report(state, "todo")["errors"][0]["open"] is True # type: ignore[index]
|
||||||
|
|
||||||
|
|
||||||
|
def test_resolve_without_build_reopens_on_later_report() -> None:
|
||||||
|
state = store.empty()
|
||||||
|
store.merge(state, "tk", "a", _crash("2026-11-17T10:00:00Z", build=0, app="tk"))
|
||||||
|
sig = _report(state, "tk")["errors"][0]["signature"] # type: ignore[index]
|
||||||
|
store.resolve(state, "tk", sig, now="2026-11-17T12:00:00Z")
|
||||||
|
store.merge(state, "tk", "b", _crash("2026-11-17T11:00:00Z", build=0, app="tk"))
|
||||||
|
assert _report(state, "tk")["errors"][0]["open"] is False # type: ignore[index]
|
||||||
|
store.merge(state, "tk", "c", _crash("2026-11-17T13:00:00Z", build=0, app="tk"))
|
||||||
|
assert _report(state, "tk")["errors"][0]["open"] is True # type: ignore[index]
|
||||||
|
|
||||||
|
|
||||||
|
def test_resolve_unknown_signature_is_false() -> None:
|
||||||
|
assert not store.resolve(store.empty(), "todo", "nope", now="2026-11-17T12:00:00Z")
|
||||||
|
|
||||||
|
|
||||||
|
def test_missing_repo_defaults_to_kuhyx_app() -> None:
|
||||||
|
state = store.empty()
|
||||||
|
entry = _crash("2026-11-17T10:00:00Z")
|
||||||
|
del entry["repo"]
|
||||||
|
store.merge(state, "todo", "a", entry)
|
||||||
|
assert _report(state, "todo")["errors"][0]["repo"] == "kuhyx/todo" # type: ignore[index]
|
||||||
|
|
||||||
|
|
||||||
|
def test_bad_entry_is_skipped() -> None:
|
||||||
|
state = store.empty()
|
||||||
|
assert not store.merge(state, "todo", "a", {"kind": 3})
|
||||||
|
assert not store.merge(state, "todo", "b", "nope")
|
||||||
|
assert store.report(state, "todo")["errors"] == []
|
||||||
|
|
||||||
|
|
||||||
|
def test_save_and_load_round_trip(tmp_path: Path) -> None:
|
||||||
|
state = store.empty()
|
||||||
|
store.merge(state, "todo", "a", _crash("2026-11-17T10:00:00Z"))
|
||||||
|
path = tmp_path / "s" / "state.json"
|
||||||
|
store.save(path, state)
|
||||||
|
assert store.load(path) == state
|
||||||
|
path.write_text("{broken")
|
||||||
|
assert store.load(path) == store.empty()
|
||||||
|
assert store.load(tmp_path / "missing.json") == store.empty()
|
||||||
|
|
||||||
|
|
||||||
|
def test_write_reports_writes_one_file_per_app(tmp_path: Path) -> None:
|
||||||
|
state = store.empty()
|
||||||
|
store.merge(state, "todo", "a", _crash("2026-11-17T10:00:00Z"))
|
||||||
|
store.merge(state, "tk", "a", _crash("2026-11-17T10:00:00Z", app="tk"))
|
||||||
|
written = store.write_reports(tmp_path, state)
|
||||||
|
assert sorted(p.name for p in written) == ["tk.json", "todo.json"]
|
||||||
|
data = json.loads((tmp_path / "todo.json").read_text())
|
||||||
|
assert data["version"] == 1
|
||||||
|
assert len(data["errors"]) == 1
|
||||||
54
app_errors/install.sh
Executable file
54
app_errors/install.sh
Executable file
@ -0,0 +1,54 @@
|
|||||||
|
#!/bin/bash
|
||||||
|
|
||||||
|
# ============================================================================
|
||||||
|
# Install the app-errors CLI and its ingest timer for the current user.
|
||||||
|
#
|
||||||
|
# Own venv at ~/.local/share/app-errors/venv, the package installed editable
|
||||||
|
# from this checkout (run it from the live ~/src/utils, never a worktree).
|
||||||
|
# crdt-sync comes from the sibling directory, so the venv runs what is on disk.
|
||||||
|
# Idempotent: rerun it after any change. Exits non-zero unless the timer is
|
||||||
|
# active and one ingest pass over the local spool succeeds.
|
||||||
|
# ============================================================================
|
||||||
|
|
||||||
|
set -euo pipefail
|
||||||
|
|
||||||
|
REPO_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
|
||||||
|
UTILS_DIR="$(dirname "$REPO_DIR")"
|
||||||
|
readonly REPO_DIR UTILS_DIR
|
||||||
|
readonly VENV_DIR="${HOME}/.local/share/app-errors/venv"
|
||||||
|
readonly BIN_DIR="${HOME}/.local/bin"
|
||||||
|
readonly UNIT_DIR="${HOME}/.config/systemd/user"
|
||||||
|
readonly TIMER="app-errors-ingest.timer"
|
||||||
|
|
||||||
|
log() { printf 'install: %s\n' "$1" >&2; }
|
||||||
|
fail() { printf 'install: FAILED -- %s\n' "$1" >&2; exit 1; }
|
||||||
|
|
||||||
|
build_venv() {
|
||||||
|
[[ -x "$VENV_DIR/bin/python" ]] || /usr/bin/python3 -m venv "$VENV_DIR" || fail "venv"
|
||||||
|
"$VENV_DIR/bin/pip" install --quiet "$UTILS_DIR/crdt-sync" || fail "crdt-sync"
|
||||||
|
"$VENV_DIR/bin/pip" install --quiet --no-deps -e "$REPO_DIR" || fail "app-errors"
|
||||||
|
mkdir -p "$BIN_DIR"
|
||||||
|
ln -sf "$VENV_DIR/bin/app-errors" "$BIN_DIR/app-errors"
|
||||||
|
}
|
||||||
|
|
||||||
|
install_timer() {
|
||||||
|
mkdir -p "$UNIT_DIR"
|
||||||
|
install -m 0644 "$REPO_DIR/systemd/app-errors-ingest.service" "$REPO_DIR/systemd/$TIMER" "$UNIT_DIR/"
|
||||||
|
systemctl --user daemon-reload
|
||||||
|
systemctl --user enable --now "$TIMER"
|
||||||
|
}
|
||||||
|
|
||||||
|
verify() {
|
||||||
|
systemctl --user is-active --quiet "$TIMER" || fail "$TIMER is not active"
|
||||||
|
"$VENV_DIR/bin/app-errors" ingest --no-rtdb >/dev/null || fail "a spool-only ingest pass failed"
|
||||||
|
log "ok: $TIMER active, ingest runs"
|
||||||
|
}
|
||||||
|
|
||||||
|
main() {
|
||||||
|
log "installing app-errors from $REPO_DIR"
|
||||||
|
build_venv
|
||||||
|
install_timer
|
||||||
|
verify
|
||||||
|
}
|
||||||
|
|
||||||
|
main "$@"
|
||||||
186
app_errors/pyproject.toml
Normal file
186
app_errors/pyproject.toml
Normal file
@ -0,0 +1,186 @@
|
|||||||
|
[project]
|
||||||
|
name = "app-errors"
|
||||||
|
version = "0.1.0"
|
||||||
|
description = "Shared app error and slow-wait ingest: RTDB and local spool reports become todoImplementer error tickets"
|
||||||
|
requires-python = ">=3.14"
|
||||||
|
dependencies = [
|
||||||
|
"crdt-sync @ git+https://github.com/kuhyx/utils@crdt-sync-v0.11.1#subdirectory=crdt-sync",
|
||||||
|
]
|
||||||
|
|
||||||
|
[project.optional-dependencies]
|
||||||
|
test = ["jsonschema==4.26.0", "pytest==9.2.0", "pytest-cov==7.1.0"]
|
||||||
|
|
||||||
|
[project.scripts]
|
||||||
|
app-errors = "app_errors.cli:main"
|
||||||
|
|
||||||
|
[tool.setuptools]
|
||||||
|
packages = ["app_errors"]
|
||||||
|
|
||||||
|
# py.typed: consumers type-check against the package (PEP 561).
|
||||||
|
[tool.setuptools.package-data]
|
||||||
|
app_errors = ["py.typed"]
|
||||||
|
|
||||||
|
[tool.ruff]
|
||||||
|
target-version = "py314"
|
||||||
|
line-length = 120
|
||||||
|
include = ["*.py", "**/*.py"]
|
||||||
|
exclude = [".git", ".venv", "__pycache__", "build", "dist", ".eggs"]
|
||||||
|
|
||||||
|
[tool.ruff.lint]
|
||||||
|
select = ["ALL"]
|
||||||
|
ignore = [
|
||||||
|
"D203",
|
||||||
|
"D213",
|
||||||
|
"COM812",
|
||||||
|
"ISC001",
|
||||||
|
"S603",
|
||||||
|
]
|
||||||
|
fixable = ["ALL"]
|
||||||
|
unfixable = []
|
||||||
|
|
||||||
|
[tool.ruff.lint.per-file-ignores]
|
||||||
|
"**/tests/*.py" = ["ANN", "ARG", "CPY001", "D", "EM101", "PLC0415", "PLR2004", "PYI034", "S101", "SLF001", "TC002", "TC003", "TRY003"]
|
||||||
|
"**/_fake_*.py" = ["ANN401", "ARG002"]
|
||||||
|
"**/test_*.py" = ["ANN", "ARG", "CPY001", "D", "EM101", "PLC0415", "PLR2004", "PYI034", "S101", "SLF001", "TC002", "TC003", "TRY003"]
|
||||||
|
|
||||||
|
|
||||||
|
[tool.ruff.lint.pydocstyle]
|
||||||
|
convention = "google"
|
||||||
|
|
||||||
|
[tool.ruff.lint.isort]
|
||||||
|
force-single-line = false
|
||||||
|
force-sort-within-sections = true
|
||||||
|
known-first-party = ["app_errors"]
|
||||||
|
|
||||||
|
[tool.ruff.lint.flake8-quotes]
|
||||||
|
docstring-quotes = "double"
|
||||||
|
inline-quotes = "double"
|
||||||
|
|
||||||
|
[tool.ruff.lint.flake8-tidy-imports]
|
||||||
|
ban-relative-imports = "all"
|
||||||
|
|
||||||
|
[tool.ruff.format]
|
||||||
|
quote-style = "double"
|
||||||
|
indent-style = "space"
|
||||||
|
skip-magic-trailing-comma = false
|
||||||
|
line-ending = "auto"
|
||||||
|
docstring-code-format = true
|
||||||
|
|
||||||
|
[tool.mypy]
|
||||||
|
python_version = "3.14"
|
||||||
|
strict = true
|
||||||
|
warn_return_any = true
|
||||||
|
warn_unused_configs = true
|
||||||
|
disallow_untyped_defs = true
|
||||||
|
disallow_incomplete_defs = true
|
||||||
|
check_untyped_defs = true
|
||||||
|
disallow_untyped_decorators = true
|
||||||
|
no_implicit_optional = true
|
||||||
|
warn_redundant_casts = true
|
||||||
|
warn_unused_ignores = true
|
||||||
|
warn_no_return = true
|
||||||
|
warn_unreachable = true
|
||||||
|
# crdt_sync ships no py.typed: its names would all be "unfollowed".
|
||||||
|
disallow_any_unimported = false
|
||||||
|
disallow_any_explicit = false
|
||||||
|
disallow_any_generics = true
|
||||||
|
disallow_subclassing_any = true
|
||||||
|
strict_equality = true
|
||||||
|
extra_checks = true
|
||||||
|
ignore_missing_imports = true
|
||||||
|
show_error_codes = true
|
||||||
|
color_output = true
|
||||||
|
exclude = [".venv/"]
|
||||||
|
|
||||||
|
[tool.pylint.main]
|
||||||
|
# The repo root on the path, so pylint resolves the package's own imports the
|
||||||
|
# same way pytest does instead of reporting import-error for them.
|
||||||
|
init-hook = "import sys; sys.path.insert(0, 'app_errors')"
|
||||||
|
analyse-fallback-blocks = true
|
||||||
|
persistent = true
|
||||||
|
jobs = 0
|
||||||
|
py-version = "3.14"
|
||||||
|
ignore = [".venv", "__pycache__"]
|
||||||
|
# Test suites intentionally use patterns (protected-access, fixture-arg
|
||||||
|
# shadowing) that don't apply to source code; ruff's per-file-ignores carry
|
||||||
|
# the equivalent exemptions, so tests stay linted -- by ruff. This is the same
|
||||||
|
# source-only pylint scope wake-alarm / diet-guard / testsAndMisc use. It has
|
||||||
|
# to be `ignore-paths`, not `ignore = ["tests"]`: `ignore` only matches the
|
||||||
|
# basename of what pylint is *given*, and pre-commit hands it explicit file
|
||||||
|
# paths, so a directory name in `ignore` never fires under the hook.
|
||||||
|
ignore-paths = ["^(.*/)?tests/.*$"]
|
||||||
|
ignore-patterns = [".*\\.pyi$"]
|
||||||
|
|
||||||
|
[tool.pylint.basic]
|
||||||
|
# snake_case, plus the ``do_<METHOD>`` names http.server dispatches on: the
|
||||||
|
# stdlib looks handlers up as ``"do_" + command``, so ``do_GET`` is the only
|
||||||
|
# spelling that works and cannot be renamed to satisfy the style.
|
||||||
|
method-rgx = "([^\\W\\dA-Z][^\\WA-Z]{2,}|_[^\\WA-Z]*|__[^\\W\\dA-Z][^\\WA-Z]+__|do_[A-Z]+|of)$"
|
||||||
|
|
||||||
|
[tool.pylint.messages_control]
|
||||||
|
enable = "all"
|
||||||
|
disable = []
|
||||||
|
|
||||||
|
[tool.pylint.design]
|
||||||
|
min-public-methods = 0
|
||||||
|
max-module-lines = 1000
|
||||||
|
max-attributes = 10
|
||||||
|
|
||||||
|
[tool.pylint.typecheck]
|
||||||
|
generated-members = [
|
||||||
|
".*\\.assert_called_once_with",
|
||||||
|
".*\\.assert_called_once",
|
||||||
|
".*\\.assert_called",
|
||||||
|
".*\\.assert_not_called",
|
||||||
|
".*\\.assert_any_call",
|
||||||
|
".*\\.call_args",
|
||||||
|
".*\\.call_args_list",
|
||||||
|
".*\\.call_count",
|
||||||
|
]
|
||||||
|
|
||||||
|
[tool.bandit]
|
||||||
|
exclude_dirs = ["tests", ".venv"]
|
||||||
|
|
||||||
|
[tool.pytest.ini_options]
|
||||||
|
testpaths = ["app_errors/tests"]
|
||||||
|
python_files = ["test_*.py", "*_test.py"]
|
||||||
|
python_classes = ["Test*"]
|
||||||
|
python_functions = ["test_*"]
|
||||||
|
addopts = [
|
||||||
|
"-v",
|
||||||
|
"--strict-markers",
|
||||||
|
"--strict-config",
|
||||||
|
"-ra",
|
||||||
|
"--cov=app_errors",
|
||||||
|
"--cov-branch",
|
||||||
|
"--cov-report=term-missing",
|
||||||
|
"--cov-report=lcov",
|
||||||
|
]
|
||||||
|
filterwarnings = [
|
||||||
|
"error",
|
||||||
|
"ignore::DeprecationWarning",
|
||||||
|
"default::pytest.PytestUnraisableExceptionWarning",
|
||||||
|
]
|
||||||
|
|
||||||
|
[tool.coverage.run]
|
||||||
|
source = ["app_errors"]
|
||||||
|
branch = true
|
||||||
|
omit = [
|
||||||
|
"*/__pycache__/*",
|
||||||
|
"*/tests/*",
|
||||||
|
"*/.venv/*",
|
||||||
|
]
|
||||||
|
|
||||||
|
[tool.coverage.report]
|
||||||
|
fail_under = 100
|
||||||
|
show_missing = true
|
||||||
|
skip_covered = false
|
||||||
|
exclude_lines = [
|
||||||
|
"pragma: no cover",
|
||||||
|
"raise NotImplementedError",
|
||||||
|
"raise AssertionError",
|
||||||
|
"if TYPE_CHECKING:",
|
||||||
|
"^\\s*\\.\\.\\.$",
|
||||||
|
'if __name__ == "__main__":',
|
||||||
|
]
|
||||||
|
partial_branches = ["pragma: no branch"]
|
||||||
5
app_errors/requirements.txt
Normal file
5
app_errors/requirements.txt
Normal file
@ -0,0 +1,5 @@
|
|||||||
|
# Exact pins, enforced by the shared dependency-freshness gate.
|
||||||
|
crdt-sync @ git+https://github.com/kuhyx/utils@crdt-sync-v0.11.1#subdirectory=crdt-sync
|
||||||
|
jsonschema==4.26.0
|
||||||
|
pytest==9.2.0
|
||||||
|
pytest-cov==7.1.0
|
||||||
10
app_errors/systemd/app-errors-ingest.service
Normal file
10
app_errors/systemd/app-errors-ingest.service
Normal file
@ -0,0 +1,10 @@
|
|||||||
|
[Unit]
|
||||||
|
Description=Ingest app error and slow-wait reports for the todoImplementer board
|
||||||
|
After=network-online.target
|
||||||
|
|
||||||
|
[Service]
|
||||||
|
Type=oneshot
|
||||||
|
ExecStart=%h/.local/share/app-errors/venv/bin/app-errors ingest
|
||||||
|
Nice=19
|
||||||
|
IOSchedulingClass=idle
|
||||||
|
TimeoutStartSec=120
|
||||||
10
app_errors/systemd/app-errors-ingest.timer
Normal file
10
app_errors/systemd/app-errors-ingest.timer
Normal file
@ -0,0 +1,10 @@
|
|||||||
|
[Unit]
|
||||||
|
Description=Ingest app error reports every 5 minutes
|
||||||
|
|
||||||
|
[Timer]
|
||||||
|
OnBootSec=2min
|
||||||
|
OnUnitActiveSec=5min
|
||||||
|
Persistent=true
|
||||||
|
|
||||||
|
[Install]
|
||||||
|
WantedBy=timers.target
|
||||||
601
app_errors/uv.lock
Normal file
601
app_errors/uv.lock
Normal file
@ -0,0 +1,601 @@
|
|||||||
|
version = 1
|
||||||
|
revision = 5
|
||||||
|
requires-python = ">=3.14"
|
||||||
|
resolution-markers = [
|
||||||
|
"python_full_version >= '3.15'",
|
||||||
|
"python_full_version < '3.15'",
|
||||||
|
]
|
||||||
|
|
||||||
|
[[package]]
|
||||||
|
name = "app-errors"
|
||||||
|
version = "0.1.0"
|
||||||
|
source = { virtual = "." }
|
||||||
|
dependencies = [
|
||||||
|
{ name = "crdt-sync" },
|
||||||
|
]
|
||||||
|
|
||||||
|
[package.optional-dependencies]
|
||||||
|
test = [
|
||||||
|
{ name = "jsonschema" },
|
||||||
|
{ name = "pytest" },
|
||||||
|
{ name = "pytest-cov" },
|
||||||
|
]
|
||||||
|
|
||||||
|
[package.metadata]
|
||||||
|
requires-dist = [
|
||||||
|
{ name = "crdt-sync", git = "https://github.com/kuhyx/utils?subdirectory=crdt-sync&rev=crdt-sync-v0.11.1" },
|
||||||
|
{ name = "jsonschema", marker = "extra == 'test'", specifier = "==4.26.0" },
|
||||||
|
{ name = "pytest", marker = "extra == 'test'", specifier = "==9.2.0" },
|
||||||
|
{ name = "pytest-cov", marker = "extra == 'test'", specifier = "==7.1.0" },
|
||||||
|
]
|
||||||
|
provides-extras = ["test"]
|
||||||
|
|
||||||
|
[[package]]
|
||||||
|
name = "argon2-cffi"
|
||||||
|
version = "25.1.0"
|
||||||
|
source = { registry = "https://pypi.org/simple" }
|
||||||
|
dependencies = [
|
||||||
|
{ name = "argon2-cffi-bindings" },
|
||||||
|
]
|
||||||
|
sdist = { url = "https://files.pythonhosted.org/packages/0e/89/ce5af8a7d472a67cc819d5d998aa8c82c5d860608c4db9f46f1162d7dab9/argon2_cffi-25.1.0.tar.gz", hash = "sha256:694ae5cc8a42f4c4e2bf2ca0e64e51e23a040c6a517a85074683d3959e1346c1", size = 45706, upload-time = "2025-06-03T06:55:32.073Z" }
|
||||||
|
wheels = [
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/4f/d3/a8b22fa575b297cd6e3e3b0155c7e25db170edf1c74783d6a31a2490b8d9/argon2_cffi-25.1.0-py3-none-any.whl", hash = "sha256:fdc8b074db390fccb6eb4a3604ae7231f219aa669a2652e0f20e16ba513d5741", size = 14657, upload-time = "2025-06-03T06:55:30.804Z" },
|
||||||
|
]
|
||||||
|
|
||||||
|
[[package]]
|
||||||
|
name = "argon2-cffi-bindings"
|
||||||
|
version = "26.2.0"
|
||||||
|
source = { registry = "https://pypi.org/simple" }
|
||||||
|
dependencies = [
|
||||||
|
{ name = "cffi" },
|
||||||
|
]
|
||||||
|
sdist = { url = "https://files.pythonhosted.org/packages/76/3b/f7bd1daac24c7017b6d09d05c56bb3f71aaae76b2ac4234ed2c00e0dd2d2/argon2_cffi_bindings-26.2.0.tar.gz", hash = "sha256:f21ab89bb9850f32b9ca038d9961424bb0d3669d579cbbbfed068cffa6fc0643", size = 1792536, upload-time = "2026-11-13T07:16:40.386Z" }
|
||||||
|
wheels = [
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/b4/21/d0e756a1b47b2674aec2919aa81096bb4143c9e3b912b9fe9e11d66bebc5/argon2_cffi_bindings-26.2.0-cp310-abi3-macosx_11_0_arm64.whl", hash = "sha256:5ec171ae5e52691b5f111d815cb656a8142bedc1408c3db904d1a11df44604ca", size = 24273, upload-time = "2026-11-13T07:15:53.707Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/18/aa/149b2b67262a83f09895fe1aa0aa9c6ac688457f11449905ab007c05f133/argon2_cffi_bindings-26.2.0-cp310-abi3-manylinux_2_26_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:92d65a0831e78294e19d7297d101eaa871033825ad2aa7cb87af2f706062acd7", size = 27232, upload-time = "2026-11-13T07:15:55.174Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/7a/82/a9226c27133c26c7892ebc7b174304f81774a78c5b1e97a96e3c15b2cba8/argon2_cffi_bindings-26.2.0-cp310-abi3-manylinux_2_26_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:2d475baecbcb506e40ab1cb05a84c9cc913a8950061a4045fd0ec0eb54aa7fa2", size = 26650, upload-time = "2026-11-13T07:15:56.269Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/ca/24/38bd2a7706025d8c2134ee493c29855ea0a74754adad619e1e929fa09068/argon2_cffi_bindings-26.2.0-cp310-abi3-manylinux_2_34_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:f073ba5029bfc847aac130b251120ed09a4fda3a3c7ac023294710351c080835", size = 27458, upload-time = "2026-11-13T07:15:57.374Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/a7/89/e4325077a26a76ded84017114139e72af9d9845fac6574c307e08743080b/argon2_cffi_bindings-26.2.0-cp310-abi3-musllinux_1_2_aarch64.whl", hash = "sha256:92629f581248269326aa4cf15974326ae0f3f141ad47e2f34100c5fea7d43083", size = 27186, upload-time = "2026-11-13T07:15:58.647Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/e2/c4/befa5f3b4a7f2f988fa54e114a6e6abff8eac89ce78007e9658dd5b0118e/argon2_cffi_bindings-26.2.0-cp310-abi3-musllinux_1_2_riscv64.whl", hash = "sha256:6b344daa1aec0fdfb3160eb2ef3f429914777288bff4097fc3e5e1e1e97c642e", size = 27643, upload-time = "2026-11-13T07:15:59.785Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/7c/6a/6f7bfd95b496e2511906f1ee05bc87914187f9ab67b71ebc5bfba38ee223/argon2_cffi_bindings-26.2.0-cp310-abi3-musllinux_1_2_x86_64.whl", hash = "sha256:df0374dd11e703522e9606318640d0cd37824264ae32c888d7f0cb4ce7aa00f1", size = 26838, upload-time = "2026-11-13T07:16:00.922Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/1a/5f/957abb665fda517d96bc7e63a61cb52a6ecb4f14d395ca3a260c867ad803/argon2_cffi_bindings-26.2.0-cp310-abi3-win32.whl", hash = "sha256:b995a2d20c1725c92de86be8b0ce6c433b01b562ad3615530c8c04b6d3b6e9fe", size = 23953, upload-time = "2026-11-13T07:16:02.046Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/d8/20/9c2ba6433cb58297b1bc8b14bfb5a703c8dccdee16c99c76ddfb66082aa4/argon2_cffi_bindings-26.2.0-cp310-abi3-win_amd64.whl", hash = "sha256:d2d4ae065e7cce4b286d3eb7c59128bfd11f8e407863b88629e9d391b864a3df", size = 25783, upload-time = "2026-11-13T07:16:03.152Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/4e/a5/f98f1e2489eda5d3316ce031022531883d45a84774c7d26b7ffb93978894/argon2_cffi_bindings-26.2.0-cp310-abi3-win_arm64.whl", hash = "sha256:a2787a5f57dbf91a6435a896a31b9253b4a2e16063e2e68764d2a9e61b46bf4b", size = 25857, upload-time = "2026-11-13T07:16:04.269Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/e7/1f/88734dfaeea3f3eca4d879b9232ef8795241a4640259f09c6a2fd2f37a23/argon2_cffi_bindings-26.2.0-cp314-cp314-pyemscripten_2026_0_wasm32.whl", hash = "sha256:1e61d4840665b8937d4a5a8741c2afd76b56de94319c634f7250b8d19291d32a", size = 15502, upload-time = "2026-11-13T07:16:06.403Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/b4/8b/4e3c1d94f2e0076731af0aeacb8d97159dcecb6e44ff822652568e8e4349/argon2_cffi_bindings-26.2.0-cp314-cp314t-macosx_11_0_arm64.whl", hash = "sha256:5985328953da31dd3e48bbe0bd8e46d8b1dc11ecbbac7c9e743f1aeea2b5ba97", size = 24456, upload-time = "2026-11-13T07:16:07.588Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/26/e0/eb153e55ac74a12ed473c3d5adad88ef8cc49c2377b78c1d4b50011d74ba/argon2_cffi_bindings-26.2.0-cp314-cp314t-manylinux_2_26_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:38a730ae67462338896f84860daf90af506b9d35e56599ec1cb4e096afc0f185", size = 27362, upload-time = "2026-11-13T07:16:08.693Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/2a/20/05df4d4a9bd02fae832aedb5ce6aa1d3791163b167ae0a1a57ef853f5787/argon2_cffi_bindings-26.2.0-cp314-cp314t-manylinux_2_26_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:78c3f90627e34b45064f23ee4f76f629e100c92aadc64fca946bd87199297ca2", size = 26825, upload-time = "2026-11-13T07:16:10.297Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/c5/7a/d31269cf7f2429cb960190bcadc573d27d948a6b5fbabbbcb54edd3e4e66/argon2_cffi_bindings-26.2.0-cp314-cp314t-manylinux_2_34_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:02086528488a85d374655e2f2f83fea03f49764587ac49d8e10bf6471df9f163", size = 27626, upload-time = "2026-11-13T07:16:11.413Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/41/94/b28583d91ff999365197fadab1dc00e1493ffa27fd61398050c6632519f3/argon2_cffi_bindings-26.2.0-cp314-cp314t-musllinux_1_2_aarch64.whl", hash = "sha256:dcb323dafcff4105ddcb7691b8b2aaac771ccf7ffab6932d77cc63bc20dc6d64", size = 27334, upload-time = "2026-11-13T07:16:12.497Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/16/cb/e0b13ce2795c16a7cb096c01a4cbf3568fefd3a25eb07b048e126854e143/argon2_cffi_bindings-26.2.0-cp314-cp314t-musllinux_1_2_riscv64.whl", hash = "sha256:2ed4524e0b397373b11358d9808436b6562ba1fe28ecc5d23305250989f2bf23", size = 27828, upload-time = "2026-11-13T07:16:13.534Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/d6/69/02e4ea29e229e02d31b1e132b168a8d3b1a866229a11e7d2e8da0980d9e4/argon2_cffi_bindings-26.2.0-cp314-cp314t-musllinux_1_2_x86_64.whl", hash = "sha256:0817f20fed8df025dd4347177158f38cf44c54544f53232a4cdcfe7fa6a13fa5", size = 26987, upload-time = "2026-11-13T07:16:14.621Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/8d/70/32e55e0d1f6b9f1fd54f0069061dbcd749abe48e16fae1c51a6d8c4bb4c5/argon2_cffi_bindings-26.2.0-cp314-cp314t-win32.whl", hash = "sha256:d98134ca7f99f6b6b1afbfc5e0fe87375ee9b0aa0e30645729d8761b9ed5bce8", size = 24929, upload-time = "2026-11-13T07:16:15.762Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/6e/2b/0ffed34635844d442fdb12a0092961f0e390e9762a2e359773bd9142ea4c/argon2_cffi_bindings-26.2.0-cp314-cp314t-win_amd64.whl", hash = "sha256:0771a338067f951844d2e8219472f4d30da498952c80f67a9c8e7b569e32d82a", size = 26711, upload-time = "2026-11-13T07:16:17.077Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/d4/79/0adb06280989f75c0ded9c78b066553afde031e921618997e1a1efb285a9/argon2_cffi_bindings-26.2.0-cp314-cp314t-win_arm64.whl", hash = "sha256:cad3e53733c9382d09a442804aaedebf82d505502f9c6cedba336fd591959b01", size = 26857, upload-time = "2026-11-13T07:16:18.196Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/f7/a5/75bbb0548ae95bffa4e192b587a767e8ed95715bcbb6e0131c2bdb3e07cd/argon2_cffi_bindings-26.2.0-cp315-abi3.abi3t-macosx_11_0_arm64.whl", hash = "sha256:128796ea187b2ea2d240ab4c3a9d3d07f638c72bdb3341d4085bba1e95d85907", size = 24292, upload-time = "2026-11-13T07:16:19.269Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/96/9a/2e6baf2d40a25aa0f954d1c59df1d886b4ced60ba6bfd4af4c9992435ed9/argon2_cffi_bindings-26.2.0-cp315-abi3.abi3t-manylinux_2_26_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:4fd4e255efdf1156415093db43270da540e3752b9496edf25f34bc64eb0eca60", size = 27241, upload-time = "2026-11-13T07:16:20.357Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/0f/40/63a5f02cc09655207d004d33a9cda248b5f5fbc7b2ccccd81142817a06a4/argon2_cffi_bindings-26.2.0-cp315-abi3.abi3t-manylinux_2_26_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:d1cf917a9917dafc5665d21745b9697d73a0678a82025f4d146976b3b4a0660f", size = 26665, upload-time = "2026-11-13T07:16:21.707Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/01/32/bbd6c60e7d13e0a52d5308e42388227a84569d67254e16fc4822d2979330/argon2_cffi_bindings-26.2.0-cp315-abi3.abi3t-manylinux_2_34_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:cad283b6122f69fd8ff30b3c1d982db4947aa9bbb1728908321352fe74013fc7", size = 27459, upload-time = "2026-11-13T07:16:22.968Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/ec/d7/b18cc175008afa10bc2ec1720e0aea6ecc602a185cc216ebc3c58db49ec3/argon2_cffi_bindings-26.2.0-cp315-abi3.abi3t-musllinux_1_2_aarch64.whl", hash = "sha256:9c497363618d80c59533b21538a8475b6c83cd152ecf98e31339847a484b4faa", size = 27184, upload-time = "2026-11-13T07:16:24.083Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/31/d2/44fd5746db6b66372854fd33f55c3bf27fcc1d5ae50a4fad1c076963738d/argon2_cffi_bindings-26.2.0-cp315-abi3.abi3t-musllinux_1_2_riscv64.whl", hash = "sha256:26c35612ae797817c9a94467df2d59d449253bc2a341bd81bcaeedcf2186ce9b", size = 27659, upload-time = "2026-11-13T07:16:25.185Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/29/83/849951df8a62f0094c61bde749289925c6985b27358b9ed487b526db9cd5/argon2_cffi_bindings-26.2.0-cp315-abi3.abi3t-musllinux_1_2_x86_64.whl", hash = "sha256:0605c024d02be0896112f4dc90a896df69464c634ec578ef6b0fe6caf9777e69", size = 26881, upload-time = "2026-11-13T07:16:26.283Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/84/91/04067bac98f55bc9be663cc1442ea516b523d8ed658113c84d008313ccb8/argon2_cffi_bindings-26.2.0-cp315-abi3.abi3t-win32.whl", hash = "sha256:b60f1f12567f86a7087b1c4edb2b673a1e396703d3b6137f13b1f6cea8e1473f", size = 24745, upload-time = "2026-11-13T07:16:27.446Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/39/b9/2799f5dda0bc7de972901321ba0faca8536b125afb1d71002170405c63d2/argon2_cffi_bindings-26.2.0-cp315-abi3.abi3t-win_amd64.whl", hash = "sha256:9f9f0215ddc8638b2003f8e8c5b0c378e0e976869c40911ac015f375a60fcca4", size = 26522, upload-time = "2026-11-13T07:16:28.538Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/6d/ed/4177677a981464afa55c324ae575cc6b9752affa8668acc40eb6899f98fc/argon2_cffi_bindings-26.2.0-cp315-abi3.abi3t-win_arm64.whl", hash = "sha256:1a525e093acb8dd2cd85317577271251be1920ad4d1e5a05bffde9c7a53290cd", size = 26646, upload-time = "2026-11-13T07:16:29.771Z" },
|
||||||
|
]
|
||||||
|
|
||||||
|
[[package]]
|
||||||
|
name = "attrs"
|
||||||
|
version = "26.1.0"
|
||||||
|
source = { registry = "https://pypi.org/simple" }
|
||||||
|
sdist = { url = "https://files.pythonhosted.org/packages/9a/8e/82a0fe20a541c03148528be8cac2408564a6c9a0cc7e9171802bc1d26985/attrs-26.1.0.tar.gz", hash = "sha256:d03ceb89cb322a8fd706d4fb91940737b6642aa36998fe130a9bc96c985eff32", size = 952055, upload-time = "2026-03-19T14:22:25.026Z" }
|
||||||
|
wheels = [
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/64/b4/17d4b0b2a2dc85a6df63d1157e028ed19f90d4cd97c36717afef2bc2f395/attrs-26.1.0-py3-none-any.whl", hash = "sha256:c647aa4a12dfbad9333ca4e71fe62ddc36f4e63b2d260a37a8b83d2f043ac309", size = 67548, upload-time = "2026-03-19T14:22:23.645Z" },
|
||||||
|
]
|
||||||
|
|
||||||
|
[[package]]
|
||||||
|
name = "certifi"
|
||||||
|
version = "2026.10.23"
|
||||||
|
source = { registry = "https://pypi.org/simple" }
|
||||||
|
sdist = { url = "https://files.pythonhosted.org/packages/fd/11/b524cbd9bbdaca58608e4cf4053fd463417549e1959fa8d3aa18319f9555/certifi-2026.10.23.tar.gz", hash = "sha256:a9895e6e2758b371e0545e321a3a8fd1fcfd9829ada8824a936dfb16aaaf36cd", size = 136225, upload-time = "2026-10-23T11:36:16.478Z" }
|
||||||
|
wheels = [
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/32/d1/a3652fe2c19134d0d15922177821d863cbd7e842d53a21bbe7e8e3a1b5ac/certifi-2026.10.23-py3-none-any.whl", hash = "sha256:e9b54de76e530bb6cf0ccd036787103acb58fd42ba930ea8bf948ddbaa2f61d1", size = 135082, upload-time = "2026-10-23T11:36:14.763Z" },
|
||||||
|
]
|
||||||
|
|
||||||
|
[[package]]
|
||||||
|
name = "cffi"
|
||||||
|
version = "2.1.1"
|
||||||
|
source = { registry = "https://pypi.org/simple" }
|
||||||
|
dependencies = [
|
||||||
|
{ name = "pycparser", marker = "implementation_name != 'PyPy'" },
|
||||||
|
]
|
||||||
|
sdist = { url = "https://files.pythonhosted.org/packages/9e/ef/008a1939e372c06329a3fce4279c02f328488f3526744906eeec3da7ad5f/cffi-2.1.1.tar.gz", hash = "sha256:dd31f52ea1086513bb9df30f8fcee9b8918323ae067a3d5b78bc826a000712be", size = 530807, upload-time = "2026-08-03T21:21:18.939Z" }
|
||||||
|
wheels = [
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/d3/7b/d6bbf82b8b96e7391438898c42f5bd96dd02030fd5b64937d248220003e2/cffi-2.1.1-cp314-cp314-ios_13_0_arm64_iphoneos.whl", hash = "sha256:7dbb61fe3a7699468030f71bbe5f8a0e326a151daa91beb11a6fc1f980c55e1c", size = 194064, upload-time = "2026-08-03T21:20:17.148Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/94/e6/bcc91b283be94735e268487a054004f0aa19947b6348fa367db53230abc8/cffi-2.1.1-cp314-cp314-ios_13_0_arm64_iphonesimulator.whl", hash = "sha256:f24fb43132a4c6b4cb4eb029492919b2db645be6808d738f244fd146c03c32cb", size = 196720, upload-time = "2026-08-03T21:20:18.268Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/d9/99/c4b0c17cacdc9c3b8f280026286a9826d6a208c0f047591a3c3ce99b91fd/cffi-2.1.1-cp314-cp314-macosx_10_15_x86_64.whl", hash = "sha256:d28630f5854ab07ab1fd4aba756de52326c82e6be15d414b12793f1975048b54", size = 184964, upload-time = "2026-08-03T21:20:19.708Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/b3/a9/9db617d05d7367c1ad0ab00b3aa6e6f9281edd689b4ee9ea0e5a84e89c97/cffi-2.1.1-cp314-cp314-macosx_11_0_arm64.whl", hash = "sha256:661c298b4821edebead0c91edd2b00374d67ad7c5a1f7a91d4442633b79d6a72", size = 184962, upload-time = "2026-08-03T21:20:20.833Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/67/b8/b42132ca113dc567d37684437b46ca1dafc885902b02a110a02d5b511857/cffi-2.1.1-cp314-cp314-manylinux2014_aarch64.manylinux_2_17_aarch64.whl", hash = "sha256:58acb8ab8e295e6c5ea12f888cbb13cf21511ef2a3303a23f4325c29d17fe5c1", size = 222328, upload-time = "2026-08-03T21:20:22.118Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/80/10/c5c0cbf0a657aecf59ef511409734230bf556f05a0d6c9eed7aa5c0a0166/cffi-2.1.1-cp314-cp314-manylinux2014_ppc64le.manylinux_2_17_ppc64le.whl", hash = "sha256:456a61fa52d579ebf9df2e9552ead5129855dbaff6c1e5a9b1bc408809bdc062", size = 209985, upload-time = "2026-08-03T21:20:23.401Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/d5/6c/bfa0b87b03b9238148beca990292843c9396ba069b54496596594173de7b/cffi-2.1.1-cp314-cp314-manylinux2014_s390x.manylinux_2_17_s390x.whl", hash = "sha256:a4f00aa42f75d6e4595e8866e748cc1705adc0cddfeb2ca86d0d03993d63ba03", size = 208530, upload-time = "2026-08-03T21:20:24.628Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/e9/02/4e7d553a7ac4b4238b38b3c1b80d486e9d4436f8d2acbf87a0997fe3f402/cffi-2.1.1-cp314-cp314-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:b0431303acaea1089ad4b3e9ce4e6518193def1118d4073ca848635ee4ea2e96", size = 221525, upload-time = "2026-08-03T21:20:25.758Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/82/1d/a4aaf9babd75acb4d5f223bff71533bee748dd770a382619a798960ee9ba/cffi-2.1.1-cp314-cp314-musllinux_1_2_aarch64.whl", hash = "sha256:64faea20f4e2613363a1a9b9c7dd73058f3ecd00133a511e72ad7c511658f527", size = 225053, upload-time = "2026-08-03T21:20:26.985Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/81/10/5dc0e7bdd18e22107054288283380fc97a06ae3f1656a106908d666a3c88/cffi-2.1.1-cp314-cp314-musllinux_1_2_x86_64.whl", hash = "sha256:5c58fe613dc5e5336357eff555824a314d8e43282600435c8d1cb6a7a2fedd13", size = 223213, upload-time = "2026-08-03T21:20:28.277Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/0b/e9/d0061c364cde06ee43168a0d076ac1da512cbc380d44767b844ba34fe2b6/cffi-2.1.1-cp314-cp314-win32.whl", hash = "sha256:1a18a57b58cfb21fc28d72e876acf10eaed67a1ed96226f92af4df681d571c4c", size = 177682, upload-time = "2026-08-03T21:20:44.288Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/a7/06/1c3e01e3ba14c39f6d10bfbac52753b7e22259e38088e5cfe1d704918690/cffi-2.1.1-cp314-cp314-win_amd64.whl", hash = "sha256:3222ba5d678f80a030e6afbcc33dc1ae5cb45facabb61cee2c7016b8432fde48", size = 187949, upload-time = "2026-08-03T21:20:45.623Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/87/5b/da4e39efe18eeb89cf580ea9cfc66b6a7c3eadb808fc0cc1d3a295cb5a5d/cffi-2.1.1-cp314-cp314-win_arm64.whl", hash = "sha256:ab36d55f9ed2d067327667c2fea18dda018eb628dd6347aa01dda6cf1f5d3836", size = 182947, upload-time = "2026-08-03T21:20:46.955Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/23/59/40338bf421c5accea1d45158170c87006ef1cd371b05c077e76476949728/cffi-2.1.1-cp314-cp314t-macosx_10_15_x86_64.whl", hash = "sha256:7750c6449dff7864bb9bb27ddfb0267756189201a3afc911d82b3caacd70dfc3", size = 188504, upload-time = "2026-08-03T21:20:29.495Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/7d/47/5ecf1023850036e674c77ec4de86182d309ae344e39e7cba984b7df5d647/cffi-2.1.1-cp314-cp314t-macosx_11_0_arm64.whl", hash = "sha256:0beceaabe56af686895136a2de78db54ecd8e4046b236b8fd6d6cb61389e9bf2", size = 188259, upload-time = "2026-08-03T21:20:31.291Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/2a/9c/92934c3bea9f785b23eba304538c0b4d37a2a96d2431eb3a1bc87a11aa19/cffi-2.1.1-cp314-cp314t-manylinux2014_aarch64.manylinux_2_17_aarch64.whl", hash = "sha256:49cbc70e6542d4ccccb936558d1064a8012541e78f821f955cff24e357776c94", size = 223864, upload-time = "2026-08-03T21:20:32.571Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/4d/45/ba4c93527bc38616a8bd36488acb69a2212d60486794f0c1f318949bbb76/cffi-2.1.1-cp314-cp314t-manylinux2014_ppc64le.manylinux_2_17_ppc64le.whl", hash = "sha256:e2d65b31f36619cda3999b78b2aa9632e76b78448e7a56fc4240824200e7c4fc", size = 211538, upload-time = "2026-08-03T21:20:33.808Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/80/e9/b6ef565e452acb932fb0cb5443f44a78efbd1233e566f02b5a83855e9115/cffi-2.1.1-cp314-cp314t-manylinux2014_s390x.manylinux_2_17_s390x.whl", hash = "sha256:28907ab9bfb6aa13184cfc17c6b8e1023c5ab6fd7076d8c20a35e59fe04f8f29", size = 210688, upload-time = "2026-08-03T21:20:34.974Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/9a/95/eff5f0cee78d2eabc7eebffec40d3fc1876b5f3c95582e018bb4b99601f2/cffi-2.1.1-cp314-cp314t-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:51b31d1c98274844cfd7838ce00bfc27c7423a4dc00fc0772fc3331c2cc90676", size = 223803, upload-time = "2026-08-03T21:20:36.564Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/fa/01/579d39fb8bef00a335a23d83757b44feb24cd6345a2c451b64cb67b9c362/cffi-2.1.1-cp314-cp314t-musllinux_1_2_aarch64.whl", hash = "sha256:5e7cecbaadb83884793e05828cee59b210b24583b9c7425d0ba6a754fe22eb4e", size = 226763, upload-time = "2026-08-03T21:20:37.816Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/8d/b0/0b44f47c60b01b57b6e2bbd92343f13a85a1d93bc46ccf6e47e244acd99c/cffi-2.1.1-cp314-cp314t-musllinux_1_2_x86_64.whl", hash = "sha256:25792eac27877609e7bb06d42ff88278a6624fff2ba9bbb523c09616b117e80f", size = 225688, upload-time = "2026-08-03T21:20:38.959Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/eb/d2/3b7176cb570a1d3e27faf67b72f591af508036e0d8b2be2ef9af9e8c84bb/cffi-2.1.1-cp314-cp314t-win32.whl", hash = "sha256:8ef53b2de9bcb9197d31854256575d59dbac0cba72ac627bb291ef5eceb74be4", size = 182868, upload-time = "2026-08-03T21:20:40.388Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/56/78/31f00c1bcd97c9bbf55f1bfdf5bc809a5de8887473e90bb9960dca825e80/cffi-2.1.1-cp314-cp314t-win_amd64.whl", hash = "sha256:616f097f2fe415bc92a247f02e11f634e1f9e9a83d327e3c915c15089c87869e", size = 194104, upload-time = "2026-08-03T21:20:41.725Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/7b/1b/58496f2ed0a35de575250c02a43ab3cc2c04d494a88fed31c1cabc0fd176/cffi-2.1.1-cp314-cp314t-win_arm64.whl", hash = "sha256:ad2c86c495b899d862ea0f4b42891b8713a3bd45dd4105c7fd51c2a72f39f3a5", size = 186402, upload-time = "2026-08-03T21:20:43.042Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/c1/8f/9ebe220eab48a093d1a5a5e339ab0dc7316eef3bb04d63c42f0251b61f50/cffi-2.1.1-cp315-cp315-ios_13_0_arm64_iphoneos.whl", hash = "sha256:dddad92b554513a31f272570678ba307fb9f618f05e3d4a5eacafff9eae03e1d", size = 194043, upload-time = "2026-08-03T21:20:48.179Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/ff/69/844bad3ece306c4782c2ecb93597035b6690d48704b803914c199da1e8b3/cffi-2.1.1-cp315-cp315-ios_13_0_arm64_iphonesimulator.whl", hash = "sha256:da0e573f9f97159390c89d9f1a9e41908b66d408cc5b58d08cf3847d844c531b", size = 196737, upload-time = "2026-08-03T21:20:49.457Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/1b/8a/af668013284634733f02d683458a0728739c7d6ddb5e14cb0c20832266fe/cffi-2.1.1-cp315-cp315-macosx_10_15_x86_64.whl", hash = "sha256:fb92203a88b3d3053034db775110081c49d28be6551923805e039924093761e4", size = 184933, upload-time = "2026-08-03T21:20:50.639Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/0c/75/2f5207ff6d1a613133b23a5203cc0c2a628313b5eb3974d7956ae3c57950/cffi-2.1.1-cp315-cp315-macosx_11_0_arm64.whl", hash = "sha256:2ae64be792b8966f2c69538199728b290e34726562896df1e5dc8ffd8d8188e8", size = 185002, upload-time = "2026-08-03T21:20:52.173Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/e2/31/9e1313b0a6e30e91b3b3d3fff51ae99c857c07738e3afcce1f7334e1b7ab/cffi-2.1.1-cp315-cp315-manylinux2014_aarch64.manylinux_2_17_aarch64.whl", hash = "sha256:507a24c282e0f42f8ed737cf048572cbf580468da5555764a8331735e9c736b6", size = 222271, upload-time = "2026-08-03T21:20:53.462Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/50/e3/f6234a833e6e08c7007003074723c406559eecf9b48dfc97471e5a8eb7a0/cffi-2.1.1-cp315-cp315-manylinux2014_ppc64le.manylinux_2_17_ppc64le.whl", hash = "sha256:246fa40ce8645a614ff682e0b70f37134e460eaf93a775e0cbe3cca585a67a80", size = 209919, upload-time = "2026-08-03T21:20:54.783Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/0d/fc/5f74e293fced6edb51af3a46c4ccf6c23c9943774ecb375ddbd522c76add/cffi-2.1.1-cp315-cp315-manylinux2014_s390x.manylinux_2_17_s390x.whl", hash = "sha256:471cee653ae88de62096552e6d24ccb4a5adb8c8c9f10b5054d0122c15bf2779", size = 208529, upload-time = "2026-08-03T21:20:56.066Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/44/16/29e6d01b388bef055ecd6ca8244b3f4d336bd09e92d5d892187b9601084e/cffi-2.1.1-cp315-cp315-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:aeae0e330c9f6acd681f647d46cefd30c29f93e3392882e792e82080c9691399", size = 221630, upload-time = "2026-08-03T21:20:57.336Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/a4/18/fa7f1f6857d5eb88a4ca99ffcbfb7c387a287ccc154c64a73e86314745d7/cffi-2.1.1-cp315-cp315-musllinux_1_2_aarch64.whl", hash = "sha256:42a494cee34437f05546455144f2b5d9ac09b1face62bcfce597d2e521066688", size = 225134, upload-time = "2026-08-03T21:20:58.675Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/e0/9f/e8e3dfa04a1b4c241f8c91faacad872b4d4efd051d49764ad4e2fd4b9fea/cffi-2.1.1-cp315-cp315-musllinux_1_2_x86_64.whl", hash = "sha256:cc572dace3f60ef98d7b12ff411d20f5362feb31a0439eab0085bbfd349982d7", size = 223197, upload-time = "2026-08-03T21:20:59.968Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/f8/7e/8debeb04f1ab9fe2a6963964cd6f1aaf7192627b83926586a6a4e089c9fa/cffi-2.1.1-cp315-cp315-win32.whl", hash = "sha256:4f42141fc14250de6dde5ee7ea4432be017252d91f19c5ad043c084cea629cac", size = 177683, upload-time = "2026-08-03T21:21:14.901Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/e0/31/5158704cc474ab65c1647932e88be78dc0873f47130e253be38bcaf13d01/cffi-2.1.1-cp315-cp315-win_amd64.whl", hash = "sha256:e6e8cff14d6fb0be70a09c0bdc58096f501952d04624ebf867e0e56da2df8960", size = 187897, upload-time = "2026-08-03T21:21:16.108Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/cc/4b/b3a2da8570c704ffc0f9762cdc3ec0f02c8573798e0b5cf7f11c82bbb70f/cffi-2.1.1-cp315-cp315-win_arm64.whl", hash = "sha256:27350daa11d4f10c540e6e89dada4c54feb7256ad03e9a4dc075ebad7ba360d1", size = 182935, upload-time = "2026-08-03T21:21:17.271Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/d0/ef/5443574510a1207e6f6bc38ba6e1f1de36cb48fef07b2728bb896a21f430/cffi-2.1.1-cp315-cp315t-macosx_10_15_x86_64.whl", hash = "sha256:c26608d2222fb1e94487e4a387d85f13eb55d5ed725cb25a0c589ac4ee60e7bc", size = 188464, upload-time = "2026-08-03T21:21:01.163Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/7e/ae/a56fa8c4686ad50e148fcbc8d3ae0d03915ff5c30d795058988c24118cef/cffi-2.1.1-cp315-cp315t-macosx_11_0_arm64.whl", hash = "sha256:4be96343e422f2dfcd12ab5c9f5aebe03f82f737c6bffeca6830b3875cb44aab", size = 188262, upload-time = "2026-08-03T21:21:02.382Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/53/b2/6187f46f2912276a3ae284076109cc5c8680482f11f766ccf26db4a86427/cffi-2.1.1-cp315-cp315t-manylinux2014_aarch64.manylinux_2_17_aarch64.whl", hash = "sha256:937c0052c05a31ca1daf18de3158eed4dbfcb9cc107adbea227728d647be701e", size = 223779, upload-time = "2026-08-03T21:21:03.553Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/8a/f6/c3ad28bd19f77047a03084424fbd4cbe997303267c14423737324be0385d/cffi-2.1.1-cp315-cp315t-manylinux2014_ppc64le.manylinux_2_17_ppc64le.whl", hash = "sha256:df423d40ee8654634421812bc3b196da3f9bd7d32929da813f8394c4348a5358", size = 211520, upload-time = "2026-08-03T21:21:04.863Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/a0/cd/ccac9013a5bd9fd764de118674ab9c805b5ca10c19270d90ee273f8b2240/cffi-2.1.1-cp315-cp315t-manylinux2014_s390x.manylinux_2_17_s390x.whl", hash = "sha256:a730a083190634c65cca36ba5f489531576ebd79bcd5c8e172130f6453127231", size = 210673, upload-time = "2026-08-03T21:21:06.223Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/52/86/2976131c639aead931c5bee5aba67e4b09fbeb8018b6f282f70803f923a7/cffi-2.1.1-cp315-cp315t-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:363e05fa78e15116c3c32c210ee36884fd6b9afa6d440e47112c3bd511d64cb6", size = 223835, upload-time = "2026-08-03T21:21:07.539Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/ac/0c/33a7aeab2f9c76918c52e084beb39c570db3588133412929e8ec06fab90b/cffi-2.1.1-cp315-cp315t-musllinux_1_2_aarch64.whl", hash = "sha256:770de9db11e84213beec501cfcaa013b019820ca881e03344dea5844f7876d94", size = 226705, upload-time = "2026-08-03T21:21:08.774Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/e3/26/2cde30fdde421130bfc18f70395731a6e6b2053c6a1978a5258ff04e72fa/cffi-2.1.1-cp315-cp315t-musllinux_1_2_x86_64.whl", hash = "sha256:7da0c5eff80f0197f3b3d1232ec5a682a9325f4ae9016a78f5f5ca35f9ced1f5", size = 225539, upload-time = "2026-08-03T21:21:09.911Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/6d/cd/a361394c94b2129d604bb846f624a8e88255a3ee33129c434a00d715e64f/cffi-2.1.1-cp315-cp315t-win32.whl", hash = "sha256:06c72bb76605a4b0cd0aad6930b69d4baf7dd5d806cfc409b824191099700e66", size = 182707, upload-time = "2026-08-03T21:21:11.226Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/9b/b5/ba2b299993c26577d529b6ae29841f9e15b9fcf004d65f423f4fcf94ade9/cffi-2.1.1-cp315-cp315t-win_amd64.whl", hash = "sha256:d9c275eaacd24aa73f94ffd6de08fc3f932424d8b6c376f4bed7cde376fe7bc3", size = 193772, upload-time = "2026-08-03T21:21:12.39Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/aa/29/35e016098c814cd93de9cd320c66b5bfba14dc6ecedd3cb518fa7c408c69/cffi-2.1.1-cp315-cp315t-win_arm64.whl", hash = "sha256:d18e5ac0f2f03f4f518d3e23db0f0cad7faa1da8620e9c09461d443bbf6e6692", size = 186360, upload-time = "2026-08-03T21:21:13.636Z" },
|
||||||
|
]
|
||||||
|
|
||||||
|
[[package]]
|
||||||
|
name = "charset-normalizer"
|
||||||
|
version = "3.5.2"
|
||||||
|
source = { registry = "https://pypi.org/simple" }
|
||||||
|
sdist = { url = "https://files.pythonhosted.org/packages/33/1c/f41d4e74c28ab327ff3acd36053f7ea506c55872d7a90b0fa71aa3ab0c89/charset_normalizer-3.5.2.tar.gz", hash = "sha256:39de2a259fc954455c57274dc94c79d5842774e1247a016aff30bc0efed0f4ef", size = 172659, upload-time = "2026-09-30T04:39:23.398Z" }
|
||||||
|
wheels = [
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/58/ca/7aa91362a2f77ac8e9e28a9b902a74f7d0e11a851ef0d27a74308da8cd90/charset_normalizer-3.5.2-cp314-cp314-android_24_arm64_v8a.whl", hash = "sha256:1afb975bd5d68d5ce9f6b6d44fdf2f7e34b895a35e95708a7a91b20a3b51d187", size = 226010, upload-time = "2026-09-30T04:36:27.669Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/a8/cf/ac8878d0322cf88a1aad4c7b147db32ca0bd806eb0060957b2e31486dbe6/charset_normalizer-3.5.2-cp314-cp314-android_24_x86_64.whl", hash = "sha256:bbbfc8e28816f19d7c0f1816664980c0a9875d01b27cdf8eedddb639d9e108ad", size = 239266, upload-time = "2026-09-30T04:36:29.434Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/c9/6d/9a08d7e0b29b7208e2c6c01dc56c8e0520e7c7beadbbfb024b58fd69c8a5/charset_normalizer-3.5.2-cp314-cp314-ios_13_0_arm64_iphoneos.whl", hash = "sha256:7967d08cf06dee78443b874f98c98036f624f3a4e73e11f9f64f5be4d25393cf", size = 206783, upload-time = "2026-09-30T04:36:30.872Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/82/44/b0aa350280e6ff5a5492d17cf10460dd39d5ee848f872f7ba2df10607f60/charset_normalizer-3.5.2-cp314-cp314-ios_13_0_arm64_iphonesimulator.whl", hash = "sha256:4c2b5031f63e331e3839b40aed2dd6f191e9c07edbde303e7876846ea1946995", size = 210449, upload-time = "2026-09-30T04:36:32.625Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/7c/8a/40db9aa9f5907bb0e6f8b6d64064bf8852fb33d4b813ff9414911df7647c/charset_normalizer-3.5.2-cp314-cp314-macosx_10_15_universal2.whl", hash = "sha256:fcff63213e8e6e47770541a4607175404f47cbb3ebea7b6058cc82d524a0e424", size = 367815, upload-time = "2026-09-30T04:36:34.197Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/7f/72/9c5e7707b57c8ddfa9ddf7b0b1d009d7fbab9e9e887d5b721060f37e307d/charset_normalizer-3.5.2-cp314-cp314-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:8d86d6fc60743dc916eb79e2eb1ec4818e21e427731543af40a3021851174a13", size = 247095, upload-time = "2026-09-30T04:36:35.803Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/83/09/71e453691e927de4ddf792770cfaab3f49d494e222f66ea5e404bbd5e39c/charset_normalizer-3.5.2-cp314-cp314-manylinux2014_armv7l.manylinux_2_17_armv7l.manylinux_2_31_armv7l.whl", hash = "sha256:7a881931aa470808df94a8c380eed2bbbc76cd9dc622310f99665658c821eb6d", size = 233942, upload-time = "2026-09-30T04:36:37.407Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/9f/86/85c84e4da8b27dd409577d9437926ff581c5f9d3c66038dc68c1a526de51/charset_normalizer-3.5.2-cp314-cp314-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:8024d00c3faf3fc0c16e07a69f4405e8eac7cc0ab15f65fe6cf43827c4cf72b4", size = 273762, upload-time = "2026-09-30T04:36:38.904Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/92/08/564955a4b5f2ccb410ab480bbe8c6a18063ff27f2d35458731c4a5335df9/charset_normalizer-3.5.2-cp314-cp314-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:4d48f2d08b9de5864e2c8744d4461b862fb149a18274abc8b698c45975573438", size = 269514, upload-time = "2026-09-30T04:36:40.469Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/18/24/bad3ac4271589df29cf5ce2f5ae490518a5739358052bd0d61209e6fea54/charset_normalizer-3.5.2-cp314-cp314-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:34276fd796040bf0993ab33a369aa572e6979c7aab225a88893667ad8eac8f7a", size = 255056, upload-time = "2026-09-30T04:36:42.02Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/d6/3e/350d89ad49916b86554d6f5f2d03ec1152148f87e5ff735106c6a03b1a36/charset_normalizer-3.5.2-cp314-cp314-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:0521c5665880b33d603717defa76c094048900010897909952397feb3039da56", size = 251311, upload-time = "2026-09-30T04:36:43.577Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/56/5b/4970a2d154df502e133402906dd04e3ae7cada7b3011283c88d0479a2585/charset_normalizer-3.5.2-cp314-cp314-musllinux_1_2_aarch64.whl", hash = "sha256:eff0ac9dbe711a4aee69bf04a83896aa9b85f19641264053a9f6d48573abb7dd", size = 250190, upload-time = "2026-09-30T04:36:45.185Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/88/8c/f1a91bddc8fb47c2889e29ea7ea49a194eb0d9868675d786806519c00d76/charset_normalizer-3.5.2-cp314-cp314-musllinux_1_2_armv7l.whl", hash = "sha256:1503bccbeb36d5527790c3930327704c39af22de3112f1b1666a9f3ce15ee204", size = 237098, upload-time = "2026-09-30T04:36:46.689Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/24/0e/bb5dace3cc7e79068425386a6589c19b5a2ab5fefc2a46abea6919683332/charset_normalizer-3.5.2-cp314-cp314-musllinux_1_2_ppc64le.whl", hash = "sha256:52aa6992700996af31f375de0c6bacd402b0097fe40b53c426b9f51a90ebabc7", size = 274228, upload-time = "2026-09-30T04:36:48.31Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/9d/79/b849ad523017ea9f5a45581bbebed91439e0cf42fd2860a6f64e358eb5a6/charset_normalizer-3.5.2-cp314-cp314-musllinux_1_2_riscv64.whl", hash = "sha256:e09a3942ecbdee5cce73ea9d42da82b81b72ac1bf031ce069b93b5adf4eac8cd", size = 252401, upload-time = "2026-09-30T04:36:50.091Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/89/8c/75469d690cf47200bce8f6cad7655724fc23148e147abfc5ce78b5f65863/charset_normalizer-3.5.2-cp314-cp314-musllinux_1_2_s390x.whl", hash = "sha256:c7c9ab723cde841fefb34efbad91e87f00a674b1fe1cd0784fde742bf2c154dc", size = 271846, upload-time = "2026-09-30T04:36:51.719Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/26/cd/6d52d3c7437cdcf2e310ce9f28f282e733d4ef60ed19105d1819c356255f/charset_normalizer-3.5.2-cp314-cp314-musllinux_1_2_x86_64.whl", hash = "sha256:ddc7dacc8ece3a182e7f15cb862d1fd616b46d076cb1ae9dd232b2c38b655874", size = 258151, upload-time = "2026-09-30T04:36:53.234Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/f7/4c/070b38bdb5f49a70199fce923ec0726a49536a63ab262abbfcaaf351110b/charset_normalizer-3.5.2-cp314-cp314-pyemscripten_2026_0_wasm32.whl", hash = "sha256:ee43c17b173d46a3212baa6ead3ae258eeabdae48c263a01ccf0218c366dd655", size = 143570, upload-time = "2026-09-30T04:36:54.816Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/81/84/9ebfc8ed6c8c4fcd8e726ff6bf220cc8deb3966e31dce9be8dd8aa017e64/charset_normalizer-3.5.2-cp314-cp314-win32.whl", hash = "sha256:4f87960d57feabfb618e4e0af6e7371645fa26a277860739d6e5d6e0012c92f0", size = 186412, upload-time = "2026-09-30T04:36:56.643Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/d1/78/5ed86f743d4bc350db307e7636419a0a5ee1d91806d30c7f667bd5c80dae/charset_normalizer-3.5.2-cp314-cp314-win_amd64.whl", hash = "sha256:e4e81e09c1578b8df602e3db08b0b3ea0a6947ad612f52bf8dc5ea8d47691f0c", size = 210965, upload-time = "2026-09-30T04:36:58.205Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/53/94/a3a7698e9b1a395e1eb99ccd9a324be9347973bff4e72db2a06496d7cd27/charset_normalizer-3.5.2-cp314-cp314-win_arm64.whl", hash = "sha256:80d02b6f04e92601a081dd97b23d3128033098bff5d35d392ddcc0476ea11253", size = 200406, upload-time = "2026-09-30T04:36:59.764Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/c1/48/c5dd00d5ef7791f02666de250a5bb6071e29b7e133cf4b835800b6d3bc27/charset_normalizer-3.5.2-cp314-cp314t-macosx_10_15_universal2.whl", hash = "sha256:dca9ab98072a5a54ebacebdc45f53e645336b320c667410b061be1ca588ae709", size = 396871, upload-time = "2026-09-30T04:37:01.543Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/12/c8/8379554b42e8368161d898476686947a0fdbd3e8865170d7909dcabfdee8/charset_normalizer-3.5.2-cp314-cp314t-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:f0aa869112ef88429ae17820d99c3dd9504c9e9c671d3c246f3d7442cb051084", size = 249711, upload-time = "2026-09-30T04:37:03.111Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/4a/eb/2ddb1035d17320caa9f41682935123a9a250277b261c3efc86b2d2a21343/charset_normalizer-3.5.2-cp314-cp314t-manylinux2014_armv7l.manylinux_2_17_armv7l.manylinux_2_31_armv7l.whl", hash = "sha256:c0afc6800ba57ccc350374c5bd6150419915d95ce93cdbab2d783d75eaf30ecb", size = 231146, upload-time = "2026-09-30T04:37:04.721Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/4a/24/2ecb4bde104322cd7859d6594fcfa74649f8d90b3221c9feecbef149875b/charset_normalizer-3.5.2-cp314-cp314t-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:7dcd882da75ef9adf94903b1e3b9419e8aa8fb4c7396822b834b9ef7fb96954f", size = 271552, upload-time = "2026-09-30T04:37:06.295Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/3f/98/9d5f6ebc3aee9fef5d30b4aff11fb2ab7a1222b4064f8ef2c7c87cde217a/charset_normalizer-3.5.2-cp314-cp314t-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:2e06a3a98f916dd41d27f3105e02e7a40181c98c94b9158733d03a6f80506c09", size = 269810, upload-time = "2026-09-30T04:37:07.905Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/09/e1/a3b06a10461b1b7628853c934c644e03bc28e42767116afb52f19a56519b/charset_normalizer-3.5.2-cp314-cp314t-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:6bd128f206a7752ae1f2ab6c61bf8a24ba28913a10df8b14c2637b973ff97a80", size = 259845, upload-time = "2026-09-30T04:37:09.554Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/fd/d3/6f561f74a296cf27d61775a1dc665ad13f3bff6a798810ca05907f37a7c4/charset_normalizer-3.5.2-cp314-cp314t-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:c8f3d67aeaf55f017982b73683f0e7342ba2f6635a78f69ce89ebb26aa411e5c", size = 252825, upload-time = "2026-09-30T04:37:11.274Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/26/9f/69e13ca3b18f43e0eafcd34c04a45b732ae22a43b54a5fc9e119103356eb/charset_normalizer-3.5.2-cp314-cp314t-musllinux_1_2_aarch64.whl", hash = "sha256:fe9753dfee015c570d73df76f899f18444d41388bffcde097deba51c4fadbb9f", size = 252659, upload-time = "2026-09-30T04:37:12.941Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/73/a9/ace29806a0dae18939919c76ba526472d83214afa101105fabff2cf30625/charset_normalizer-3.5.2-cp314-cp314t-musllinux_1_2_armv7l.whl", hash = "sha256:92888bb3187c5ba50500b00b3b310c9f2c651709d28036077680cb5255450a03", size = 238819, upload-time = "2026-09-30T04:37:14.659Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/f8/c1/6116d52a2e3311ec80f21f5fb5e17b27405f10b9608af8f6e69516841a1b/charset_normalizer-3.5.2-cp314-cp314t-musllinux_1_2_ppc64le.whl", hash = "sha256:d008d90a7f2471519aef0c90dfbe73b3e6e4d5e66ac48e19154c17e89e98b604", size = 272973, upload-time = "2026-09-30T04:37:16.346Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/19/aa/9955c7e93bba10a9c7e8f7a5031b7ced66f3a1883a55c00712b8d5850ff3/charset_normalizer-3.5.2-cp314-cp314t-musllinux_1_2_riscv64.whl", hash = "sha256:31f3930700408d211f13378ccbe1c40845d8da54bd0681fac3a9b5aae81c7aa8", size = 253692, upload-time = "2026-09-30T04:37:18.212Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/bb/33/2a6ae7fdc1b10cb581cef91addd8cdfc5f40d50abb5702309369d5834579/charset_normalizer-3.5.2-cp314-cp314t-musllinux_1_2_s390x.whl", hash = "sha256:2a925889534b3748302dae5dead07cc13480de1dac3aea80a941b729b471ef93", size = 268757, upload-time = "2026-09-30T04:37:19.877Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/a2/22/80992720a0282cd39bba1db35868e6b9c22f41281160143a836544bc1d8a/charset_normalizer-3.5.2-cp314-cp314t-musllinux_1_2_x86_64.whl", hash = "sha256:f5ec61164adcec446f8969a3358ec3f9b26bbda3b9213e5586d219afa8df2915", size = 262220, upload-time = "2026-09-30T04:37:21.583Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/92/9f/181fd07e1bffea1d95cd80c84ac537354f50699c22cfc4d3c02b6fc16208/charset_normalizer-3.5.2-cp314-cp314t-win32.whl", hash = "sha256:598a11a2c7ebaa5334bf698bf29568c9c390abac6a154d8170fedecd1cea38c5", size = 197797, upload-time = "2026-09-30T04:37:23.235Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/49/1c/25d8415ec1c4f2f41f1680435e4c87cfb378ff2f677d950946f2a45d0632/charset_normalizer-3.5.2-cp314-cp314t-win_amd64.whl", hash = "sha256:7fdde2c9fd9e3eca40631e024664cf2584272cc8f96308cbe5fdfc930f51d8bc", size = 222765, upload-time = "2026-09-30T04:37:24.891Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/3e/b4/46b48f013dadfc0d0d33b375438e31bdf5a989dc68389c6bf627054d4df9/charset_normalizer-3.5.2-cp314-cp314t-win_arm64.whl", hash = "sha256:d1befeed746d247c81127bb14de9dc3d30edb6e5976d34f83f86ed262b1d9105", size = 210985, upload-time = "2026-09-30T04:37:26.634Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/ca/e9/34e597dee616d0b8ee4b34d29399e85c2204ade174157a48505d42baa4ff/charset_normalizer-3.5.2-cp315-cp315-macosx_10_15_universal2.whl", hash = "sha256:87475fabc8d9996fd9c27debb395e642e8c838d78a00b6e932227a0e06b81e26", size = 367676, upload-time = "2026-09-30T04:37:28.329Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/60/9f/a5d1c91c0263745e2cd344c5a4415d787c575501ab1d449f1148ac6b495d/charset_normalizer-3.5.2-cp315-cp315-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:9409a8bf35cf78353942504b24a57de3d75b708997a1e4bd8db71ac8633ce364", size = 248414, upload-time = "2026-09-30T04:37:30.167Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/26/79/e697f77464748a3ee3cf490c83d592459400d4898380d66c38366b03080c/charset_normalizer-3.5.2-cp315-cp315-manylinux2014_armv7l.manylinux_2_17_armv7l.manylinux_2_31_armv7l.whl", hash = "sha256:498dc3188ca05a68231ac3fdbfc7f57eb67e1343c30e0fea17f8218c1599b253", size = 244775, upload-time = "2026-09-30T04:37:31.964Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/ca/87/3d42a42e18ea066e2513936fd678a00696e77878b5ae04528976abdbcb83/charset_normalizer-3.5.2-cp315-cp315-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:e242bb1c5e76e97dfa9e7f209a71e93a01d7f19ffdd5cfbb2e2d55b4f08f8ab0", size = 273877, upload-time = "2026-09-30T04:37:33.661Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/c3/76/8a28136f3938ba9836f84280ce0c4d61ed1cf15a036b2034900c62634162/charset_normalizer-3.5.2-cp315-cp315-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:def79fa35ef0cef8d2accec024f4fdc7ead3012ff02f5215c783f39f03ef8cfc", size = 269455, upload-time = "2026-09-30T04:37:35.573Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/a0/a1/4fbf5d0f0f1b2a080474c1cf9a2f12c4c6531bb0e8ba591055e846d2b4e9/charset_normalizer-3.5.2-cp315-cp315-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:3df041de8887954562c9b261cba85ca0e9ded74048daf125f45edcfaa4832229", size = 257336, upload-time = "2026-09-30T04:37:37.397Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/ba/a2/8b50aa320adb880ad579518e6f718f24944804b42a88b83d267d5d444125/charset_normalizer-3.5.2-cp315-cp315-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:04851f73ae72b8413dddadb16a49dfee95263553741fd42d546f7d66907e6be5", size = 257584, upload-time = "2026-09-30T04:37:39.522Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/a5/57/50e3fed84e175f40349bd0da7a4fce94c87f0378f52d74f511d89e0bdc20/charset_normalizer-3.5.2-cp315-cp315-musllinux_1_2_aarch64.whl", hash = "sha256:183b88127acdb4fabe59d951ab424faf1af7b63cdbb5f776186c1ea2ffcaed98", size = 251854, upload-time = "2026-09-30T04:37:41.23Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/d6/54/f7fbb3493c9f49091213b9c2d6dd65800696f1ce1a3f196a4205f50417b1/charset_normalizer-3.5.2-cp315-cp315-musllinux_1_2_armv7l.whl", hash = "sha256:16fa0eccf81304b79c5cd87f9271c3b85dd9dd99245e4422ae9c0dd45e0f99d3", size = 248767, upload-time = "2026-09-30T04:37:42.883Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/d9/37/b3a6385acc5a1e45b39ae9c90bfb9cf838a09b9dd37ef2740ab4c6b4a2eb/charset_normalizer-3.5.2-cp315-cp315-musllinux_1_2_ppc64le.whl", hash = "sha256:7441d755b7ab94f8d4eb3e43ec05482d760842fd263d003a99102d742cd835e2", size = 274479, upload-time = "2026-09-30T04:37:44.658Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/89/44/809913e2cfd279e635a9294fdbbfb1b1dc62a8189d473d561f649fce98d8/charset_normalizer-3.5.2-cp315-cp315-musllinux_1_2_riscv64.whl", hash = "sha256:ca403d7e4798f525fdfc78e258820419cbbd0f0ecbab9de7840e3c017cf6b8cf", size = 258310, upload-time = "2026-09-30T04:37:46.529Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/af/a2/f28400ab13359d91bd39179df8e149376b9bf36588e739a3a4f9de2b84b2/charset_normalizer-3.5.2-cp315-cp315-musllinux_1_2_s390x.whl", hash = "sha256:df29a0a7107f7011e77f4eebdddec4c7331e24d787a0b21a46d63bdf7445da95", size = 271100, upload-time = "2026-09-30T04:37:48.399Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/e9/89/9bab37955edf0adb3b66f8a3a6617d9f2f487e0d56f295a6a286cb640aa6/charset_normalizer-3.5.2-cp315-cp315-musllinux_1_2_x86_64.whl", hash = "sha256:f3c96f633825733f735c5a9cf21d21a257d8e1edf0b1cee0a064b9c424ca0f7d", size = 259936, upload-time = "2026-09-30T04:37:50.023Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/23/b5/4459e08d45a679f903d50fea08bc52cfa728cca4d7bd02c757b5e5abda2e/charset_normalizer-3.5.2-cp315-cp315-win32.whl", hash = "sha256:281cb91036248400f4cc957495cccd44c275c2e0c5854f7e45ac5cf7dc193847", size = 186301, upload-time = "2026-09-30T04:37:51.722Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/98/e8/55d5fd3935b4bce6da4fe0df61898e8c82653e317e677bd58aceb9c60f13/charset_normalizer-3.5.2-cp315-cp315-win_amd64.whl", hash = "sha256:89b53f3cda69831909888e0494f4fa0bcd3537e3e138dabeb620bd6ad946bae8", size = 210858, upload-time = "2026-09-30T04:37:53.427Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/a9/5b/974423c2fd8e524c7a7f64318c1e02240ef954912fa2b4d70344107b9c68/charset_normalizer-3.5.2-cp315-cp315-win_arm64.whl", hash = "sha256:6be488a102b8cf28d0391d8c4ba7748938ae28b78ad901f8585520fca33ead1a", size = 200309, upload-time = "2026-09-30T04:37:55.015Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/ee/f9/00ee0195db1013d8f7c416fd770fbeb560bb46eb2e36b054d05cb56f6cfa/charset_normalizer-3.5.2-cp315-cp315t-macosx_10_15_universal2.whl", hash = "sha256:915563965d418f986e7e145accc592eae9e1a1be3566ff98a05d7a9ec42a76e1", size = 395343, upload-time = "2026-09-30T04:37:56.743Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/04/3a/c00b50e94c964cf934c7899cd47c97952fc11dad71cc5884b3c61795b09b/charset_normalizer-3.5.2-cp315-cp315t-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:65cd72beeeca9d3aaea1201e5923859f308f952f9c71de93f06063c79f0f7a3b", size = 250114, upload-time = "2026-09-30T04:37:58.607Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/50/27/d102dc880bbcffd0479ab64dfc1fb96777a854355a55e2bda72a71efadcb/charset_normalizer-3.5.2-cp315-cp315t-manylinux2014_armv7l.manylinux_2_17_armv7l.manylinux_2_31_armv7l.whl", hash = "sha256:b7fd005a73d9e657273b7a10dc71a9e03c8fb9ee6999798d6918ce095b81ac7f", size = 239997, upload-time = "2026-09-30T04:38:00.511Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/a5/4a/bf7ef45794dd293fab5f98a9309817977fbb845b9998f171b8cc5d8437a3/charset_normalizer-3.5.2-cp315-cp315t-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:e54da4baf05720032d527874d40b65fa4d7e5c6c6a43d0c3adbeffcaf275a2b3", size = 272313, upload-time = "2026-09-30T04:38:02.509Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/e8/ee/008a2837737991474c5754bb3191010007663860979701990982a502cbaf/charset_normalizer-3.5.2-cp315-cp315t-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:124fbf1a8ff966d87ae05bb8bd45a71f966055ed8bba320d0c7cf450bc5f4d0e", size = 269986, upload-time = "2026-09-30T04:38:04.435Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/93/ad/bd74a283940dc910c5b14f8e4f80a248082bc9c0fcbe1f54530cb6d9cc5e/charset_normalizer-3.5.2-cp315-cp315t-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:28b4f0d66fb834ff90f28209ac7bce77868c45d8c93e26f906709d9b7c2e1af9", size = 260202, upload-time = "2026-09-30T04:38:06.549Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/8a/7b/ed341c66f69f688723501fac752be3d63c7159ca0d0d4174fc611e5710bb/charset_normalizer-3.5.2-cp315-cp315t-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:58ca3755ee7ff7f59b57789ec9833c9de9ea275405cdd240eda1f193112e398a", size = 259083, upload-time = "2026-09-30T04:38:08.311Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/cc/9d/e41588b777965e5031a43128a1e96173ebb35ac75fc53ec3b517e7c21cd4/charset_normalizer-3.5.2-cp315-cp315t-musllinux_1_2_aarch64.whl", hash = "sha256:443eae2bf318abeaf6f15d785138f71fd6de770e99a92158b8b814265e079115", size = 253081, upload-time = "2026-09-30T04:38:10.402Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/81/35/b761eb6d8c1eb218b9b42b9b4d5ac902afdc399fb6dac6f9a9aac7bda589/charset_normalizer-3.5.2-cp315-cp315t-musllinux_1_2_armv7l.whl", hash = "sha256:58f361dcbab699cf8f42db3f47c8e7fd1036f138c23a5d08de9fde5f425a730c", size = 248712, upload-time = "2026-09-30T04:38:12.317Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/4d/2c/147169a041b747759f37405c0a97157e8e92de967968373101ff14915cba/charset_normalizer-3.5.2-cp315-cp315t-musllinux_1_2_ppc64le.whl", hash = "sha256:1b4cbc7c3491ccb4aa17fcd8165649d01cf39f76de1696da8631b5f71b85401d", size = 274176, upload-time = "2026-09-30T04:38:14.138Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/f0/2d/0ff8db0d373ba8538db686db11cd7e8912031490b9e4f383b41912e8d594/charset_normalizer-3.5.2-cp315-cp315t-musllinux_1_2_riscv64.whl", hash = "sha256:ba0b1d2620edf869789c3879223f52bf2afc5d31b3cb47cc57b3a12c05e2aa9d", size = 259413, upload-time = "2026-09-30T04:38:15.841Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/8a/8e/b4a085fb47c9d3a7e43576a4784fdd8fe23f907514a972de8086edaf7a48/charset_normalizer-3.5.2-cp315-cp315t-musllinux_1_2_s390x.whl", hash = "sha256:5e2b6b57e9733d39f0c9fd3185efa6b8e29652c4cd8fe94180272cf6ed9a78c4", size = 269434, upload-time = "2026-09-30T04:38:17.626Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/83/1c/d8d8d7322a7c3eecdf3237a4a419cf41d2eaad8e006ce7dfdd9d4c8fa2eb/charset_normalizer-3.5.2-cp315-cp315t-musllinux_1_2_x86_64.whl", hash = "sha256:51cf45226a9b588d0d2b4880c62d686934b63ab0bd79ca23ab0e9762eb27441b", size = 262716, upload-time = "2026-09-30T04:38:19.214Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/a0/16/0e4c6ba9b44e97a2da150e52d331e8f9c968b21b358fbffa6c856cebcd89/charset_normalizer-3.5.2-cp315-cp315t-win32.whl", hash = "sha256:5fb29fb8cd1a46c27a1bf9613ad5ec2599310d46b4025d9556404a6b6a292800", size = 197159, upload-time = "2026-09-30T04:38:21.037Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/be/33/e90bc2b1374f7f36ef106f56620de5a783907e19ca857efe2277e31cac3e/charset_normalizer-3.5.2-cp315-cp315t-win_amd64.whl", hash = "sha256:a192e2c40070d92c3ccf777e3a5c4ff515573cd2bb7ed0c537fdadbbec5bbf21", size = 221322, upload-time = "2026-09-30T04:38:22.886Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/66/89/dfa6dcb08c200b7830ab56439e8c1890f2971d51aafbb3937894a2e7fcfc/charset_normalizer-3.5.2-cp315-cp315t-win_arm64.whl", hash = "sha256:749e97e1b32313717a565abbe321bc2190bc8b35f1a67e4cdbc7c56c8d8ffe58", size = 209192, upload-time = "2026-09-30T04:38:24.648Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/8c/ab/176fbfd5b64939c55d652366aa5b9ef1d767af207a3aa6ebeb0d226c484d/charset_normalizer-3.5.2-cp37-abi3-macosx_10_9_universal2.whl", hash = "sha256:4275811936e2f06feff5e598fb42a1b7ae852da8e39605211892b56b81a34efd", size = 331815, upload-time = "2026-09-30T04:38:26.216Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/7e/84/371eac6b30bdbcbf2d632a1a01809103459216fcaae61b8b8d922c1bfb8a/charset_normalizer-3.5.2-cp37-abi3-manylinux1_x86_64.manylinux_2_28_x86_64.manylinux_2_5_x86_64.whl", hash = "sha256:1c50fe28bbc2ced33386f298650d91218076c05420e6cbd790b913adc41659e7", size = 253276, upload-time = "2026-09-30T04:38:28.032Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/43/6f/c4fbae58febff71709c51bc7e18fdfa55341dc382704740f9f0cbf03817b/charset_normalizer-3.5.2-cp37-abi3-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:d19fbd981a488e22cd04883659ca6b08f50b5974f9fd7c95655ef6a043e5893f", size = 241239, upload-time = "2026-09-30T04:38:29.732Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/61/71/458c3f42164a07d0c5210798e9e704b39e540a6793b05aba67f3a35243a9/charset_normalizer-3.5.2-cp37-abi3-manylinux2014_armv7l.manylinux_2_17_armv7l.manylinux_2_31_armv7l.whl", hash = "sha256:0fed1d06615f022ee3b13caf5e8b180cfea32bb2c5aded8a9d44277afc040f93", size = 231121, upload-time = "2026-09-30T04:38:31.462Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/09/54/ab9e89367076f6331bb6c65c4bf14a5361fa5191cb6561bf534f18504e1b/charset_normalizer-3.5.2-cp37-abi3-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:838dcc90063569a0448120554591a1d6c4a4ffe11babf048908793154ab86ade", size = 260350, upload-time = "2026-09-30T04:38:33.239Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/7c/c1/061431ecc688d9d76602502cb57cc01e691e682c18f1beb45f9673b5bbd2/charset_normalizer-3.5.2-cp37-abi3-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:2ce45c6627b22c47e390bc91a41c3d13032192e699fa0bea96e9671b373d69b0", size = 255430, upload-time = "2026-09-30T04:38:34.865Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/8d/1f/20c8949f0676f7ab811abdeb7f4d7f1cbc6e61ff20bef08b44edeb092bc8/charset_normalizer-3.5.2-cp37-abi3-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:0774bf9bf620249fee3e0b8b9fd3065de213be30f3aa94ce2494b3b638949e26", size = 250612, upload-time = "2026-09-30T04:38:36.649Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/2b/9e/46f2fa4c431fc98c4ae76a8cb5bdca54e0341e3cfc3fcfd8e82740250818/charset_normalizer-3.5.2-cp37-abi3-musllinux_1_2_aarch64.whl", hash = "sha256:1db38f4c5496827c1a501846d64d14c3b80c7e6714e406cd7dc36a9899fa1011", size = 242083, upload-time = "2026-09-30T04:38:38.26Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/bd/39/559be29a0c0f086e0bba6922babd38916cc5e0b58ced4de13ee01ea05508/charset_normalizer-3.5.2-cp37-abi3-musllinux_1_2_armv7l.whl", hash = "sha256:304d8e4d493af723536393eee0c689eb7813f4a474c8b479dee63f1fdd98f621", size = 232738, upload-time = "2026-09-30T04:38:39.81Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/ff/6c/387b0e4f756a282831c1d9fc6aeb6c51ca4507ca202767c8de15ce9b12e2/charset_normalizer-3.5.2-cp37-abi3-musllinux_1_2_ppc64le.whl", hash = "sha256:9b7f416ff0978e2f2249330527f0ad6fa02f4932e6199692d3b52da2048c19e4", size = 260703, upload-time = "2026-09-30T04:38:41.346Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/96/92/1fdf015f09ef449f50d3ac4b67c90887c9c318b727daa95cc4f866e6521d/charset_normalizer-3.5.2-cp37-abi3-musllinux_1_2_riscv64.whl", hash = "sha256:01077390b03f7988f11d700a2194e69b119741a86b1a638b1db88891e3eced8e", size = 247622, upload-time = "2026-09-30T04:38:42.937Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/dc/3c/8e7b8a5671ad5d433669fb2a76f1a0164df2d9b1718b0206bc2a16d840cc/charset_normalizer-3.5.2-cp37-abi3-musllinux_1_2_s390x.whl", hash = "sha256:7e841fb9010836c992c9f12fcbd43a831de93a5f726fc1ccd8ca1d0268c5014c", size = 257500, upload-time = "2026-09-30T04:38:44.604Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/b4/f0/45b579df5cabc1d5d53ea1cc35e8437d3ca768c0acccc7041517cb6fbb32/charset_normalizer-3.5.2-cp37-abi3-musllinux_1_2_x86_64.whl", hash = "sha256:9cae88599c7219005d879f98e5ed53341e9a122af585e1091200358a3003d2a0", size = 255100, upload-time = "2026-09-30T04:38:46.289Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/31/68/fdec18a343f5fb3f310588dd478b09ac4799e0b187dbade3a8cd776f03ef/charset_normalizer-3.5.2-cp37-abi3-win32.whl", hash = "sha256:01b0c0d2262a9e28e8484a278c7e1b5d650e3ac8cf2683d2967e25899f208bdf", size = 174499, upload-time = "2026-09-30T04:38:47.999Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/9d/8a/b618149cc5207943a0242068d7a27897f56a62947b5a039085f2a22029f8/charset_normalizer-3.5.2-cp37-abi3-win_amd64.whl", hash = "sha256:9f56f72050826f63dcee7a7f55b0a77168cb3bfc553fd405e7f8f9ece75a4036", size = 200092, upload-time = "2026-09-30T04:38:49.707Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/03/cf/4c66866fa9e2b1c78e3c911516d1de497a677b7ac60f1eceda74ce777ca3/charset_normalizer-3.5.2-cp37-abi3-win_arm64.whl", hash = "sha256:40ab6bffa02ae10a0581e6c198be7d2d8ca5c2a0c64e4ed3465d766df457573e", size = 294363, upload-time = "2026-09-30T04:38:51.312Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/fc/ad/d07d7862a62ffa6d79d68074d14823243dd235a77c45262acbf6adeb28bf/charset_normalizer-3.5.2-py3-none-any.whl", hash = "sha256:b6b751274acb69d77b3323d6b7dbaa3c7fdfc1eb829b7eb61d262f32e1af9685", size = 68872, upload-time = "2026-09-30T04:39:21.828Z" },
|
||||||
|
]
|
||||||
|
|
||||||
|
[[package]]
|
||||||
|
name = "colorama"
|
||||||
|
version = "0.4.6"
|
||||||
|
source = { registry = "https://pypi.org/simple" }
|
||||||
|
sdist = { url = "https://files.pythonhosted.org/packages/d8/53/6f443c9a4a8358a93a6792e2acffb9d9d5cb0a5cfd8802644b7b1c9a02e4/colorama-0.4.6.tar.gz", hash = "sha256:08695f5cb7ed6e0531a20572697297273c47b8cae5a63ffc6d6ed5c201be6e44", size = 27697, upload-time = "2022-10-25T02:36:22.414Z" }
|
||||||
|
wheels = [
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/d1/d6/3965ed04c63042e047cb6a3e6ed1a63a35087b6a609aa3a15ed8ac56c221/colorama-0.4.6-py2.py3-none-any.whl", hash = "sha256:4f1d9991f5acc0ca119f9d443620b77f9d6b33703e51011c16baf57afb285fc6", size = 25335, upload-time = "2022-10-25T02:36:20.889Z" },
|
||||||
|
]
|
||||||
|
|
||||||
|
[[package]]
|
||||||
|
name = "coverage"
|
||||||
|
version = "7.17.3"
|
||||||
|
source = { registry = "https://pypi.org/simple" }
|
||||||
|
sdist = { url = "https://files.pythonhosted.org/packages/ed/8f/19651ed6f648de7e1383bb759207078e2ad8addeca711187e1cb3a495f14/coverage-7.17.3.tar.gz", hash = "sha256:6695d1bb2a9a2fbd7806d69d78cf30f35eb0f65045da0ec5b5045242fadd6a78", size = 1004507, upload-time = "2026-11-12T12:26:44.986Z" }
|
||||||
|
wheels = [
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/98/bd/86199a63e36d1ec253e128aa3df186933c7c5993945be114b9e5102b7c77/coverage-7.17.3-cp314-cp314-android_24_arm64_v8a.whl", hash = "sha256:6f8f925262bc0d6fea12d5dde6998aa57f162e05d5a7d50b95d400ab05bb4537", size = 229914, upload-time = "2026-11-12T12:25:10.352Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/d5/43/e0366c117f7cd88889674837e2146e9114d7c045fd7383c9f3c551f5b863/coverage-7.17.3-cp314-cp314-android_24_x86_64.whl", hash = "sha256:9e888603ea67c63ba264f39f3459f4cf68adc78dcd9f8bfa65dde601265a40f1", size = 230030, upload-time = "2026-11-12T12:25:11.794Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/a6/b6/1f7e3f29bb0700586d6709d533a0421ed96e1372b608facc6870c05b0489/coverage-7.17.3-cp314-cp314-ios_13_0_arm64_iphoneos.whl", hash = "sha256:fab6f713a1f2f0ab7fb7d55f3aea15d1f3fbd31ace61b585ecd87c8e34f898fb", size = 228215, upload-time = "2026-11-12T12:25:13.133Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/9e/cd/81261279e5a47a1295992e5d648fa30626af692c05b0767a037120953a17/coverage-7.17.3-cp314-cp314-ios_13_0_arm64_iphonesimulator.whl", hash = "sha256:4300ad360b21af19584c4cc82022979544d776ba2fb2df5418b2f3cae1eee6d2", size = 228518, upload-time = "2026-11-12T12:25:14.389Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/78/37/3a28b845dc06bcf17e0501fd641020760b61754444b904aa4973fd7c8098/coverage-7.17.3-cp314-cp314-macosx_10_15_x86_64.whl", hash = "sha256:e033255f24c1df6e046b6c4e9f91baacae08426beb5296bea8d46176b3a137d8", size = 228726, upload-time = "2026-11-12T12:25:15.693Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/79/dd/b770682a17e5e911e9c4db6af947641ed334dfd6155632f71fa54375f4a3/coverage-7.17.3-cp314-cp314-macosx_11_0_arm64.whl", hash = "sha256:22a80bbdee3c22fb3319befaa112a2ed2d6e1417aa75c310f048235170ceca44", size = 228894, upload-time = "2026-11-12T12:25:17.47Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/e9/e4/420e4d6f9ce1e6b8234bafad3508974950ec926063eb4d5e8d71c498b0a5/coverage-7.17.3-cp314-cp314-manylinux1_i686.manylinux_2_28_i686.manylinux_2_5_i686.whl", hash = "sha256:cfb1d2c52bb66e847669000658a5394d50aba835df8e31c2146034f978c8a4cf", size = 260939, upload-time = "2026-11-12T12:25:18.67Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/26/2c/c871c22a11981f58895e4dd167f4aa64c04853c5a0e91de853408c0f2d3e/coverage-7.17.3-cp314-cp314-manylinux1_x86_64.manylinux_2_28_x86_64.manylinux_2_5_x86_64.whl", hash = "sha256:eb25b51a30d07db8493901e3040284f2e756ec2b6549ee392798b9ef4c0607b3", size = 263872, upload-time = "2026-11-12T12:25:20Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/43/f3/f90e9619f2b0e1dc4d5f487163c3e9fd21629acfe3cd8abb97fa2afa12b2/coverage-7.17.3-cp314-cp314-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:2b9a39e25bf0e6fe072c6f3bceaa02f5303b9f975e83f590d118c4e92aacf6d8", size = 264877, upload-time = "2026-11-12T12:25:21.341Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/f3/8e/b45330abc908d11c65e68be5f240237ad433c8e03dcb99b474541f129e3e/coverage-7.17.3-cp314-cp314-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:9e331bc028b44496ad85d4a2656dbad0feb35baf4a66500042c4aaa878ea132c", size = 267361, upload-time = "2026-11-12T12:25:22.549Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/38/80/06eaca23adf2d3b1526fca9e6d3433b0b4aa91e653b59774ea9fc44e1c03/coverage-7.17.3-cp314-cp314-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:17a4bd9edd312744035e1298a6ac30dd7332a7f1ecdc63c9eb0685589b161eb1", size = 260674, upload-time = "2026-11-12T12:25:23.869Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/58/1b/cf0a2d4d5aaf87b6b9f7d5f0c2e5d110079e9c2a23e11c04f20c98e98689/coverage-7.17.3-cp314-cp314-musllinux_1_2_aarch64.whl", hash = "sha256:cc12f44ac4d5d6be301285c0a4f9c4ae52e673672e284b2a2744e20d24025573", size = 262658, upload-time = "2026-11-12T12:25:25.255Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/fb/23/ede764173d08bd9cefeeee344826c22e93d7111fd17b0677436616c98662/coverage-7.17.3-cp314-cp314-musllinux_1_2_i686.whl", hash = "sha256:0241e03dd65a1edf2e841eb19d8d72dca21ada5c869dcef6c9fde1b166d519a9", size = 260759, upload-time = "2026-11-12T12:25:26.949Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/e1/44/b93c258ecbe1848f2117f7466e8c3060554b419f6eabd3761ef95d095c4b/coverage-7.17.3-cp314-cp314-musllinux_1_2_ppc64le.whl", hash = "sha256:42a1f511a334745a66b8f580c4d561e728243e35f3ada0ada35444c4b2fb9fa9", size = 265227, upload-time = "2026-11-12T12:25:28.493Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/9f/fc/09a224782b0720b6a4c9e2fba0a479b87a2b046c523ffdd56339d2d8d516/coverage-7.17.3-cp314-cp314-musllinux_1_2_riscv64.whl", hash = "sha256:095ad10d17a28c845f2e5f99e398db2f0c680401731ff63a3a1789f2e61ef1e0", size = 260428, upload-time = "2026-11-12T12:25:29.799Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/1d/c9/3027a58b3db40ded4dc43a8040a45a91e61ebb9f32a4de86e30a29d8effb/coverage-7.17.3-cp314-cp314-musllinux_1_2_x86_64.whl", hash = "sha256:28b05f6b2622551805324196c32f3f20f4fa639bade8ac299ca83073253f6663", size = 262489, upload-time = "2026-11-12T12:25:31.127Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/69/a5/f9f767f731fd5a314e66fecd55d8ae320da95467feaf0f3742edf890049f/coverage-7.17.3-cp314-cp314-win32.whl", hash = "sha256:8b8188229ab3b3769a1c4aaa22357447555416deb440326c665a3bd25fd45ce0", size = 230582, upload-time = "2026-11-12T12:25:32.302Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/5b/1f/d377b98f63d876649083ce837f0e7cc2eefbfcb4088dc4a1428612ccd741/coverage-7.17.3-cp314-cp314-win_amd64.whl", hash = "sha256:957ba72e11d26b6e6e1abdaa72e41020871f4108c8ff64ff571fc50c81fb57a3", size = 231206, upload-time = "2026-11-12T12:25:33.558Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/89/2e/2c1607f6f1505fbed80910d95e51ce520945ad34a640c532123f75de5580/coverage-7.17.3-cp314-cp314-win_arm64.whl", hash = "sha256:f7ff8b21efcbdf9c7a6c051dc158c9bb9e938b7af33e55ed264d2e529b836d17", size = 231047, upload-time = "2026-11-12T12:25:34.908Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/11/79/428dc7fe065893833222ef604a261a5e16aa304be055ee99dff0fbb3bd66/coverage-7.17.3-cp314-cp314t-macosx_10_15_x86_64.whl", hash = "sha256:3f6d942e066ca009bd1f7ebf5450287a5e9bfc5a6e20a8d8c408a61b433c7f94", size = 229254, upload-time = "2026-11-12T12:25:36.209Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/fe/e8/60ce9cf304d2505cff1389a98e13bd67792f44bed530935bcce48db693f1/coverage-7.17.3-cp314-cp314t-macosx_11_0_arm64.whl", hash = "sha256:e3948b2e5c3af0133af3e117ee033e6cc656c43d7549d3296e4b3807908dec9f", size = 229584, upload-time = "2026-11-12T12:25:37.567Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/42/b3/f209433ec9dde9dd4e471afafd6b467b51653af4a678e39792638832c85e/coverage-7.17.3-cp314-cp314t-manylinux1_i686.manylinux_2_28_i686.manylinux_2_5_i686.whl", hash = "sha256:0bad8245a15bc7b15d26d25ece243bbf5d1b1229144f3db189014174429b63bb", size = 269701, upload-time = "2026-11-12T12:25:38.827Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/4a/0c/34a2caf1e74950efe9f24de673767ec67fe60470c900610e58fa639366f7/coverage-7.17.3-cp314-cp314t-manylinux1_x86_64.manylinux_2_28_x86_64.manylinux_2_5_x86_64.whl", hash = "sha256:bdf8fefb9f1acb3e92842fb42e29968d053e9545e4e9d9edb5c32a30fab8f899", size = 272171, upload-time = "2026-11-12T12:25:40.298Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/ac/1b/1e87f731b4e930cb636cc15bfb55855d52a1f31e9193d645e96ad7ebe0ab/coverage-7.17.3-cp314-cp314t-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:499acdc43bf1addf7fecc59a3123847bb96873c07001cfbeb709a71b181fa03d", size = 274823, upload-time = "2026-11-12T12:25:41.529Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/c8/1f/e6e2cfe9d4f4df4228587b7f528d8b9985005e9f904c2e59ce51d236dbd4/coverage-7.17.3-cp314-cp314t-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:11116ab42247d55980b51ab49b5c066de9b6baa56fe371fd555e54feae338619", size = 276333, upload-time = "2026-11-12T12:25:42.834Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/9e/1f/3937e3745b511d67228dcbf15f7f24cec9da7fdacee443ecf837465c1663/coverage-7.17.3-cp314-cp314t-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:56b469b63d8270aa67bc919ab8457f4d83115459556a76d09238052a3ab094db", size = 269560, upload-time = "2026-11-12T12:25:44.059Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/33/73/1b597ea0d77d062ed62d556e3a94c85fb7d3e56cac526d8a273f4e8872ea/coverage-7.17.3-cp314-cp314t-musllinux_1_2_aarch64.whl", hash = "sha256:95da285cf77352d4a527e1fd16c1c5c3762e42d1d71cfa9ef2c72a5c796cce36", size = 272118, upload-time = "2026-11-12T12:25:45.643Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/60/8a/1daee0aeb0a1d16884f5da92e2cf9300913bb216f42dff221329b3bd5651/coverage-7.17.3-cp314-cp314t-musllinux_1_2_i686.whl", hash = "sha256:c38a85dde92c4129641544aca998382f7448a87a17d202765a6adb8a87a33fc7", size = 269548, upload-time = "2026-11-12T12:25:47.043Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/40/d3/78fa95e9980917e2b75b97c056c3e70f9c9c9170fcde210897b4c0b35d03/coverage-7.17.3-cp314-cp314t-musllinux_1_2_ppc64le.whl", hash = "sha256:e9396d4d90fb47a1e124a985ac6a3172dbd58334d1de5189f06b75ae96ff69ee", size = 273964, upload-time = "2026-11-12T12:25:48.222Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/14/fa/2870663f070df38497ead9197a7e5af06f00286d5236192ea3d23bda68a1/coverage-7.17.3-cp314-cp314t-musllinux_1_2_riscv64.whl", hash = "sha256:e266c693c8bd6541f31cd71eda9b5aa3732adecbd04522880ea3d23d99b202eb", size = 269021, upload-time = "2026-11-12T12:25:49.548Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/30/fa/390e1199f21b4c2a8797492aa5351e8b74065fef609b717255cd88e54c5a/coverage-7.17.3-cp314-cp314t-musllinux_1_2_x86_64.whl", hash = "sha256:0837b71a40749d9c4016cf8c51ba8c6153f7dd40cf4dfa287a2f28376fa50917", size = 270929, upload-time = "2026-11-12T12:25:51.099Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/4e/e3/e29ec216a87330812142af2290224002b84804c5361eebe68c57e2ace5cd/coverage-7.17.3-cp314-cp314t-win32.whl", hash = "sha256:8a054b755bc6665b339a923fed14a54446c43c942bf4edf08a59b1225b284c93", size = 230892, upload-time = "2026-11-12T12:25:52.755Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/9c/e0/3854a8d843b31a317f251a0fc148c1980dde60f872fce30f6f037dc432e2/coverage-7.17.3-cp314-cp314t-win_amd64.whl", hash = "sha256:fa8903475085973b5c916e8a958afd22101b9559880ffbeab5aeac4196768338", size = 231750, upload-time = "2026-11-12T12:25:53.953Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/84/b7/748a7b92e7e7605532754e5718ef3109144ed7e58c0721d0d5c9fa9083a6/coverage-7.17.3-cp314-cp314t-win_arm64.whl", hash = "sha256:582c5d80b6de5b1909a4222ec1f5676bb2e03815c6be9ff43db2d8a71de5079c", size = 231381, upload-time = "2026-11-12T12:25:55.232Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/e3/44/8cb5635090ddf8674625f5067c0575ead89863664fff3cf73fb2f93c9287/coverage-7.17.3-cp315-cp315-android_24_arm64_v8a.whl", hash = "sha256:49a4f12eff115fc2447d3438b2c08d7e5adb3abc811c050ee508f8189718cc5d", size = 229920, upload-time = "2026-11-12T12:25:56.587Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/8a/54/b7ba20ab94696a790c2703ceb32f10b15f0a70dc2ae19178fd17d4915937/coverage-7.17.3-cp315-cp315-android_24_x86_64.whl", hash = "sha256:e04385647f444d55b483a0e4dc519f46134846eddd80910a0d0953ea19e58358", size = 230038, upload-time = "2026-11-12T12:25:57.842Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/ae/57/00c6e8a207674280408907cf4861e925c8e136770d333f5c9ee4dde5dc12/coverage-7.17.3-cp315-cp315-ios_13_0_arm64_iphoneos.whl", hash = "sha256:faee34ea548318f6f9010928edab2f91b36a19b58376e69ab0e76d4f3a0bf9df", size = 228239, upload-time = "2026-11-12T12:25:59.159Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/81/ab/b3f996c33524cef1d9bf80fe677619bf17282fefb9f3497da83fabea67cd/coverage-7.17.3-cp315-cp315-ios_13_0_arm64_iphonesimulator.whl", hash = "sha256:7c420ffa993c25cc74c263e9c1c869fbaea7d16dcb6448eef4fa6f1905560f5a", size = 228535, upload-time = "2026-11-12T12:26:00.402Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/32/ed/83f6e5ef0f7e39deb1d7915c2eb3c8946c002afba2f5f58ae05f870e3532/coverage-7.17.3-cp315-cp315-macosx_10_15_x86_64.whl", hash = "sha256:e592f790fee57e2bedaa27cdc76988a082090d1aac560ca4bbea80a7a58436ec", size = 228733, upload-time = "2026-11-12T12:26:01.649Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/d8/34/d256f50c5bf16255ae04aa917ba1857e127023dfd2c06499f777c7a4cd29/coverage-7.17.3-cp315-cp315-macosx_11_0_arm64.whl", hash = "sha256:59c15dcae783ed291da3af6be2e70762322637ac886b19671d12123521cf6ac3", size = 228929, upload-time = "2026-11-12T12:26:02.97Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/35/a4/31617273e938a7d9c7378335cb41e147bc6c293acac8ea643d74b3bc29e3/coverage-7.17.3-cp315-cp315-manylinux1_i686.manylinux_2_28_i686.manylinux_2_5_i686.whl", hash = "sha256:733368982d2799ff04d768916fb755e54d4ce11af3573488ece451745c90d4a7", size = 260825, upload-time = "2026-11-12T12:26:04.219Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/10/61/1bd79ec66957f4ea7ce5f687a18aa50f3b3e8715e4843f6ed3e5f03f24bf/coverage-7.17.3-cp315-cp315-manylinux1_x86_64.manylinux_2_28_x86_64.manylinux_2_5_x86_64.whl", hash = "sha256:a13a946d8de807d8992e56a09502952d81bfbb4b80204ef77a6a2a38b4ce22be", size = 264469, upload-time = "2026-11-12T12:26:05.491Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/e9/47/db887dff6eaf0a24396021ee4956eac563bd286677252e444f89a80e5166/coverage-7.17.3-cp315-cp315-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:c769e6a28bb645c915449ed8ddf6059765a72d8ef79590bfd6202022a4441cd3", size = 265623, upload-time = "2026-11-12T12:26:06.798Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/69/b9/e86863e2ac724844a07dbd165da6912d31c6a2cad99ab23b2c204e655bbc/coverage-7.17.3-cp315-cp315-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:bf7a43782b20951fe9ddc6f6c28da51c65d3c0d5d5fc3c5a0e566986aa3ec0aa", size = 267981, upload-time = "2026-11-12T12:26:08.051Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/72/d0/a3536c347bf036e3aa383c85db80a3ce5f2ca961f8500f46c25ac6a14c3c/coverage-7.17.3-cp315-cp315-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:b65db089de3f219c850f21a2ca915f43f6fa1da5bfb55871c089d3be82c10369", size = 261235, upload-time = "2026-11-12T12:26:09.392Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/7b/26/f7c1a5c62c66a4ceccb9889eb7fefaca6c34fc72f47553ffb134262533cb/coverage-7.17.3-cp315-cp315-musllinux_1_2_aarch64.whl", hash = "sha256:228f4bcecadcbb1ec3ed088b0595c5c08f3fca01406b72e8a02209a3af16aff9", size = 263461, upload-time = "2026-11-12T12:26:10.684Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/45/4f/51a9d4af3dac74e146d65e0b696a98eaad7badc3837e42fa386c8ef96c55/coverage-7.17.3-cp315-cp315-musllinux_1_2_i686.whl", hash = "sha256:3a5691ef42b16e22976ec0352a76a0f7c3b4196fe3d39805dcc765e31ce54f22", size = 261436, upload-time = "2026-11-12T12:26:12.421Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/e5/bb/6bcac633b71c1e675d9bc7ba97e9b28c32a3309db57185ce5af35176b1c7/coverage-7.17.3-cp315-cp315-musllinux_1_2_ppc64le.whl", hash = "sha256:2765261bdcb5f6c01af41d97ec4fcfe18acd1114d8d2690536a36f86b67c179f", size = 265926, upload-time = "2026-11-12T12:26:13.684Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/d4/6f/fc1007053178d2fbef0a89014a60e34a8b7a9e831d2f78301a55f0cbf644/coverage-7.17.3-cp315-cp315-musllinux_1_2_riscv64.whl", hash = "sha256:45268757a45946ab3fc9d2c30019aff2d3804ae660121d5b31f523366f604e67", size = 260770, upload-time = "2026-11-12T12:26:15.247Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/44/e4/90fee6c30eacfd84d6969223f823e4d14f02a07df9ad91e5de2b3fd6c466/coverage-7.17.3-cp315-cp315-musllinux_1_2_x86_64.whl", hash = "sha256:24389d7d50f1fe98ac8d8ec1c946656a75b97d953b51a714484e174ed9f48eb1", size = 263276, upload-time = "2026-11-12T12:26:16.551Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/3e/03/4108b8e1f428dd511a422510fce64aae0afa7b7350f73a55f6d6d5812d7e/coverage-7.17.3-cp315-cp315-win32.whl", hash = "sha256:ff0ca078fe63faffff1cff24c804afd4010e35d9c75bb593877b3d4321826c91", size = 230578, upload-time = "2026-11-12T12:26:17.793Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/95/46/e213941d820ab8e2ba788177569e781c50381bfd9ddb35d50f5f63d096cb/coverage-7.17.3-cp315-cp315-win_amd64.whl", hash = "sha256:f8f6252bb4c457d686c18e42965087b30155ff72b0dbda6e79a43ee3682c0870", size = 231196, upload-time = "2026-11-12T12:26:19.172Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/f7/4c/703768310ea21b513fdfd42d114447f0a335b763d70aacd54f8ecbc1e59a/coverage-7.17.3-cp315-cp315-win_arm64.whl", hash = "sha256:5559549a14f997b261c936ca463ed67e030511f914ffd1692ad08b3b16ed6034", size = 231046, upload-time = "2026-11-12T12:26:20.477Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/5b/4c/e27066a48746f622abc8ccf941917294bf46ee87077427d9a22aa98a74a3/coverage-7.17.3-cp315-cp315t-macosx_10_15_x86_64.whl", hash = "sha256:b6db3399e76a366353dd0c9a009fe74c3d1c892de35863331c4d06fbe0dd83b8", size = 229243, upload-time = "2026-11-12T12:26:22.109Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/38/29/129c10c8b1555ece4aaa9ad197769abda281bc204d7b055bf85681e12e15/coverage-7.17.3-cp315-cp315t-macosx_11_0_arm64.whl", hash = "sha256:47e49fced11190fdc678182b0e7f8947db4fc1c1216094923a1d2bbedba3c84a", size = 229600, upload-time = "2026-11-12T12:26:23.372Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/11/91/4cd15480a1d6bb7102dfd42c03197034aff1cb0f12b3791ed6e14872c2d6/coverage-7.17.3-cp315-cp315t-manylinux1_i686.manylinux_2_28_i686.manylinux_2_5_i686.whl", hash = "sha256:fb5945d7360fb258dee758258d93ea624a712fae494e7a0037a92505b3eb8b32", size = 270046, upload-time = "2026-11-12T12:26:24.615Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/1e/b0/b7db33135f973cba720c20d8055c26177217cd07c4e903fc24a71715be0e/coverage-7.17.3-cp315-cp315t-manylinux1_x86_64.manylinux_2_28_x86_64.manylinux_2_5_x86_64.whl", hash = "sha256:47cd7674a39bad6480e565e2a5b77f8089ebfbcd3aacc572abc6cebabe1f4cc9", size = 272815, upload-time = "2026-11-12T12:26:25.864Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/a1/ea/207ab861d69f4008d90d193ab5e9d5721ea2a75ec4a1e826720519142795/coverage-7.17.3-cp315-cp315t-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:ff5069e99039739c2fade5dd12cf8df7dc1b1217a0b915110605e0bbdddf1187", size = 275531, upload-time = "2026-11-12T12:26:27.096Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/a9/6e/d5144a94a9758d25f3d9143b86a0ab04feded2a30d8c9365c646d504aea9/coverage-7.17.3-cp315-cp315t-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:b7028eabf24ad18646dbfc6b352cece01779914e69254ddcacdfb9f805d89f61", size = 276906, upload-time = "2026-11-12T12:26:28.311Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/e7/b4/8328eaa253b44b081e25236abb4717f7afd37ecae02cc6ca77d853efdde9/coverage-7.17.3-cp315-cp315t-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:349ab42e0b6b72892f187a60a0890b3a76710e93b7c31579e81648d46230a8ed", size = 270557, upload-time = "2026-11-12T12:26:29.969Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/6b/bd/22effefa744acb7cac84addd7d619538c7604fe7d7b6fe3b989ad6f60fed/coverage-7.17.3-cp315-cp315t-musllinux_1_2_aarch64.whl", hash = "sha256:397e5342fd4f19ae930a5234643a63a8eaccc18a2f034a2f1765a5313123489d", size = 273009, upload-time = "2026-11-12T12:26:31.591Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/a0/b6/5e1a93260f8524832bd5781108dc38497d7930bb451014350ce61b22f848/coverage-7.17.3-cp315-cp315t-musllinux_1_2_i686.whl", hash = "sha256:8009572d242674765b84ecceba126c2392b1824b32f41db1f3323d23d4cb598f", size = 270006, upload-time = "2026-11-12T12:26:32.85Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/25/35/e7ccdc8675afd66c4c9310e883c255dec3277fdff65c640ec0ac531b1f9e/coverage-7.17.3-cp315-cp315t-musllinux_1_2_ppc64le.whl", hash = "sha256:dc116b251f7a4ae0266dba0ef31a742c6c517d3a99b4d50016548a17d407ac5f", size = 274755, upload-time = "2026-11-12T12:26:34.058Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/1e/a3/d8c76a38363e59654516041471cdc5b325fa22835a87d5213e20553454fb/coverage-7.17.3-cp315-cp315t-musllinux_1_2_riscv64.whl", hash = "sha256:b73148d024d086239fc04c03daaeb1934a6d295312dd0d6a04a937326c1207d4", size = 270158, upload-time = "2026-11-12T12:26:35.772Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/0f/e9/cf0fded465f8d9a238d6b4fa4908a84f08ae483b3d4adddbd9668dc09ab0/coverage-7.17.3-cp315-cp315t-musllinux_1_2_x86_64.whl", hash = "sha256:7f02996b09190bcdee3b2af38bf2279e4a1a65306afd3e6c229029dbe41e42ea", size = 271819, upload-time = "2026-11-12T12:26:37.046Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/ac/24/fcde10f418dec10e647c1d697f5fee500605adae2a0105fe772ed6dfff17/coverage-7.17.3-cp315-cp315t-win32.whl", hash = "sha256:80e219a51ef7ccf78fcd584257e523ece0d390cb3d9d3896660eac05a19ac691", size = 230874, upload-time = "2026-11-12T12:26:38.293Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/80/bf/095490c7d43ba2e38eb0c4af31a37beb1f2347c4765613e39f8587c5f00a/coverage-7.17.3-cp315-cp315t-win_amd64.whl", hash = "sha256:86563b5323fc13239d943b22a1bb9ec60f9ca17bd9a0be09c40a89836697aea2", size = 231735, upload-time = "2026-11-12T12:26:40.717Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/1e/f8/21db698c4785e3604755415aaeaa49bf00220c210f09c06dd185fce6f986/coverage-7.17.3-cp315-cp315t-win_arm64.whl", hash = "sha256:f8356475aba020621f8277f1a81c2dbdbda8286c7c6130f242c9816e044062a9", size = 231374, upload-time = "2026-11-12T12:26:42.14Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/d1/8e/f7d7e69e2ad34ce08595b787eb578f669c00fd57d432ed4c7cfd71666f36/coverage-7.17.3-py3-none-any.whl", hash = "sha256:21745c08f2835b847a16887b748d3084dddeb0571ae2a0d62e33644413568b99", size = 219999, upload-time = "2026-11-12T12:26:43.553Z" },
|
||||||
|
]
|
||||||
|
|
||||||
|
[[package]]
|
||||||
|
name = "crdt-sync"
|
||||||
|
version = "0.11.1"
|
||||||
|
source = { git = "https://github.com/kuhyx/utils?subdirectory=crdt-sync&rev=crdt-sync-v0.11.1#317448062419e3faf48aee8a50452c5572d244f9" }
|
||||||
|
dependencies = [
|
||||||
|
{ name = "argon2-cffi" },
|
||||||
|
{ name = "pynacl" },
|
||||||
|
{ name = "requests" },
|
||||||
|
]
|
||||||
|
|
||||||
|
[[package]]
|
||||||
|
name = "idna"
|
||||||
|
version = "3.20"
|
||||||
|
source = { registry = "https://pypi.org/simple" }
|
||||||
|
sdist = { url = "https://files.pythonhosted.org/packages/f5/08/8eea9d4b8302028f3abb2c0813953f7aec26d33b7a8960ed760e65ff29fa/idna-3.20.tar.gz", hash = "sha256:a7db850025b95ded1eae8a46181a1a6c56c92c96f0e2b005d9ff8dc0210cab44", size = 216463, upload-time = "2026-09-17T14:11:04.752Z" }
|
||||||
|
wheels = [
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/58/a2/bb081bab032533a855d44de1d56f8e8426114ff1ba5d1f07a438a0a654f8/idna-3.20-py3-none-any.whl", hash = "sha256:ab7ae7122974553370f0bdb919e1a960b2cd1bc1ef0276416d896db81c14582c", size = 69583, upload-time = "2026-09-17T14:11:03.168Z" },
|
||||||
|
]
|
||||||
|
|
||||||
|
[[package]]
|
||||||
|
name = "iniconfig"
|
||||||
|
version = "2.3.1"
|
||||||
|
source = { registry = "https://pypi.org/simple" }
|
||||||
|
sdist = { url = "https://files.pythonhosted.org/packages/01/e1/2069291243c926a2ff1cd706c7f3eeb9b62144bf60f77c9fb9ff2fb26bd3/iniconfig-2.3.1.tar.gz", hash = "sha256:67f4b9c50da0dedf52af349e7749a80a9057a5031199791b906c3bb3ae878960", size = 21209, upload-time = "2026-10-06T22:48:38.076Z" }
|
||||||
|
wheels = [
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/56/43/4ca9e49d27a1fcf6bece6f6aec0ea46bb9112489b93d4b688fb415457bdb/iniconfig-2.3.1-py3-none-any.whl", hash = "sha256:9121e2c1fdb355232495be3194c8dfe87ccc2d5dee45947b78e68f499790d7a7", size = 7552, upload-time = "2026-10-06T22:48:36.959Z" },
|
||||||
|
]
|
||||||
|
|
||||||
|
[[package]]
|
||||||
|
name = "jsonschema"
|
||||||
|
version = "4.26.0"
|
||||||
|
source = { registry = "https://pypi.org/simple" }
|
||||||
|
dependencies = [
|
||||||
|
{ name = "attrs" },
|
||||||
|
{ name = "jsonschema-specifications" },
|
||||||
|
{ name = "referencing" },
|
||||||
|
{ name = "rpds-py" },
|
||||||
|
]
|
||||||
|
sdist = { url = "https://files.pythonhosted.org/packages/b3/fc/e067678238fa451312d4c62bf6e6cf5ec56375422aee02f9cb5f909b3047/jsonschema-4.26.0.tar.gz", hash = "sha256:0c26707e2efad8aa1bfc5b7ce170f3fccc2e4918ff85989ba9ffa9facb2be326", size = 366583, upload-time = "2026-01-07T13:41:07.246Z" }
|
||||||
|
wheels = [
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/69/90/f63fb5873511e014207a475e2bb4e8b2e570d655b00ac19a9a0ca0a385ee/jsonschema-4.26.0-py3-none-any.whl", hash = "sha256:d489f15263b8d200f8387e64b4c3a75f06629559fb73deb8fdfb525f2dab50ce", size = 90630, upload-time = "2026-01-07T13:41:05.306Z" },
|
||||||
|
]
|
||||||
|
|
||||||
|
[[package]]
|
||||||
|
name = "jsonschema-specifications"
|
||||||
|
version = "2025.9.1"
|
||||||
|
source = { registry = "https://pypi.org/simple" }
|
||||||
|
dependencies = [
|
||||||
|
{ name = "referencing" },
|
||||||
|
]
|
||||||
|
sdist = { url = "https://files.pythonhosted.org/packages/19/74/a633ee74eb36c44aa6d1095e7cc5569bebf04342ee146178e2d36600708b/jsonschema_specifications-2025.9.1.tar.gz", hash = "sha256:b540987f239e745613c7a9176f3edb72b832a4ac465cf02712288397832b5e8d", size = 32855, upload-time = "2025-09-08T01:34:59.186Z" }
|
||||||
|
wheels = [
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/41/45/1a4ed80516f02155c51f51e8cedb3c1902296743db0bbc66608a0db2814f/jsonschema_specifications-2025.9.1-py3-none-any.whl", hash = "sha256:98802fee3a11ee76ecaca44429fda8a41bff98b00a0f2838151b113f210cc6fe", size = 18437, upload-time = "2025-09-08T01:34:57.871Z" },
|
||||||
|
]
|
||||||
|
|
||||||
|
[[package]]
|
||||||
|
name = "packaging"
|
||||||
|
version = "26.3"
|
||||||
|
source = { registry = "https://pypi.org/simple" }
|
||||||
|
sdist = { url = "https://files.pythonhosted.org/packages/7d/fa/3944b40b07da9ce895c0e6303a5ab7d53da063554f534556b134a54d6093/packaging-26.3.tar.gz", hash = "sha256:94edc256424af38762eb31306eed28beb9f0efc50a8837492c9d6fd6004aed79", size = 313412, upload-time = "2026-08-04T18:15:28.737Z" }
|
||||||
|
wheels = [
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/63/34/ba1c580383c9eada3711951fef0795c80b829a078d72188184bcab9dd527/packaging-26.3-py3-none-any.whl", hash = "sha256:d7193f7c8e4e93f444fde0262bf90af30e16fa0ad0ad44cb553c87339b23cd1c", size = 129956, upload-time = "2026-08-04T18:15:27.159Z" },
|
||||||
|
]
|
||||||
|
|
||||||
|
[[package]]
|
||||||
|
name = "pluggy"
|
||||||
|
version = "1.7.0"
|
||||||
|
source = { registry = "https://pypi.org/simple" }
|
||||||
|
sdist = { url = "https://files.pythonhosted.org/packages/bf/db/7fc19e6f2dc92a966727031389fc2e08b558f0f25eb7403c1119ad4713cd/pluggy-1.7.0.tar.gz", hash = "sha256:d1eaa46ebb595891b860ab086b4d09c8588af65ebd4361b8e8f4bb8920b90ba8", size = 123304, upload-time = "2026-10-15T09:50:58.343Z" }
|
||||||
|
wheels = [
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/40/9e/2b38731e0fc536806f16490e1a12d7f0dc2a1235aa8cc07bcc75416a7daa/pluggy-1.7.0-py3-none-any.whl", hash = "sha256:7dd7b0d8832ba3cb632c306926ded123429211b83641b35dc5c41ad2d34f9bec", size = 27082, upload-time = "2026-10-15T09:50:56.808Z" },
|
||||||
|
]
|
||||||
|
|
||||||
|
[[package]]
|
||||||
|
name = "pycparser"
|
||||||
|
version = "3.12"
|
||||||
|
source = { registry = "https://pypi.org/simple" }
|
||||||
|
sdist = { url = "https://files.pythonhosted.org/packages/cb/27/eeb9f307bf07060f3d9f9aa0fb8c15b01bdfded0a941e4b2719c7f94cacd/pycparser-3.12.tar.gz", hash = "sha256:f03387877eab82ce01bbdfd0ba7252ee55a90b1c708d5129e2ce915475cf1db6", size = 158785, upload-time = "2026-10-22T13:40:03.56Z" }
|
||||||
|
wheels = [
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/b6/ae/315bbeee126a769cbde43cf4908acb4b40408d8bf8bbf334dd7368d8dadf/pycparser-3.12-py3-none-any.whl", hash = "sha256:a076f3f489b39b43ed13563a1dafe42447445bec2e294154ec5c57fcdda4c85e", size = 62600, upload-time = "2026-10-22T13:40:02.021Z" },
|
||||||
|
]
|
||||||
|
|
||||||
|
[[package]]
|
||||||
|
name = "pygments"
|
||||||
|
version = "2.21.0"
|
||||||
|
source = { registry = "https://pypi.org/simple" }
|
||||||
|
sdist = { url = "https://files.pythonhosted.org/packages/49/2e/ced460408999b33da6b31b0021b0f37d329e202d4169aeb164493778f25b/pygments-2.21.0.tar.gz", hash = "sha256:610ca751c9bc2492b38eb9a38a7fbc93edbbb2d7182edaf34e66ae493dee5c8c", size = 5005329, upload-time = "2026-08-17T08:02:48.824Z" }
|
||||||
|
wheels = [
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/71/46/17f022dd3e953bf20a04a028a21ec746d942f8d2af30fa0f124fa0e6a684/pygments-2.21.0-py3-none-any.whl", hash = "sha256:2363c69b61c4a97c838da3b130dcd6468f4848992b21a82f2a63ec34377137d9", size = 1250147, upload-time = "2026-08-17T08:02:44.912Z" },
|
||||||
|
]
|
||||||
|
|
||||||
|
[[package]]
|
||||||
|
name = "pynacl"
|
||||||
|
version = "1.6.2"
|
||||||
|
source = { registry = "https://pypi.org/simple" }
|
||||||
|
dependencies = [
|
||||||
|
{ name = "cffi", marker = "platform_python_implementation != 'PyPy'" },
|
||||||
|
]
|
||||||
|
sdist = { url = "https://files.pythonhosted.org/packages/d9/9a/4019b524b03a13438637b11538c82781a5eda427394380381af8f04f467a/pynacl-1.6.2.tar.gz", hash = "sha256:018494d6d696ae03c7e656e5e74cdfd8ea1326962cc401bcf018f1ed8436811c", size = 3511692, upload-time = "2026-01-01T17:48:10.851Z" }
|
||||||
|
wheels = [
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/4b/79/0e3c34dc3c4671f67d251c07aa8eb100916f250ee470df230b0ab89551b4/pynacl-1.6.2-cp314-cp314t-macosx_10_10_universal2.whl", hash = "sha256:622d7b07cc5c02c666795792931b50c91f3ce3c2649762efb1ef0d5684c81594", size = 390064, upload-time = "2026-01-01T17:31:57.264Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/eb/1c/23a26e931736e13b16483795c8a6b2f641bf6a3d5238c22b070a5112722c/pynacl-1.6.2-cp314-cp314t-manylinux2014_aarch64.manylinux_2_17_aarch64.whl", hash = "sha256:d071c6a9a4c94d79eb665db4ce5cedc537faf74f2355e4d502591d850d3913c0", size = 809370, upload-time = "2026-01-01T17:31:59.198Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/87/74/8d4b718f8a22aea9e8dcc8b95deb76d4aae380e2f5b570cc70b5fd0a852d/pynacl-1.6.2-cp314-cp314t-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:fe9847ca47d287af41e82be1dd5e23023d3c31a951da134121ab02e42ac218c9", size = 1408304, upload-time = "2026-01-01T17:32:01.162Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/fd/73/be4fdd3a6a87fe8a4553380c2b47fbd1f7f58292eb820902f5c8ac7de7b0/pynacl-1.6.2-cp314-cp314t-manylinux_2_26_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:04316d1fc625d860b6c162fff704eb8426b1a8bcd3abacea11142cbd99a6b574", size = 844871, upload-time = "2026-01-01T17:32:02.824Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/55/ad/6efc57ab75ee4422e96b5f2697d51bbcf6cdcc091e66310df91fbdc144a8/pynacl-1.6.2-cp314-cp314t-manylinux_2_26_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:44081faff368d6c5553ccf55322ef2819abb40e25afaec7e740f159f74813634", size = 1446356, upload-time = "2026-01-01T17:32:04.452Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/78/b7/928ee9c4779caa0a915844311ab9fb5f99585621c5d6e4574538a17dca07/pynacl-1.6.2-cp314-cp314t-manylinux_2_34_aarch64.whl", hash = "sha256:a9f9932d8d2811ce1a8ffa79dcbdf3970e7355b5c8eb0c1a881a57e7f7d96e88", size = 826814, upload-time = "2026-01-01T17:32:06.078Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/f7/a9/1bdba746a2be20f8809fee75c10e3159d75864ef69c6b0dd168fc60e485d/pynacl-1.6.2-cp314-cp314t-manylinux_2_34_x86_64.whl", hash = "sha256:bc4a36b28dd72fb4845e5d8f9760610588a96d5a51f01d84d8c6ff9849968c14", size = 1411742, upload-time = "2026-01-01T17:32:07.651Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/f3/2f/5e7ea8d85f9f3ea5b6b87db1d8388daa3587eed181bdeb0306816fdbbe79/pynacl-1.6.2-cp314-cp314t-musllinux_1_2_aarch64.whl", hash = "sha256:3bffb6d0f6becacb6526f8f42adfb5efb26337056ee0831fb9a7044d1a964444", size = 801714, upload-time = "2026-01-01T17:32:09.558Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/06/ea/43fe2f7eab5f200e40fb10d305bf6f87ea31b3bbc83443eac37cd34a9e1e/pynacl-1.6.2-cp314-cp314t-musllinux_1_2_x86_64.whl", hash = "sha256:2fef529ef3ee487ad8113d287a593fa26f48ee3620d92ecc6f1d09ea38e0709b", size = 1372257, upload-time = "2026-01-01T17:32:11.026Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/4d/54/c9ea116412788629b1347e415f72195c25eb2f3809b2d3e7b25f5c79f13a/pynacl-1.6.2-cp314-cp314t-win32.whl", hash = "sha256:a84bf1c20339d06dc0c85d9aea9637a24f718f375d861b2668b2f9f96fa51145", size = 231319, upload-time = "2026-01-01T17:32:12.46Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/ce/04/64e9d76646abac2dccf904fccba352a86e7d172647557f35b9fe2a5ee4a1/pynacl-1.6.2-cp314-cp314t-win_amd64.whl", hash = "sha256:320ef68a41c87547c91a8b58903c9caa641ab01e8512ce291085b5fe2fcb7590", size = 244044, upload-time = "2026-01-01T17:32:13.781Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/33/33/7873dc161c6a06f43cda13dec67b6fe152cb2f982581151956fa5e5cdb47/pynacl-1.6.2-cp314-cp314t-win_arm64.whl", hash = "sha256:d29bfe37e20e015a7d8b23cfc8bd6aa7909c92a1b8f41ee416bbb3e79ef182b2", size = 188740, upload-time = "2026-01-01T17:32:15.083Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/be/7b/4845bbf88e94586ec47a432da4e9107e3fc3ce37eb412b1398630a37f7dd/pynacl-1.6.2-cp38-abi3-macosx_10_10_universal2.whl", hash = "sha256:c949ea47e4206af7c8f604b8278093b674f7c79ed0d4719cc836902bf4517465", size = 388458, upload-time = "2026-01-01T17:32:16.829Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/1e/b4/e927e0653ba63b02a4ca5b4d852a8d1d678afbf69b3dbf9c4d0785ac905c/pynacl-1.6.2-cp38-abi3-manylinux2014_aarch64.manylinux_2_17_aarch64.whl", hash = "sha256:8845c0631c0be43abdd865511c41eab235e0be69c81dc66a50911594198679b0", size = 800020, upload-time = "2026-01-01T17:32:18.34Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/7f/81/d60984052df5c97b1d24365bc1e30024379b42c4edcd79d2436b1b9806f2/pynacl-1.6.2-cp38-abi3-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:22de65bb9010a725b0dac248f353bb072969c94fa8d6b1f34b87d7953cf7bbe4", size = 1399174, upload-time = "2026-01-01T17:32:20.239Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/68/f7/322f2f9915c4ef27d140101dd0ed26b479f7e6f5f183590fd32dfc48c4d3/pynacl-1.6.2-cp38-abi3-manylinux_2_26_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:46065496ab748469cdd999246d17e301b2c24ae2fdf739132e580a0e94c94a87", size = 835085, upload-time = "2026-01-01T17:32:22.24Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/3e/d0/f301f83ac8dbe53442c5a43f6a39016f94f754d7a9815a875b65e218a307/pynacl-1.6.2-cp38-abi3-manylinux_2_26_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:8a66d6fb6ae7661c58995f9c6435bda2b1e68b54b598a6a10247bfcdadac996c", size = 1437614, upload-time = "2026-01-01T17:32:23.766Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/c4/58/fc6e649762b029315325ace1a8c6be66125e42f67416d3dbd47b69563d61/pynacl-1.6.2-cp38-abi3-manylinux_2_34_aarch64.whl", hash = "sha256:26bfcd00dcf2cf160f122186af731ae30ab120c18e8375684ec2670dccd28130", size = 818251, upload-time = "2026-01-01T17:32:25.69Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/c9/a8/b917096b1accc9acd878819a49d3d84875731a41eb665f6ebc826b1af99e/pynacl-1.6.2-cp38-abi3-manylinux_2_34_x86_64.whl", hash = "sha256:c8a231e36ec2cab018c4ad4358c386e36eede0319a0c41fed24f840b1dac59f6", size = 1402859, upload-time = "2026-01-01T17:32:27.215Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/85/42/fe60b5f4473e12c72f977548e4028156f4d340b884c635ec6b063fe7e9a5/pynacl-1.6.2-cp38-abi3-musllinux_1_2_aarch64.whl", hash = "sha256:68be3a09455743ff9505491220b64440ced8973fe930f270c8e07ccfa25b1f9e", size = 791926, upload-time = "2026-01-01T17:32:29.314Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/fa/f9/e40e318c604259301cc091a2a63f237d9e7b424c4851cafaea4ea7c4834e/pynacl-1.6.2-cp38-abi3-musllinux_1_2_x86_64.whl", hash = "sha256:8b097553b380236d51ed11356c953bf8ce36a29a3e596e934ecabe76c985a577", size = 1363101, upload-time = "2026-01-01T17:32:31.263Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/48/47/e761c254f410c023a469284a9bc210933e18588ca87706ae93002c05114c/pynacl-1.6.2-cp38-abi3-win32.whl", hash = "sha256:5811c72b473b2f38f7e2a3dc4f8642e3a3e9b5e7317266e4ced1fba85cae41aa", size = 227421, upload-time = "2026-01-01T17:32:33.076Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/41/ad/334600e8cacc7d86587fe5f565480fde569dfb487389c8e1be56ac21d8ac/pynacl-1.6.2-cp38-abi3-win_amd64.whl", hash = "sha256:62985f233210dee6548c223301b6c25440852e13d59a8b81490203c3227c5ba0", size = 239754, upload-time = "2026-01-01T17:32:34.557Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/29/7d/5945b5af29534641820d3bd7b00962abbbdfee84ec7e19f0d5b3175f9a31/pynacl-1.6.2-cp38-abi3-win_arm64.whl", hash = "sha256:834a43af110f743a754448463e8fd61259cd4ab5bbedcf70f9dabad1d28a394c", size = 184801, upload-time = "2026-01-01T17:32:36.309Z" },
|
||||||
|
]
|
||||||
|
|
||||||
|
[[package]]
|
||||||
|
name = "pytest"
|
||||||
|
version = "9.2.0"
|
||||||
|
source = { registry = "https://pypi.org/simple" }
|
||||||
|
dependencies = [
|
||||||
|
{ name = "colorama", marker = "sys_platform == 'win32'" },
|
||||||
|
{ name = "iniconfig" },
|
||||||
|
{ name = "packaging" },
|
||||||
|
{ name = "pluggy" },
|
||||||
|
{ name = "pygments" },
|
||||||
|
]
|
||||||
|
sdist = { url = "https://files.pythonhosted.org/packages/79/42/bb4641652e58dedeac2ec51abc1f8cae4fee4ec63899a0999016229a0f2a/pytest-9.2.0.tar.gz", hash = "sha256:97c4f3b1f3c7414aa36465e09b8220f1d03627993bd51b1282e193753c80557b", size = 1797555, upload-time = "2026-10-27T21:30:20.728Z" }
|
||||||
|
wheels = [
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/51/39/1f5d8c8877a0fa327db959c19341d4be61660de1ab6b7391f9eb805bcd67/pytest-9.2.0-py3-none-any.whl", hash = "sha256:07acdcf88ec174f907dc01af70bf52d49b014bbab03faeeade31c96b18c2e588", size = 411776, upload-time = "2026-10-27T21:30:19.131Z" },
|
||||||
|
]
|
||||||
|
|
||||||
|
[[package]]
|
||||||
|
name = "pytest-cov"
|
||||||
|
version = "7.1.0"
|
||||||
|
source = { registry = "https://pypi.org/simple" }
|
||||||
|
dependencies = [
|
||||||
|
{ name = "coverage" },
|
||||||
|
{ name = "pluggy" },
|
||||||
|
{ name = "pytest" },
|
||||||
|
]
|
||||||
|
sdist = { url = "https://files.pythonhosted.org/packages/b1/51/a849f96e117386044471c8ec2bd6cfebacda285da9525c9106aeb28da671/pytest_cov-7.1.0.tar.gz", hash = "sha256:30674f2b5f6351aa09702a9c8c364f6a01c27aae0c1366ae8016160d1efc56b2", size = 55592, upload-time = "2026-03-21T20:11:16.284Z" }
|
||||||
|
wheels = [
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/9d/7a/d968e294073affff457b041c2be9868a40c1c71f4a35fcc1e45e5493067b/pytest_cov-7.1.0-py3-none-any.whl", hash = "sha256:a0461110b7865f9a271aa1b51e516c9a95de9d696734a2f71e3e78f46e1d4678", size = 22876, upload-time = "2026-03-21T20:11:14.438Z" },
|
||||||
|
]
|
||||||
|
|
||||||
|
[[package]]
|
||||||
|
name = "referencing"
|
||||||
|
version = "0.37.0"
|
||||||
|
source = { registry = "https://pypi.org/simple" }
|
||||||
|
dependencies = [
|
||||||
|
{ name = "attrs" },
|
||||||
|
{ name = "rpds-py" },
|
||||||
|
]
|
||||||
|
sdist = { url = "https://files.pythonhosted.org/packages/22/f5/df4e9027acead3ecc63e50fe1e36aca1523e1719559c499951bb4b53188f/referencing-0.37.0.tar.gz", hash = "sha256:44aefc3142c5b842538163acb373e24cce6632bd54bdb01b21ad5863489f50d8", size = 78036, upload-time = "2025-10-13T15:30:48.871Z" }
|
||||||
|
wheels = [
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/2c/58/ca301544e1fa93ed4f80d724bf5b194f6e4b945841c5bfd555878eea9fcb/referencing-0.37.0-py3-none-any.whl", hash = "sha256:381329a9f99628c9069361716891d34ad94af76e461dcb0335825aecc7692231", size = 26766, upload-time = "2025-10-13T15:30:47.625Z" },
|
||||||
|
]
|
||||||
|
|
||||||
|
[[package]]
|
||||||
|
name = "requests"
|
||||||
|
version = "2.34.2"
|
||||||
|
source = { registry = "https://pypi.org/simple" }
|
||||||
|
dependencies = [
|
||||||
|
{ name = "certifi" },
|
||||||
|
{ name = "charset-normalizer" },
|
||||||
|
{ name = "idna" },
|
||||||
|
{ name = "urllib3" },
|
||||||
|
]
|
||||||
|
sdist = { url = "https://files.pythonhosted.org/packages/ac/c3/e2a2b89f2d3e2179abd6d00ebd70bff6273f37fb3e0cc209f48b39d00cbf/requests-2.34.2.tar.gz", hash = "sha256:f288924cae4e29463698d6d60bc6a4da69c89185ad1e0bcc4104f584e960b9ed", size = 142856, upload-time = "2026-05-14T19:25:27.735Z" }
|
||||||
|
wheels = [
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/a0/f4/c67b0b3f1b9245e8d266f0f112c500d50e5b4e83cb6f3b71b6528104182a/requests-2.34.2-py3-none-any.whl", hash = "sha256:2a0d60c172f83ac6ab31e4554906c0f3b3588d37b5cb939b1c061f4907e278e0", size = 73075, upload-time = "2026-05-14T19:25:26.443Z" },
|
||||||
|
]
|
||||||
|
|
||||||
|
[[package]]
|
||||||
|
name = "rpds-py"
|
||||||
|
version = "2026.9.1"
|
||||||
|
source = { registry = "https://pypi.org/simple" }
|
||||||
|
sdist = { url = "https://files.pythonhosted.org/packages/42/68/3bd46b8a5e01d3c2ebdf9c5e9497912e3fe0cde02bac21a7130ca866e403/rpds_py-2026.9.1.tar.gz", hash = "sha256:4793ef7f78268b124b73fa933440f01d258bbae01de9fa53e9080c9ab0425a12", size = 63948, upload-time = "2026-10-04T16:32:36.469Z" }
|
||||||
|
wheels = [
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/8a/f2/67b94be1532767803415c1c5a1fd88ea487643d74a673cec1ba140af77bb/rpds_py-2026.9.1-cp314-cp314-macosx_10_12_x86_64.whl", hash = "sha256:c9d1aca01f49170fdcf5c92761b1fafe97f554b721ca4570c5949fff778f0d4b", size = 347178, upload-time = "2026-10-04T16:30:00.865Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/04/37/b751de2b59b0197a1d92a5dd491de88e8a5e928c2e6562581974f1e85263/rpds_py-2026.9.1-cp314-cp314-macosx_11_0_arm64.whl", hash = "sha256:3f0e9ac28fc067d4d34b88ae43c48e9489455c97fee9633d851f7eeed5a05d35", size = 341878, upload-time = "2026-10-04T16:30:02.564Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/72/e2/5873bc4643c250db9e05d48dc0c93763d4aa68bc3b81164cb1af3b45b284/rpds_py-2026.9.1-cp314-cp314-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:07deecbfce94c78473018bc7d10b337cc651d12df87a1eb2cb3e4024bc9c33d0", size = 373963, upload-time = "2026-10-04T16:30:04.026Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/51/03/5acf7632158247f3f6386ff0af3a1ee48167d575037e8d0920594b76d92b/rpds_py-2026.9.1-cp314-cp314-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:821b2755db9194409254012f429c56643416fb96ef9be090be82ec8826b7f477", size = 377975, upload-time = "2026-10-04T16:30:05.555Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/e6/00/63fda451b8bffa5808fc8bb311ee7c073b340974b09f273c7b2a145d3d62/rpds_py-2026.9.1-cp314-cp314-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:3c91c210ae7645626c608400e3519b4a642f837cce09ca830db3beb2e9f274d4", size = 490347, upload-time = "2026-10-04T16:30:07.156Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/a1/ae/c093ffd070ba0fb02f76c565d06fecc65ad6e4afdbae78f7031076d3cdac/rpds_py-2026.9.1-cp314-cp314-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:54ac2158a6f96cfbabff0b2eedaf94b90c5ec7ca8317fcadc61e1c2b2e0ff6ef", size = 392962, upload-time = "2026-10-04T16:30:08.77Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/22/9d/d08a1128ab199b2f0cf25bfeb0639bd05119fff4b7c47bec24ef9a8ec23f/rpds_py-2026.9.1-cp314-cp314-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:eac2f5dbafd585dfe31f86a23ebf0d3ba480a9d49ebc87947267b5608d4ea0cd", size = 371623, upload-time = "2026-10-04T16:30:10.501Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/53/c7/4758ddcbb75609414bbccfcb11d612436f9b3ee821bd2f33f0f1604ee648/rpds_py-2026.9.1-cp314-cp314-manylinux_2_31_riscv64.whl", hash = "sha256:8aa5dda18d39b6143eb24809d158f9252c88f402749b6f1b62a506cc7d96cc35", size = 376997, upload-time = "2026-10-04T16:30:12.124Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/87/e4/947bd7f608ff60faf46dc9d389c3dffd0e3d767d78a0be19978448ef0ce7/rpds_py-2026.9.1-cp314-cp314-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:5c90e7fa02e8f5de0d10c17595c568ada48c5302e749462c0ea1a4c362111a86", size = 400169, upload-time = "2026-10-04T16:30:13.804Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/4b/35/fe93e020a0543b5670472c18d7e6af3197c08da571240ce1965c84f85c0f/rpds_py-2026.9.1-cp314-cp314-musllinux_1_2_aarch64.whl", hash = "sha256:e6d198bad4e49dd6732fbd636e2fc5c082f45c8cad0b4acb756b00c82c76072e", size = 551615, upload-time = "2026-10-04T16:30:15.332Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/0d/4f/5d2a0136bb03b2a56a39dc6ff92d58a6e3e53a2e17079238b86228882f16/rpds_py-2026.9.1-cp314-cp314-musllinux_1_2_i686.whl", hash = "sha256:96beca19ec79de272e8668585380ff9092c47077c1d7a1e098e00bbd921f4785", size = 614655, upload-time = "2026-10-04T16:30:16.92Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/09/1c/3f1025aaf70d9bf7272cc41f8b64ee76b48bf01726248138430e16f23b38/rpds_py-2026.9.1-cp314-cp314-musllinux_1_2_x86_64.whl", hash = "sha256:a5cf77eb04f20b720be95265a3e00eb2a14814074255cc27069c551b2db53118", size = 579602, upload-time = "2026-10-04T16:30:18.555Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/53/0d/5c72e6204f76610608706da32b6b7e11ef7e10317558a7bb15a122e008dc/rpds_py-2026.9.1-cp314-cp314-win32.whl", hash = "sha256:a03d57b86d2a51d0a66c92177e2be154ad015f357791d306e714569999cdb4cc", size = 206315, upload-time = "2026-10-04T16:30:20.05Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/a4/0b/489d48abbcc7d70cf3fbf662d9d22abf1f4650761c0a9ae05260800800d3/rpds_py-2026.9.1-cp314-cp314-win_amd64.whl", hash = "sha256:837c6b305e26fe0f75b15c92cf3b2ba29e0ae19dc40b1c557b026cb426347d0c", size = 222852, upload-time = "2026-10-04T16:30:21.604Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/91/16/bbb05a7e6a10cf79ba639be7f799d770ee15f64175cc61d081b218dd402a/rpds_py-2026.9.1-cp314-cp314-win_arm64.whl", hash = "sha256:fce4b85234a0cbad67bf8e6e1201ee815d172c9aebad75f25645bc4d834f8e31", size = 218709, upload-time = "2026-10-04T16:30:23.036Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/22/ac/ac507a0a4ec478ca470440a09583db4be5259ba7670aeba0620822f1e57a/rpds_py-2026.9.1-cp314-cp314t-macosx_10_12_x86_64.whl", hash = "sha256:3a72c11530d71abfb66c8d7696a2f86c43e63fca8b948f1a784ac490f4ec688e", size = 349596, upload-time = "2026-10-04T16:30:24.558Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/e9/f2/817a46b658d5070f477f722c298ee9a24525b0e4017347964146ef5fdd0e/rpds_py-2026.9.1-cp314-cp314t-macosx_11_0_arm64.whl", hash = "sha256:068c37bba854ec2fe42f7365c640af11dd9895890ccbf2df5070d0c059bd7f96", size = 343114, upload-time = "2026-10-04T16:30:26.048Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/6c/42/6ade976b13ac1b4cb3bf2eb603f1be2fe74df19a29988d4c2b386be59d6f/rpds_py-2026.9.1-cp314-cp314t-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:d7fca4eb6df565e2a928f1c7dad92d27db8f9df0f449e76423ed5d7e713ed445", size = 374197, upload-time = "2026-10-04T16:30:27.699Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/d9/70/77cdf1d3f1a07faabe936016ae623aec7981f73108a8fe7a203ed2e21998/rpds_py-2026.9.1-cp314-cp314t-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:c933c6678c6f116ff8af47a4c6db0868b8ace74af0343016c0ef00f00272ea69", size = 378025, upload-time = "2026-10-04T16:30:29.451Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/3f/6b/18a44a3beaa9b7931acb04af7bd9539836477c630a794452d4826d6185d4/rpds_py-2026.9.1-cp314-cp314t-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:028ad274ea951dac64491b5d1e65712a4aeabfdbdb9fccf797b57bd899b0c495", size = 491969, upload-time = "2026-10-04T16:30:30.995Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/73/27/fb39cfd6bddaf741b024f813890374578ff8ac1f1adc473659c048b03b05/rpds_py-2026.9.1-cp314-cp314t-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:740d0a99cf9de0b17a3943388e9294a59becf75e7c43421f387bd3c7a9901f7c", size = 393905, upload-time = "2026-10-04T16:30:32.628Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/ed/71/0fa7bb77b57af0d710273964180d11b503f62b8a5c358eb2d8c3f62feff6/rpds_py-2026.9.1-cp314-cp314t-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:0da298fb372dc192610a4b9ecbc68a0cd8b675bbbd1fc519d01b41cfd658333e", size = 374569, upload-time = "2026-10-04T16:30:34.257Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/54/22/f41cfac269af3b449513ef1bc3d7f32fde52abbbd2d01c7e76b47743acd9/rpds_py-2026.9.1-cp314-cp314t-manylinux_2_31_riscv64.whl", hash = "sha256:eb61be926bb81567c1f48bdc8aa22b9855048dc2efd53871f9f7e6e9a5632346", size = 377482, upload-time = "2026-10-04T16:30:35.997Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/b4/fc/312b49006e7f8f9ca5f96647577b8aa6f3df30519c46bd448f5c425af0b2/rpds_py-2026.9.1-cp314-cp314t-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:42e75466f83cd43f6026c81eab74246efb2bdadafb307b85700632d06c68f299", size = 400040, upload-time = "2026-10-04T16:30:37.76Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/cf/a6/18cca7a878dc7fa95165a83343fd4d7b65643fd22e54e47340a451121d5c/rpds_py-2026.9.1-cp314-cp314t-musllinux_1_2_aarch64.whl", hash = "sha256:617f59cde379b4f648a09797b7f683d04b90a46344cddab85639da5aff0f5531", size = 551849, upload-time = "2026-10-04T16:30:39.443Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/e4/6d/1f5685e20f39604691bdc3c05aaa6b8bd2f954e9e996477adf2376768e33/rpds_py-2026.9.1-cp314-cp314t-musllinux_1_2_i686.whl", hash = "sha256:3edae8c5ddfdb6985d49ae9d150516e5076888879022f91a26c2de9276ce0bdb", size = 614842, upload-time = "2026-10-04T16:30:41.231Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/c6/25/98652109fd9f7e10268dd4571aa52b81987001b806f37ef1a18260de714a/rpds_py-2026.9.1-cp314-cp314t-musllinux_1_2_x86_64.whl", hash = "sha256:0f045bb053c9057720d72c56dffe30dffdc05997b2897a827b9325f0ab6623fa", size = 582606, upload-time = "2026-10-04T16:30:43.345Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/19/03/11ca09099bab5f53373a80a334c424ec917c13d050760a59499d2af5171e/rpds_py-2026.9.1-cp314-cp314t-win32.whl", hash = "sha256:bf35d0568abda97233239ce32896d3ad53fccc537832c104e30c94aa5fb93569", size = 203341, upload-time = "2026-10-04T16:30:44.954Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/6f/8a/88909e3ffd9f47f5b58211473875d8c3c09079f0058c46fb72c55a702a26/rpds_py-2026.9.1-cp314-cp314t-win_amd64.whl", hash = "sha256:1e8d4d79d828299bf44a55db22a9388ab967b49d17132c88eab0f4360b48da8e", size = 222843, upload-time = "2026-10-04T16:30:46.486Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/f6/b7/a662f367d4896dd0a10cef2fc91f10b7f08af1c10858e287e019563f338d/rpds_py-2026.9.1-cp315-cp315-macosx_10_12_x86_64.whl", hash = "sha256:1d77b649e6f7cdf12ca5c2a98dad0ad37f9ea9b6f960408a92f0cb12bb3d04d9", size = 347463, upload-time = "2026-10-04T16:30:48.203Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/ae/3f/ad45d03df4f84ebae5439577ee81f3999d182711e82235c8037b6528890e/rpds_py-2026.9.1-cp315-cp315-macosx_11_0_arm64.whl", hash = "sha256:00ba2d8c7dd4ee537978ddf4b3fbd712bef2d8751603f7f3146b3f4287768e25", size = 342051, upload-time = "2026-10-04T16:30:49.872Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/7e/31/3dcd68c13d4bcc59c1f7eb33ac8e80698f06f3eb0d8a1e06419836071c20/rpds_py-2026.9.1-cp315-cp315-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:ec450527cbf485e13c8d3602a54f428ab0432fdade0ede75efd74b735421c871", size = 374143, upload-time = "2026-10-04T16:30:51.508Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/cf/0d/68c1f058a250fbd1380ebda9fc227cbf50117adf8ffe8161ef383ea79f68/rpds_py-2026.9.1-cp315-cp315-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:306ee1850d8105b5baf977e78d45fcadd12c1a54678d614c9baf217708446e91", size = 378604, upload-time = "2026-10-04T16:30:53.206Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/d7/d6/2d4c59b85397cb4800594fadf692688ccf5ce556adc930e7a5bf21061a5e/rpds_py-2026.9.1-cp315-cp315-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:ef6b65b03247c54692ad4fd9ee97cb772781927db72e3cb05e70b3db6d1ff14f", size = 490790, upload-time = "2026-10-04T16:30:54.925Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/da/04/7e05dc3aebaf52f4e026766bd668fdd09a9d0e23f64a14686b36b3501892/rpds_py-2026.9.1-cp315-cp315-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:a575404ebc9cf2e91edd32eaf570ec1430eb900d4f56724ba7dd4bc1fc9c176d", size = 393146, upload-time = "2026-10-04T16:30:56.625Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/57/ca/e2e9a0a46a74ed51a0498ba1fe10f4ea6b2d9a155f372a2f91e51f18cf10/rpds_py-2026.9.1-cp315-cp315-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:2c16ab111bc27c646ba8aa005d0527754edc538ebb636f0b1bf8e244b48d1945", size = 372022, upload-time = "2026-10-04T16:30:58.295Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/ba/cb/8f8774df5134e23424372838bcc5c7ed4127d723e1ff52f7bebd4dcb2563/rpds_py-2026.9.1-cp315-cp315-manylinux_2_31_riscv64.whl", hash = "sha256:7664419f27db41d4f1c43a78dccda7dd6e8ef2428df3ee01d0c2a07a6b071297", size = 377092, upload-time = "2026-10-04T16:30:59.984Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/90/02/8d7095d73bf9114219be40230baa5df00611e0a82ed9517779ff9c19f82b/rpds_py-2026.9.1-cp315-cp315-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:4b26b03d9d2658ee2fa234f8f4f19f38a09773fe5261028025032e26d4d35af0", size = 400830, upload-time = "2026-10-04T16:31:01.721Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/ec/02/8206856f8f363cd042a8315dc86b3912f5dcb6d3c66bbb24b69c2bfb0775/rpds_py-2026.9.1-cp315-cp315-musllinux_1_2_aarch64.whl", hash = "sha256:be3e47e2d91aa3942ff9bf4077a505226005abfc39b6f7554a91c1b9393986b9", size = 551478, upload-time = "2026-10-04T16:31:03.472Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/41/6b/36211f1bb1f0b0313f496d92f5905b74ea107f27cb16fa3355a82f04575e/rpds_py-2026.9.1-cp315-cp315-musllinux_1_2_i686.whl", hash = "sha256:6307a0da524939decb8ca4a3933b8ab62525794411d6984fca6726e732804af6", size = 615173, upload-time = "2026-10-04T16:31:05.281Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/35/77/cda0c4a6f055446b692f0ed5692f73707cafd3dff82672ede31b1a9b59de/rpds_py-2026.9.1-cp315-cp315-musllinux_1_2_x86_64.whl", hash = "sha256:159a7aab5c5e8b112c8830f54717ce56da1252ebdbb526f5be2df2309280b9e7", size = 579653, upload-time = "2026-10-04T16:31:07.065Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/74/ec/d8385f446240aed643b9e92a5055cff3015cc04a13c61f73b2883c478ed5/rpds_py-2026.9.1-cp315-cp315-win32.whl", hash = "sha256:dbc2673f9223d420c91145599b3ba45a8a50c207d1976908e5fb5ddb0c9b9429", size = 206498, upload-time = "2026-10-04T16:31:08.989Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/6d/a5/71b5cd00e0521e3b6b81828baea368c62b6b700ebdd9554cd7d41ddf12fa/rpds_py-2026.9.1-cp315-cp315-win_amd64.whl", hash = "sha256:75c38c50ab9aca840225d9a9a3810bf11d04bd5c1f186cabbb8aee56db3e9b15", size = 223121, upload-time = "2026-10-04T16:31:10.84Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/33/58/dba857c3bc8221b31b62eb170a3080f4f191de79f047200389b7ed1b06a7/rpds_py-2026.9.1-cp315-cp315-win_arm64.whl", hash = "sha256:a431156bb41865fc14cd5d79bb9d7bbed83110b0159e34e62ae30951f96c0009", size = 218741, upload-time = "2026-10-04T16:31:12.592Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/5b/d0/320ab28ccc1415eeb509d68682b0014fb74690cd49f1c2d29a232475af50/rpds_py-2026.9.1-cp315-cp315t-macosx_10_12_x86_64.whl", hash = "sha256:ef0d8c843e2827d6c120ab4687e9423fb1d893db1df27b7c1506615bcb9734a0", size = 349719, upload-time = "2026-10-04T16:31:14.48Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/56/88/f5b12f1358f443c08b7ce3cc8391d82d335f4872580e2e097847fd36087a/rpds_py-2026.9.1-cp315-cp315t-macosx_11_0_arm64.whl", hash = "sha256:45bc6bccf78b20fd834237d18db64965d7ee68ba7f60440a26c7ab71e7b8d51a", size = 343267, upload-time = "2026-10-04T16:31:16.827Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/f7/0c/c765b0059d532acb3b9c45d781ccc22f15a96dbe443d00903f643ba9df10/rpds_py-2026.9.1-cp315-cp315t-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:1d55198263bb51f557550c6ed2e6d1cb6a6fed6eb5c9120b741c5926bef8a45d", size = 374555, upload-time = "2026-10-04T16:31:18.931Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/6b/8a/cafddfda77564a10cd21184640c3bffda6a2b8d20972fb5dedd5e0166328/rpds_py-2026.9.1-cp315-cp315t-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:a8763f20692da7df39b0afdd1ba3042b004c50a45994f76c2d9a25641f7673db", size = 378346, upload-time = "2026-10-04T16:31:20.75Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/b9/01/5e626016eff72c183bf6c96539240cace15d402468647a453ec08415b2fc/rpds_py-2026.9.1-cp315-cp315t-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:e43d4a1f673e8a1cbd8533e809e02b4bf9d4f2280269bb640436556312121250", size = 492373, upload-time = "2026-10-04T16:31:22.614Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/3b/9c/15a2469e9389242f46896b3f0a01d68caea8a5a35c011fcb05ef333aae73/rpds_py-2026.9.1-cp315-cp315t-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:ea394a937f17a54c51239348bdbe2e3518124c8d4a8951ba04a311d3095bd18f", size = 394371, upload-time = "2026-10-04T16:31:24.768Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/63/f5/c100ff77e1e6366e947c75969c258fdfc4b7bc5bbfe7351e62ffbf2a1228/rpds_py-2026.9.1-cp315-cp315t-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:cdeaa99ce822dca76cfb1b993e9120c5ea212f2eb66d48950ad63c349668a018", size = 375132, upload-time = "2026-10-04T16:31:26.588Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/dd/f4/fe0269c9de253e99c81cabc12b8971a5feaa083debdaff1221e06264d9e3/rpds_py-2026.9.1-cp315-cp315t-manylinux_2_31_riscv64.whl", hash = "sha256:b4f062343e7ad3fa94f2c66e5ae667dee47ee74dd41a9057c4fbe163236a123d", size = 377642, upload-time = "2026-10-04T16:31:28.677Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/05/65/b34a7b257baccff8f4a24a722933166d4941d5ebdc9c3f4bc4ffcd5ce4f4/rpds_py-2026.9.1-cp315-cp315t-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:22ffd29a63d71fb1b81552c21f2c2b734949b7ac751a9be70675a939a900839b", size = 400855, upload-time = "2026-10-04T16:31:30.802Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/98/32/844e54176b6071b90b38a564e6940bc6eb8f97b2890dc709c19db9dec0f4/rpds_py-2026.9.1-cp315-cp315t-musllinux_1_2_aarch64.whl", hash = "sha256:08dae4a4095150a7c4545a1fb40b98e1ab1744fbc2770d92c977b9dadaa49ab6", size = 552573, upload-time = "2026-10-04T16:31:32.709Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/17/73/6041d20729dffbfdf155c02d65be58bc225a1c1fb548fd87c23ef306138f/rpds_py-2026.9.1-cp315-cp315t-musllinux_1_2_i686.whl", hash = "sha256:9a0460d43603d1fd9ef59c30278531e15d78581721ddb538fa560aa7817ea4ad", size = 615840, upload-time = "2026-10-04T16:31:34.565Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/af/9e/418094adaee6b056ce199051b255448ed872829051e341b2294c80da0977/rpds_py-2026.9.1-cp315-cp315t-musllinux_1_2_x86_64.whl", hash = "sha256:1c2d1f6da5128eabf34e963d7163a818846075a52568250d006c4c953b40f903", size = 582764, upload-time = "2026-10-04T16:31:36.665Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/3d/9b/1698ebf6b840ddfe8b472198abbed6ace35c6e398faeecd6c47dae742a4e/rpds_py-2026.9.1-cp315-cp315t-win32.whl", hash = "sha256:5c6ee90dee3e85e055ddfd502d611643d9b0fd94c818220bda84ec3dacd9b27b", size = 203795, upload-time = "2026-10-04T16:31:38.53Z" },
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/8a/e2/91f70d804c61f8eac39a417e82aa1024f655ab9e8bdd7393b196242bc41b/rpds_py-2026.9.1-cp315-cp315t-win_amd64.whl", hash = "sha256:fe5ad0664ec772b02c45859041aa17655709cced7a31005817fbbbd988c25567", size = 223037, upload-time = "2026-10-04T16:31:40.468Z" },
|
||||||
|
]
|
||||||
|
|
||||||
|
[[package]]
|
||||||
|
name = "urllib3"
|
||||||
|
version = "2.8.0"
|
||||||
|
source = { registry = "https://pypi.org/simple" }
|
||||||
|
sdist = { url = "https://files.pythonhosted.org/packages/e3/05/b17359e1cefb4f909b5e40b1b90a496d987258916dbbf88e842c729f510e/urllib3-2.8.0.tar.gz", hash = "sha256:63bf2ead4c879426ebf22ef2a781eeb4aa3b4ae798a0435506f8687fd5bb9b63", size = 458972, upload-time = "2026-09-15T19:29:36.253Z" }
|
||||||
|
wheels = [
|
||||||
|
{ url = "https://files.pythonhosted.org/packages/92/9d/c4e665119135114480843e7ab388fa94d8480650450e6f8e26b70d323a4c/urllib3-2.8.0-py3-none-any.whl", hash = "sha256:0cf3cae568d36aa9576b28dfb35f11328f1cb974ca7647d9475ebb86c75ac6e3", size = 135717, upload-time = "2026-09-15T19:29:34.577Z" },
|
||||||
|
]
|
||||||
7
coverage_gaps/__init__.py
Normal file
7
coverage_gaps/__init__.py
Normal file
@ -0,0 +1,7 @@
|
|||||||
|
"""Deterministic coverage-gap lister: a coverage report in, a task list out.
|
||||||
|
|
||||||
|
Replaces "spawn an LLM agent to explore where coverage is missing". Reads lcov,
|
||||||
|
Cobertura XML, JaCoCo XML or coverage.py JSON and lists, per file, exactly
|
||||||
|
which lines and branches are uncovered. Exit codes are the verdict (0 covered,
|
||||||
|
1 gaps, 2 unreadable) so CI and hooks adjudicate without a model.
|
||||||
|
"""
|
||||||
5
coverage_gaps/__main__.py
Normal file
5
coverage_gaps/__main__.py
Normal file
@ -0,0 +1,5 @@
|
|||||||
|
"""`python3 -m coverage_gaps` -- the entrypoint the `coverage-gaps` wrapper calls."""
|
||||||
|
|
||||||
|
from coverage_gaps.cli import main
|
||||||
|
|
||||||
|
raise SystemExit(main())
|
||||||
16
coverage_gaps/bin/coverage-gaps
Executable file
16
coverage_gaps/bin/coverage-gaps
Executable file
@ -0,0 +1,16 @@
|
|||||||
|
#!/bin/bash
|
||||||
|
|
||||||
|
# ============================================================================
|
||||||
|
# coverage-gaps -- per-file task list of uncovered lines/branches.
|
||||||
|
# Thin wrapper over `python3 -m coverage_gaps` (see coverage_gaps/cli.py).
|
||||||
|
# Usage: coverage-gaps <report> [--json] [--max-files N] [--min-missed N]
|
||||||
|
# [--path-prefix P] Exit: 0 covered | 1 gaps | 2 bad input
|
||||||
|
# ============================================================================
|
||||||
|
|
||||||
|
set -euo pipefail
|
||||||
|
|
||||||
|
BIN_DIR="$(cd "$(dirname "$(readlink -f "${BASH_SOURCE[0]}")")" && pwd -P)"
|
||||||
|
readonly BIN_DIR
|
||||||
|
|
||||||
|
PYTHONPATH="$BIN_DIR/../.." python3 -m coverage_gaps "$@"
|
||||||
|
exit $?
|
||||||
63
coverage_gaps/cli.py
Normal file
63
coverage_gaps/cli.py
Normal file
@ -0,0 +1,63 @@
|
|||||||
|
"""Command line: `coverage-gaps REPORT [--json] [--max-files N] ...`."""
|
||||||
|
|
||||||
|
from __future__ import annotations
|
||||||
|
|
||||||
|
import argparse
|
||||||
|
import sys
|
||||||
|
from collections.abc import Sequence
|
||||||
|
from pathlib import Path
|
||||||
|
|
||||||
|
from coverage_gaps.models import ReportError
|
||||||
|
from coverage_gaps.parsers import load_report
|
||||||
|
from coverage_gaps.render import select, to_json, to_markdown
|
||||||
|
|
||||||
|
EXIT_COVERED = 0
|
||||||
|
EXIT_GAPS = 1
|
||||||
|
EXIT_UNREADABLE = 2
|
||||||
|
|
||||||
|
|
||||||
|
def build_parser() -> argparse.ArgumentParser:
|
||||||
|
"""Argument parser (format is auto-detected from file content)."""
|
||||||
|
parser = argparse.ArgumentParser(
|
||||||
|
prog="coverage-gaps",
|
||||||
|
description="List uncovered lines/branches from lcov, Cobertura, JaCoCo "
|
||||||
|
"or coverage.py JSON reports. Exit 0 covered, 1 gaps, 2 unreadable.",
|
||||||
|
)
|
||||||
|
parser.add_argument("report", type=Path, help="coverage report file")
|
||||||
|
parser.add_argument("--json", action="store_true", help="emit JSON, not markdown")
|
||||||
|
parser.add_argument(
|
||||||
|
"--max-files",
|
||||||
|
type=int,
|
||||||
|
default=0,
|
||||||
|
metavar="N",
|
||||||
|
help="list only the N worst files (0 = all)",
|
||||||
|
)
|
||||||
|
parser.add_argument(
|
||||||
|
"--min-missed",
|
||||||
|
type=int,
|
||||||
|
default=1,
|
||||||
|
metavar="N",
|
||||||
|
help="skip files with fewer than N missed lines+branches",
|
||||||
|
)
|
||||||
|
parser.add_argument(
|
||||||
|
"--path-prefix",
|
||||||
|
default="",
|
||||||
|
metavar="PREFIX",
|
||||||
|
help="only files whose path starts with PREFIX",
|
||||||
|
)
|
||||||
|
return parser
|
||||||
|
|
||||||
|
|
||||||
|
def main(argv: Sequence[str] | None = None) -> int:
|
||||||
|
"""Run the tool and return the process exit code."""
|
||||||
|
args = build_parser().parse_args(argv)
|
||||||
|
try:
|
||||||
|
fmt, gaps = load_report(args.report)
|
||||||
|
except ReportError as exc:
|
||||||
|
print(f"coverage-gaps: {exc}", file=sys.stderr)
|
||||||
|
return EXIT_UNREADABLE
|
||||||
|
files = select(gaps, path_prefix=args.path_prefix, min_missed=args.min_missed)
|
||||||
|
shown = args.max_files if args.max_files > 0 else len(files)
|
||||||
|
render = to_json if args.json else to_markdown
|
||||||
|
sys.stdout.write(render(fmt, files, shown) + ("\n" if args.json else ""))
|
||||||
|
return EXIT_GAPS if files else EXIT_COVERED
|
||||||
69
coverage_gaps/models.py
Normal file
69
coverage_gaps/models.py
Normal file
@ -0,0 +1,69 @@
|
|||||||
|
"""Format-neutral data model shared by every parser and renderer."""
|
||||||
|
|
||||||
|
from __future__ import annotations
|
||||||
|
|
||||||
|
from dataclasses import dataclass, field
|
||||||
|
|
||||||
|
|
||||||
|
class ReportError(Exception):
|
||||||
|
"""The input is unreadable, unrecognised or malformed (exit code 2)."""
|
||||||
|
|
||||||
|
|
||||||
|
@dataclass
|
||||||
|
class FileAccumulator:
|
||||||
|
"""Mutable per-file collector that merges repeated records for one path.
|
||||||
|
|
||||||
|
Reports may list a file more than once (lcov re-runs, Cobertura inner
|
||||||
|
classes). A line or branch counts as covered if ANY record covered it.
|
||||||
|
"""
|
||||||
|
|
||||||
|
lines: dict[int, bool] = field(default_factory=dict)
|
||||||
|
branches: dict[tuple[int, int, int], bool] = field(default_factory=dict)
|
||||||
|
|
||||||
|
def add_line(self, line: int, covered: bool) -> None:
|
||||||
|
"""Record a line, OR-merging with earlier records of the same line."""
|
||||||
|
self.lines[line] = self.lines.get(line, False) or covered
|
||||||
|
|
||||||
|
def add_branch(self, line: int, block: int, index: int, covered: bool) -> None:
|
||||||
|
"""Record one branch outcome, OR-merging on (line, block, index)."""
|
||||||
|
key = (line, block, index)
|
||||||
|
self.branches[key] = self.branches.get(key, False) or covered
|
||||||
|
|
||||||
|
|
||||||
|
@dataclass(frozen=True)
|
||||||
|
class FileGap:
|
||||||
|
"""Coverage state of one source file."""
|
||||||
|
|
||||||
|
path: str
|
||||||
|
total_lines: int
|
||||||
|
missed_lines: tuple[int, ...]
|
||||||
|
total_branches: int
|
||||||
|
missed_branch_lines: tuple[int, ...]
|
||||||
|
missed_branches: int
|
||||||
|
|
||||||
|
@property
|
||||||
|
def missed(self) -> int:
|
||||||
|
"""Missed lines plus missed branches: the sort key."""
|
||||||
|
return len(self.missed_lines) + self.missed_branches
|
||||||
|
|
||||||
|
@property
|
||||||
|
def percent(self) -> float:
|
||||||
|
"""Percent covered over lines and branches combined (100 if empty)."""
|
||||||
|
total = self.total_lines + self.total_branches
|
||||||
|
if total == 0:
|
||||||
|
return 100.0
|
||||||
|
return 100.0 * (total - self.missed) / total
|
||||||
|
|
||||||
|
|
||||||
|
def build_gap(path: str, acc: FileAccumulator) -> FileGap:
|
||||||
|
"""Freeze an accumulator into a FileGap."""
|
||||||
|
missed_lines = tuple(sorted(n for n, ok in acc.lines.items() if not ok))
|
||||||
|
missed_br = [key for key, ok in acc.branches.items() if not ok]
|
||||||
|
return FileGap(
|
||||||
|
path=path,
|
||||||
|
total_lines=len(acc.lines),
|
||||||
|
missed_lines=missed_lines,
|
||||||
|
total_branches=len(acc.branches),
|
||||||
|
missed_branch_lines=tuple(sorted({key[0] for key in missed_br})),
|
||||||
|
missed_branches=len(missed_br),
|
||||||
|
)
|
||||||
132
coverage_gaps/parsers.py
Normal file
132
coverage_gaps/parsers.py
Normal file
@ -0,0 +1,132 @@
|
|||||||
|
"""Parsers for lcov, Cobertura XML, JaCoCo XML and coverage.py JSON."""
|
||||||
|
|
||||||
|
from __future__ import annotations
|
||||||
|
|
||||||
|
import json
|
||||||
|
import re
|
||||||
|
import xml.etree.ElementTree as ET
|
||||||
|
from collections.abc import Callable
|
||||||
|
from pathlib import Path
|
||||||
|
|
||||||
|
from coverage_gaps.models import FileAccumulator, FileGap, ReportError, build_gap
|
||||||
|
|
||||||
|
_CONDITION = re.compile(r"\((\d+)/(\d+)\)")
|
||||||
|
|
||||||
|
|
||||||
|
def _finish(files: dict[str, FileAccumulator]) -> list[FileGap]:
|
||||||
|
return [build_gap(path, acc) for path, acc in files.items()]
|
||||||
|
|
||||||
|
|
||||||
|
def parse_lcov(text: str) -> list[FileGap]:
|
||||||
|
"""Parse lcov.info: SF / DA / BRDA records, `end_of_record` optional."""
|
||||||
|
files: dict[str, FileAccumulator] = {}
|
||||||
|
acc: FileAccumulator | None = None
|
||||||
|
for raw in text.splitlines():
|
||||||
|
line = raw.strip()
|
||||||
|
if line.startswith("SF:"):
|
||||||
|
acc = files.setdefault(line[3:], FileAccumulator())
|
||||||
|
elif acc is not None and line.startswith("DA:"):
|
||||||
|
num, hits, *_ = line[3:].split(",")
|
||||||
|
acc.add_line(int(num), int(hits) > 0)
|
||||||
|
elif acc is not None and line.startswith("BRDA:"):
|
||||||
|
num, block, branch, taken = line[5:].split(",")
|
||||||
|
covered = taken not in ("-", "0")
|
||||||
|
acc.add_branch(int(num), int(block), _branch_id(branch), covered)
|
||||||
|
elif line == "end_of_record":
|
||||||
|
acc = None
|
||||||
|
return _finish(files)
|
||||||
|
|
||||||
|
|
||||||
|
def _branch_id(branch: str) -> int:
|
||||||
|
return int(branch) if branch.isdigit() else 0
|
||||||
|
|
||||||
|
|
||||||
|
def parse_cobertura(text: str) -> list[FileGap]:
|
||||||
|
"""Parse Cobertura `coverage.xml` (coverage.py, gcovr, ...)."""
|
||||||
|
root = ET.fromstring(text)
|
||||||
|
files: dict[str, FileAccumulator] = {}
|
||||||
|
for cls in root.iter("class"):
|
||||||
|
acc = files.setdefault(cls.get("filename", ""), FileAccumulator())
|
||||||
|
for node in cls.iter("line"):
|
||||||
|
num = int(node.get("number", "0"))
|
||||||
|
acc.add_line(num, int(node.get("hits", "0")) > 0)
|
||||||
|
match = _CONDITION.search(node.get("condition-coverage", ""))
|
||||||
|
if match:
|
||||||
|
hit, total = int(match[1]), int(match[2])
|
||||||
|
for idx in range(total):
|
||||||
|
acc.add_branch(num, 0, idx, idx < hit)
|
||||||
|
return _finish(files)
|
||||||
|
|
||||||
|
|
||||||
|
def parse_jacoco(text: str) -> list[FileGap]:
|
||||||
|
"""Parse JaCoCo XML: per `sourcefile` line records (mi/ci/mb/cb)."""
|
||||||
|
root = ET.fromstring(text)
|
||||||
|
files: dict[str, FileAccumulator] = {}
|
||||||
|
for package in root.iter("package"):
|
||||||
|
base = package.get("name", "")
|
||||||
|
for source in package.iter("sourcefile"):
|
||||||
|
name = source.get("name", "")
|
||||||
|
acc = files.setdefault(
|
||||||
|
f"{base}/{name}" if base else name, FileAccumulator()
|
||||||
|
)
|
||||||
|
for node in source.iter("line"):
|
||||||
|
num = int(node.get("nr", "0"))
|
||||||
|
acc.add_line(num, int(node.get("ci", "0")) > 0)
|
||||||
|
missed_b, covered_b = int(node.get("mb", "0")), int(node.get("cb", "0"))
|
||||||
|
for idx in range(missed_b + covered_b):
|
||||||
|
acc.add_branch(num, 0, idx, idx >= missed_b)
|
||||||
|
return _finish(files)
|
||||||
|
|
||||||
|
|
||||||
|
def parse_coverage_json(text: str) -> list[FileGap]:
|
||||||
|
"""Parse `coverage json` output (with or without branch data)."""
|
||||||
|
files: dict[str, FileAccumulator] = {}
|
||||||
|
for path, data in json.loads(text).get("files", {}).items():
|
||||||
|
acc = files.setdefault(path, FileAccumulator())
|
||||||
|
for num in data.get("executed_lines", []):
|
||||||
|
acc.add_line(num, True)
|
||||||
|
for num in data.get("missing_lines", []):
|
||||||
|
acc.add_line(num, False)
|
||||||
|
missing = data.get("missing_branches", [])
|
||||||
|
for idx, (src, _dst) in enumerate(missing):
|
||||||
|
acc.add_branch(abs(src), 1, idx, False)
|
||||||
|
covered = data.get("summary", {}).get("covered_branches", 0)
|
||||||
|
for idx in range(covered):
|
||||||
|
acc.add_branch(0, 2, idx, True)
|
||||||
|
return _finish(files)
|
||||||
|
|
||||||
|
|
||||||
|
def detect_format(text: str) -> str:
|
||||||
|
"""Return 'lcov' | 'cobertura' | 'jacoco' | 'json' from file content."""
|
||||||
|
head = text.lstrip()[:4000]
|
||||||
|
if head.startswith("{"):
|
||||||
|
return "json"
|
||||||
|
if head.startswith("<"):
|
||||||
|
if "<report" in head:
|
||||||
|
return "jacoco"
|
||||||
|
if "<coverage" in head:
|
||||||
|
return "cobertura"
|
||||||
|
elif re.search(r"^(TN|SF):", head, re.MULTILINE):
|
||||||
|
return "lcov"
|
||||||
|
raise ReportError("unrecognised coverage report format")
|
||||||
|
|
||||||
|
|
||||||
|
_PARSERS: dict[str, Callable[[str], list[FileGap]]] = {
|
||||||
|
"lcov": parse_lcov,
|
||||||
|
"cobertura": parse_cobertura,
|
||||||
|
"jacoco": parse_jacoco,
|
||||||
|
"json": parse_coverage_json,
|
||||||
|
}
|
||||||
|
|
||||||
|
|
||||||
|
def load_report(path: Path) -> tuple[str, list[FileGap]]:
|
||||||
|
"""Read and parse a report; raise ReportError on any failure."""
|
||||||
|
try:
|
||||||
|
text = path.read_text(encoding="utf-8", errors="replace")
|
||||||
|
except OSError as exc:
|
||||||
|
raise ReportError(f"cannot read {path}: {exc.strerror}") from exc
|
||||||
|
fmt = detect_format(text)
|
||||||
|
try:
|
||||||
|
return fmt, _PARSERS[fmt](text)
|
||||||
|
except (ET.ParseError, ValueError, TypeError, AttributeError) as exc:
|
||||||
|
raise ReportError(f"malformed {fmt} report {path}: {exc}") from exc
|
||||||
102
coverage_gaps/render.py
Normal file
102
coverage_gaps/render.py
Normal file
@ -0,0 +1,102 @@
|
|||||||
|
"""Filtering and rendering: markdown (agent task list) and JSON."""
|
||||||
|
|
||||||
|
from __future__ import annotations
|
||||||
|
|
||||||
|
import json
|
||||||
|
from collections.abc import Iterable, Sequence
|
||||||
|
|
||||||
|
from coverage_gaps.models import FileGap
|
||||||
|
|
||||||
|
|
||||||
|
def compact_ranges(lines: Iterable[int]) -> str:
|
||||||
|
"""Collapse line numbers into '12-18, 40'."""
|
||||||
|
nums = sorted(set(lines))
|
||||||
|
parts: list[str] = []
|
||||||
|
idx = 0
|
||||||
|
while idx < len(nums):
|
||||||
|
end = idx
|
||||||
|
while end + 1 < len(nums) and nums[end + 1] == nums[end] + 1:
|
||||||
|
end += 1
|
||||||
|
parts.append(_span(nums[idx], nums[end]))
|
||||||
|
idx = end + 1
|
||||||
|
return ", ".join(parts)
|
||||||
|
|
||||||
|
|
||||||
|
def _span(start: int, end: int) -> str:
|
||||||
|
return str(start) if start == end else f"{start}-{end}"
|
||||||
|
|
||||||
|
|
||||||
|
def select(
|
||||||
|
gaps: Sequence[FileGap], *, path_prefix: str = "", min_missed: int = 1
|
||||||
|
) -> list[FileGap]:
|
||||||
|
"""Keep files with gaps under the prefix, worst first (ties by path)."""
|
||||||
|
kept = [
|
||||||
|
gap
|
||||||
|
for gap in gaps
|
||||||
|
if gap.path.startswith(path_prefix) and gap.missed >= max(min_missed, 1)
|
||||||
|
]
|
||||||
|
return sorted(kept, key=lambda gap: (-gap.missed, gap.path))
|
||||||
|
|
||||||
|
|
||||||
|
def _totals(files: Sequence[FileGap]) -> dict[str, int]:
|
||||||
|
return {
|
||||||
|
"files": len(files),
|
||||||
|
"missed_lines": sum(len(gap.missed_lines) for gap in files),
|
||||||
|
"missed_branches": sum(gap.missed_branches for gap in files),
|
||||||
|
}
|
||||||
|
|
||||||
|
|
||||||
|
def to_json(fmt: str, files: Sequence[FileGap], shown: int) -> str:
|
||||||
|
"""Machine-readable output; `files` is already sorted and filtered."""
|
||||||
|
entries = [
|
||||||
|
{
|
||||||
|
"path": gap.path,
|
||||||
|
"percent_covered": round(gap.percent, 2),
|
||||||
|
"missed": gap.missed,
|
||||||
|
"missed_lines": compact_ranges(gap.missed_lines),
|
||||||
|
"missed_line_numbers": list(gap.missed_lines),
|
||||||
|
"missed_branch_count": gap.missed_branches,
|
||||||
|
"missed_branch_lines": list(gap.missed_branch_lines),
|
||||||
|
}
|
||||||
|
for gap in files[:shown]
|
||||||
|
]
|
||||||
|
doc = {
|
||||||
|
"format": fmt,
|
||||||
|
"total": _totals(files),
|
||||||
|
"shown": len(entries),
|
||||||
|
"files": entries,
|
||||||
|
}
|
||||||
|
return json.dumps(doc, indent=2)
|
||||||
|
|
||||||
|
|
||||||
|
def to_markdown(fmt: str, files: Sequence[FileGap], shown: int) -> str:
|
||||||
|
"""Markdown task list meant to be pasted to an agent verbatim."""
|
||||||
|
total = _totals(files)
|
||||||
|
out = [
|
||||||
|
"# Coverage gaps",
|
||||||
|
"",
|
||||||
|
(
|
||||||
|
f"Format: {fmt}. Total: {total['files']} files with gaps, "
|
||||||
|
f"{total['missed_lines']} missed lines, "
|
||||||
|
f"{total['missed_branches']} missed branches."
|
||||||
|
),
|
||||||
|
]
|
||||||
|
if shown < len(files):
|
||||||
|
out.append(f"Showing the {shown} worst files.")
|
||||||
|
if not files:
|
||||||
|
return "\n".join(out) + "\n\nNo coverage gaps.\n"
|
||||||
|
out += ["", "Write tests that cover every item below, then re-run the report.", ""]
|
||||||
|
for rank, gap in enumerate(files[:shown], start=1):
|
||||||
|
out.append(f"## {rank}. `{gap.path}` - {gap.percent:.1f}% covered")
|
||||||
|
if gap.missed_lines:
|
||||||
|
out.append(
|
||||||
|
f"- missed lines ({len(gap.missed_lines)}): "
|
||||||
|
f"{compact_ranges(gap.missed_lines)}"
|
||||||
|
)
|
||||||
|
if gap.missed_branches:
|
||||||
|
out.append(
|
||||||
|
f"- missed branches ({gap.missed_branches}) at lines: "
|
||||||
|
f"{compact_ranges(gap.missed_branch_lines)}"
|
||||||
|
)
|
||||||
|
out.append("")
|
||||||
|
return "\n".join(out).rstrip() + "\n"
|
||||||
0
coverage_gaps/tests/__init__.py
Normal file
0
coverage_gaps/tests/__init__.py
Normal file
89
coverage_gaps/tests/conftest.py
Normal file
89
coverage_gaps/tests/conftest.py
Normal file
@ -0,0 +1,89 @@
|
|||||||
|
"""Small fixture reports, one per supported format, all describing a.py/b.py.
|
||||||
|
|
||||||
|
a.py: lines 1-5 with 2,3 and 5 missed + one missed branch on line 4.
|
||||||
|
b.py: fully covered (must never be listed).
|
||||||
|
"""
|
||||||
|
|
||||||
|
from __future__ import annotations
|
||||||
|
|
||||||
|
import json
|
||||||
|
import sys
|
||||||
|
from pathlib import Path
|
||||||
|
|
||||||
|
import pytest
|
||||||
|
|
||||||
|
sys.path.insert(0, str(Path(__file__).resolve().parents[2]))
|
||||||
|
|
||||||
|
LCOV = """TN:
|
||||||
|
SF:a.py
|
||||||
|
DA:1,1
|
||||||
|
DA:2,0
|
||||||
|
DA:3,0
|
||||||
|
DA:4,1
|
||||||
|
DA:5,0
|
||||||
|
BRDA:4,0,0,1
|
||||||
|
BRDA:4,0,1,-
|
||||||
|
end_of_record
|
||||||
|
SF:b.py
|
||||||
|
DA:1,3
|
||||||
|
end_of_record
|
||||||
|
SF:a.py
|
||||||
|
DA:1,1
|
||||||
|
DA:2,0
|
||||||
|
end_of_record
|
||||||
|
"""
|
||||||
|
|
||||||
|
COBERTURA = """<?xml version="1.0" ?>
|
||||||
|
<coverage version="7"><packages><package name="p"><classes>
|
||||||
|
<class filename="a.py"><lines>
|
||||||
|
<line number="1" hits="1"/><line number="2" hits="0"/><line number="3" hits="0"/>
|
||||||
|
<line number="4" hits="1" branch="true" condition-coverage="50% (1/2)"/>
|
||||||
|
<line number="5" hits="0"/></lines></class>
|
||||||
|
<class filename="b.py"><lines><line number="1" hits="2"/></lines></class>
|
||||||
|
<class filename="a.py"><lines><line number="1" hits="1"/></lines></class>
|
||||||
|
</classes></package></packages></coverage>
|
||||||
|
"""
|
||||||
|
|
||||||
|
JACOCO = """<?xml version="1.0" encoding="UTF-8"?>
|
||||||
|
<!DOCTYPE report PUBLIC "-//JACOCO//DTD Report 1.1//EN" "report.dtd">
|
||||||
|
<report name="x"><package name="com/x">
|
||||||
|
<sourcefile name="A.kt">
|
||||||
|
<line nr="1" mi="0" ci="3"/><line nr="2" mi="2" ci="0"/><line nr="3" mi="1" ci="0"/>
|
||||||
|
<line nr="4" mi="0" ci="4" mb="1" cb="1"/><line nr="5" mi="1" ci="0"/></sourcefile>
|
||||||
|
<sourcefile name="B.kt"><line nr="1" mi="0" ci="1"/></sourcefile>
|
||||||
|
</package><package name=""><sourcefile name="Top.kt">
|
||||||
|
<line nr="1" mi="0" ci="1"/></sourcefile></package></report>
|
||||||
|
"""
|
||||||
|
|
||||||
|
COVERAGE_JSON = json.dumps(
|
||||||
|
{
|
||||||
|
"files": {
|
||||||
|
"a.py": {
|
||||||
|
"executed_lines": [1, 4],
|
||||||
|
"missing_lines": [2, 3, 5],
|
||||||
|
"missing_branches": [[4, 5]],
|
||||||
|
"summary": {"covered_branches": 1},
|
||||||
|
},
|
||||||
|
"b.py": {
|
||||||
|
"executed_lines": [1],
|
||||||
|
"missing_lines": [],
|
||||||
|
"missing_branches": [],
|
||||||
|
},
|
||||||
|
}
|
||||||
|
}
|
||||||
|
)
|
||||||
|
|
||||||
|
|
||||||
|
@pytest.fixture
|
||||||
|
def reports(tmp_path: Path) -> dict[str, Path]:
|
||||||
|
"""Write each fixture report to disk, keyed by format name."""
|
||||||
|
out = {}
|
||||||
|
for name, body in {
|
||||||
|
"lcov": LCOV,
|
||||||
|
"cobertura": COBERTURA,
|
||||||
|
"jacoco": JACOCO,
|
||||||
|
"json": COVERAGE_JSON,
|
||||||
|
}.items():
|
||||||
|
out[name] = tmp_path / f"{name}.rpt"
|
||||||
|
out[name].write_text(body, encoding="utf-8")
|
||||||
|
return out
|
||||||
Some files were not shown because too many files have changed in this diff Show More
Loading…
Reference in New Issue
Block a user