glimmer 0.10.4 → 1.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4fbfd6caf79d10dbaeb2d737d68a8f028819d6172f45a8b494d1a88c34e3e04b
-  data.tar.gz: 9fcbc6d1948ced1b67192aeb22a25420b9a165930bc084e30534141c2f65a1fb
+  metadata.gz: 7b0649c15df47ea25dfacee159d334e1ba296468477d9e46229fbb99d73725e4
+  data.tar.gz: 52b2d756a2d8c24cc2fa1f6072a4084d87d8c08198183159ef31ddb5b105634d
 SHA512:
-  metadata.gz: b5809d0f9a9ae9536dfaf0ff74612c44a74df732d3ea7db7a8102aec6e434373104f9fba13a1aa3c1109faad754cfa390c3ac57bbd5de379f31441d9d61357d0
-  data.tar.gz: 4d5d53bd6881b462b2aa2ca36ddcd2e41ab61862f5162e0a888288596609271fb5e8e3130a9c99647d7226ed1373ee1b2a6477d8e5660ec13bbb615f5a853b72
+  metadata.gz: 697d512b1ed187adf8a385fbaf6b7b5f21ae9a96a2896f08e3a718839adc0af0c6fac93aa2fb2ecc5f6c84e898b6e3ce1caf264e2b095d6de71a1a3ed96699c3
+  data.tar.gz: b9a8fb00ada502c70b4b9d6401596807ad2a881b6926b9150c6f29ca7f687e1eee824f88ee1fb99dae845e338d2a92fdde0c388ec8366a83e724efe6a4d20b45

data/CHANGELOG.md

@@ -0,0 +1,361 @@
+# Change Log
+
+Related Change Logs:
+- [glimmer-dsl-swt/CHANGELOG.md](https://github.com/AndyObtiva/glimmer-dsl-swt/blob/master/CHANGELOG.md)
+
+## 1.0.0
+
+- Code/Documentation preparation for version 1.0.0
+
+## 0.10.4
+
+- Support Glimmer::Config.log_excluded_keywords option for whether or not to log keywords that are excluded by Glimmer::Config.excluded_keyword_checkers
+
+## 0.10.3
+
+- Made Glimmer::Config module more resilient to invalid logger level values set via GLIMMER_LOGGER_LEVEL env var
+
+## 0.10.2
+
+- Added observer notification support for all Array mutation methods in ObservableArray (e.g. `delete_if`, `select!`, `uniq!`, `collect!`, etc...)
+
+## 0.10.1
+
+- excluded_keyword_checkers option for filtering certain keywords from Glimmer DSL processing 
+- Updates to logging levels to be more appropriate
+- Fixed an issue to avoid crashing when calling observer.unregister/unobserve on a non-observable
+
+## 0.10.0
+
+- Remove Glimmer::Config.enable_logging method
+- Refactor Glimmer config logger and reset level to error
+- Update all logger calls to lazy blocks
+
+## 0.9.5
+
+- Removed resetting of DSL Engine upon encountering an exception as it is not needed and sometimes causes the wrong behavior
+
+## 0.9.4
+
+- Fix issue with observing attributes on classes directly instead of their objects
+
+## 0.9.3
+
+- Add infinite loop detection support to avoid infinite loops (breaks after 100 repetitions)
+- Add Glimmer::Config option to specify loop max limit or disable completely
+- ExcludedKeywordError with no logging for excluded keywords such as `to_a` and `to_h`
+
+## 0.9.2
+
+- Extracted common model data-binding classes from glimmer-dsl-swt
+
+## 0.9.1
+
+- Display error message if Glimmer DSL was invoked without any configured DSLs
+
+## 0.9.0
+
+- Extracted Glimmer DSL for SWT into glimmer-dsl-swt gem
+- Extracted Glimmer DSL for XML into glimmer-dsl-xml gem
+- Extracted Glimmer DSL for CSS into glimmer-dsl-css gem
+- Introduced Glimmer DSL for Opal in glimmer-dsl-swt gem
+
+## 0.8.2
+
+- `message_box` DSL keyword
+- Table single/multi selection databinding
+- Table cell editing databinding
+- Enhance table listener events with table_item and column_index methods
+- Fix `Glimmer::SWT::ShellProxy#pack_same_size` for Linux
+
+## 0.8.1
+
+- Fix Glimmer::SWT::ShellProxy#pack_same_size for Windows
+
+## 0.8.0
+
+- Delegate listeners for menu items (:cascade) encapsulated by menus (dropdown menus)
+- Make custom widget option method receive "default: hash key" instead of 2nd argument (adjusting scaffolding accordingly)
+- Move about/preferences menu listeners from ShellProxy to DisplayProxy where they truly belong (adjusting scaffolding accordingly)
+
+## 0.7.8
+
+- Fix verbiage for summary/description in scaffolding custom shell gems (change custom widget reference to custom shell)
+- Scaffolding builds a proper binary for custom shell gems and includes it in executables in Rakefile
+- Scaffolding adds about/preferences menu actions to apps/custom-shell-gems
+- Make custom widget/shell options writable 
+- Support "dialog" Glimmer DSL keyword
+
+## 0.7.7
+
+- Fix issue with scaffolding apps with dash in their name
+- Make scaffolded custom shells launchable as standalone apps (native executables) too
+
+## 0.7.6
+
+- Support text widget selection data-binding explicitly
+- Make specs pass on Linux
+- Maintain tree item expansion on data-binding related changes
+- Make scaffolded apps launch from bin file not app file
+
+## 0.7.5
+
+- Make :virtual a default tree SWT style
+- Support Tree selection databinding (just like List)
+- Support built-in Tree editing (i.e. editing tree item text)
+- Support unregistering widget listeners
+- Added tab item proxy dispose method that automatically unsets/disposes tab item inner control before disposing tab item itself
+
+## 0.7.4
+
+- Have tree data-binding auto-embed models as tree item data
+- TreeProxy#depth_first_search implementation
+- Support read-only data-binding
+
+## 0.7.3
+
+- Fix issue with rake tasks getting included twice
+- Fix pack_same_size for shell_proxy
+- Add pack_same_size to widget_proxy similar to that of shell_proxy
+
+## 0.7.2
+
+- Fix issue with data binding a nested value with an on_read converter block not getting triggered if model value was nil
+- Fix issue with glimmer command triggered rake tasks not honoring glimmer application local Rakefile settings
+
+## 0.7.1
+
+- Fix crash issue with data-binding widget properties that are not supported in both directions
+- Fix issue with scaffolding gems not having the right name
+- Fix display of rdoc gem message on every glimmer app run
+- Fix issues in closing a shell in girb
+- Fix issue with Glimmer not clearing DSL Engine parent stacks when DSL interpretation raises exception
+- Fix freezing issue upon logging observables and raising observable errors by overriding inspect on Observable to avoid printing nested tree of observers
+- Added validation for shell widget parentage (accepting a shell or nil) in shell expression
+- Support bidirectional data-binding of menu item selection (e.g. radio menu item)
+- Make shell auto-activate on show with 0.25 delay 
+
+## 0.7.0
+
+- Expose `rake glimmer:package` rake task via `glimmer package` command
+- Scaffold a Glimmer app: provide a standard structure for building a Glimmer app (models, views, and assets [images, videos, sounds])
+- Scaffold a Glimmer custom shell
+- Scaffold a Glimmer custom widget
+- Scaffold a Glimmer custom widget gem
+- Scaffold a Glimmer custom shell gem
+- Extract Video widget into its own custom widget glimmer-video gem
+- Extract Gladiator into its own custom shell glimmer-gladiator gem
+- Support disable_dsl/enable_dsl/enabled_dsls=
+- Minify CSS produced by CSS DSL
+- Avoid using p in CSS DSL as it clashes with HTML p. Use pv instead (property value).
+- Configure scaffold rspec_helper with glimmer-appropriate after block
+- Move logger/import_swt_packages methods on Glimmer to Glimmer::Config
+- Reorganize samples as hello and elaborate inside samples directory
+
+## 0.6.0
+
+- Added multi-DSL support back to Glimmer
+- Glimmer XML (HTML) DSL
+- Glimmer CSS DSL
+- Support mixing DSLs (e.g. SWT browser widget that has an XML text)
+- Fixed Gladiator issue with not saving on quit
+- Made color, rgb, and rgba SWT DSL static expressions instead of dynamic
+
+## 0.5.11
+
+- Added file and url attribute writers to `video` widget
+- Fix Gladiator issue with empty replace text field
+- Fix Gladiator issue with opening empty file
+- Support picking up VERSION and LICENSE.txt files in glimmer:package rake task
+- Update packaging to build app DMG file with humanized name (having spaces for multiple words) and to autoset a default mac bundle ID
+
+## 0.5.10
+
+- Fix video widget scrolling bar appearing issue
+- Ensure on_about/on_preferences menu items are ignored on Windows
+- Support SWT negative symbols postfixed by exclamation mark (e.g. :max! for no :max)
+- Fix a bug in girb that made it not start anymore
+- Fix a bug in Gladiator when jumping to line before a caret has been set
+
+## 0.5.9
+
+- Allow discovery of custom widgets without namespace if there are no existing classes with same name
+- Add filters (global listeners) to SWT Display
+- ShellProxy #pack and #pack_same_size methods
+- Added Gladiator (Glimmer Editor) sample and command
+
+## 0.5.8
+
+- Support hooking into About and Preferences application menu items
+- Support passing multiple SWT styles to a shell
+
+## 0.5.7
+
+- Make mixing Glimmer into a class enable Glimmer DSL in both class instance scope and singleton class scope
+- Remove app_name and app_version since they show up from plist file upon Mac packaging
+- Change default packaged app name (shows up in top menu bar on Mac) to humanized form (e.g. MathBowling becomes Math Bowling)
+- Provide README instructions and easy packaging options for signing apps (Glimmer::Package.javapackager_extra_args)
+
+## 0.5.6
+
+- Add `rake glimmer:package:config` command to generate JAR config file
+- Enabling passing extra args to javapackager via `JAVAPACKAGER_EXTRA_ARGS="..." rake glimmer:package`
+
+## 0.5.5
+
+- shell widget args for SWT Display app name and app version
+- Glimmer DSL colors lazy initialize and don't have an SWT Display object dependency anymore
+- Glimmer DSL Menu/MenuItem support
+
+## 0.5.4
+
+- Support custom data-binding property converters for nested/index data-binding
+- Add glimmer command --log-level option
+- Add glimmer command env var support
+- Improvements to video widget (new methods and events to listen to)
+
+## 0.5.3
+
+- Upgraded rake dependency to 10.1.0 to avoid conflicting dependencies
+- Stopped disposing display upon closing a shell to allow reuse
+- Support custom data-binding property converters
+- Automatic re-packing of shell when layout or layout data is updated with data-binding
+
+## 0.5.2
+
+- Support publishing a Glimmer app for the Mac (package as dmg file)
+- Fix background_image widget property support to accept files in a JAR file
+- Fix video widget support to accept files in a JAR file
+
+## 0.5.0
+
+- Upgraded SWT to version 4.15
+- Upgraded to JRuby 9.2.11.1
+- Refurbished/refactored Glimmer code design and APIs getting a performance boost
+- Scraped XML and multi-DSL support
+- Renamed `#add_contents` to `#content`
+- made it configurable to include SWT Packages or not
+- Supported color keyword for standard colors
+- Supported swt keyword for style
+- Supported async_exec/sync_exec keywords in Glimmer DSL directly
+- Changed "def body" to body { } in custom widget/shell
+- Renamed commands to keywords in Glimmer
+- Made Glimmer::Launcher automatically figure out dev mode when run as bin/glimmer locally
+- Added LOAD_PATH explicitly
+
+## 0.4.9
+- Added `org.eclipse.swt.custom` to default list of Glimmer SWT packages
+- Added Custom Shell
+- Made shell `#open` method remember if it was already opened before yet hidden, and just show the shell
+- Implement shell `#hide` method
+- Alias shell `#open` as `#show`
+- Support CustomWidget/CustomShell Custom Property Observers
+- Support on_*** observers on WidgetProxy's directly
+- Support on_event_*** observers for SWT.constant event listeners (like show and hide)
+- Added widget focus listener and data-binding support
+- Support Glimmer DSL observe keyword and make it return observer registration object to unregister later on (unobserve)
+- Support CustomWidget before_body and after_body hooks
+- Make Glimmer DSL block provide parent Glimmer object (not SWT widget) as block argument
+- Give widgets/custom-widgets ability to add content (properties/nested widgets) after construction via `#content` method
+- Update setBackgroundImage to take an image path string for convenience (instead of an SWT image)
+
+## 0.4.8
+- Video widget
+- Girb fix to auto-include Glimmer
+
+## 0.4.7
+- Fixed issues with custom widget support working for custom table, custom combo, custom list, parent of layout/layout-data, and on_*** observers
+- Support for custom attributes/observers on a custom widget
+- Display error message when using tab item widget NOT under a tab folder
+
+## 0.4.6
+- Added SWT 4.14 library jars directly in project
+
+## 0.4.5
+- SWT Browser widget support
+
+## 0.4.4
+- Glimmer Custom Widget support
+- Support --debug flag
+
+## 0.4.3
+- Provide an easy way to make windows non-resizable
+- Shorten needed :color_xyz symbols for known widget color properties like background and foreground to :xyz
+- Friendly error message for passing a bad widget property font style (not normal, bold, italic)
+- Friendly error message for passing a bad SWT style in general
+- Support a single computed data binding as a string (not array)
+
+## 0.4.2
+- Center window upon opening
+- Set window minimum width (130) upon opening
+- Accept SWT Shell constructor arguments
+
+## 0.4.1
+- SWT Layout DSL support
+- SWT Layout Data DSL support
+
+## 0.4.0
+- Changed `BlockObserver` into `Observer.proc`
+- Added `Observer#proc` to create simple block-based observers.
+- Updated Observer API renaming `#update` to `#call`
+- Renamed `R` prefixed classes (i.e. Ruby) to `G` prefixed classes (i.e. Glimmer) (e.g. `RWidget` becomes `WidgetProxy`)
+- Namespaced all of Glimmer's classes and modules under `Glimmer`
+- Added `display` Glimmer DSL keyword to instantiate an SWT Display
+- Removed `String` and `Symbol` monkey-patching
+- Accept standard color value passed to widget color properties as `String` or `Symbol`
+
+## 0.3.5
+- Added font support to Glimmer DSL via name/height/style hash
+- Added SWTProxy to easily build SWT constants (e.g. SWTProxy[:border] is SWT::BORDER )
+
+## 0.3.4
+- Fixed color support/property converter support to work both in data-binding and in static property setting
+
+## 0.3.3
+- Added color support to Glimmer DSL (rgb, rgba, and :color_*)
+
+## 0.3.2
+- Automatically import SWT packages when including/extending Glimmer
+- Automatically enhance objects as ObservableArray or ObservableModel when observing them
+
+## 0.3.1
+- Fixed issue related to unnecessary tracking of parents in Observer
+
+## 0.3.0
+- Automatic cleanup of observers upon updating values in data-binding (nested/indexed) or disposing a widget
+- Change of APIs whereby Observer class is responsible for registering observers with observables on properties
+
+## 0.2.5
+- Register a property type converter for `visible` property in widget binding, to ensure converting to boolean before setting in SWT widget.
+
+## 0.2.4
+- Added nested indexed computed property data binding support (e.g. bind(person, 'addresses[0].street_count', computed_by: ['addresses[0].streets']))
+
+## 0.2.3
+- Fixed nested indexed property data binding support for indexed leaf property (e.g. bind(person, 'names[1]'))
+
+## 0.2.2
+- Added nested indexed property data binding support (e.g. bind(person, 'addresses[1].street'))
+
+## 0.2.0
+- Upgraded to JRuby 9.2.10.0
+- Fixed support for Windows & Linux
+- Removed need to download SWT by including directly in gem for all platforms
+- Simplified usage of glimmer command by preloading glimmer and not requiring setup
+
+## 0.1.11.SWT4.14
+- Upgraded SWT to version 4.14
+
+## 0.1.11.470
+- Nested property data binding support
+
+## 0.1.10.470
+- Support Tree data-binding (one-way from model to tree)
+
+## 0.1.8.470
+- girb support
+
+## 0.1.5.470
+- Glimmer now uses a Ruby Logger in debug mode to provide helpful debugging information
+- Glimmer has a smart new Ruby shell script for executing applications
+- Glimmer now downloads swt.jar automatically when missing (e.g. 1st run) on Mac, Windows, and Linux, and for x86 and x86-64 CPU architectures.

data/CONTRIBUTING.md

@@ -0,0 +1,62 @@
+# Contributing
+
+Please follow [glimmer-dsl-swt/CONTRIBUTING.md](https://github.com/AndyObtiva/glimmer-dsl-swt/blob/master/CONTRIBUTING.md) too.
+
+## Pre-requisites
+
+- MacOS
+- Other pre-requisites mentioned in [README.md](https://github.com/AndyObtiva/glimmer/tree/master#pre-requisites)
+
+## Machine Setup
+
+Follow these steps, running mentioned commands in the terminal:
+- Fork project repo
+- Ensure pre-requisites installed (installing JRuby via RVM on the Mac)
+- cd into project again to activate RVM glimmer gemset
+- gem install bundler
+- bundle
+- rake # runs specs (ensure they finish successfully)
+- Once done, open a pull request with master branch.
+
+### rspec
+
+`rake` or `rake spec` runs all specs.
+
+To run a specific spec file, run:
+```
+rake SPEC=spec_file_path
+```
+
+To run a specific spec, run:
+```
+rake SPEC=spec_file_path:line_number
+```
+
+To display Glimmer debug information, add `GLIMMER_DEBUG=true`:
+```
+rake SPEC=spec_file_path:line_number GLIMMER_DEBUG=true
+```
+
+Note: make sure not to use the keyboard or mouse while tests are running since they bring up UI elements behind the scenes (invisible). This avoids fudging them and causing false test failures. If you get obscure failures related to focus of widgets, they are most likely false negatives. Just rerun the specs without touching the keyboard or mouse and they would pass if they are not really broken.
+
+### build
+
+`rake build` builds the Glimmer gem under the `pkg` directory.
+
+### glimmer command
+
+To run a glimmer sample, run local `bin/glimmer` command:
+```
+bin/glimmer samples/hello_world.rb
+```
+
+It will notify you that you are in development mode.
+
+### girb command
+
+To experiment with glimmer syntax using `girb`, run local `bin/girb`:
+```
+bin/girb
+```
+
+It will notify you that you are in development mode.

data/LICENSE.txt

@@ -1,4 +1,4 @@
-Copyright (c) 2011-2020 Andy Maleh
+Copyright (c) 2007-2020 Andy Maleh
 
 Permission is hereby granted, free of charge, to any person obtaining
 a copy of this software and associated documentation files (the

data/PROCESS.md

@@ -0,0 +1,35 @@
+# Glimmer Process (Beyond Agile)
+
+**Glimmer Process** is the lightweight software development process used for building [Glimmer](https://github.com/AndyObtiva/glimmer) libraries and [Glimmer](https://github.com/AndyObtiva/glimmer) apps, which goes beyond Agile, rendering all Agile processes obsolete. **Glimmer Process** is simply made up of 7 guidelines to pick and choose as necessary until software development needs are satisfied. Not all guidelines need to be incorporated into every project, but it is still important to think through every one of them before ruling any out. Guidelines can be followed in any order. 
+
+## GPG (Glimmer Process Guidelines):
+- **Requirements Gathering**: Spend no more than a few hours writing the initial requirements you know from the business owner, gathering missing requirements, and planning to elicit more requirements from users, customers, and stakeholders. Requirements are not set in stone, but serve as a good starting point in understanding what a project is about. After initial release, only document small tasks going forward.
+- **Software Architecture and Design Diagrams**: Perform software architecture and design activities as necessary by analyzing requirements and creating diagrams.
+- **Initial Release Plan**: This guideline's motto is "Plans are Nothing. Planning is Everything" (said by Dwight D. Eisenhower) because the initial release plan is not set in stone and might change completely, but is still invaluable in launching a new project forward. Consider including alpha releases (for internal testing) and beta releases (for customer testing).
+- **Small Releases**: Develop and release in small increments. Do not release more than 3-weeks worth of work, preferring releases that are shorter than a week worth of work whenever possible. Break releases down. If you need to support multiple platforms, release for a platform at a time. If a feature includes a number of other features, then release them one by one instead of all at once. If a feature involves multiple options, release the default version first, and then release extra options later.
+- **Usability Testing**: Make sure to observe a user using your software the first few releases or when releasing critical brand new unproven features. Ask them to complete a list of goals using the software, but do not help them to complete them unless they get very stuck. Write down notes silently while observing them use your software. Once done with usability testing, you may then ask further questions about any of the notes you wrote down, and afterwards add the notes as feature enhancements and bug fixes. Implement them and then do another usability test with the improvements in place. Repeat as necessary only.
+- **Automated Tests**: Cover sensitive parts of the code with automated tests at the appropriate level of testing needed. Run tests in a continuous integration server.
+- **Refactoring**: Simplify code, eliminate code duplication, improve code organization, extract reusable components, and extract reusable libraries at every opportunity possible.
+
+--
+
+Copyright (c) 2020 Andy Maleh
+ 
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+ 
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+ 
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.