#flexbox #layout #facebook #bindings #engine #node #yoga-rs

yoga

Rust bindings for Facebook's Yoga, a Flexbox layout engine

6 releases (3 breaking)

0.4.0 Dec 20, 2022
0.3.1 Jan 16, 2019
0.3.0 Oct 16, 2018
0.2.0 Jun 18, 2018
0.1.1 Oct 12, 2017

#971 in GUI

Download history 19/week @ 2024-04-15 16/week @ 2024-04-22 32/week @ 2024-04-29 13/week @ 2024-05-06 69/week @ 2024-05-13 9/week @ 2024-05-20 61/week @ 2024-05-27 7/week @ 2024-06-03 1/week @ 2024-06-10 18/week @ 2024-06-17 103/week @ 2024-06-24 153/week @ 2024-07-01 10/week @ 2024-07-08 113/week @ 2024-07-15 9/week @ 2024-07-22 74/week @ 2024-07-29

285 downloads per month

MIT license

7MB
135K SLoC

C++ 61K SLoC // 0.2% comments JavaScript 21K SLoC // 0.0% comments C# 19K SLoC // 0.0% comments Java 19K SLoC // 0.0% comments Python 7.5K SLoC // 0.3% comments Visual Studio Project 3K SLoC Rust 1.5K SLoC // 0.0% comments Objective-C 1K SLoC // 0.0% comments Visual Studio Solution 1K SLoC Automake 385 SLoC // 0.2% comments Swift 295 SLoC // 0.1% comments M4 255 SLoC // 0.4% comments Shell 149 SLoC // 0.4% comments C 143 SLoC // 0.0% comments Ruby 87 SLoC // 0.1% comments Batch 71 SLoC Xcode Config 33 SLoC // 0.7% comments Prolog 15 SLoC NuGet Config 8 SLoC

Contains (JAR file, 1.5MB) android-support-v4.jar, (Zip file, 1MB) appcompat-v7-24.2.1.aar, (JAR file, 315KB) src/yoga/lib/junit/junit-4.12.jar, (JAR file, 125KB) src/yoga/lib/hamcrest/hamcrest-2.1.jar, (JAR file, 55KB) gradle-wrapper.jar, (Zip file, 59KB) src/yoga/lib/soloader/soloader-0.5.1.aar and 3 more.

Yoga-rs

Build Status

A Rust wrapper for Facebook's Yoga layout library.

You may also want to check out taffy (a revived fork of the abandoned stretch) as it is a pure Rust implementation.

Dependencies

  • cargo
  • rustc

Build

$ cargo build --release

Run Example

$ cargo run --release --example layout

Format Code

$ cargo +nightly fmt

Example Code

#[macro_use]
extern crate yoga;

use yoga::prelude::*;
use yoga::Node;
use yoga::StyleUnit::{Auto, UndefinedValue};

fn main() {
	let mut node = Node::new();

	let mut child = Node::new();
	let mut other_child = Node::new();

	node.insert_child(&mut child, 0);
	node.insert_child(&mut other_child, 1);

	style!(node,
		Margin(10 pt),
		MarginLeft(Auto),
		PaddingHorizontal(4 pt),
		Left(16 %),
		Bottom(UndefinedValue)
	);

	let child_styles = make_styles!(
		Width(32 pt),
		Height(32 pt),
		FlexGrow(1.0),
		Margin(Auto)
	);

	child.apply_styles(&child_styles);
	other_child.apply_styles(&child_styles);

	node.calculate_layout(512.0, 512.0, yoga::Direction::LTR);

	println!("Layout is {:#?}", child.get_layout());
}

Testing

The unit tests are automatically generated based on upstream fixtures and should not be edited manually.

$ cargo test

To generate the test cases: Download the ChromeDriver binary and put it somewhere in your $PATH. Linux/MacOS example:

$ cp chromedriver /usr/local/bin

Then run the following

$ cd gentest
$ bundle install # Install the required ruby gems
$ ruby gentest/gentest.rb # Generate the tests
$ cargo +nightly fmt # Format the tests for consistency

Dependencies