scarpe 0.2.2 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b07033a939f5503cea0f357a5ac67f0df01833038c433933c4dd2984bcd15b76
-  data.tar.gz: cc633f8adfe627f260e06371feae6d1b152f28c279db62576c82f5c16a44e1be
+  metadata.gz: 4d9a2f4008f1c1db114dc1b5f3b0331635b8021d878a3ca30d79a7c8bc6a00fd
+  data.tar.gz: 4d46f7680c7dcee6737c0ba6c9214ace6d81383b3238cc4c93c94521569cdc3f
 SHA512:
-  metadata.gz: 105ea36e4f41d00d1e67ce3ff68cefac8195cc692225133e90382c770c2bfe393ee50c827b5feff0873f9d34cb54b35a11cf7e75994ec10b62d35f72ee0adb37
-  data.tar.gz: ff5b648210d7d24e9114e3850529c10999091215aa5f7576e4ee26544797cb98e1f6a51642f39c4b638b7f4a55525bc463188a678265d4ff13f01a5af8d0f931
+  metadata.gz: f4b7b5279f422631643c9c53e98051abce6c85ab42ec4d1eee3e19dc0bb1c15a77ba6773c2e844bafa3313ea58138f4c855c4d8036f122863dbb5f57c226c10a
+  data.tar.gz: 71206dc45ab004580e009cc9ccc03c9af075721538dcf2bf7527dcdd5c2a428a5b84aa109c1f322480550b900c0376eea215515057aa3570ba9dea0e7b7539a1

data/.rubocop.yml

@@ -7,7 +7,7 @@ AllCops:
   Exclude:
     - 'bin/**/*'
     - 'exe/**/*'
-    - 'examples/**/*'
+    # - 'examples/**/*' Since I'm only doing this locally.
     - 'docs/**/*'
 
 Layout/LineLength:
@@ -19,6 +19,12 @@ Style/RedundantHeredocDelimiterQuotes:
 Style/MissingRespondToMissing:
   Enabled: false
 
+Metrics/ParameterLists:
+  Enabled: false
+
+Style/ParallelAssignment:
+  Enabled: false
+
 
 
 Style/MethodCallWithArgsParentheses:

data/.yardopts

@@ -8,6 +8,7 @@
 --exclude lib/scarpe/glibui
 lib/**/*.rb
 lacci/lib/**/*.rb
+scarpe-components/lib/**/*.rb
 -
 docs/yard/*.md
 docs/static/manual.md

data/CHANGELOG.md

@@ -1,19 +1,65 @@
-## [Unreleased]
+## [Unreleased Future]
 
 Here we write upgrading notes for brands. It's a team effort to make them as
 straightforward as possible.
 
-### Added
+### Enhancements
+
+### Bugs Fixed
 - #-some-pr-number <description> @author-of-pr
 
-### Changed
+### Incompatibilities
+
+## [0.3.1] - 2023-??-?? - Up
+
+Lots of bug fixes. We're also still implementing major Shoes3 features.
+Testing is finally improving at a reasonable rate, but we have a long
+way to go.
+
+The Scarpe architecture is still early. We've improved the internal APIs
+for creating drawables significantly, added an asset server and are
+still making big changes.
+
+### Enhancements
+
+- Ovals!
+- Lots more text methods: del, sub, sup; lots more text styles: underline, strikethrough, strikecolor, align
+- Features! Shoes.app(feature: [:html, :scarpe]) lets apps declare dependencies on non-classic Shoes!
+- Better handling of :left, :top, :width and :height, :margin and :padding on more drawables
+- The html_class style is a feature to make it easier to do Bootstrap styling on your drawables
+- Directly run Shoes Specs, including with Niente
+- We use Minitest assertion DSL rather than our own everywhere now
+
+### Bugs Fixed
+
+- We've changed "module Shoes" to "class Shoes" for Shoes3 compatibility.
+- Several style and method names, including on Para and ListBox, changed to Shoes3 standard.
+
+### Incompatibilities
+
+TextDrawables now draw with very different Calzini (HTML renderer) properties
+We're deprecating the CatsCradle test DSL in favour of Shoes-Spec.
+Some error names have changed, with more to come.
+We've changed the Lacci drawable-create event to include the parent ID.
+
+## [0.3.0] - 2023-11-24 - You
+
+- Progress bars
+- Various new APIs and many bug fixes
+- Added Tiranti, a Bootstrap-based Calzini HTML renderer replacement
+- Added Calzini, a Drawable-to-HTML renderer
+- Rename of Widget to Drawable
+- Extremely early Shoes-Spec testing support
+- Niente, a "no-op" testing display service
+
+## [0.2.1] - 2023-07-02 - Give
 
-### Fixed
+- Bugfix release
 
-## [0.2.0] - 2022-07-02
+## [0.2.0] - 2023-07-02 - Gonna
 
 - First batch of functionality. Will aggressively track to changelog from here on out.
 
-## [0.1.0] - 2022-02-09
+## [0.1.0] - 2023-02-09 - Never
 
 - Initial release

data/Gemfile

@@ -21,7 +21,8 @@ group :development do
   gem "redcarpet"
   gem "debug"
   gem "rubocop", "~> 1.21"
-  gem "rubocop-shopify"
+  gem "htmlbeautifier"
+  gem "diff-lcs"
   #gem "commonmarker"
   #gem "github-markup"
 end

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    scarpe (0.2.1)
+    scarpe (0.3.0)
       bloops (~> 0.5)
       fastimage
       lacci
@@ -9,17 +9,19 @@ PATH
       nokogiri
       scarpe-components
       sqlite3
+      webrick
       webview_ruby (~> 0.1.1)
 
 PATH
   remote: lacci
   specs:
-    lacci (0.2.1)
+    lacci (0.3.0)
+      scarpe-components
 
 PATH
   remote: scarpe-components
   specs:
-    scarpe-components (0.2.1)
+    scarpe-components (0.3.0)
 
 GEM
   remote: https://rubygems.org/
@@ -31,11 +33,13 @@ GEM
     debug (1.8.0)
       irb (>= 1.5.0)
       reline (>= 0.3.1)
+    diff-lcs (1.5.0)
     fastimage (2.2.7)
     ffi (1.15.5)
     ffi-compiler (1.0.1)
       ffi (>= 1.0.0)
       rake
+    htmlbeautifier (1.4.2)
     io-console (0.6.0)
     irb (1.6.4)
       reline (>= 0.3.0)
@@ -51,8 +55,12 @@ GEM
       minitest (>= 5.0)
       ruby-progressbar
     multi_json (1.15.0)
+    nokogiri (1.15.2-arm64-darwin)
+      racc (~> 1.4)
     nokogiri (1.15.2-x86_64-darwin)
       racc (~> 1.4)
+    nokogiri (1.15.2-x86_64-linux)
+      racc (~> 1.4)
     parallel (1.22.1)
     parser (3.2.1.0)
       ast (~> 2.4.1)
@@ -76,10 +84,10 @@ GEM
       unicode-display_width (>= 2.4.0, < 3.0)
     rubocop-ast (1.26.0)
       parser (>= 3.2.1.0)
-    rubocop-shopify (2.12.0)
-      rubocop (~> 1.44)
     ruby-progressbar (1.11.0)
+    sqlite3 (1.6.3-arm64-darwin)
     sqlite3 (1.6.3-x86_64-darwin)
+    sqlite3 (1.6.3-x86_64-linux)
     unicode-display_width (2.4.2)
     webrick (1.7.0)
     webview_ruby (0.1.2)
@@ -90,20 +98,26 @@ GEM
       webrick (~> 1.7.0)
 
 PLATFORMS
+  arm64-darwin-21
+  arm64-darwin-22
+  arm64-darwin-23
   x86_64-darwin-19
+  x86_64-darwin-20
   x86_64-darwin-22
+  x86_64-darwin-23
   x86_64-linux
 
 DEPENDENCIES
   bloops (~> 0.5)
   debug
+  diff-lcs
+  htmlbeautifier
   lacci!
   minitest (~> 5.0)
   minitest-reporters
   rake (~> 13.0)
   redcarpet
   rubocop (~> 1.21)
-  rubocop-shopify
   scarpe!
   scarpe-components!
   yard

data/LICENSE.txt

@@ -1,6 +1,12 @@
+Scarpe, Lacci and Scarpe-Components code is available under the MIT license.
+
+Bootswatch themes are made by Thomas Park and are released under MIT license.
+Bootstrap Icons are by Bootstrap Icons and are released under MIT license.
+
+=================
 The MIT License (MIT)
 
-Copyright (c) 2022 TODO: Write your name
+Copyright (c) 2022-present, Scarpe team and contributors.
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

data/README.md

@@ -7,7 +7,7 @@
 
 <img src="https://user-images.githubusercontent.com/7865030/217309905-7f25e3cf-1850-481d-811b-dfddea2df54a.png" width="200" height="200">
 
-"Scarpe" means shoes in Italian. "Scarpe" also means [Shoes](https://github.com/shoes/shoes-deprecated) in modern Ruby and webview!
+"Scarpe" means shoes in Italian. "Scarpe" also means [Shoes](https://github.com/shoes/shoes-deprecated) in modern Ruby and Webview!
 
 Scarpe isn't feature complete with any version of Shoes (yet?). We're initially targeting [Shoes 3](https://github.com/scarpe-team/scarpe/wiki/ShoesImplementations.md), also called "Red Shoes."
 
@@ -15,7 +15,7 @@ Scarpe isn't feature complete with any version of Shoes (yet?). We're initially
 
 Shoes is an old library (really [several different ones](https://github.com/scarpe-team/scarpe/wiki/ShoesImplementations.md)) that let you build little local desktop computer programs, package them up and give copies to people. Imagine if you can write a tiny little Ruby program (e.g. sneak a peek at the next section) and then it would make a runnable app, opening a window in Ruby, where you could click buttons and play sounds and stuff.
 
-Scarpe is a rewrite of Shoes, because old Shoes doesn't really work any more. There have been a surprising number of rewrites of Shoes over the years -- people love it and miss having it around. This one is ours. Also it uses Webview.
+Scarpe is a rewrite of Shoes, because old Shoes doesn't work any more. There have been a surprising number of rewrites of Shoes over the years -- people love it and miss having it around. This one is ours. By default it uses [Webview](https://github.com/webview/webview).
 
 ## Usage
 
@@ -29,33 +29,49 @@ Shoes.app do
 end
 ```
 
-More examples can be found in the [`examples` folder](https://github.com/scarpe-team/scarpe/tree/main/examples)!
+<img width="480" alt="hello_world" src="https://user-images.githubusercontent.com/9624267/158565981-57240f72-fbaf-4b72-b66e-8c0d517a90d7.png">
+
+A bit more...
+
+```ruby
+Shoes.app do
+  @push = button "Push me"
+  @note = para "Nothing pushed so far"
+  @push.click {
+    @note.replace(
+      "Aha! Click! ",
+      link("Go back") { @note.replace "Nothing pushed so far" }
+    )
+  }
+end
+```
 
-## Screenshots
+<img width="480" alt="hello_world" src="https://user-images.githubusercontent.com/9624267/158566011-0372d0c7-fbeb-4ed6-a082-73908f04a0b6.gif">
 
-From the hello world example:
+More examples can be found in the [`examples` folder](https://github.com/scarpe-team/scarpe/tree/main/examples)!
 
-<img width="480" alt="hello_world" src="https://user-images.githubusercontent.com/9624267/158565981-57240f72-fbaf-4b72-b66e-8c0d517a90d7.png">
+## Wiki
 
-From the button example:
+Explore more in the [Scarpe Wiki](https://github.com/scarpe-team/scarpe/wiki) for in-depth documentation, tutorials, and additional resources. Whether you're a new user, a new contributor or an experienced user, the Wiki provides valuable information to enhance your Scarpe experience.
 
-<img width="480" alt="hello_world" src="https://user-images.githubusercontent.com/9624267/158566011-0372d0c7-fbeb-4ed6-a082-73908f04a0b6.gif">
 
 ## Scarpe in Development
 
 ### Quickstart
 
-Scarpe requires [Ruby 3.2](https://www.ruby-lang.org/en/downloads/) or higher! You can use `rvm`, `rbenv` or your favourite version control just like normal.
+Scarpe requires [Ruby 3.2](https://www.ruby-lang.org/en/downloads/) or higher! You can use `rvm`, `rbenv` or your favourite version control to install Ruby just like normal.
 
 This repo is where most of the action is happening right now, and to have the full Scarpe experience _today_ this is probably what you want to do.
 
 ```
 # dependencies - Mac version
 brew install portaudio pkg-config # for sound!
+# dependencies - Mac M1 version
+brew install portaudio && bundle config build.bloops --with-portaudio-dir=$(brew --prefix portaudio)
 # dependencies - Ubuntu Linux version
-sudo apt install libgtk-3-dev libwebkit2gtk-4.0-dev libportaudio2
+sudo apt install libgtk-3-dev libwebkit2gtk-4.0-dev portaudio19-dev
 
-for any other linux or windows. please see the webview docs for your [platform](https://github.com/webview/webview#prerequisites)
+for any other Linux or Windows please see the webview docs for your [platform](https://github.com/webview/webview#prerequisites)
 
 # get it
 git clone http://github.com/scarpe-team/scarpe
@@ -67,33 +83,71 @@ cd scarpe; bundle install
 
 If you are using Visual Studio Code, you can use this [extension](https://github.com/gintama91/Scarpe-Vscode-Extension). This extension simplifies the process of executing commands by eliminating the need to repeatedly type lengthy file paths, resulting in a more efficient and productive development experience.
 
-### Finer details
+## Run Test
+
+To Run all availble tests run command 
+
+```
+bundle exec rake ci_test
+
+```
+
+### To Run Tests separately 
+
+Scarpe is composed of [various sub-libraries](https://github.com/scarpe-team/scarpe/wiki/ShoesArchitecture.md). You can run some tests separately.
+
+Run Lacci Tests:
+
+```
+bundle exec rake lacci_test
+
+```
+
+Run Scarpe-Components Tests:
+
+```
+bundle exec rake component_test
+```
+
+Run Scarpe Tests:
+
+```
+bundle exec rake test
+```
+
+Check HTML Output:
+
+```
+bundle exec rake test:check_html_fixtures
+```
+
+### Finer Details
 
 First, clone the [main GitHub repository](https://github.com/scarpe-team/scarpe).
 
-`bundle install` dependencies like webview from the cloned directory in your Ruby of choice.
+`bundle install` dependencies like Webview from the cloned directory in your Ruby of choice.
 
 You can run without Scarpe being installed by including its directory. For instance, from the "examples" directory you can run `ruby -I../lib -I../lacci/lib -rscarpe hello_world.rb`. You can also install Scarpe locally (`gem build scarpe.gemspec && gem install scarpe-0.1.0.gem`) or using a Gemfile with the "path" option for local Scarpe.
 
 Most commonly we are all using this command: `./exe/scarpe examples/button.rb --dev --debug`
 
-The `--dev` flag points to your local scarpe rather than an installed Scarpe gem.
+The `--dev` flag points to your local Scarpe rather than an installed Scarpe gem.
 
 The `--debug` flag will dump a ton of useful information to the console if you want to see what's happening with your app.
 
-It's very early in the development process. If you'd like to help develop Scarpe, great! It would be useful to drop us a message/issue/PR on GitHub early on, so we know you're working in a particular area, and we can warn you if anybody else is currently doing so. We also have a Discord.
+It's very early in Scarpe's development process. If you'd like to help develop Scarpe, great! It would be useful to drop us a message/issue/PR on GitHub early on, so we know you're working in a particular area, and we can warn you if anybody else is currently doing so. We also have a Discord.
 
 We'd love the help!
 
-If you want to quickly add a feature, you can use the `ruby scarpegen.rb` command. This command will generate the necessary files for you, along with a simple template and a set of questions to guide you through the process. By following these steps, you will be good to go!
-
-By leveraging the `ruby scarpegen.rb` command and the provided resources, you can expedite the feature addition process and ensure a smoother development experience.
+If you want to quickly add a feature, you can use the `ruby scarpegen.rb` command. This command will generate the necessary files for you, along with a simple template and a set of questions to guide you through the process. By leveraging the `ruby scarpegen.rb` command and the provided resources, you can expedite the feature addition process and ensure a smoother development experience.
 
-## Are we done yet?
+## Are We Done Yet?
 
 Great question! Right now we have a few key things we want to achieve. The first is passing all of the examples we can get our hands on. The second is passing [Hackety-Hack](https://github.com/hacketyhack/hacketyhack). We're manually keeping tabs on that here.
 
-### Webview Display Service Examples Passing
+But the short version is: no, we're far from done. Some Shoes features (e.g. multiple window support) may be very difficult to support with Webview at all. We're working on other ways to handle those features.
+
+### Examples Passing with the Webview Display Service
 
 ![](https://geps.dev/progress/30?dangerColor=800000&warningColor=ff9900&successColor=006600)
 
@@ -118,6 +172,31 @@ The SCARPE_TEST_CONTROL environment variable can contain a path to a test-contro
 
 If you run ./exe/scarpe --dev env, you can see all current environment settings.
 
+## Shoes-Spec
+
+Pre-Scarpe Shoes didn't have specific test APIs or infrastructure. That was pretty standard for GUI libraries when it was written. Scarpe supports a test API called Shoes-Spec, and different display services tend to extend it.
+
+The idea is that you write a standard Shoes application and then there's additional test code that runs once your application is running. Since different display services run in very different ways (e.g. Webview vs Wasm vs GTK+), the test code isn't necessarily in the same Ruby process as the Shoes application.
+
+They're often packaged in .sspec files that look like this:
+
+~~~
+---
+----------- app code
+Shoes.app do
+  @b = button "OK" do
+    @b.text = "Clicked"
+  end
+end
+
+----------- test code
+assert_equal "OK", button().text
+button().trigger_click
+assert_equal "Clicked", button().text
+~~~
+
+See [https://github.com/scarpe-team/shoes-spec] for more details.
+
 ## More info
 
 * [Nobody Knows Shoes manual](https://github.com/whymirror/why-archive/raw/master/shoes/nobody-knows-shoes.pdf)
@@ -147,7 +226,7 @@ You can set SCARPE_LOG_CONFIG to an appropriate YAML file to set log levels per-
 ```
 {
     "default": "warn",
-    "WV::WebWrangler": ["logger/web_wrangler.log", "debug"]
+    "Webview::WebWrangler": ["logger/web_wrangler.log", "debug"]
 }
 ```
 

data/Rakefile

@@ -4,6 +4,59 @@ require "bundler/gem_tasks"
 require "rake/testtask"
 require "rubocop/rake_task"
 
+# Rakefile
+
+task :ci_test do
+  puts "
+  \033[1;32;4;47mInstalling Dependencies\033[0m
+  "
+
+  system('brew install pkg-config portaudio')
+
+ 
+  puts "
+  \033[1;32;4;47mCheckout Code\033[0m
+  "
+  system('git checkout main')
+
+ 
+  puts "
+  \033[1;32;4;47mSetup Ruby and install Gems\033[0m
+  "
+  system('bundle install')
+
+  # Run tests
+  
+  puts "
+  \033[1;32;4;47mRun Lacci Tests\033[0m
+  "
+  system('CI_RUN=true bundle exec rake lacci_test')
+
+  puts "
+  \033[1;32;4;47mRun Scarpe-Component Tests\033[0m
+  "
+
+  system('CI_RUN=true bundle exec rake component_test')
+
+ 
+  puts "
+  \033[1;32;4;47mRun Scarpe Tests\033[0m
+  "
+  system('CI_RUN=true bundle exec rake test')
+
+  
+  puts "
+  \033[1;32;4;47mCheck HTML Output\033[0m
+  "
+  system('bundle exec rake test:check_html_fixtures')
+
+ 
+  puts "
+  \033[1;32;4;47mUpload Fail logs\033[0m
+  "
+  system('if [ ! -z "$(ls logger/test_failure*.out.log 2>/dev/null)" ]; then actions/upload-artifact@v4 --name "test failure logs" --path logger/test_failure*.out.log; fi')
+end
+
 Rake::TestTask.new(:test) do |t|
   t.libs << "test"
   t.libs << "lib"
@@ -22,6 +75,20 @@ Rake::TestTask.new(:component_test) do |t|
   t.test_files = FileList["scarpe-components/test/**/test_*.rb"]
 end
 
+namespace :test do
+  desc 'Regenerate HTML fixtures'
+  task :regenerate_html_fixtures do |t|
+    ENV['SELECTED_FILE'] = ARGV[-1] if ARGV[-1].include?(".rb")
+    load 'tasks/regenerate_html_fixtures.rb'
+  end
+
+  desc 'Check HTML fixtures against latest output'
+  task :check_html_fixtures do |t|
+    ENV['SELECTED_FILE'] = ARGV[-1] if ARGV[-1].include?(".rb")
+    load 'tasks/check_html_fixtures.rb'
+  end
+end
+
 RuboCop::RakeTask.new
 
-task default: [:test, :lacci_test, :component_test, :rubocop]
+task default: [:test, :lacci_test, :component_test]

data/examples/Edit_box_Styles.rb

@@ -0,0 +1,8 @@
+Shoes.app do
+    para "Anything:",size:"30px"
+    lorem = "Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim."
+    @manuscript = edit_box(lorem, width: "100%", font:"italic normal bold 25px 'Times New Roman', serif;", tooltip:"This is a tooltip") do |box|
+      @char_count.replace("#{box.text.length} characters")
+    end
+    @char_count = para "#{@manuscript.text.length} characters" ,size:"20px"
+  end

data/examples/Kerning.rb

@@ -0,0 +1,7 @@
+Shoes.app do
+
+    para "This text have kerning applied to it", kerning:10, size:18
+
+    para "This is normal text for reference", size:18
+    
+end

data/examples/animate.rb

@@ -0,0 +1,20 @@
+Shoes.app do
+  stack do
+    para "10 fps"
+    p = para "-"
+    animate do |frame|
+      p.replace(frame.to_s)
+    end
+    para "20 fps"
+    p2 = para "-"
+    animate(20) do |frame|
+      p2.replace(frame.to_s)
+    end
+    para "3spf"
+    p3 = para "-"
+    every(3) do |count|
+      p3.replace(count.to_s)
+    end
+  end
+end
+

data/examples/arrow.rb

@@ -0,0 +1,10 @@
+Shoes.app do
+  arrow 100, 100, 30
+
+  arrow 150, 120,40
+
+  arrow 30 ,60 ,40
+
+  arrow :left => 50, :top => 80,
+    :width => 40
+end

data/examples/border.rb

@@ -0,0 +1,11 @@
+Shoes.app(width: 300, height: 50) do
+  stack height: 50 do
+    para "Border is on top of text"
+    border yellow, strokewidth: 4
+  end
+
+  stack do
+    para "This border is also on top of text"
+    border blue, strokewidth: 4
+  end
+end

data/examples/btn_tooltip.rb

@@ -0,0 +1,7 @@
+Shoes.app do
+  @btn = button "who am i?", :tooltip => "i have no idea either"
+  @para = para "i am a button"
+  @btn.hover do
+    @para.replace "i am a button and i am being hovered"
+  end
+end

data/examples/button_style_changed.rb

@@ -0,0 +1,7 @@
+Shoes.app do
+  @p = para "This text will start red\n", stroke: :red
+  button "OK" do
+    @p.replace("... but turn green when you click it.")
+    @p.stroke = :green
+  end
+end

data/examples/button_styles_default.rb

@@ -0,0 +1,6 @@
+Shoes.app do
+  style Shoes::Para, stroke: :red
+  para "This text should be red\n"
+  para "But this text should be green\n", stroke: :green
+  button "OK"
+end

data/examples/check.rb

@@ -5,6 +5,8 @@ Shoes.app do
       flow { check; para "Kin-Dza-Dza by Georgi Danelia" }
       flow { check; para "Children of Heaven by Majid Majidi" }
       @btn = check; para "The White Balloon by Jafar Panahi"
+      @p = para ""
+      @btn.click { @p.replace("Clicked! Yay!") }
       flow do
         button "Mark me" do
           @btn.checked = true

data/examples/download_and_show_image.rb

@@ -1,3 +1,6 @@
+# html_ci: false
+# This is due to a button rendering issue
+
 Shoes.app do
   stack do
     title "Downloading Google image", size: 16

data/examples/flags/finland.rb

@@ -0,0 +1,15 @@
+Shoes.app(title: "Finland", width: 360, height: 220, ) do
+  background blue
+  stack width: 100, height: 80 do
+    background white
+  end
+  stack width: 100, height: 80, top: 140, left: 0 do
+    background white
+  end
+  stack width: 200, height: 80, top: 0, left: 160 do
+    background white
+  end
+  stack width: 200, height: 80, top: 140, left: 160 do
+    background white
+  end
+end

data/examples/flags/italy.rb

@@ -0,0 +1,11 @@
+Shoes.app(height: 300) do
+  stack width: 0.33, height: 1.0 do
+    background green
+  end
+  stack width: 0.34, height: 1.0 do
+    background white
+  end
+  stack width: 0.33, height: 1.0 do
+    background red
+  end
+end

data/examples/flags/mauritius.rb

@@ -0,0 +1,14 @@
+Shoes.app(title: "Mauritius", height: 300) do
+  stack width: 1.0, height: 0.25 do
+    background red
+  end
+  stack width: 1.0, height: 0.25 do
+    background blue
+  end
+  stack width: 1.0, height: 0.25 do
+    background yellow
+  end
+  stack width: 1.0, height: 0.25 do
+    background green
+  end
+end