v7.7.4: Rapid input

Bugfix update to allow for faster/instant input that tends to come from external scanners.

Bugfixes

• Fix rapid input to _GetchLinux (@SebWalter, #159)

v7.7.3: Maybe Windows input will work now

This version primarily updates the Windows getch mapping, so things like arrow keys should work more consistently across machines. s/o @Moeefa!

Fixes

• Update windows platform specific key codes (@Moeefa, #153)

v7.7.2: The smallest update

This is mostly to bump documentation versions, as there are a few important clarifications in there.

---

Additions

• Stop allowing selection of closed Collapsible's items (337e780)
• Clarify some documentation

🚀

v7.7.1: Minor fixes pt.2

Really small update this time, mostly dealing with long-standing issues. Haven't had the time to work on any programming for a minute (a multiple-month spanning minute, at that), so apologies for it taking so long.

Additions

• Add support for wide characters

Bugfixes

• Fix inline widget referring to hover mouse mode

---

🚀

v7.7.0: Minor fixes

Changelog

Additions

• Add support for Button submit on carriage return (#127, 0cdcc91)

Bugfixes

• Fix sluggish and unreliable text input caused by getch_timeout (74f72df)

🚀

v7.6.0: Fix 'er up!

Minor release to allow building our documentation.

Changelog

Bugfixes

• (temporarily) Fix hyperlinks breaking SVG exports

Removals

• Remove (undocumented) shortening behaviour from Button (#124)

  Normally this would be considered an API breaking change, but since it was never documented (and didn't even work properly in most scenarios) it's only a minor-level change.

v7.5.0: Windows mouse support!

The standout feature from this update is finally getting windows mouse support working, courtesy of @Tired-Fox!

Changelog

Additions

• Add support for Windows' mouse events (@Tired-Fox, #122)
• Add support for feeding input into getch

Refactor

• Allow immediately halting WindowManager programatically by not blocking on getch calls

Bugfixes

• Fix mouse event handlers not getting cleaned up properly

v7.4.0: Long overdue!

Lots and lots of things have happened since my previous time writing a release like this. It will all make sense soon (you can check my PyPi for a sneak peak!), but for the time being there's some changes to document.

Changelog

Additions

• Add meta tokens for saving & restoring styles (bcf0a2e)

  This adds the new meta tokens #stash, #pop and their clearing-variants #stash/ and #/pop, which allow you to save a snapshot of the currently applied styles and restore it at a later point within the same markup.

  It can be super useful for when you want to insert special styles for a single word.

  [bold 141]This is an example with a [#stash/ @black grey]code-snippet [#/pop] in the middle.

• Add support for alt/ctrl+backspace to remove whole words (@i404788, #109)

• Add support for word move actions (Ctrl/Alt+/) & Home/End move (@i404788, #109)

Bugfixes

• Fix multiline Label widget to incorrectly display message with hyperlink (@leonard-IMBERT, #108)
• Fix input errors when alert is open (@qoft, #115)

Miscellaneous

• Add readme and changelog to sdist (@thewchan, #102)

v7.3.0: Document this!

The primary focus for this release is the new documentation, but there is a lot of minor changes that slipped through in the meantime. The new documentation is great; it has much more in-depth content on most parts of the library, it looks amazing and it's a lot less of a hassle to maintain! It also has build-time screenshot generation using this very module, so all the SVGs will always remain up to date.

Changelog

Additions

• Add support for SHIFT+ scroll events (74722db)
• Add shade number indicators to Palette.print (06f2ec7)
• Add inline widget runner (ba19d36)

Bugfixes

• Fix incorrect macro caching behaviour (321f1f9)
• Fix various issues and misbehaviours with SVG exports
• Fix incorrect placement of InputField cursor (7281c57)

Refactors

• New MkDocs based documentation

  While the previous documentation was alright, it missed a lot of things. MkDocs makes it a bit easier to create step-by-step style documentation pages, which was exactly what we needed. We also made use of Termage to make it a lot more dynamic.

• Change terminal.py -> term.py and serializer.py -> serialization.py to avoid naming conflicts (e38603e)

• Improve pseudo token behaviour by parsing it as a new token type (f19b897)

• Start generating semantic colors (success, warning, error) by blending with the primary (2daee90)

Removals

• Remove is_bindable widget attribute (866cd09)

  This was only used as an arbitrary limitation, one that was not needed in the library.

Showcase

v7.2.0: Palettes and #auto!

This version brings the long-awaited (at least by myself) color palette system!

Before that, the new #auto TIM pseudo-tag deserves a mention. It makes the parser look at the currently applied background color, and it is replaced with a color that properly contrasts it while parsing! This way, [alias #auto]Text, will always be legible, regardless of the meaning of alias. It is also automatically used by all widget styles (whenever there is no foreground specified), so you can just define a style as @surface+1, and PTG will make sure it looks nice and readable!

Anyways, the palette. Here is the gist of it:

• The new module palettes provides a Palette class
• This class can generate mashing colors from just one primary color input, with multiple possible strategies
• The whole module now has a default palette that can be accessed using ptg.palette and in markup

TIM gains the following sets of new aliases:

• primary
• secondary
• tertiary
• accent
• surface
• surface2
• surface3
• surface4
• success
• warning
• error

Each color has 7 shades, and each shade a foreground and background variant. The base color (i.e. with no shade modifications) use the name as written above, and every other alias is defined as {name}{+/-}{shade_amount}, like primary-3 for the darkest shade of primary, and surface+2for the second-brightest surface shade. Each alias comes complete with a background variant bound to@{alias}`, such as @secondary+2.

It's easier to show than tell, so here is the new default palette, as exported by ptg --palette --export-svg <filename>:

Changelog

Additions

• Add various color manipulation utilities
• Add #auto TIM pseudo-tag that always gives properly contrasted foreground text
• Add palettes module for framework-wide color generation & configuration
• Add Synchronized Output support
• Add FancyReprWidget
• Add ptg --palette flag

Bugfixes

• Fix markup aliases getting literalized during parsing.eval_alias & MarkupLanguage.alias
• Fix background colors creating vertical seams in SVG exports
• Fix colors getting localized pre-maturely

Refactors

• Make all the ptg program & all builting widgets use the global palette
• Prefix all ANSI colors with ansi-

Showcase

Here is my home-grown project launcher, lens, using the new default color palette (and an upcoming new button widget, but that's for the next release notes):

...and now, using it's custom-defined palette, using the primary color #58A46F:

Here is ptg in the new default color palette:

...and now with a bunch of randomly generated ones: