MikeFaith/pm3py
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs: update CLAUDE.md and progress for trace/ package

Browse Source 
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
This commit is contained in:
michael
2026-03-18 19:49:59 -07:00
parent 117f46efb9
commit 7fc2470b01
2 changed files with 22 additions and 12 deletions
Download Patch File Download Diff File Expand all files Collapse all files

22
docs/plans/2026-03-18-refactor-progress.md
View File

@@ -35,17 +35,21 @@
**Status: Complete**
Extracted sniff infrastructure from `core/hf_iso15.py` (615→130 lines) into dedicated modules:
- `sniff/trace.py` — `parse_tracelog()`, `TRACELOG_HDR_SIZE` (protocol-agnostic)
- `sniff/ndef.py` — NDEF TLV/record decode (`decode_ndef_annotation()`)
- `sniff/decode_iso15.py` — ISO 15693 command/response decoders, command tables
- `sniff/format.py` — ANSI color formatting, `format_sniff_line()`
- `sniff/session.py` — `SniffSession` with `iso15()` method (replaces `sniff_decoded()`)
- `sniff/__init__.py` — re-exports all public symbols
Extracted sniff infrastructure from `core/hf_iso15.py` (615→130 lines) into two packages:
`core/hf_iso15.py` retains `HF15Commands` (scan/rdbl/wrbl/sniff) and re-exports sniff symbols for backward compat. `download_trace()` and `sniff_decoded()` delegate to `SniffSession`.
**`pm3py/trace/`** — shared trace infrastructure (used by sniff, sim, reader):
- `trace.py` — `parse_tracelog()`, `TRACELOG_HDR_SIZE` (protocol-agnostic)
- `ndef.py` — NDEF TLV/record decode (`decode_ndef_annotation()`)
- `decode_iso15.py` — ISO 15693 command/response decoders, command tables
- `format.py` — ANSI color formatting, `format_sniff_line()`
**65/65 tests passing** (35 sniff tests work through re-exports, no test changes needed).
**`pm3py/sniff/`** — sniff orchestration (consumes trace/):
- `session.py` — `SniffSession` with `iso15()` method (replaces `sniff_decoded()`)
- `__init__.py` — re-exports trace symbols for convenience
`core/hf_iso15.py` retains `HF15Commands` (scan/rdbl/wrbl/sniff) and re-exports trace symbols for backward compat. `download_trace()` and `sniff_decoded()` delegate to `SniffSession`.
**65/65 tests passing** (35 sniff/trace tests work through re-exports, no test changes needed).
## Phase 3 — Scaffold `transponders/`