Skip to content

0.3.0

Choose a tag to compare

@dmccoystephenson dmccoystephenson released this 02 Oct 03:33
· 47 commits to main since this release
053552f

0.3.0

Upgrading from v0.2.0 needs no code changes, and existing saves load exactly as before. Two error messages now also say what to do about the error, and bundle builds now warn when an extraFiles entry is missing. The original wording is still at the start of each changed error message, so checks that use startswith or in on it keep working.

Changes

Clearer errors

  • SaveFileManager.get_save_path() called before a slot is selected still raises ValueError starting with "No save slot selected". The message now also names the requested file and tells you to call select_save_slot(n) first or to open the game with tak.saves.chooseSlot() (#8, #11).
  • createUserInterface() with an unsupported type still raises ValueError starting with "Unsupported UI type: ". The message now also lists every accepted tak.ui.UIType member, which helps when a caller passes the enum's value (e.g. "console") or misspells a name (#8).

Web bundles

  • tak.web.bundle.build() still skips extraFiles entries that don't exist. It now prints a warning to stderr for each one, naming the entry and the root directory, so a mistyped path shows up at build time (#12).

Version

v0.2.0 → 0.3.0 — MINOR. Mechanical floor from comparing the package's public surface and save paths: MINOR.
Judgment: None of the changes break consumers. Save paths, slot layout and the format of save files are unchanged. The flagged change in saves/manager.py only rewrites the ValueError text, and the new text still opens with "No save slot selected". The createUserInterface error still opens with "Unsupported UI type: ". Only a caller that compares the whole message for exact equality would notice, and these strings are not a documented contract. bundle.build now writes a stderr warning for each missing extraFiles entry, which is new user-visible behaviour, so the release stays at the minor floor.

  • minor: save path changed: src/tak/saves/manager.py

Verification

Verified before publication; this tag points at the exact commit that was verified.

  • tests gate run: the library's own suite at this commit — Python 3.8: 150 passed in 11.51s; Python 3.12: 150 passed in 11.52s (8 assertions passed).
  • save-compatibility gate run: saves written by v0.2.0 and the curated fixture were read by this release twice with every file byte-identical, and a new save was added beside them without touching them (18 assertions passed).
  • consumers gate run: Tidewater (106 passed in 0.55s), Overwinter (45 passed in 0.74s), FishE (923 passed in 51.49s) — each one's own test suite, green on its current pin — passed with this release (12 assertions passed).

Install: pip install "tak @ git+https://github.com/Stephenson-Software/tak@v0.3.0". What the checks cover: python-release-gates.


drafted by Claude on behalf of Daniel Stephenson