diskstack 1.0.0__py3-none-any.whl

diskstack-1.0.0.dist-info/METADATA

@@ -0,0 +1,329 @@
+Metadata-Version: 2.4
+Name: diskstack
+Version: 1.0.0
+Summary: Merge several dumps of one floppy disk into the best possible image, and say what is still missing
+Author-email: Christian Bosch <cbosch101@gmail.com>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/Booyaka101/diskstack
+Project-URL: Repository, https://github.com/Booyaka101/diskstack
+Project-URL: Issues, https://github.com/Booyaka101/diskstack/issues
+Project-URL: Changelog, https://github.com/Booyaka101/diskstack/blob/main/CHANGELOG.md
+Keywords: floppy,flux,greaseweazle,supercard-pro,scp,preservation,disk-image,data-recovery,retrocomputing,amiga,mfm
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: System :: Archiving
+Classifier: Topic :: System :: Recovery Tools
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+License-File: NOTICE
+License-File: diskstack/_vendor/greaseweazle/COPYING
+Requires-Dist: click>=8.1
+Requires-Dist: bitarray>=2.9
+Requires-Dist: crcmod>=1.7
+Provides-Extra: test
+Requires-Dist: pytest>=7; extra == "test"
+Provides-Extra: dev
+Requires-Dist: pytest>=7; extra == "dev"
+Requires-Dist: ruff>=0.16; extra == "dev"
+Dynamic: license-file
+
+# diskstack
+
+Merge several dumps of one floppy disk into the best possible image, and get
+told exactly what is still missing.
+
+## The loop
+
+Read the disk twice, stack the dumps, and diskstack hands you back a
+Greaseweazle command that re-reads only the tracks that are still bad:
+
+```
+$ diskstack disk_a.scp disk_b.scp -o merged.img
+
+720 sectors: 714 clean (from 2 files), 6 unresolved
+
+Tracks needing attention
+  cyl  head  clean  voted  unresolved  missing  sector ids still bad
+   17     0      7      0           2        0  4,7
+   18     0      7      0           2        0  4,7
+   19     0      7      0           2        0  4,7
+
+Re-read just these tracks, then run diskstack again with the new capture added:
+  gw read retry.scp --tracks=c=17-19:h=0
+```
+
+Three tracks instead of eighty, so the drive spends seconds on the media
+rather than minutes. Feed the new capture back in:
+
+```
+$ gw read disk_c.scp --tracks=c=17-19:h=0
+$ diskstack disk_a.scp disk_b.scp disk_c.scp -o merged.img
+
+720 sectors: 714 clean (from 3 files), 6 recovered by vote
+Since the last report: 6 recovered.
+
+Every sector confirmed by CRC. Nothing left to re-read.
+```
+
+That run produced a file byte-identical to the original disk image. Repeat
+until the unresolved count reaches zero or stops moving. diskstack reads the
+report it is about to overwrite, so it tells you which of the two happened:
+either how many sectors the new capture recovered, or that nothing changed and
+another pass at the same settings is unlikely to. It also keeps the decoded
+flux, so the second run only decodes the capture you just added: re-running
+the three-capture merge above takes 0.4 seconds against 6.5 the first time.
+The full session is in
+[examples/console-session.txt](examples/console-session.txt) and the report it
+wrote is in [examples/diskstack-report.json](examples/diskstack-report.json).
+
+## Install
+
+```
+pip install diskstack
+```
+
+Python 3.11 or newer. No hardware, no network, no configuration.
+
+Until the PyPI upload lands, `pip install
+git+https://github.com/Booyaka101/diskstack` gets you the same thing.
+
+## Use
+
+```
+diskstack disk_a.scp disk_b.scp disk_c.img -o merged.img
+```
+
+Inputs are two or more dumps of the same disk, in any mix of:
+
+| what | extensions |
+| --- | --- |
+| flux | `.scp` (SuperCard Pro), `.raw` (KryoFlux streams), `.hfe` (HxC) |
+| sector images | `.img`, `.ima`, `.st`, `.adf`, `.imd` |
+
+For KryoFlux, name any one of the per-track stream files and the rest of the
+set is picked up from the directory.
+
+Output is a sector image: `.img`, `.ima`, `.st`, `.adf` or `.imd`. Flux goes in
+but never comes out. Along with it you get `diskstack-report.json` next to the
+image and the table above on stdout.
+
+Formats understood are IBM FM and MFM (PC 160K through 2.88M, Atari ST) and
+AmigaDOS MFM. `diskstack --list-formats` prints the list. Detection is
+automatic; `--format ibm.720` overrides it.
+
+The exit code is 0 when every sector is confirmed and 2 when something is still
+unresolved, so a retry loop can be scripted.
+
+## How it decides
+
+Every sector of every revolution of every input is a separate read attempt.
+Attempts are grouped by the `(cylinder, head, sector id)` in their ID address
+mark, never by where they sit in the flux, because two captures of the same
+disk do not line up: the index phase differs and so does the motor speed.
+
+Per sector, in order:
+
+1. **clean** - an attempt whose own CRC or checksum passes. Taken as is.
+2. **recovered by vote** - no attempt passed, so the attempts get recombined
+   into candidate payloads and the first one that satisfies a check value off
+   the disk wins. Three routes are tried, best evidence first:
+   `majority` votes byte by byte across every attempt, `per_source_majority`
+   collapses each input file to one payload first so a capture with more
+   revolutions cannot outvote the files that read the sector correctly, and
+   `cross_check` tries each individual read as it stands, which is what
+   recovers a sector whose payload was fine and whose own CRC bytes were the
+   damaged part. The CRC bytes came off the same damaged track, so they get
+   voted on too and the voted check value is tried alongside the ones read.
+   Ties go to the dump that read the rest of the disk best. The report says
+   which route it was.
+3. **unresolved** - the vote still failed. The largest cluster of attempts that
+   agree exactly is written out, the sector is listed in the table, and its
+   track goes into the re-read command.
+
+A sector that is good in any input is never worse in the output. There is a
+test for that.
+
+Only a handful of reconstructions are tried, deliberately. A CRC16 accepts the
+wrong payload once in 65536 tries, so every extra candidate thrown at the check
+value buys recovery at the price of a small chance of confidently writing out
+garbage. Three routes that each mean something beats a brute-force sweep over
+the contested bytes.
+
+The check value has to come off the disk, which means a stack of only sector
+images can never reach step 2. `.img` and `.adf` files carry data and nothing
+to verify it with, so identical bytes in two images prove only that both dumps
+read the same thing. Mixing in one flux capture is what gives the vote
+something to check against.
+
+That distinction runs through the whole report. A sector is `verified` when
+some read of it satisfied a check value off the disk, and a merge of sector
+images alone never gets that, so the closing line says the sectors came from
+inputs that carry no check value instead of claiming a CRC confirmed them. A
+sector is `contested` when two dumps both looked good and held different
+bytes. Nothing in a sector image can arbitrate that, so diskstack keeps the
+best-ranked dump's copy, prints which sectors it happened to, and leaves the
+judgement to you. It is what deliberate weak bits look like, and also what two
+dumps of two different disks look like.
+
+A sector the merge could not confirm is marked `unstable` if one capture read
+it two different ways across its own revolutions. That is what weak bits look
+like, and they are usually deliberate, so more passes over the disk will not
+settle them. The stdout note says so next to the re-read command. Two `--pll`
+settings reading one revolution two ways is a different thing, a decode that
+went marginal rather than a disk that moved, and does not count.
+
+Sectors Greaseweazle filled with `-=[BAD SECTOR]=-` are treated as failed
+reads, not as data, so a `.img` from an earlier bad session still contributes
+its good sectors. `--keep-filler` turns that off.
+
+A truncated `.img` or `.adf` contributes only the sectors the file actually
+holds bytes for. The readers pad a short image out to the format's length and
+mark every sector they invented as CRC-clean, so without that check a dump that
+stopped halfway would win the merge with 512 bytes of nothing per sector.
+
+## Options
+
+```
+  -o, --output PATH               Merged sector image to write (.img, .ima,
+                                  .st, .adf, .imd).  [required]
+  -r, --report PATH               JSON report path  [default: diskstack-
+                                  report.json beside the output]
+  --no-report                     Do not write the JSON report.
+  -f, --format TEXT               Disk format, e.g. ibm.720 or amiga.amigados.
+                                  Detected from the inputs when not given.
+  --list-formats                  Print the disk formats diskstack understands
+                                  and exit.
+  --pll SPEC                      Flux PLL settings, e.g.
+                                  period=5:phase=60:lowpass=1.5. Repeat to
+                                  decode each capture several ways and let the
+                                  results compete.
+  --revs N                        Use only the first N revolutions of each
+                                  flux capture [default: all of them]  [x>=1]
+  --keep-filler                   Trust sectors written as '-=[BAD SECTOR]=-'
+                                  filler instead of treating them as failed
+                                  reads.
+  --fill-unresolved [best|filler|zero]
+                                  What to write for a sector no input
+                                  confirmed: its best guess, bad-sector
+                                  filler, or zeroes.  [default: best]
+  --no-vote                       Skip the byte-wise majority vote; keep only
+                                  sectors whose own CRC passes.
+  -j, --jobs N                    Worker processes for decoding flux [default:
+                                  one per core, up to 8]  [x>=0]
+  --cache DIR                     Where to keep decoded flux between runs
+                                  [default: .diskstack-cache beside the
+                                  output]
+  --no-cache                      Decode every flux capture again instead of
+                                  reusing the decode a previous run stored.
+  --retry-name NAME               Filename used in the printed gw read
+                                  command.  [default: retry.scp]
+  -q, --quiet                     Print the summary and the re-read command,
+                                  no tables.
+  -V, --version                   Show the version and exit.
+  -h, --help                      Show this message and exit.
+```
+
+Decoding flux is the slow part, so it runs one track per core by default. A
+three-capture 40-cylinder merge takes about six seconds on eight cores against
+half a minute on one. `--jobs 1` forces the single-process path, which is also
+what happens automatically if the worker pool cannot start.
+
+`--pll` is worth knowing about. Repeating it decodes each flux capture several
+ways, and since two PLL settings disagree about different marginal bitcells,
+they become independent attempts that the vote can use:
+
+```
+diskstack a.scp b.scp -o merged.img --pll period=5:phase=60 --pll lowpass=1.5
+```
+
+It applies to every flux container, `.scp`, `.raw` and `.hfe` alike.
+
+Decoded flux is kept in `.diskstack-cache` beside the output, along with the
+detected disk format, so a re-run only pays for the captures it has not seen.
+An entry is named for a hash of the input's bytes and of every setting that
+changes the decode, which means a fresh dump written over the same filename is
+a new entry rather than a stale hit, and a capture that moved or was renamed
+still counts as one it has seen. `--cache DIR` puts it somewhere else,
+`--no-cache` turns it off, and deleting the directory costs nothing but the
+next decode. It drops its least recently used entries once it passes 512 MB;
+three captures of a 360K disk take 377 KB.
+
+## The report
+
+`diskstack-report.json` carries one entry per sector of the disk: its status,
+how many attempts it got, how many agreed, and which file and revolution each
+contributing read came from. Plus per-input totals and the re-read trackspecs.
+`schema` is versioned and starts at 1.
+
+```json
+{
+  "cyl": 17, "head": 0, "sec_id": 4, "size": 512,
+  "status": "unresolved", "attempts": 6, "good": 0, "agreement": 3,
+  "discarded": 0, "unstable": false, "contested": false, "verified": false,
+  "method": null,
+  "sources": [{"path": "capture_a.scp", "rev": 0}]
+}
+```
+
+`method` names the route that rebuilt a recovered sector and is null for any
+other status. `discarded` counts attempts thrown away because they decoded to
+the wrong length for the sector. `verified` and `contested` are the two above,
+and `totals` counts both across the disk.
+
+`since_last_report` holds the `recovered`, `lost` and `still_bad` counts
+against the report this run replaced, or null on the first run and whenever
+the old report covers a different set of sectors. Each input carries `cached`,
+saying whether its sectors were decoded on this run or reused from an earlier
+one.
+
+## What it does not do
+
+v1 is deliberately narrow. No GCR, so no Apple II and no Commodore. No writing
+flux back out. No hardware access, so nothing here talks to a Greaseweazle
+or a KryoFlux. No copy-protection preservation: this produces sector images,
+which is the wrong container for weak bits and long tracks. No network calls.
+
+## Validation, honestly
+
+The three-capture test builds genuine SuperCard Pro flux from a real PC floppy
+image, damages each capture a different way, gives each its own index phase and
+its own motor speed within 1.5 percent, and asserts the merged output is
+byte-identical to the original. The AmigaDOS codec gets the same treatment one
+track at a time, since the fixture disk is a PC one. That is a real decode of
+real flux through Greaseweazle's own decoders, but the damage is synthetic. It
+has not yet been run against dumps of a genuinely deteriorated disk.
+
+If you have a disk that needs several passes, I would like to see the report.
+Open an issue with the `diskstack-report.json` and what the disk is.
+
+## Tests
+
+```
+pip install -e ".[dev]"
+python tests/fixtures/make_fixtures.py     # downloads 360 KB, writes 55 MB
+python -m pytest tests -q
+ruff check .
+```
+
+The fixture builder needs the network once. Everything else runs offline.
+
+## Built on Greaseweazle
+
+The flux and sector decoders are [Greaseweazle's](
+https://github.com/keirf/greaseweazle), vendored under
+`diskstack/_vendor/greaseweazle` because Greaseweazle is not published on PyPI.
+It is public domain under the Unlicense. `tools/vendor.py` regenerates the tree
+from a pinned commit and applies every local change; `NOTICE` lists them.
+
+Runtime dependencies are `click`, `bitarray` and `crcmod`. The last two are
+what the vendored decoders need.
+
+## License
+
+MIT. See `LICENSE`, and `NOTICE` for the vendored code.

diskstack-1.0.0.dist-info/RECORD

@@ -0,0 +1,119 @@
+diskstack/__init__.py,sha256=ZU5oaRHH7jE5eYXj0ZG0asmB-1Z5rC4dRbNpNxYBVm8,125
+diskstack/cache.py,sha256=h-HGf7IA26PlETg6O7MHmGkmJPfGV_UQ2fkIFkpKZvM,7956
+diskstack/candidates.py,sha256=JWSgyGJk29jk9iGta_jtAiBkuZwYrJpzEcu3WhoDp5U,15987
+diskstack/cli.py,sha256=Aqr9QfhIrmzDiawbxHewGEEs--y1ePBJ1aEGQ3N-KdU,14766
+diskstack/errors.py,sha256=2cBdBva5nbkEZyouny4HEC1hyHyzsdnjPkmU5mdmPpQ,187
+diskstack/filler.py,sha256=h7QUXDOCptWkqSffv6XgOsOBgBBNATTOt34OPttBvvg,1109
+diskstack/formats.py,sha256=A8CVQOKhV6p5KQy5gZszp1fIL5eb341651crPHPB0wo,15645
+diskstack/parallel.py,sha256=TwISTrTf5CIoANWX7WFapNUGdUvi0PpqSAIHVkD-VUA,2690
+diskstack/report.py,sha256=969R5HjjTdOgt8fjvmPap8cbCYUXqZ2Y059BfHDeS9w,14022
+diskstack/stack.py,sha256=qNI6zL-AC5bR3DNItXhIAXto0wcPCN7TROcZO72zu6U,11953
+diskstack/_vendor/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+diskstack/_vendor/greaseweazle/COPYING,sha256=fhLl30uuEsshWBuhV87SDhmGoFCN0Q0Oikq5pM-U6Fw,1211
+diskstack/_vendor/greaseweazle/__init__.py,sha256=WQwc7i6Az4lXTHq87mu07KGYA4q8I86DhEvIPa6Dl9c,107
+diskstack/_vendor/greaseweazle/error.py,sha256=iX0IepFCSzR1pTO9DVVZYA0mBk4U4DovPTspvH76wKo,420
+diskstack/_vendor/greaseweazle/flux.py,sha256=x5YUkf-lZSt-rdpGRtEZE-6eFq0uu0eHg7FpAVWiae8,10940
+diskstack/_vendor/greaseweazle/track.py,sha256=60ArZiY8RwxTtxamnMi7c3FyTzNYOKXRtB7FdRwOiw4,19948
+diskstack/_vendor/greaseweazle/codec/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+diskstack/_vendor/greaseweazle/codec/bitcell.py,sha256=9c2rlwGFK0Z44biRTKSylsc8I3wA0OJEQ9MLQZ2rPg4,3601
+diskstack/_vendor/greaseweazle/codec/codec.py,sha256=aw_KbW3OWGvxv1mZJlrfx0bktv9tfdnywbYZCN15ZuE,13105
+diskstack/_vendor/greaseweazle/codec/amiga/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+diskstack/_vendor/greaseweazle/codec/amiga/amigados.py,sha256=RLsBMw5Jb-lEukC1eByWQojojIAtvsT5tAUCauJsGq0,6725
+diskstack/_vendor/greaseweazle/codec/apple2/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+diskstack/_vendor/greaseweazle/codec/apple2/apple2_gcr.py,sha256=0eDsEi8-f2_rur63EFybdS9KbO7ASAVzhMANzpTyU_8,7053
+diskstack/_vendor/greaseweazle/codec/commodore/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+diskstack/_vendor/greaseweazle/codec/commodore/c64_gcr.py,sha256=bPMf_pAx5fLxTaLcxiMj521W1P8SF8ylls4YyNCuyjg,7345
+diskstack/_vendor/greaseweazle/codec/datageneral/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+diskstack/_vendor/greaseweazle/codec/datageneral/datageneral.py,sha256=RvKUrcUF5QK0JhRGwGtFMoCcBDRIDYGeq9vUXCCz69Q,6962
+diskstack/_vendor/greaseweazle/codec/hp/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+diskstack/_vendor/greaseweazle/codec/hp/hp_mmfm.py,sha256=p8jqwqiLpwEfdKu3EEewiyjWB-HXjFU004JqiBCvC1k,8107
+diskstack/_vendor/greaseweazle/codec/ibm/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+diskstack/_vendor/greaseweazle/codec/ibm/ibm.py,sha256=w_il3GnAZW26LId9X-MSl4DSMIilNNmrV89nUq_RAkw,34932
+diskstack/_vendor/greaseweazle/codec/macintosh/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+diskstack/_vendor/greaseweazle/codec/macintosh/mac_gcr.py,sha256=2Jf9eZhEPhKC-7Wrp6OGmn89hMJGrDuAaEoP1A--h-c,7752
+diskstack/_vendor/greaseweazle/codec/micropolis/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+diskstack/_vendor/greaseweazle/codec/micropolis/micropolis.py,sha256=tnDAiJ5KBaP5FXT5Ef1jf5ySYDbhG7YP8VKubbe1F4I,7707
+diskstack/_vendor/greaseweazle/codec/northstar/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+diskstack/_vendor/greaseweazle/codec/northstar/northstar.py,sha256=M-nldnwo0B-jRveJX1Kgay5Hc29N0OBfRbP6NiAlxgA,6651
+diskstack/_vendor/greaseweazle/data/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+diskstack/_vendor/greaseweazle/data/diskdefs.cfg,sha256=eequJOURVsKk-X6fmvfzFfj8yGIyLtIGtIN6wAtewgs,3448
+diskstack/_vendor/greaseweazle/data/diskdefs_acorn.cfg,sha256=-o9Eu6_vjxhI0CZjGOn5ujLUaFfUFlZyg0brtWHYf-Q,1657
+diskstack/_vendor/greaseweazle/data/diskdefs_akai.cfg,sha256=96wq0X2t3lSDWLG5fOh4yrj2sGypMUGKggyxRKQIjw8,374
+diskstack/_vendor/greaseweazle/data/diskdefs_amiga.cfg,sha256=83IYH8_JwC_hYXkfdlejw3xgOwqCxOXrGLPTo6o5_6I,222
+diskstack/_vendor/greaseweazle/data/diskdefs_apple2.cfg,sha256=JWOklXhZzE8W1mxHpCmDVus0e552mJ1fVE57SpdTJNM,690
+diskstack/_vendor/greaseweazle/data/diskdefs_apricot.cfg,sha256=LYkiw7mmeSZ1GqiJwVh4wQEGWizGmqLlcL9E_Ivvh1I,347
+diskstack/_vendor/greaseweazle/data/diskdefs_atari.cfg,sha256=YwMHbbhWTSD0O17Z1hXsVH2evunvQR3avqUC3DR9YZk,442
+diskstack/_vendor/greaseweazle/data/diskdefs_atarist.cfg,sha256=B1bwX8GASwY5S4N_fHQUBQ8cC_ujP06lMw-F4IKMvC0,1035
+diskstack/_vendor/greaseweazle/data/diskdefs_coco.cfg,sha256=eNwkP7lPNGUZMBrpLXNOeNwCCp-A3rYgCayuuJUh6kk,1474
+diskstack/_vendor/greaseweazle/data/diskdefs_commodore.cfg,sha256=2eX6fgesLyAClkS2UV2naR1NjPw9_kCjUh9qFRxSPvo,1986
+diskstack/_vendor/greaseweazle/data/diskdefs_datageneral.cfg,sha256=O_nbKIbKYK7WZTPKYN5r7m9ZkIryRC79KlLqRxDKn-g,101
+diskstack/_vendor/greaseweazle/data/diskdefs_dec.cfg,sha256=JN084FacPBXyPeKr8ke04bf_veHsMWtLn_2pK1LXDj4,575
+diskstack/_vendor/greaseweazle/data/diskdefs_dragon.cfg,sha256=M5Cu5_RfRhdCQ_tWlfDVLXJt1JEThWjt4JadBuLMXQo,890
+diskstack/_vendor/greaseweazle/data/diskdefs_eagle.cfg,sha256=6ZB0BRYLULkv2LIVVUeHN1vPII92mIOPYKwO_ZMbtds,331
+diskstack/_vendor/greaseweazle/data/diskdefs_ensoniq.cfg,sha256=Fsa41MjiTJeDmzY4syIdnd8Gh8RXIjPwJ4tRAfD3hfo,603
+diskstack/_vendor/greaseweazle/data/diskdefs_epson.cfg,sha256=a8w_diUD8N246PUWj3EPMPf6Codh12qIEcuj8DtrCP0,1735
+diskstack/_vendor/greaseweazle/data/diskdefs_gem.cfg,sha256=MgEnLPouLpnD9NooBUIZePh7OjZpjmgxCLw-a5KQpzk,227
+diskstack/_vendor/greaseweazle/data/diskdefs_hp.cfg,sha256=lyhIrAmN4BFsGc0OFOWyjmYGmE0FGFKk35ylrAs0sgU,393
+diskstack/_vendor/greaseweazle/data/diskdefs_ibm.cfg,sha256=PvUVaLNs5fFEa7z4lWMCqIoRBOePAZX0WmInT5KiZWg,2038
+diskstack/_vendor/greaseweazle/data/diskdefs_kaypro.cfg,sha256=osHT7EyIjyZ1Frd_Zh3KnkpPqD_NMQjbr8VqdDt8g8k,762
+diskstack/_vendor/greaseweazle/data/diskdefs_luxor.cfg,sha256=TUZIGdiIe46JilQmp-44iFL12K0TPYph1lvb2zQ51Jc,1348
+diskstack/_vendor/greaseweazle/data/diskdefs_mac.cfg,sha256=nhFqsAkWCm8Cgvkbq4SvFQykEuwYXsdni-JsW2G0VeE,1255
+diskstack/_vendor/greaseweazle/data/diskdefs_micropolis.cfg,sha256=PeHM3pUxYGwMVc5NWVOT2-lsYUGXeC6NXdr7T6AqgFM,1042
+diskstack/_vendor/greaseweazle/data/diskdefs_mm1.cfg,sha256=lDwnY4yJHRuR-OrqEoiC1bsN-ccroava0d5j4O07mvk,1143
+diskstack/_vendor/greaseweazle/data/diskdefs_msx.cfg,sha256=_msxB-vcSGUl_j94zqeGvgkgKXKLvSA6w7dVh1iHBqU,585
+diskstack/_vendor/greaseweazle/data/diskdefs_northstar.cfg,sha256=P09c66m2mHs87Y-v95VEAju6UuQcYrAMeFQTz8POiUQ,493
+diskstack/_vendor/greaseweazle/data/diskdefs_occ1.cfg,sha256=WfjsOiQWXVrrnybOhn3017pAF40csnkeTtHcNiWpaMM,305
+diskstack/_vendor/greaseweazle/data/diskdefs_olivetti.cfg,sha256=CU61ghIg89DyyGNn0_wC6r-cf21s_xJ6CKKe99wzCU4,286
+diskstack/_vendor/greaseweazle/data/diskdefs_pc98.cfg,sha256=_y1XZCOUBloEmgKF5dm-VO3Qzqw1sxkspOxjZDBeLxA,994
+diskstack/_vendor/greaseweazle/data/diskdefs_raw.cfg,sha256=qgFZJzZqqGDwKU9c9DjckNtJpGHfhOuuDOrxzSo6vFo,374
+diskstack/_vendor/greaseweazle/data/diskdefs_rm.cfg,sha256=rA0OjCacR3Wps5MzSBY723nPObMYEEMkqvrAr9NAbe0,1810
+diskstack/_vendor/greaseweazle/data/diskdefs_sci.cfg,sha256=R4LKnz1N_f80bYJoqicvNqnP355fFCXxiv7hMB20Q0E,290
+diskstack/_vendor/greaseweazle/data/diskdefs_sega.cfg,sha256=Oz0OBtobWxn1kE4fvFi4QvKaKZKb7Jp-ery0hJ4cxhc,178
+diskstack/_vendor/greaseweazle/data/diskdefs_sharp.cfg,sha256=jK5c50KVX0sfF0SGnX-hvivyWQvIyS3qS-mcF8w7kRU,178
+diskstack/_vendor/greaseweazle/data/diskdefs_thomson.cfg,sha256=MUEcT99wrVif5IXq0gNQC9dr15SB3cQ8y4sThKus5f0,1476
+diskstack/_vendor/greaseweazle/data/diskdefs_tsc.cfg,sha256=AIKsFqNYC-p2fpNkkcOBD34C_syVCtqX7KXJABjT1Lo,1529
+diskstack/_vendor/greaseweazle/data/diskdefs_xerox.cfg,sha256=KPfA1yzymL29zuDTpfkmtBKglaqJ9peErbkZyxbPZc4,951
+diskstack/_vendor/greaseweazle/data/diskdefs_zx.cfg,sha256=BtgWO6IZNgq6HxeWxepESAojv9HNXyUxrS_FBErl2_Y,3295
+diskstack/_vendor/greaseweazle/image/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+diskstack/_vendor/greaseweazle/image/a2r.py,sha256=0jLiLgpTdD8iaeTMjxIlTnmDCnTZS4MSXC3c1FLlW7M,3536
+diskstack/_vendor/greaseweazle/image/acorn.py,sha256=Qd-UltEDDQokjuoNmaglPutFFZnEgmjeM4k8zCsp9Ac,644
+diskstack/_vendor/greaseweazle/image/adf.py,sha256=BoOZpsQqm3JP8O-7S6ECeFioQ2oB0NCtwPpk0K57mkw,396
+diskstack/_vendor/greaseweazle/image/apple2.py,sha256=toCQz5-_7N-AhtksmKuwQ7yzujwdvzBdWw51gg7cY8I,460
+diskstack/_vendor/greaseweazle/image/apridisk.py,sha256=edJsZrSQgFlTz9vbvLxArBsv35ebcabcUfLbC2rIK9g,3903
+diskstack/_vendor/greaseweazle/image/caps.py,sha256=mUYxDSnY49vXlTmY_gS4tJbSGYj5aqU3xPA3hP4bFOU,15932
+diskstack/_vendor/greaseweazle/image/d64.py,sha256=ikyCHGI7-wEyLJg842N4Cgu7ZWn9Ax20m4zJ2OQ52ak,1656
+diskstack/_vendor/greaseweazle/image/d81.py,sha256=OGQ3oi9RslS5GCQueM4rDRPLoY3tBCld6u3uumpHYEE,688
+diskstack/_vendor/greaseweazle/image/d88.py,sha256=TElUF3uYLVgfnR1PU9RSbooEqO3_Uuhuxe4jinhWBsc,7277
+diskstack/_vendor/greaseweazle/image/dcp.py,sha256=yIoRhzMmT2mKKQZPOF_X0aR4MPOq7MLgRXSeM3ZojEU,1253
+diskstack/_vendor/greaseweazle/image/dim.py,sha256=87B_TkqAMNuQRHyeY8UMoLE_BAZfR-SmA8_m142a6ao,1463
+diskstack/_vendor/greaseweazle/image/dmk.py,sha256=oBI5XtDmVYWtQeYgBxOJGPqlDdt22spPRjZehOYpfbY,6214
+diskstack/_vendor/greaseweazle/image/dsk.py,sha256=iKrdp3F8F9R2M9FlZ_bIUAq5kKXjCSgl0-OtjNgDZdg,985
+diskstack/_vendor/greaseweazle/image/edsk.py,sha256=sYFhZcyuraIudTZkx6zQWlwQxhgBGbpzHqoH8gDjY24,23782
+diskstack/_vendor/greaseweazle/image/fd.py,sha256=KhJ71Atxg39jJ9ifdqTyvvctfHBQ2lZyL3MMPxA6DXA,838
+diskstack/_vendor/greaseweazle/image/fdi.py,sha256=IPTAM1zAAuEt6Gfp5Z6lxJyVxJsLzMTLyBnC5-mMqOo,1450
+diskstack/_vendor/greaseweazle/image/hdm.py,sha256=EhtOGL-_xTTGwEp2DAou-xsL3MjeUReQDxYCNppCfY0,390
+diskstack/_vendor/greaseweazle/image/hfe.py,sha256=CGEUSkbONCvLP6TbgPplWYdKpbbe1aUlFMqbbXK2WiM,27175
+diskstack/_vendor/greaseweazle/image/image.py,sha256=bzNrSc8ddIQbDTNvgXmp0Dgl4AMKTxYci1D-UxJmkds,4292
+diskstack/_vendor/greaseweazle/image/imd.py,sha256=URLenkW6fh84vxbSNZg9Yd8bX86O2o7rOdlHo_aEHOA,6761
+diskstack/_vendor/greaseweazle/image/img.py,sha256=BVCRpN0su55z4OiISpbAlClaVb-ghCgjpsc0P0An2rA,3340
+diskstack/_vendor/greaseweazle/image/kryoflux.py,sha256=vkr2NB0jXrlTlFN0xBJZg58ZWL6UvQvcE2tilhchYUk,9826
+diskstack/_vendor/greaseweazle/image/mgt.py,sha256=EqoUOpMiQ9AmAgY24HUTxdV1nLFj1FnIBRQIdtTwLNk,389
+diskstack/_vendor/greaseweazle/image/msa.py,sha256=ixEIBlMu_7lwOn-4ssxnCkzF-HCceaMw9NcnzRdPgSY,5464
+diskstack/_vendor/greaseweazle/image/nfd.py,sha256=Il2-ZcZj1kBD7WVxEkX7M3x6XrFPVd2F7180nN1w7HI,4660
+diskstack/_vendor/greaseweazle/image/nsi.py,sha256=LPQ3XDhWIptAUypLNuvDL1TjqDq2qQNrAzTjml7Kahk,1274
+diskstack/_vendor/greaseweazle/image/scp.py,sha256=UO7MyqOm4huXJKa6Fwrc2qFZLrJ-xVk0WWTJJofYHmU,16891
+diskstack/_vendor/greaseweazle/image/sf7.py,sha256=gOR1D0BBmiFALJ-zkEihNIpZEZzd4RxLqwhK-BrCeXw,393
+diskstack/_vendor/greaseweazle/image/sharp2d.py,sha256=VkAVCtzAVj5liDv34lKfKzQPdD4gnz-ftE80CNmx4O4,398
+diskstack/_vendor/greaseweazle/image/td0.py,sha256=DogtiUJgmK-b5z5foTv6wVnQj0xQ63GtT-4tifKzGtE,5031
+diskstack/_vendor/greaseweazle/image/xdf.py,sha256=tvtKBBB5qwVWBxoGX0KA1C6wtoWM8u2159g7vqKXQ3E,390
+diskstack/_vendor/greaseweazle/optimised/__init__.py,sha256=fixsy0ziIuGEx9cTHs0ubxe0IBW90C6tFZLP8uTE0jA,522
+diskstack/_vendor/greaseweazle/tools/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+diskstack/_vendor/greaseweazle/tools/util.py,sha256=mbvAf1ySO68pbgz_nQqDG6I8WQsLt96P-7x8UgrcZRU,4714
+diskstack-1.0.0.dist-info/licenses/LICENSE,sha256=uf44leV1GCW7pqMmbDtnSEARGNLN6k_er7NOzwP1zZA,1072
+diskstack-1.0.0.dist-info/licenses/NOTICE,sha256=SXxJ2QAHgRlt7dOP2m3edrWoRovcxOp8-YUjw-E4FII,2664
+diskstack-1.0.0.dist-info/licenses/diskstack/_vendor/greaseweazle/COPYING,sha256=fhLl30uuEsshWBuhV87SDhmGoFCN0Q0Oikq5pM-U6Fw,1211
+diskstack-1.0.0.dist-info/METADATA,sha256=3b8b-g09OORQFFKQ0rS94qE5OnrbEMKm0Wd33pDVcPw,15164
+diskstack-1.0.0.dist-info/WHEEL,sha256=YVMoNqKzERt-wjUZwJ33xBGAwnFl-4cqbYkTtWa4itE,91
+diskstack-1.0.0.dist-info/entry_points.txt,sha256=yXB56_Aa3eeNz3oumReSQEV-XBR3kmDJ7B2gvKFE2o0,49
+diskstack-1.0.0.dist-info/top_level.txt,sha256=x2MhHA534oHwVVdaqAhJpImQmD61VsNjbDqHiIYEKEc,10
+diskstack-1.0.0.dist-info/RECORD,,

diskstack-1.0.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (84.0.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

diskstack-1.0.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+diskstack = diskstack.cli:main

diskstack-1.0.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Christian Bosch
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

diskstack-1.0.0.dist-info/licenses/NOTICE

@@ -0,0 +1,55 @@
+diskstack bundles part of Greaseweazle.
+
+    https://github.com/keirf/greaseweazle
+    commit 26690f89967d519e0106ab9566019a026b920bb4 (master, post-v1.23)
+
+Greaseweazle is released into the public domain under the Unlicense. The full
+text is in diskstack/_vendor/greaseweazle/COPYING.
+
+Greaseweazle is not published on PyPI, so its flux and sector decoders are
+vendored rather than depended on. tools/vendor.py regenerates the whole tree
+from that commit; nothing under diskstack/_vendor/ is edited by hand.
+
+What is vendored: src/greaseweazle/ minus usb.py, cli.py and tools/. TrackSet,
+range_str and columnify are extracted from tools/util.py into a standalone
+module because the rest of that file drives the USB hardware and needs
+pyserial.
+
+Local changes, all applied automatically by tools/vendor.py:
+
+  * imports rewritten from `greaseweazle.*` to
+    `diskstack._vendor.greaseweazle.*`
+
+  * greaseweazle/__init__.py is generated. It carries the vendored commit as
+    __version__ and imports codec.codec, because codec/codec.py imports every
+    codec at module scope and those codecs import back into codec.ibm.ibm, so
+    importing e.g. image.imd first lands on a partially-initialised module.
+    Upstream never hits this because its CLI always reaches codec.codec first.
+
+  * codec/ibm/ibm.py: the two `print("Unknown mark %02x")` warnings are
+    dropped. Damaged tracks produce them constantly and they would corrupt the
+    table diskstack prints on stdout.
+
+  * optimised/__init__.py: the two warnings about the missing C extension are
+    dropped, for the same reason. The pure-Python fallback is used and is fast
+    enough (about 75 ms per three-revolution track).
+
+  * image/imd.py: the reader now records the per-sector data-error flag
+    (rec & 4) and the data-unavailable code (rec == 0) as a failed CRC instead
+    of discarding both. An IMD full of error sectors is exactly the input
+    diskstack exists to merge.
+
+  * tools/util.py: TrackSet.TrackIter gets an __iter__ returning itself. An
+    iterator has to be iterable, and Python 3.13 enforces it, so without this
+    every `for track in diskdef.tracks` raises TypeError there.
+
+  * codec/codec.py: importlib.resources.open_text is replaced with
+    importlib.resources.files(...).joinpath(...).open(), which is the form
+    that still works once the package is installed as a wheel.
+
+The test fixtures download Transylvania.img from the fluxfox test corpus:
+
+    https://github.com/dbalsom/fluxfox/tree/main/tests/images/transylvania
+
+See the LICENSE.txt in that directory for its terms. Nothing from it is
+redistributed here; tests/fixtures/make_fixtures.py fetches it on demand.

diskstack-1.0.0.dist-info/licenses/diskstack/_vendor/greaseweazle/COPYING

@@ -0,0 +1,24 @@
+This is free and unencumbered software released into the public domain.
+
+Anyone is free to copy, modify, publish, use, compile, sell, or
+distribute this software, either in source code form or as a compiled
+binary, for any purpose, commercial or non-commercial, and by any
+means.
+
+In jurisdictions that recognize copyright laws, the author or authors
+of this software dedicate any and all copyright interest in the
+software to the public domain. We make this dedication for the benefit
+of the public at large and to the detriment of our heirs and
+successors. We intend this dedication to be an overt act of
+relinquishment in perpetuity of all present and future rights to this
+software under copyright law.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY CLAIM, DAMAGES OR
+OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
+ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
+OTHER DEALINGS IN THE SOFTWARE.
+
+For more information, please refer to <http://unlicense.org/>

diskstack-1.0.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+diskstack