Skip to content

Releases: dbosk/pytorial

v0.10.1

Choose a tag to compare

@dbosk dbosk released this 21 Sep 08:36
6b8925a

A patch release; nothing changes for tutorial authors or for hosts that embed the CLI.

  • tutorial list stays tab-separated when its output is captured, even with FORCE_COLOR set (#36). Rich reports a terminal under that variable, so scripts piping the list used to get a styled table in environments that export it, some CI systems among them. FORCE_COLOR still colours output as intended.
  • The source distribution is complete (#37). Up to 0.10.0 it held the lessons and no Python module, so a build from it produced an empty package. It now also carries the literate .nw sources, every Makefile, the documentation inputs and the makefiles submodule, so with noweb installed you can unpack it and run make. It is about 210 KB instead of 15 KB.
  • Neither artefact ships a stray tutorials/CLAUDE.md any more (#38). The file was empty in 0.9.0 and 0.10.0.

The wheel's contents are otherwise unchanged: 7 modules and 3 lessons.

What's Changed

  • Keep tutorial list tab-separated when FORCE_COLOR is set by @dbosk in #39
  • Ship a complete sdist and keep stray files out of both artefacts by @dbosk in #40

Full Changelog: v0.10.0...v0.10.1

v0.10.0

Choose a tag to compare

@dbosk dbosk released this 21 Sep 08:04
43940d1

Behaviour change

Output in interactive shell steps now wraps at the reader's terminal width instead of always at 80 columns (#30): the step shell's PTY takes the size of the real terminal and follows resizes.

  • Plain-string required_patterns are unaffected, because matching collapses all whitespace, line breaks included.
  • A regex pattern that matches several words of wrapped program output (argparse help, for instance) with a literal space can stop matching when the line breaks between those words. Use \s+ between words.
  • Scripted shells (run_scripted_shell) stay unsized, so recorded test transcripts do not change.

For hosts that embed the CLI

  • using-tutorials is now self-contained and can be completed in a host that mounts nothing else from pytorial (#27). It has 9 steps; the install step moved to the end of writing-tutorials.
  • The run summary names the command as the host mounted it, for example myhost tutorial review <id> (#31). No new parameter: it comes from the host's own parser.
  • add_typer_subcommand and add_argparse_subcommand keep their signatures.

In-progress runs of using-tutorials and writing-tutorials need --restart, since both lessons changed.

What's Changed

  • Make using-tutorials completable in an embedded host by @dbosk in #28
  • Give interactive step shells the size of the real terminal by @dbosk in #33
  • Name the host's command in the run summary by @dbosk in #34

Full Changelog: v0.9.0...v0.10.0

v0.9.0

Choose a tag to compare

@dbosk dbosk released this 18 Sep 11:58
a865c8a

What's Changed

  • Refuse shell tutorials up front where no POSIX terminal exists by @dbosk in #20
  • Always delegate doc/pytorial.pdf to the doc sub-make by @dbosk in #23
  • Add in-place tutorials that run in the current directory by @dbosk in #18
  • Tidy the blocked-step message and the in-place test fixture by @dbosk in #26

Full Changelog: v0.8.1...v0.9.0

v0.8.1

Choose a tag to compare

@dbosk dbosk released this 11 Sep 08:00
34a31f2

What's Changed

  • Allow embedded CLIs to import pytorial on Windows by @dbosk in #19

Full Changelog: v0.8...v0.8.1

v0.8

Choose a tag to compare

@dbosk dbosk released this 27 Aug 11:34
64606ff

What's Changed

  • Rename the project identity from tutorial to pytorial by @dbosk in #17

Full Changelog: v0.7...v0.8

v0.7

Choose a tag to compare

@dbosk dbosk released this 27 Aug 07:03
220f9f2

What's Changed

  • Defer rich and other heavy imports to their point of use by @dbosk in #16

Full Changelog: v0.6...v0.7

v0.6

Choose a tag to compare

@dbosk dbosk released this 11 May 06:16
6242578

What's Changed

  • Improve tutorial CLI guidance by @dbosk in #14

Full Changelog: v0.5...v0.6

v0.5

Choose a tag to compare

@dbosk dbosk released this 30 Apr 12:32
4977dfd

What's Changed

Full Changelog: v0.4...v0.5

v0.4

Choose a tag to compare

@dbosk dbosk released this 30 Apr 08:13
a046929

What's Changed

  • feature/add step shell hooks by @dbosk in #12

Full Changelog: v0.3...v0.4

v0.3

Choose a tag to compare

@dbosk dbosk released this 29 Apr 07:50
99f1b0a

What's Changed

  • include missing tutorial markdown files in wheel by @dbosk in
    #11

Full Changelog: v0.2...v0.3