Skip to content

Releases

v0.4.4

Choose a tag to compare

@abhiksark abhiksark released this 21 Aug 04:06

Fixed

  • Status output no longer crashes on a console that cannot encode its symbols.
    verify, list, run and solution raised UnicodeEncodeError under a
    strict ASCII locale or a Windows code page; they now fall back to ASCII
    stand-ins (+ pass, x fail, > current, - locked) and keep the Unicode
    glyphs where the console supports them. Captured check output is degraded the
    same way rather than raising, since every check prints its own status line.
  • doctor no longer raises on a workspace it cannot read. Windows reports an
    unresolvable path as ERROR_CANT_RESOLVE_FILENAME with no matching errno, so
    it escaped the symlink-loop and missing-path branches and crashed the command
    whose purpose is describing a broken workspace.
  • Navigation bindings stay reachable in narrow terminals. Below 70 columns the
    footer hides the command-palette key and puts Topics, Docs and Quit first, so
    they are no longer clipped off-screen at 40 columns.
  • Readme images now use absolute URLs, so they render on the PyPI project page
    instead of appearing as broken links.

Changed

  • Continuous integration runs on Windows and macOS as well as Linux. Nothing in
    the project had previously executed on Windows, which is why the encoding and
    doctor failures above went unnoticed.
  • Failing checks in the variables and async topics now explain what was
    expected instead of raising a bare AssertionError. Together with the
    messages added in 0.4.3, checks/async/ no longer has a single unexplained
    assertion.
  • Curriculum conventions are documented in CONTRIBUTING.md, and new exercises
    can be proposed through a discussion form rather than the issue tracker.

v0.4.3

Choose a tag to compare

@abhiksark abhiksark released this 20 Aug 15:47

Added

  • pythonlings doctor reports a read-only diagnostic across the interpreter,
    package metadata, workspace layout, manifest, reference solutions, progress
    state, reset snapshots, and bundled documentation.
  • An Exercise Proposals discussion form, so anyone can propose a new exercise
    without needing issue-tracker permissions.
  • Community links for the BangPypers Discord and GitHub Discussions.
  • Curriculum conventions are now documented in CONTRIBUTING.md: the
    five-artifact sync, the completion marker's semantics, and the rules for
    writing checks.

Changed

  • Refreshed the project branding, and replaced the static Readme hero with an
    animated banner that performs the exercise loop it describes.
  • Added actionable failure messages to 58 assertions across 20 check files, so
    a failing exercise explains what was expected instead of raising a bare
    AssertionError.
  • Continuous integration now runs on Python 3.9 and 3.10 as well, matching the
    versions the package declares support for, and runs on pushes to dev.

Fixed

  • Package metadata now records the author and maintainer.

v0.4.2

Choose a tag to compare

@abhiksark abhiksark released this 16 Aug 20:26
ade3c83

Pythonlings v0.4.2 is a patch release focused on safer workspaces, clearer failures, and refreshed project guidance.

Changed

  • Refreshed the project branding, screenshots, terminal demo, and contributor guidance.

Fixed

  • pythonlings update now prefers the current workspace while preserving explicit --path and global --root precedence. Missing and invalid targets are not created or modified.
  • Invalid, unreadable, and unsafe manifests now produce contextual command-line errors without Python tracebacks.
  • Workspace initialization and updates preserve custom .gitignore entries, ordering, line endings, and repeated-run idempotency.

Full changelog: v0.4.1...v0.4.2

v0.4.1

Choose a tag to compare

@abhiksark abhiksark released this 21 Jun 14:41
b77ae01

Additive TUI polish on top of v0.4.0 (patch, not a milestone bump).

Added

  • First-launch welcome screen explaining the edit → save → advance loop and key shortcuts (shown once).
  • Overall curriculum progress shown in the TUI alongside per-topic progress.
  • A celebration screen when the whole curriculum is complete.

Fixed

  • Finishing a single topic no longer shows the whole-curriculum "All exercises complete" header.

v0.4.0 — zero-config first run

Choose a tag to compare

@abhiksark abhiksark released this 20 Jun 08:11
047694c

Added

  • Zero-config first run: pythonlings with no workspace creates one at ~/.pythonlings and opens the first exercise — no init, no --path, no cd.
  • PYTHONLINGS_HOME environment variable to point the default workspace somewhere else.

Changed

  • pythonlings init with no --path now targets ~/.pythonlings instead of the current directory, so it can no longer fail by landing in a folder full of unrelated files.
  • init is now idempotent on an existing workspace (a friendly note instead of an error), and its non-empty-directory error explains how to proceed.
  • Every command resolves its workspace the same way: an explicit --root, then the current directory if it is a workspace, then ~/.pythonlings.

Full changelog: https://github.com/abhiksark/pythonlings/blob/main/CHANGELOG.md

v0.3.1

Choose a tag to compare

@abhiksark abhiksark released this 20 Jun 06:34
d58a92a

Fixed

  • pythonlings --version now reports the installed package version instead of a separate hardcoded string in cli.py (which had drifted to 0.3.0). The version is read from package metadata, so it can no longer fall out of sync with pyproject.toml.
  • Corrected stale pylings references in the contributor guide (CLAUDE.md): the smoke-test command, manual-testing flows, package paths, stylesheet, and entry point now consistently use the pythonlings name the project adopted in 0.3.0. (The unrelated pylings PyPI package belongs to a different project; pythonlings is the only command this project ships.)

Full changelog: https://github.com/abhiksark/pythonlings/blob/main/CHANGELOG.md

v0.3.0 — rename to pythonlings

Choose a tag to compare

@abhiksark abhiksark released this 18 Jun 15:53
10e6bb0

First release under the pythonlings name (formerly python-learnings; CLI was pylings).

Added

  • F5 in-app reference now bundles a second complementary section per topic (~3× more offline content).

Changed

  • Renamed project, PyPI package, CLI command, and Python package to pythonlings. Existing workspaces migrate automatically (.pylings/ → .pythonlings/, preserving progress).
  • README/quick-start now describe the built-in editor accurately.

Fixed

  • Running pythonlings outside a workspace explains how to create one with pythonlings init.

Removed

  • Unused watchdog dependency.

Install: pipx install pythonlings (or uvx pythonlings).

v0.2.0

Choose a tag to compare

@abhiksark abhiksark released this 30 May 12:28

Support Python 3.9 and 3.10.

  • Lower the minimum supported Python from 3.11 to 3.9.
  • Fall back to the tomli backport where tomllib is unavailable.
  • type_hints4/8 and itertools8 carry small forward-compat shims so their modern syntax/stdlib usage runs on 3.9-3.10; the learner's task is unchanged.

v0.1.0

Choose a tag to compare

@abhiksark abhiksark released this 30 May 10:50

Initial release.

Pylings v0.1

Choose a tag to compare

@abhiksark abhiksark released this 25 May 12:30

Added

  • Interactive Textual coding workflow with topic picker, resume state, hints,
    reset, and automatic check reruns.
  • CLI commands for listing topics, running exercises, printing hints, resetting
    files, and verifying curricula.
  • 292 Python exercises across 31 topics with mirrored hidden checks.
  • Bundled local Python documentation snippets generated from official docs.
  • In-app documentation modal with F5, Esc, and O keyboard flow.
  • Contributor guide, screenshots, release flow notes, and MIT license.

Verified

  • Full test suite: 105 passed.
  • Curriculum/docs audit: every exercise has a configured docs URL and a bundled
    local snippet.