glimmer-dsl-libui 0.9.3 → 0.9.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f0fd65bf048edb4ec2556097bcbbe82b2dd2c1411e6a2c81d592901a40fdcf0f
-  data.tar.gz: 4e48a01e498afdf21fc72a82891106e8198360eeea971f98663e585b6c2ba6d1
+  metadata.gz: 916c5f10df3886ef6a5eed0ba6cbade95141812b5f5ab302ba3fb6dc0449a989
+  data.tar.gz: 6558bc6824e050a4f36c8d89d8ee2eded34017e2f931905f7469e045e56ab5e7
 SHA512:
-  metadata.gz: 45492206e1c62e3daf5199a6551029300a8f73a8fdf1cf40b38a3efdaddc49f8b123c18ae61c2b233ed2c19272aa9661c35043b2adccc2cc4f487f004486e8a1
-  data.tar.gz: 0c2b32d5c933da94e99f07926491d1423b29e36b91ad8e2a207472d5235d199a7761f9d768ce7a4eea02287515837aa4c35c0aeb6ed9b1d5c21d387fd796e9c6
+  metadata.gz: 5395eb43d9bc4a6aee0a18d498334a15475bd17cd976853bfb79c831eb55cdda6d68a9f8f04d62586d6d442004f0c74cef96f4f11e2ac53a08fba100813f989d
+  data.tar.gz: 8d8ed838367b768e7c18d47027f0b8a11d5728bf578339867b60411566dec0ada11294f9691008489f8fedaf971548d0c8bdc927f1b2f53f8f3de0a8e9a90b01

data/CHANGELOG.md

@@ -1,5 +1,9 @@
 # Change Log
 
+## 0.9.4
+
+- Scaffold Custom Window via `glimmer scaffold:customwindow[name,namespace]`
+
 ## 0.9.3
 
 - Application Scaffolding via `glimmer scaffold[app_name]` includes a Model layer

data/README.md

@@ -1,4 +1,4 @@
-# [<img src="https://raw.githubusercontent.com/AndyObtiva/glimmer/master/images/glimmer-logo-hi-res.png" height=85 />](https://github.com/AndyObtiva/glimmer) Glimmer DSL for LibUI 0.9.3
+# [<img src="https://raw.githubusercontent.com/AndyObtiva/glimmer/master/images/glimmer-logo-hi-res.png" height=85 />](https://github.com/AndyObtiva/glimmer) Glimmer DSL for LibUI 0.9.4
 ## Prerequisite-Free Ruby Desktop Development Cross-Platform Native GUI Library  ([Fukuoka Award Winning](http://www.digitalfukuoka.jp/topics/187?locale=ja))
 ### The Quickest Way From Zero To GUI
 [![Gem Version](https://badge.fury.io/rb/glimmer-dsl-libui.svg)](http://badge.fury.io/rb/glimmer-dsl-libui)
@@ -351,6 +351,7 @@ Learn more about the differences between various [Glimmer](https://github.com/An
     - [Run Application](#run-application)
     - [Run Examples](#run-examples)
     - [Scaffold Application](#scaffold-application)
+    - [Scaffold Custom Window](#scaffold-custom-window)
   - [Girb (Glimmer IRB)](#girb-glimmer-irb)
   - [Glimmer GUI DSL Concepts](#glimmer-gui-dsl-concepts)
   - [API](#api)
@@ -421,7 +422,7 @@ gem install glimmer-dsl-libui
 Or install via Bundler `Gemfile`:
 
 ```ruby
-gem 'glimmer-dsl-libui', '~> 0.9.3'
+gem 'glimmer-dsl-libui', '~> 0.9.4'
 ```
 
 Test that installation worked by running the [Glimmer Meta-Example](#examples):
@@ -625,7 +626,7 @@ Scaffold Glimmer DSL for LibUI application with this command:
 glimmer "scaffold[app_name]"
 ```
 
-That will generate the general MVC structure of a new Glimmer DSL for LibUI application.
+That will automatically generate the general MVC structure of a new Glimmer DSL for LibUI application and launch the application when done.
 
 For example, if we run:
 
@@ -659,6 +660,16 @@ Views live under `app/app_name/view` (e.g. `app/hello_world/view`)
 
 Models live under `app/app_name/model` (e.g. `app/hello_world/model`)
 
+The application runs automatically once scaffolding is done.
+
+![glimmer-dsl-libui-mac-scaffold-app-initial-screen.png](images/glimmer-dsl-libui-mac-scaffold-app-initial-screen.png)
+
+![glimmer-dsl-libui-mac-scaffold-app-preferences.png](images/glimmer-dsl-libui-mac-scaffold-app-preferences.png)
+
+![glimmer-dsl-libui-mac-scaffold-app-changed-greeting.png](images/glimmer-dsl-libui-mac-scaffold-app-changed-greeting.png)
+
+![glimmer-dsl-libui-mac-scaffold-app-about.png](images/glimmer-dsl-libui-mac-scaffold-app-about.png)
+
 Once you step into the application directory, you can run it in one of multiple ways:
 
 ```
@@ -679,12 +690,6 @@ glimmer run
 
 ![glimmer-dsl-libui-mac-scaffold-app-initial-screen.png](images/glimmer-dsl-libui-mac-scaffold-app-initial-screen.png)
 
-![glimmer-dsl-libui-mac-scaffold-app-preferences.png](images/glimmer-dsl-libui-mac-scaffold-app-preferences.png)
-
-![glimmer-dsl-libui-mac-scaffold-app-changed-greeting.png](images/glimmer-dsl-libui-mac-scaffold-app-changed-greeting.png)
-
-![glimmer-dsl-libui-mac-scaffold-app-about.png](images/glimmer-dsl-libui-mac-scaffold-app-about.png)
-
 The application comes with the [juwelier](https://rubygems.org/gems/juwelier) gem for auto-generating an application gem from the app `Rakefile` and `Gemfile` configuration (no need to manually declare gems in a gemspec... just use `Gemfile` normally and [juwelier](https://rubygems.org/gems/juwelier) takes care of the rest by generating an app gemspec automatically from `Gemfile`).
 
 You can package the newly scaffolded app as a Ruby gem by running this command:
@@ -725,6 +730,158 @@ hello_world
 
 ![glimmer-dsl-libui-mac-scaffold-app-initial-screen.png](images/glimmer-dsl-libui-mac-scaffold-app-initial-screen.png)
 
+### Scaffold Custom Window
+
+When you are in a scaffolded application, you can scaffold a new custom window (a window that you can put anything in to represent a view concept in your application) by running this command:
+
+```
+glimmer scaffold:customwindow[name,namespace]
+```
+
+The name represents the custom window view class name (it can be underscored, and Glimmer will automatically classify it).
+
+The namespace is optional and represents the module that the custom window view class will live under. If left off, the main application class namespace is used (e.g. the top-level `HelloWorld` class namespace for a `hello_world` application).
+
+You can also use the shorter `cw` alias for `customwindow`:
+
+```
+glimmer scaffold:cw[name,namespace]
+```
+
+For example by running this command under a `hello_world` application:
+
+```
+glimmer scaffold:cw[greeting_window]
+```
+
+That will generate this class under `app/hello_world/view/greeting_window`:
+
+```ruby
+class HelloWorld
+  module View
+    class GreetingWindow
+      include Glimmer::LibUI::CustomWindow
+    
+          
+      ## Add options like the following to configure CustomWindow by outside consumers
+      #
+      # options :title, :background_color
+      # option :width, default: 320
+      # option :height, default: 240
+  
+      ## Use before_body block to pre-initialize variables to use in body and
+      #  to setup application menu
+      #
+      # before_body do
+      #
+      # end
+  
+      ## Use after_body block to setup observers for controls in body
+      #
+      # after_body do
+      #
+      # end
+  
+      ## Add control content inside custom window body
+      ## Top-most control must be a window or another custom window
+      #
+      body {
+        window {
+          # Replace example content below with custom window content
+          content_size 240, 240
+          title 'Hello World'
+          
+          margined true
+          
+          label {
+            text 'Hello World'
+          }
+        }
+      }
+    end
+  end
+end
+```
+
+When the generated file is required in another view, the custom window keyword `greeting_window` become available and reusable, like by calling:
+
+```ruby
+greeting_window.show
+```
+
+Here is an example that generates a custom window with a namespace:
+
+```
+glimmer scaffold:cw[train,station]
+```
+
+That will generate this class under `app/station/view/train`:
+
+```ruby
+module Station
+  module View
+    class Train
+      include Glimmer::LibUI::CustomWindow
+    
+          
+      ## Add options like the following to configure CustomWindow by outside consumers
+      #
+      # options :title, :background_color
+      # option :width, default: 320
+      # option :height, default: 240
+  
+      ## Use before_body block to pre-initialize variables to use in body and
+      #  to setup application menu
+      #
+      # before_body do
+      #
+      # end
+  
+      ## Use after_body block to setup observers for controls in body
+      #
+      # after_body do
+      #
+      # end
+  
+      ## Add control content inside custom window body
+      ## Top-most control must be a window or another custom window
+      #
+      body {
+        window {
+          # Replace example content below with custom window content
+          content_size 240, 240
+          title 'Station'
+          
+          margined true
+          
+          label {
+            text 'Station'
+          }
+        }
+      }
+    end
+  end
+end
+```
+
+When that file is required, the `train` keyword becomes available:
+
+```ruby
+train.show
+```
+
+If for whatever reason, you end up with 2 custom window views having the same name with different namespaces, then you can invoke the specific custom window you want by including the Ruby namespace in underscored format separated by double-underscores:
+
+```ruby
+station__view__train.show
+```
+
+Or another `train` custom window view:
+
+```ruby
+hello_world__view__train.show
+```
+
 ## Girb (Glimmer IRB)
 
 You can run the `girb` command (`bin/girb` if you cloned the project locally) to do some quick and dirty experimentation and learning:

data/VERSION

@@ -1 +1 @@
-0.9.3
+0.9.4

data/lib/glimmer/rake_task/scaffold.rb

@@ -639,7 +639,7 @@ require '#{current_dir_name}/model/greeting'
           margined true
           
           label {
-            text <= [@greeting, :text]
+            #{%i[gem app].include?(window_type) ? "text <= [@greeting, :text]" : "text '#{human_name(custom_window_name)}'"}
           }
         }
       }

data/lib/glimmer/rake_task.rb

@@ -93,16 +93,16 @@ namespace :glimmer do
     Glimmer::RakeTask::Scaffold.app(args[:app_name])
   end
 
-#   namespace :scaffold do
-#     desc 'Scaffold Glimmer::UI::CustomWindow subclass (full window view) under app/views (namespace is optional) [alt: scaffold:cw]'
-#     task :customwindow, [:name, :namespace] do |t, args|
-#       require_relative 'rake_task/scaffold'
-#       Glimmer::RakeTask::Scaffold.custom_window(args[:name], args[:namespace])
-#     end
-#
-#     task :cw, [:name, :namespace] => :customwindow
-#     task :custom_window, [:name, :namespace] => :customwindow
-#     task :"custom-window", [:name, :namespace] => :customwindow
+  namespace :scaffold do
+    desc 'Scaffold Glimmer::UI::CustomWindow subclass (full window view) under app/views (namespace is optional) [alt: scaffold:cw]'
+    task :customwindow, [:name, :namespace] do |t, args|
+      require_relative 'rake_task/scaffold'
+      Glimmer::RakeTask::Scaffold.custom_window(args[:name], args[:namespace])
+    end
+
+    task :cw, [:name, :namespace] => :customwindow
+    task :custom_window, [:name, :namespace] => :customwindow
+    task :"custom-window", [:name, :namespace] => :customwindow
 #
 #     desc 'Scaffold Glimmer::UI::CustomControl subclass (part of a view) under app/views (namespace is optional) [alt: scaffold:cc]'
 #     task :customcontrol, [:name, :namespace] do |t, args|
@@ -159,7 +159,7 @@ namespace :glimmer do
 #     task :custom_window_gem, [:name, :namespace] => 'gem:customwindow'
 #     task :custom_control_gem, [:name, :namespace] => 'gem:customcontrol'
 #     task :custom_shape_gem, [:name, :namespace] => 'gem:customshape'
-#   end
+  end
   
   namespace :list do
     task :list_require do

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: glimmer-dsl-libui
 version: !ruby/object:Gem::Version
-  version: 0.9.3
+  version: 0.9.4
 platform: ruby
 authors:
 - Andy Maleh