stretchable 1.0.0b2

Layout library for Python (based on Taffy, a rust-powered implementation of CSS Grid/Flexbox)

Introduction

This package enables target-agnostic layout operations using CSS Grid and Flexbox. Possible uses include UI layouts, page layouts for reports, complex plotting layouts, etc.

It implements Python bindings for Taffy, an implementation of Grid/Flexbox written in Rust. It was originally based on Stretch (hence the name), but has since migrated to use Taffy.

Getting Started

Helpful resources to getting started with layouts using CSS Grid and Flexbox are listed below.

Flexbox

• Flexbox Froggy. This is an interactive tutorial/game that allows you to learn the essential parts of Flexbox in a fun engaging way.
• A Complete Guide To Flexbox by CSS Tricks. This is detailed guide with illustrations and comphrehensive written explanation of the different Flexbox properties and how they work.
• Yoga Playground

CSS Grid

• CSS Grid Garden. This is an interactive tutorial/game that allows you to learn the essential parts of CSS Grid in a fun engaging way.
• A Complete Guide To CSS Grid by CSS Tricks. This is detailed guide with illustrations and comphrehensive written explanation of the different CSS Grid properties and how they work.

Usage

See demos for examples of basic usage.

Building

Install Rust with rustup and use maturin develop for development and maturin build [--release] to build.

Testing

Install test dependencies and invoke pytest. Note that there are ~700 tests, the majority of which are run using Selenium with the Chrome WebDriver, and the complete test suite can take 10+ minutes to complete. Use pytest --lf to only run the last-failed tests.

NOTE: There is one test fixture max_height_overrides_height_on_root which is known to fail. This is related to node visibility, see #43.

License

This work is released under the MIT license. A copy of the license is provided in the LICENSE file.