guilded 1.0.0

data/.gitignore

@@ -0,0 +1,3 @@
+.* # Ignore all dotfiles...
+!.gitignore # except for .gitignore
+pkg/*

data/History.txt

@@ -0,0 +1,111 @@
+= 1.0.0 2009-10-15
+
+* It's about time for a 1.0.0 release
+* Updated the browser detector to be more robust in its detection abilities and provide more features
+
+
+= 0.3.0 2009-07-12
+
+* Added support for MooTools library.
+* Added :mootools option to the Guilder.add() method.  If true is passed into this option when adding a component, Guilded
+  will automatically add the mootools library to the libs collection so that the lib will be included in the assets the
+  page loads.
+* Updated the g_javascript_include_tag to resolve the :jquery and :mootools symbols to their respective libraries based
+  on the configuration of Guilded and the current running environment.
+
+
+= 0.2.9 2009-06-18
+
+* Added rescue code if the browser name or version fails.
+
+
+= 0.2.8 2009-06-12
+
+* Removed some code from the InactiveRecord:Base extension for human attrbiute hint that returns unless 
+  table_exists? as this does not make any sense for InactiveRecord.
+
+
+= 0.2.7 2009-06-10
+
+* Changed the BrowserDetector to need to be instantiated to use.  No longer just static methods.
+
+
+= 0.2.6 2009-06-10
+
+* Added some more view helpers for the browser detector.
+
+
+= 0.2.5 2009-06-10
+
+* Added BrowserDetector to assist with determining which browser is making a request.
+
+
+= 0.2.4 2009-05-29
+
+* Added add_data method to the Guilder object allowing named data structures to be passed to the JavaScript 
+  executing environment.
+* Added a jQuery event to the body DOM element called guildedInitialized.  To execute JavaScript code after all 
+  Guilded components are intialized, simply bind to this event.
+
+
+= 0.2.0 2009-04-06
+
+* Added human attribute hint support for InactiveRecord
+
+
+= 0.2.0 2009-03-27
+
+* Added Mark Perkins jquery-url plugin and made it a default library
+
+
+= 0.1.9 2009-03-26
+
+* Added Rails helper method to resolve REST path helpers and args
+
+
+= 0.1.5 2009-03-24
+
+* Added g_apply_style helper
+* Added functionality to put CSS link tags in the HTML header, where they belong
+
+
+== 0.1.4 2009-03-17
+
+* Added include_component? method for testing if a component type is already present in the Guilded elements collection
+* Fixed bug with Exception raising in add method
+
+
+== 0.1.2 2009-03-13
+
+* Fixed a bug with stylesheet and JS tag helpers.
+
+
+== 0.1.0 2009-03-12
+
+* Fixed a bug with requiring files.
+
+
+== 0.0.9 2009-03-12
+
+* Added Guilded::Rails::Helpers class to hold some common helpers for Rails components
+
+
+== 0.0.8 2009-03-12
+
+* Added attr_human_override and attr_human_hint
+
+
+== 0.0.7 2009-03-11
+
+* Bug fixes
+
+
+== 0.0.6 2009-03-11
+
+* Updated config file and Guilder to accept an :env variable.  This variable will allow Guilded to know what environment
+  it is running in so that it knows whether to cache assets, etc.
+
+
+== 0.0.1 2009-02-28
+
+* Initial release

data/README.rdoc

@@ -0,0 +1,219 @@
+= guilded
+
+http://github.com/midas/guilded/tree/master
+
+
+== DESCRIPTION
+
+Guilded is a framework for building web based components centered around current web standards and best practices. The current 
+framework is written in ruby, but could be ported to other languages.
+
+Guilded intends to provide a toolset for creating and consuming reusable web components.  Currently, this problem domain is
+filled with JavaScript frameworks.  These frameworks are wonderful and work very well.   However, they do not degrade gracefully and 
+are not accessible.  Guilded seeks to provide the same level of "componentization" and ease of use without sacrificing degradability 
+and accessibility.  Guilded will achieve these goals by applying each technology at our disposal (HTML, CSS and JavaScript) to do 
+as it was intended. 
+
+XHTML will be employed for content.  CSS used for layout and styling.  Behavior will be added to a component with JavaScript 
+through progressive enhancement.  The user will have the best experience with a Guilded component when CSS and JavaScript are 
+enabled in their browser, but will still be able to use the component when CSS and JavaScript are disabled. 
+
+Guilded will use jQuery as it's base JavaScript framework.  jQuery was chosen because it lends itself to progressive enhancement
+due to the way it was authored.  In addition, the tight integration of jQuery's selectors with CSS selectors is also highly 
+desirable.  When authoring a Guilded component, it is encouraged to write the behavior code as a jQuery plugin.  This will 
+allow the jQuery plugin to be used outside of the Guilded project, if desired.
+
+Guilded also seeks to provide a standardized CSS framework for creating layouts that are reusable and predictable.
+
+Guilded will utilize the currently existing RubyGems system to package its components.  A new Guilded component will be packaged 
+in a Gem and have a dependency on the Guilded gem.
+
+The Guilded gem contains the framework to build Guilded components.
+
+Update: Due to the quality components, etc. being generated by the MooTools community and the general quality of the library, we 
+have decided to include support for it in Guilded as of release 0.3.0.
+
+
+== FEATURES
+
+=== Centralized control of CSS and JavaScript assets needed to render a web page.
+* Automatic addition of jQuery 1.3.2 library.
+* Automatic addition of MooTools 1.2.3 library if a utilized component defines it as a dependency using the :mootools => true option
+  with the Guilder.add() method when defining the component.
+* Automatic addition of Yahoo's reset-min.css.
+* Redefinition of jQuery's $ method to $j and running jQuery in no conflict mode to allow other libraries to retain control 
+  of the $ method.
+* Definition of the g namespace to avoid JavaScript name collisions.  Simply define your custom functions within the g object.
+* Definition of convenience method $j().  Equivalent to jQuery() or $().  Guilded runs jQuery in no conflict mode, giving the $
+  back to any other JavaScript frameworks in use.  You must use $j() or jQuery() in lieu of $().
+* Definition of convenience method $jc().  Equivalent to jQuery( '.' + className ).
+* Definition of convenience method $jid().  Equivalent to jQuery( '#' + idName ). 
+* The assets required for each component are added by the author to a central data store.  When the view helper to create
+  the component is called, these assets are added to the asset store.  This results in a single method call with some options
+  to use a Guilded component.  No need to include JavaScript source files or CSS files.  Guilded automatically does this for 
+  you.
+* For CSS assets, Guilded simply loops through the collection of CSS assets creating an HTML link tag for each asset, or one 
+  HTML link tag for the cached version of these asset(s), when running in production mode.
+* For JavaScript assets, Guilded loops through the collection of JavaScript assets creating an HTML script tag for each, or a
+  single script tag for the cached version of these asset(s), when running in production mode.
+* Pass named data structures from the server to the client side environment for use with the Guilder.add_data() method.  Once Guilded
+  is initialized, the data structure will be instantiated for you with the name specified within the g object.
+* Execute custom JavaScript code after all Guilded components are initialized (ensuring everything you wish to use is instantiated) 
+  using the 'guildedInitialized' custom jQuery event defined on the body DOM element.
+* g_javascript_include_tag view helper that will explicitly add JavaScript libraries to the libs collection to be included in the 
+  assets.  This helper will also resolve any libs to their full or compressed versions dependent on the current executing environment.  
+  Additionally, the symbols :jquery and :mootools will be expanded to the lib version defined in the Guilded configuration.
+
+=== Caching of CSS and JavaScript assets needed to render a web page.
+* The CSS assets are cached to form one file.  In addition, the JavaScript assets are cached to form one file.  These files are 
+  named by sorting and concatenating into a single string the names of each individual respective asset.  This string is then hashed 
+  to generate a reproducable unique string.  This file naming technique allows Guilded to find cached asset files that 
+  match a combination of Guilded components, not an action, URI, etc.  Thus, one file for a certain combination of Guilded 
+  components is generated and then reused on any page where the combination appears.
+
+=== Automatic choosing of packed, compressed or minified JavaScript files when in production mode.
+* In production mode, Guilded automatically looks for a .pack, .compressed or .min version of the JavaScript assets.  If one of 
+  these is found, it includes it, otherwise, it includes the version specified by the author in the view helper.  This is usually 
+  an unpacked version of the file.
+
+=== Additional common utilities
+* Determine the browser making a request with the BrowserDetector class and related view helpers.
+* Extends ActiveRecord to have a attr_human_hint method.  This method works similar to the attr_human_name method except a hint
+  to use on forms, etc is being set.
+* Extends InactiveRecord (http://github.com/midas/inactive_record/tree/master) to include the attr_human_hint method.
+
+
+== GUILDED COMPONENT PROJECTS
+
+* http://github.com/midas/g_already_grid/tree/master
+* http://github.com/midas/g_auto_completer/tree/master
+* http://github.com/midas/g_flash_growler/tree/master
+* http://github.com/midas/g_flot/tree/master
+* http://github.com/midas/g_form_submit_protector/tree/master
+* http://github.com/midas/g_named_scope_filters/tree/master
+* http://github.com/midas/g_nested_select/tree/master
+* http://github.com/midas/g_sectioned_shower/tree/master
+* http://github.com/midas/g_toggle_block/tree/master
+
+
+== PROBLEMS
+
+
+
+== REQUIREMENTS
+
+* jQuery 1.3.2 (included in Guilded)
+
+
+== OPTIONALS
+
+* MooTools 1.2.3 (included in Guilded)
+
+
+== INSTALL
+
+  gem sources -a http://gems.github.com
+  sudo gem install midas-guilded
+
+
+== INSTALL FOR RAILS
+
+Add to environment file:
+
+  config.gem "guilded", :version => '1.0.0'
+
+Run:
+
+  sudo rake:gems:install
+	
+Generate:
+
+  script/generate guilded_config
+  script/generate guilded_assets
+
+
+Edit the settings file at config/initializers/load_guilded_settings.rb.  Change any of these settings to reflect how
+you would like Guilded to be configured.  If you change where any file(s) are configured to be located, then also move 
+the respective file(s).
+
+
+== USAGE
+
+=== COMPONENT FRAMEWORK
+
+You must make a call to the view helper to apply the CSS  It should be placed in your layout:
+
+  <%= g_apply_style %>
+
+There is also a view helper to apply the JavaScript.  You can place this at the bottom of your layout(s) (so you
+do not have to include it in every template):
+
+  <%= g_apply_behavior %>
+
+You also must reset the Guilded singleton that manages everything after each rendering.  The best way to do this is a before 
+filter in your application controller:
+
+  before_filter :reset_guilded
+	
+  #...
+	
+  protected
+	
+  def reset_guilded
+    Guilded::Guilder.instance.reset!
+  end
+
+Then install one or more Guilded components and you are on your way!
+
+=== BROWSER DETECTOR
+
+The browser detector uses the HTTP user agent string to determine which browser is making the current request.  The detector
+can determine the name, version, major version, minor version, build version and revision version of the current browser.
+
+If using Rails, there are several view helpers available that use the BrowserDetector: g_browser_name(), g_browser_version(),
+g_browser_full_name() and g_browser_is?().
+
+The following examples will assume Firefox 3.5.3 on OS/X is being used.  The user agent string for Firefox 3.5.3 on OS/X is:
+
+  Mozilla/5.0 (Macintosh; U; Intel Mac OS X 10.6; en-US; rv:1.9.1.3) Gecko/20090824 Firefox/3.5.3
+
+g_browser_name
+
+  <% if g_browser_name == 'firefox' %>
+    ...
+
+g_browser_version
+
+  <% if g_browser_version == '3.5.3' %>
+    ...
+
+g_browser_full_name
+
+  <%= g_browser_full_name # Outputs: Firefox 3.5.3 %>
+
+g_browser_is?
+
+  <% if g_browser_is?( :name => 'firefox', :version => '3.5.3' ) %>
+    ...
+
+  <% if g_browser_is?( :name => 'firefox', :major_version => '3' ) %>
+    ...
+
+  <% if g_browser_is?( :name => :firefox, :major_version => 3, :minor_version => 5, :build_version => 3 ) %>
+    ...
+
+  <% if g_browser_is?( :name => :firefox, :major_version => 3, :minor_version => 5, :build_version => 3, :revision_version => 0 ) %>
+    ...
+
+
+== LICENSE
+
+Copyright (c) 2009 C. Jason Harrelson (midas)
+
+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.

data/Rakefile

@@ -0,0 +1,56 @@
+require 'rubygems'
+require 'rake'
+
+begin
+  require 'jeweler'
+  Jeweler::Tasks.new do |gem|
+    gem.name = "guilded"
+    gem.summary = %Q{A framework for building web based components centered around current web standards and best practices.}
+    gem.description = %Q{Guilded intends to provide a toolset for creating and consuming reusable web components.  Currently, this problem domain is filled with JavaScript frameworks.  These frameworks are wonderful and work very well.   However, they do not degrade gracefully and are not accessible.  Guilded seeks to provide the same level of "componentization" and ease of use without sacrificing degradability and accessibility.  Guilded will achieve these goals by applying each technology at our disposal (HTML, CSS and JavaScript) to do as it was intended.}
+    gem.email = "jason@lookforwardenterprises.com"
+    gem.homepage = "http://github.com/midas/guilded"
+    gem.authors = ["C. Jason Harrelson (midas)"]
+    gem.add_dependency "activesupport", ">= 2.0.2"
+  end
+  Jeweler::GemcutterTasks.new
+rescue LoadError
+  puts "Jeweler (or a dependency) not available. Install it with: sudo gem install jeweler"
+end
+
+require 'rake/testtask'
+Rake::TestTask.new(:test) do |test|
+  test.libs << 'lib' << 'test'
+  test.pattern = 'test/**/*_test.rb'
+  test.verbose = true
+end
+
+begin
+  require 'rcov/rcovtask'
+  Rcov::RcovTask.new do |test|
+    test.libs << 'test'
+    test.pattern = 'test/**/*_test.rb'
+    test.verbose = true
+  end
+rescue LoadError
+  task :rcov do
+    abort "RCov is not available. In order to run rcov, you must: sudo gem install spicycode-rcov"
+  end
+end
+
+task :test => :check_dependencies
+
+task :default => :test
+
+require 'rake/rdoctask'
+Rake::RDocTask.new do |rdoc|
+  if File.exist?('VERSION')
+    version = File.read('VERSION')
+  else
+    version = ""
+  end
+
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title = "tester #{version}"
+  rdoc.rdoc_files.include('README*')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end

data/VERSION

@@ -0,0 +1 @@
+1.0.0

data/guilded.gemspec

@@ -0,0 +1,90 @@
+# Generated by jeweler
+# DO NOT EDIT THIS FILE
+# Instead, edit Jeweler::Tasks in Rakefile, and run `rake gemspec`
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{guilded}
+  s.version = "1.0.0"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["C. Jason Harrelson (midas)"]
+  s.date = %q{2009-10-17}
+  s.description = %q{Guilded intends to provide a toolset for creating and consuming reusable web components.  Currently, this problem domain is filled with JavaScript frameworks.  These frameworks are wonderful and work very well.   However, they do not degrade gracefully and are not accessible.  Guilded seeks to provide the same level of "componentization" and ease of use without sacrificing degradability and accessibility.  Guilded will achieve these goals by applying each technology at our disposal (HTML, CSS and JavaScript) to do as it was intended.}
+  s.email = %q{jason@lookforwardenterprises.com}
+  s.extra_rdoc_files = [
+    "README.rdoc"
+  ]
+  s.files = [
+    ".gitignore",
+     "History.txt",
+     "README.rdoc",
+     "Rakefile",
+     "VERSION",
+     "guilded.gemspec",
+     "lib/guilded.rb",
+     "lib/guilded/browser_detector.rb",
+     "lib/guilded/component_def.rb",
+     "lib/guilded/exceptions.rb",
+     "lib/guilded/guilder.rb",
+     "lib/guilded/rails.rb",
+     "lib/guilded/rails/active_record/human_attribute_hint.rb",
+     "lib/guilded/rails/active_record/human_attribute_override.rb",
+     "lib/guilded/rails/helpers.rb",
+     "lib/guilded/rails/inactive_record/human_attribute_hint.rb",
+     "lib/guilded/rails/view_helpers.rb",
+     "rails_generators/guilded_assets/guilded_assets_generator.rb",
+     "rails_generators/guilded_assets/templates/guilded.js",
+     "rails_generators/guilded_assets/templates/guilded.min.js",
+     "rails_generators/guilded_assets/templates/jquery-1.2.6.js",
+     "rails_generators/guilded_assets/templates/jquery-1.2.6.min.js",
+     "rails_generators/guilded_assets/templates/jquery-1.3.2.js",
+     "rails_generators/guilded_assets/templates/jquery-1.3.2.min.js",
+     "rails_generators/guilded_assets/templates/jquery-url.js",
+     "rails_generators/guilded_assets/templates/jquery-url.min.js",
+     "rails_generators/guilded_assets/templates/mootools-1.2.3.js",
+     "rails_generators/guilded_assets/templates/mootools-1.2.3.min.js",
+     "rails_generators/guilded_assets/templates/reset-min.css",
+     "rails_generators/guilded_config/guilded_config_generator.rb",
+     "rails_generators/guilded_config/templates/load_guilded_settings.rb",
+     "script/console",
+     "script/destroy",
+     "script/generate",
+     "tasks/rails.rake",
+     "tasks/rspec.rake",
+     "test/guilded/browser_detector_test.rb",
+     "test/guilded/component_def_test.rb",
+     "test/guilded/guilder_test.rb",
+     "test/guilded/rails/helpers_test.rb",
+     "test/guilded/rails/view_helpers_test.rb",
+     "test/guilded_test.rb",
+     "test/test_helper.rb"
+  ]
+  s.homepage = %q{http://github.com/midas/guilded}
+  s.rdoc_options = ["--charset=UTF-8"]
+  s.require_paths = ["lib"]
+  s.rubygems_version = %q{1.3.5}
+  s.summary = %q{A framework for building web based components centered around current web standards and best practices.}
+  s.test_files = [
+    "test/guilded/browser_detector_test.rb",
+     "test/guilded/component_def_test.rb",
+     "test/guilded/guilder_test.rb",
+     "test/guilded/rails/helpers_test.rb",
+     "test/guilded/rails/view_helpers_test.rb",
+     "test/guilded_test.rb",
+     "test/test_helper.rb"
+  ]
+
+  if s.respond_to? :specification_version then
+    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::RubyGemsVersion) >= Gem::Version.new('1.2.0') then
+      s.add_runtime_dependency(%q<activesupport>, [">= 2.0.2"])
+    else
+      s.add_dependency(%q<activesupport>, [">= 2.0.2"])
+    end
+  else
+    s.add_dependency(%q<activesupport>, [">= 2.0.2"])
+  end
+end