adding PageLayout and examples

[FoamyGuy]

A new type of layout that allows you to organize your UI into pages that you can change between using name, index, or prev/next functions.

[rsbohn]

Consider adding a property to retrieve the current page content:

showing_page_content -> Displayable

Make it easy for the user to retrieve the object they added using add_content() without any wrappers.

The user shouldn't need to know about _page_group and sub_view_obj, these are implementation details.

[FoamyGuy]

Consider adding a property to retrieve the current page content:

showing_page_content -> Displayable

Make it easy for the user to retrieve the object they added using add_content() without any wrappers.

The user shouldn't need to know about _page_group and sub_view_obj, these are implementation details.

Good idea, I like that functionality. Thanks for trying this out and suggesting improvements. I'll add another commit with this new property

[FoamyGuy]

Also I like the idea of a Displayable typing protocol (I think that is the right term). Lots of functions can accept this type of argument. Originally TileGrid and Group were the only that existed but now the vectorio shapes exist and are similar. Having this type defined somewhere will allow us to more easily update it if we end up adding any more types that can be shown directly like this.

[FoamyGuy]

Latest commit adds the showing_page_content property as well as an illustration of it's usage in the advanced example script

[FoamyGuy]

Not sure of the cause of CI failure. It passes locally for me:

Will look into this a bit later on today.

[FoamyGuy]

I think this is the root caused of the CI failure. psf/black#2964 Looks like there are a few options to get past it but it might be something we'll need to decided on across all of the libraries if I am understanding correctly.

[FoamyGuy]

Indeed the Black / Click version issue is what was causing CI to fail. There was a commit yesterday to change the version used and I just re-ran the jobs and now it's passing 🎉

[aioue]

LGTM.

Tested code on a Titano successfully.

Test process:

• Loaded page_layout.py onto a Titano
• Ran the 2 test files using adapted import line from page_layout import PageLayout (hobbyist python user)

Test results:

• simpletest PASS. Rendered both pages successfully and switches between them.
• advancedtest PASS. Rendered all three pages successfully and modifies the second page as expected.

Notes:

• Feels faster to load the code and render the text and shapes than other Learning System templates 🚀 Nice work FoamyGuy 👏