scarpe 0.2.1 → 0.2.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b494d51af2b6c932398ba4bd9e4a4028bfb023d240c993d6ec2abc067867418a
-  data.tar.gz: aadbaeaaf38a75e493aab9576513efa56fd7deb51decf23caba95124db910e68
+  metadata.gz: b07033a939f5503cea0f357a5ac67f0df01833038c433933c4dd2984bcd15b76
+  data.tar.gz: cc633f8adfe627f260e06371feae6d1b152f28c279db62576c82f5c16a44e1be
 SHA512:
-  metadata.gz: ed68d1232d8b5572b354e302359aeeacf34046eab08cc4dd4c42ff468b270dfb52e791c670cc81e8d7b94176a10d8356855c1c8f4b82a74c3136bd29ea1a7821
-  data.tar.gz: bf95030dbc45c5e1383ba18dc0918270025d8d5fee8422cd2c523660bf87e8ef1b6935f31624a106977b2ff3bbea5b7542f2b3b042e293478cbdad37f6fce689
+  metadata.gz: 105ea36e4f41d00d1e67ce3ff68cefac8195cc692225133e90382c770c2bfe393ee50c827b5feff0873f9d34cb54b35a11cf7e75994ec10b62d35f72ee0adb37
+  data.tar.gz: ff5b648210d7d24e9114e3850529c10999091215aa5f7576e4ee26544797cb98e1f6a51642f39c4b638b7f4a55525bc463188a678265d4ff13f01a5af8d0f931

data/.rubocop.yml

@@ -8,6 +8,7 @@ AllCops:
     - 'bin/**/*'
     - 'exe/**/*'
     - 'examples/**/*'
+    - 'docs/**/*'
 
 Layout/LineLength:
   Max: 150
@@ -82,3 +83,6 @@ Style/ReturnNil:
 
 Style/ClassAndModuleChildren:
   Enabled: false
+
+Layout/EmptyLineBetweenDefs:
+  Enabled: false

data/.yardopts

@@ -1,3 +1,14 @@
 --markup-provider=redcarpet
 --markup=markdown
+--protected
+--no-private
+--template-path docs/yard/template
+--tag incompatibility:"Incompatibilities with Shoes"
+--exclude lib/scarpe/libui
+--exclude lib/scarpe/glibui
+lib/**/*.rb
+lacci/lib/**/*.rb
+-
+docs/yard/*.md
+docs/static/manual.md
 

data/Gemfile

@@ -5,6 +5,9 @@ source "https://rubygems.org"
 # Specify your gem's dependencies in scarpe.gemspec
 gemspec
 
+gem "lacci", path: "lacci"
+gem "scarpe-components", path: "scarpe-components"
+
 gem "bloops", "~> 0.5" #path: "../bloopsaphone" #git: "https://github.com/scarpe-team/bloopsaphone"
 gem "rake", "~> 13.0"
 

data/Gemfile.lock

@@ -0,0 +1,112 @@
+PATH
+  remote: .
+  specs:
+    scarpe (0.2.1)
+      bloops (~> 0.5)
+      fastimage
+      lacci
+      logging (~> 2.3.1)
+      nokogiri
+      scarpe-components
+      sqlite3
+      webview_ruby (~> 0.1.1)
+
+PATH
+  remote: lacci
+  specs:
+    lacci (0.2.1)
+
+PATH
+  remote: scarpe-components
+  specs:
+    scarpe-components (0.2.1)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    ansi (1.5.0)
+    ast (2.4.2)
+    bloops (0.5)
+    builder (3.2.4)
+    debug (1.8.0)
+      irb (>= 1.5.0)
+      reline (>= 0.3.1)
+    fastimage (2.2.7)
+    ffi (1.15.5)
+    ffi-compiler (1.0.1)
+      ffi (>= 1.0.0)
+      rake
+    io-console (0.6.0)
+    irb (1.6.4)
+      reline (>= 0.3.0)
+    json (2.6.3)
+    little-plugger (1.1.4)
+    logging (2.3.1)
+      little-plugger (~> 1.1)
+      multi_json (~> 1.14)
+    minitest (5.18.0)
+    minitest-reporters (1.6.0)
+      ansi
+      builder
+      minitest (>= 5.0)
+      ruby-progressbar
+    multi_json (1.15.0)
+    nokogiri (1.15.2-x86_64-darwin)
+      racc (~> 1.4)
+    parallel (1.22.1)
+    parser (3.2.1.0)
+      ast (~> 2.4.1)
+    racc (1.7.1)
+    rainbow (3.1.1)
+    rake (13.0.6)
+    redcarpet (3.6.0)
+    regexp_parser (2.7.0)
+    reline (0.3.4)
+      io-console (~> 0.5)
+    rexml (3.2.5)
+    rubocop (1.46.0)
+      json (~> 2.3)
+      parallel (~> 1.10)
+      parser (>= 3.2.0.0)
+      rainbow (>= 2.2.2, < 4.0)
+      regexp_parser (>= 1.8, < 3.0)
+      rexml (>= 3.2.5, < 4.0)
+      rubocop-ast (>= 1.26.0, < 2.0)
+      ruby-progressbar (~> 1.7)
+      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-x86_64-darwin)
+    unicode-display_width (2.4.2)
+    webrick (1.7.0)
+    webview_ruby (0.1.2)
+      ffi
+      ffi-compiler
+      rake
+    yard (0.9.28)
+      webrick (~> 1.7.0)
+
+PLATFORMS
+  x86_64-darwin-19
+  x86_64-darwin-22
+  x86_64-linux
+
+DEPENDENCIES
+  bloops (~> 0.5)
+  debug
+  lacci!
+  minitest (~> 5.0)
+  minitest-reporters
+  rake (~> 13.0)
+  redcarpet
+  rubocop (~> 1.21)
+  rubocop-shopify
+  scarpe!
+  scarpe-components!
+  yard
+
+BUNDLED WITH
+   2.4.10

data/README.md

@@ -9,11 +9,11 @@
 
 "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 Classic.
+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."
 
 ## Wait, What's A Shoes?
 
-Shoes is an old library (really several different ones) 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.
+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.
 
@@ -29,7 +29,7 @@ Shoes.app do
 end
 ```
 
-More examples can be found in the `examples` folder!
+More examples can be found in the [`examples` folder](https://github.com/scarpe-team/scarpe/tree/main/examples)!
 
 ## Screenshots
 
@@ -45,31 +45,43 @@ From the button example:
 
 ### Quickstart
 
-Scarpe requires [Ruby 3.2](https://www.ruby-lang.org/en/downloads/) or higher! use `rvm` or `rbenv` for version control
+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.
 
-This 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.
+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 - Ubuntu Linux version
+sudo apt install libgtk-3-dev libwebkit2gtk-4.0-dev libportaudio2
+
+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
 cd scarpe; bundle install
+
 # run it
 ./exe/scarpe examples/button.rb --dev
 ```
 
+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
 
 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.
 
-You can run without Scarpe being installed by including its directory. For instance, from the "examples" directory you can run `ruby -I../lib 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.
+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`
+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.
 
-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.
+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.
 
 We'd love the help!
 
@@ -79,22 +91,13 @@ By leveraging the `ruby scarpegen.rb` command and the provided resources, you ca
 
 ## Are we done yet?
 
-Huh. 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 HacketyHack. We're manually keeping tabs on that here.
-
-🚨 **This is manually checked and not an automation.** 🚨
+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
 
-![](https://geps.dev/progress/16?dangerColor=800000&warningColor=ff9900&successColor=006600)
-
-__41/288__
-
-### GlimmerLibUI Display Service Examples Passing
-
-![](https://geps.dev/progress/2?dangerColor=800000&warningColor=ff9900&successColor=006600)
-
-__4/288__
+![](https://geps.dev/progress/30?dangerColor=800000&warningColor=ff9900&successColor=006600)
 
+__92/304__
 ## Teach me more about Shoes, the DSL, what it is and why it is amazing
 
 1. [Nobody Knows Shoes - _why's Manual](https://github.com/whymirror/why-archive/raw/master/shoes/nobody-knows-shoes.pdf)
@@ -105,16 +108,16 @@ __4/288__
 
 Scarpe allows you to modify the app's behaviour outside of the normal Shoes API with environment variables.
 
-For example, we are working with multiple display services like Webview, Glimmer, and possibly some others.
-
-The SCARPE_DISPLAY_SERVICE environment variable allows you to choose one or more display services, from the default Webview service to potentially other experimental or incomplete services. This may be important if you're developing a new display method for Scarpe. The display service variable will contain a name like "wv_local" or "wv_remote" or "glibui" which corresponds to a require-able Ruby file under lib/scarpe, either in the Scarpe gem or another gem your app requires.
+The SCARPE_DISPLAY_SERVICE environment variable allows you to choose one or more display services, from the default Webview service, to [Scarpe-Wasm](https://github.com/scarpe-team/scarpe-wasm) to potentially other experimental or incomplete services. This may be important if you're developing a new display method for Scarpe. The display service variable will contain a name like "wv_local" or "wv_remote" or "wasm_local" which correspond to a require-able Ruby file under lib/scarpe, either in the Scarpe gem or another gem your app requires.
 
 Example usage:
 
-`SCARPE_DISPLAY_SERVICE=glibui ./exe/scarpe examples/hello_world.rb`
+`SCARPE_DISPLAY_SERVICE=wv_relay ./exe/scarpe examples/hello_world.rb`
 
 The SCARPE_TEST_CONTROL environment variable can contain a path to a test-control-interface script for the Webview display service. If you look at test_helper, it gives some examples of how to use it.
 
+If you run ./exe/scarpe --dev env, you can see all current environment settings.
+
 ## More info
 
 * [Nobody Knows Shoes manual](https://github.com/whymirror/why-archive/raw/master/shoes/nobody-knows-shoes.pdf)
@@ -150,6 +153,10 @@ You can set SCARPE_LOG_CONFIG to an appropriate YAML file to set log levels per-
 
 ## Documentation
 
+Usually it's easiest to [just view the latest on GitHub](https://scarpe-team.github.io/scarpe/).
+
+But you can also built it yourself, locally, for testing or to take on the road.
+
 Scarpe uses [YARD](https://yardoc.org/) for basic API documentation. You can run "yard doc" to generate documentation
 locally, and then view it with "yard server". Point your browser at "http://localhost:8808" for local viewing.
 

data/Rakefile

@@ -10,6 +10,18 @@ Rake::TestTask.new(:test) do |t|
   t.test_files = FileList["test/**/test_*.rb"]
 end
 
+Rake::TestTask.new(:lacci_test) do |t|
+  t.libs << "lacci/test"
+  t.libs << "lacci/lib"
+  t.test_files = FileList["lacci/test/**/test_*.rb"]
+end
+
+Rake::TestTask.new(:component_test) do |t|
+  t.libs << "scarpe-components/test"
+  t.libs << "scarpe-components/lib"
+  t.test_files = FileList["scarpe-components/test/**/test_*.rb"]
+end
+
 RuboCop::RakeTask.new
 
-task default: [:test, :rubocop]
+task default: [:test, :lacci_test, :component_test, :rubocop]

data/docs/yard/catscradle.md

@@ -0,0 +1,44 @@
+# CatsCradle and Fiber-Based Testing
+
+We've tried a number of things for testing. We mock extensively in many places. We use promises to handle "assert thing X after the next redraw"-type testing.
+
+Most recently, we have a Fiber-based approach to testing which is a little weird, but (so far) looks pretty good. Here's a representative test of that kind:
+
+```
+  def test_html_dom_multiple_update
+    run_test_scarpe_code(<<-'SCARPE_APP', app_test_code: <<-'TEST_CODE')
+      Shoes.app do
+        para "Hello World"
+      end
+    SCARPE_APP
+      on_heartbeat do
+        p = para()
+        assert_include dom_html, "Hello World"
+        p.replace("Goodbye World")
+        wait fully_updated
+        assert_include dom_html, "Goodbye World"
+        p.replace("Hello Again")
+        wait fully_updated
+        assert_include dom_html, "Hello Again"
+
+        test_finished
+      end
+    TEST_CODE
+  end
+```
+
+That's fine. There's a very simple Scarpe app with a single para. The test finds it, then makes sure the page HTML includes the right text. Then it changes it, waits for the redraw and makes sure it contains the new right text. Then, basically, does those same things again. So what's interesting here?
+
+Primarily that it waits. You could reasonably think, "waiting is easy - you can use promises or sleeps for that." And normally you'd be right. But in this case, this uses the Webview local display service. It will crash if you don't return control to its main loop within a fraction of a second. And until it gets back to its main loop it can't receive calls from Javascript. Those "dom_html" calls require looping to Webview and back, as (of course) does "wait fully_updated".
+
+But this method appears to run through, line by line, until it's done. How?
+
+Fibers. Specifically, Ruby 3.0 added some nice Fiber capabilities that we can use. You can go look [at the docs](https://ruby-doc.org/core-3.0.0/Fiber.html#method-i-transfer) if you want.
+
+If you check catscradle.rb, you can see us doing a fun little dance where a block like the on_heartbeat above creates a Fiber, and there's a manager Fiber to coordinate them. On every heartbeat and redraw we run the manager Fiber, which in turn runs every other Fiber that's ready, which it tracks via Promises.
+
+A ready Fiber will run until it does something blocking, like a dom_html or wait call. Then it returns a Promise object that will be fulfilled when it's ready to run again, like a Promise for being fully redrawn, or a promise for when a snippet of Javascript finishes.
+
+Once the manager has run every ready Fiber once, it yields control and waits to be called again.
+
+Right now (June 2023) we keep control simple by only being called on heartbeats or redraws, so sometimes a promise *not* involving promises or redraws can wait awhile extra (up to 1/10th of a second or so) before it runs again. It would be possible to run the manager in response to other promises completing, and that would probably be more efficient. I'm just worried about that complicating the flow of control and leading to weird order-dependent bugs. So right now we do the simple thing, which can be slower.

data/docs/yard/template/default/fulldoc/html/setup.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+def generate_docpages_list
+  @file_list = true
+
+  # Customise these more?
+  @items = options.files.select { |m| m.filename.end_with?(".md") }
+
+  @list_title = "Doc Pages List"
+  @list_type = "file"
+  generate_list_contents
+  @file_list = nil
+end

data/docs/yard/template/default/layout/html/setup.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+def menu_lists
+  [
+    {:type => 'docpages', :title => 'Doc Pages', :search_title => 'Doc Pages'},
+    {:type => 'class', :title => 'Classes', :search_title => 'Class List'},
+    {:type => 'method', :title => 'Methods', :search_title => 'Method List'},
+    {:type => 'file', :title => 'Files', :search_title => 'File List'},
+  ]
+end

data/examples/background_with_image.rb

@@ -0,0 +1,16 @@
+Shoes.app do
+
+  stack width:100, height:100 do
+    background "docs/static/avatar.png"
+    border blue ,strokewidth: 4
+  end
+
+  stack width:100, height:100 do
+    background red
+  end
+
+  stack width:100, height:100 do
+    background "rgba(255,200,0,255)"
+  end
+
+end

data/examples/bloopsaphone/working/bronx_army_knife.rb

@@ -0,0 +1,66 @@
+# Bronx Army Knife
+
+# By analogy with "Bronx Cheer."
+
+class SystemConfiguration
+  def self.checked_run(cmd, msg: "returned an error")
+    system(cmd)
+    unless $?.success?
+      puts "Command failed: #{cmd.inspect} in #{Dir.pwd}; #{$?.inspect}..."
+      raise msg
+    end
+  end
+
+  def self.basic_install_check
+    unless `uname -a`.include?("Darwin")
+      raise "Feel free to adjust this app, but right now it's very Mac-specific!"
+    end
+
+    unless system("which ffmpeg")
+      raise "Please install FFMPEG! On Mac this might be 'brew install ffmpeg'"
+    end
+
+    unless system("which basic-pitch")
+      puts <<~USAGE_TEXT
+        You'll need to install basic-pitch. It can be a bit involved.
+        Basic-Pitch requires Python 3.7+, or 3.10+ for Mac M1s.
+
+        See:
+          https://github.com/spotify/basic-pitch
+          https://basicpitch.spotify.com/
+    USAGE_TEXT
+      raise "Please install basic-pitch! On Mac this might be 'pip3 install basic_pitch'"
+    end
+  end
+
+  def self.mic_device_string
+    audio_devices_text = `ffmpeg -f avfoundation -list_devices true -i "" 2>&1`
+
+    if audio_devices_text.include?("] MacBook Pro Microphone")
+      dev_num = audio_devices_text.split("] MacBook Pro Microphone")[0][-1]
+      unless ("0".."5").include?(dev_num)
+        raise "Couldn't recognise your audio device as a small number in text:\n#{audio_devices_text}\n\n!!!"
+      end
+      return ":" + dev_num
+    end
+
+    raise "Time to improve the checking to recognise the Mac microphone!"
+  end
+
+  def self.record_audio_to_file(path, seconds: 1)
+    @mic_dev ||= mic_device_string
+    checked_run("ffmpeg -f avfoundation -i \"#{@mic_dev}\" -t #{seconds}s #{path}")
+  end
+end
+
+SystemConfiguration.basic_install_check
+
+Shoes.app do
+  @status_text = para "Right now: nothing recorded"
+
+  @b = button "record" do
+    @status_text.replace("...")
+    SystemConfiguration.record_audio_to_file("~/Desktop/test_audio.wav")
+    @status_text.replace("Recorded: ~/Desktop/test_audio.wav")
+  end
+end

data/examples/bloopsaphone/working/morning_serenity.rb

@@ -0,0 +1,21 @@
+Shoes.app height: 200, width: 200, title: "Morning Serenity" do
+  @sleepy_person = para "😴"
+
+  button "Good Morning!" do
+    @sleepy_person.replace "😀"
+    b = Bloops.new
+    b.tempo = 70
+
+    s1 = b.sound Bloops::SINE
+    s1.attack = 0.5
+    s1.sustain = 0.3
+    s1.decay = 0.4
+
+    pattern1 = "4:e5 4:d5 4:c5 4:d5 2:e5 4:e5 4:d5 4:c5 4:d5 2:e5 4:d5 4:c5 4:b4 4:c5 2:d5"
+
+    b.tune s1, pattern1
+
+    b.play
+  end
+
+end

data/examples/bloopsaphone/working/simpsons_theme_song_by_why.rb

@@ -1,14 +1,16 @@
 
   b = Bloops.new
   b.tempo = 180
-  
-  
+
+
   sound = b.sound Bloops::SQUARE
   sound.volume = 0.4
   sound.sustain = 0.3
   sound.attack = 0.1
   sound.decay = 0.3
-  
+
   b.tune sound, "32 + C E F# 8:A G E C - 8:A 8:F# 8:F# 8:F# 2:G"
-  
   b.play
+
+# Added, or it justs falls off the end
+sleep 0.5 while not b.stopped?

data/examples/button_go_away.rb

@@ -1,4 +1,4 @@
-Shoes.app(debug: true) do
+Shoes.app do
   @b = button "Go away, button"
   @b.click {
     @b.destroy

data/examples/check.rb

@@ -0,0 +1,18 @@
+Shoes.app do
+    stack do
+      para "Among these films, which do you prefer?"
+      flow { check; para "The Taste of Tea by Katsuhito Ishii" }
+      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"
+      flow do
+        button "Mark me" do
+          @btn.checked = true
+
+        end
+        button "unmark me" do
+          @btn.checked = false
+        end
+      end
+    end
+  end

data/examples/clear_and_append.rb

@@ -0,0 +1,24 @@
+Shoes.app do
+  stack do
+    button("More Stuff!") do
+      @slot.append do
+        ins "I'm enthused."
+        title "Enthused!"
+        banner "ENTHUSED!"
+      end
+    end
+
+    button("No Stuff!") do
+      @slot.clear
+    end
+
+    button("Different Stuff!") do
+      @slot.clear do
+        para "I'm so different!"
+        title "I'm like a totally different but emo person! Or possibly chicken."
+      end
+    end
+
+    @slot = stack(width: "100%") { para 'Good Morning' }
+  end
+end

data/examples/download_and_show_image.rb

@@ -0,0 +1,28 @@
+Shoes.app do
+  stack do
+    title "Downloading Google image", size: 16
+    @status = para "Enter URL and press Enter:"
+
+    url_edit = edit_line
+    caption "here is a cute cat url: https://img.freepik.com/premium-photo/funny-smart-cat-professor-with-glasses-illustration-generative-ai_845977-709.jpg?w=700&h=300"
+
+    button 'Download Image!', color: "#3d5a80", padding_bottom: "8", padding_top: "8", text_color: "white", font_size: "16" do
+      download(url_edit.text, save: "downloaded_image.png") do
+        @status.replace "Download completed. Click to display the image."
+        @download_completed = true
+        button 'Display Image', color: "#3d5a80", padding_bottom: "8", padding_top: "8", text_color: "white", font_size: "16" do
+          if @download_completed
+            @status.replace "Showing you the image..."
+            display_image("downloaded_image.png")
+          end
+        end
+      end
+    end
+
+
+  end
+
+  def display_image(image_path)
+    image(image_path)
+  end
+end

data/examples/edit_box.rb

@@ -1,10 +1,8 @@
 Shoes.app do
   para "Manuscript:"
-  @manuscript = edit_box(width: "100%") do
-    "Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim."
+  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%") do |box|
+    @char_count.replace("#{box.text.length} characters")
   end
   @char_count = para "#{@manuscript.text.length} characters"
-  @manuscript.change { |text|
-    @char_count.replace("#{text.length} characters")
-  }
 end

data/examples/fonts.rb

@@ -1,6 +1,6 @@
-Scarpe.app do
+Shoes.app do
     para "Hello, world!", font: "Arial", size: 20
     para "Hello, world!", font: "Courier", size: 20
     para "Hello, world!", font: "MS Gothic", size: 20
 end
-  
+

data/examples/get_headers.rb

@@ -0,0 +1,10 @@
+Shoes.app do
+  stack do
+    title "Searching", :size => 16
+    @status = para "One moment..."
+
+    download "http://www.google.com/search?q=shoes" do |goog|
+      @status.replace "Headers: " + goog.response.headers.inspect
+    end
+  end
+end

data/examples/highlander.rb

@@ -58,6 +58,8 @@ def highlander_the_selected_item
     end
   end
 
+  $dup_list.selected_item = nil
+  $bottom_display.replace BOTTOM_DISPLAY_INSTRUCTIONS
   update_dup_list
 end
 

data/examples/link.rb

@@ -2,7 +2,7 @@ Shoes.app do
   def collapsed
     @para = para(
       "'Scarpe' means shoes in Italian. 'Scarpe' also means Shoes in...",
-      link("(show more)") { @para.destroy_self; @para = expanded }
+      link("(show more)") { @para.destroy; @para = expanded }
     )
   end
 
@@ -12,7 +12,7 @@ Shoes.app do
       "Scarpe isn't feature complete with any version of Shoes (yet?). We're initially targeting Shoes Classic. ",
       link("Learn more", click: "http://github.com/schwad/scarpe"),
       " ",
-      link("(show less)") { @para.destroy_self; @para = collapsed }
+      link("(show less)") { @para.destroy; @para = collapsed }
     )
   end