Monkeybars 1.0.5

This is a fork of the Monkeybars project. I forked it off the latest (as of Oct-27-2009) commit in the official repository (30c1b8a27a4a424aed8aea07a66920db953ef992).

Reasons why I forked:

• I don’t like Project Kenai. (i.e. I did not find an option to fork a project there.)
• I probably change(d) things that the original creators and contributors would not approve.

I will soon publish a gem on gemcutter.

Substantial changes:

• The skeleton sets MB_ENV and MB_ROOT.
• View state does no longer contain a model object but a hash.
• The skeleton contains a folder for specs.
• The generate task puts source code into the src folder and has an option for generation a UI class which uses SwingSet.
• SwingSet is included in the jar file now, but you still can use any other Java class as your UI.
• MigLayout is included in the skeleton for UIs.

PROBLEMS

• Should rename the project a bit.
• Should provide a task to get the latest MigLayout jar.
• Should have more documentation. (The wiki will be filled soon, I promise.)
• Should make it easy to include gem, jar and other libraries.
• Should clean the tasks on the project, bones is driving me crazy…

ENVIRONMENT VARS

MB_ENV: Possible values:

• "development": You can use any installed libraries on your JRuby system. Nice because you do not need to include every library you want to try in your project. Will be set, if you have "development" on your command line. (e.g. jruby src/main.rb development)
• "production": Default value. You can only use libraries inside your project. (see kenai.com/projects/monkeybars/pages/UseRubyGemsInYourApplication)
• "spec:development": Default for spec. (jrake spec or jrake spec:development)
• "spec:production": jrake spec:production

MB_ROOT:

The root directory of the MB app.

INSTALL

build the gem and install it:

  git clone git://github.com/moser/Monkeybars.git
  cd Monkeybars
  jruby -S rake gem:install

wiki.github.com/moser/Monkeybars/getting-started

ORIGINAL README

Monkeybars 1.0.4

DESCRIPTION:

Monkeybars is a library that enables you to interface (via JRuby) with and take advantage of Swing without writing any Java directly. Using any editor you like, you create Java GUI elements and Monkeybars takes care of registering event listeners, receiving and handling events, updating your view from a model, etc. Monkeybars makes very few assumptions about your model or the structure of the code in your Java forms so it can be integrated into existing projects with a minimum of hassle.

FEATURES/PROBLEMS:

Needs more spec coverage

SYNOPSIS:

Mailing list, downloads and bug reports

The source, mailing list, discussion forums, issue tracking, and wiki is hosted by Kenai

 http://kenai.com/projects/monkeybars

Downloads are hosted by RubyForge

 http://rubyforge.org/projects/monkeybars

REQUIREMENTS:

  Java 1.6, Rake, JRuby 1.4 or later.

INSTALL:

There are three ways to obtain Monkeybars. All are located on the RubyForge project page ( rubyforge.org/projects/monkeybars).

  - Source distribution
  - Gem which includes a project generator, ideal for new projects
  - Jar file for integration into existing Java applications

LICENSE:

Monkeybars is licensed under the Ruby licence, see COPYING.txt.

ATTRIBUTION:

Monkeybars is the work of many contributors.

David Koontz - Core contributor, original author, tutorials Logan Barnett - Core contributor, nested views, signals, many bug fixes Mario Aquino - Core contributor, listener registration, Foxtrot integration, many bug fixes and specs James Britt - Fixes to documentation, build process, nested view bugs