Repository navigation
Releases
Releases · abhiksark/pythonlings
v0.4.4
Fixed
- Status output no longer crashes on a console that cannot encode its symbols.
verify,list,runandsolutionraisedUnicodeEncodeErrorunder a
strict ASCII locale or a Windows code page; they now fall back to ASCII
stand-ins (+pass,xfail,>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. doctorno longer raises on a workspace it cannot read. Windows reports an
unresolvable path asERROR_CANT_RESOLVE_FILENAMEwith 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
doctorfailures above went unnoticed. - Failing checks in the
variablesandasynctopics now explain what was
expected instead of raising a bareAssertionError. 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
Added
pythonlings doctorreports 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 todev.
Fixed
- Package metadata now records the author and maintainer.
v0.4.2
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 updatenow prefers the current workspace while preserving explicit--pathand global--rootprecedence. 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
.gitignoreentries, ordering, line endings, and repeated-run idempotency.
Full changelog: v0.4.1...v0.4.2
v0.4.1
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
Added
- Zero-config first run:
pythonlingswith no workspace creates one at~/.pythonlingsand opens the first exercise — noinit, no--path, nocd. PYTHONLINGS_HOMEenvironment variable to point the default workspace somewhere else.
Changed
pythonlings initwith no--pathnow targets~/.pythonlingsinstead of the current directory, so it can no longer fail by landing in a folder full of unrelated files.initis 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
Fixed
pythonlings --versionnow reports the installed package version instead of a separate hardcoded string incli.py(which had drifted to0.3.0). The version is read from package metadata, so it can no longer fall out of sync withpyproject.toml.- Corrected stale
pylingsreferences in the contributor guide (CLAUDE.md): the smoke-test command, manual-testing flows, package paths, stylesheet, and entry point now consistently use thepythonlingsname the project adopted in 0.3.0. (The unrelatedpylingsPyPI package belongs to a different project;pythonlingsis the only command this project ships.)
Full changelog: https://github.com/abhiksark/pythonlings/blob/main/CHANGELOG.md
v0.3.0 — rename to pythonlings
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
pythonlingsoutside a workspace explains how to create one withpythonlings init.
Removed
- Unused
watchdogdependency.
Install: pipx install pythonlings (or uvx pythonlings).
v0.2.0
Support Python 3.9 and 3.10.
- Lower the minimum supported Python from 3.11 to 3.9.
- Fall back to the
tomlibackport wheretomllibis 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
Pylings v0.1
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, andOkeyboard 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.