shway 3.0

data/CHANGELOG

@@ -0,0 +1,11 @@
+========================================
+2009-07-28  BRANCH v3.0
+----------------------------------------
+
+SHWAY
+-created 'shway' gem and took only what was needed from the plugins.
+-this CHANGELOG is only partially populated. Once I test this out a bit I'll do a proper changelog.
+-I am releasing the gem from the branch for now. I will merge it all to trunk once I am sure it all works properly.
+
+
+

data/Manifest

@@ -0,0 +1,41 @@
+CHANGELOG
+init.rb
+install.rb
+install_files/javascripts/iepngfix.htc
+install_files/javascripts/iepngfix_tilebg.js
+install_files/stylesheets/reset.css
+install_files/templates/example_presenter.rb
+install_files/templates/example_stylesheet.css.rb
+lib/rubygems/commands/shway_init_command.rb
+lib/rubygems_plugin.rb
+lib/shway/controllers/shway_controller.rb
+lib/shway/css/css_helper.rb
+lib/shway/css/css_parser.rb
+lib/shway/css/css_styles.rb
+lib/shway/extensions/routing_extensions.rb
+lib/shway/helpers/html_helper.rb
+lib/shway/helpers/shway_controller_helper.rb
+lib/shway/helpers/shway_helper.rb
+lib/shway/presenters/shway_model_presenter.rb
+lib/shway/presenters/shway_presenter.rb
+lib/shway/test/shway_test_helper.rb
+lib/shway.rb
+Manifest
+Rakefile
+README
+templates/css.html.erb
+templates/css.rhtml
+test/shway_core/css_config_test.rb
+test/shway_core/css_helper_test.rb
+test/shway_core/css_parser_test.rb
+test/shway_core/html_helper_test.rb
+test/shway_core/shway_controller_test.rb
+test/shway_core/shway_core_test_helper.rb
+test/shway_core/shway_helper_test.rb
+test/shway_core/shway_presenter_test.rb
+test/shway_core/shway_routes_test.rb
+test/shway_core/views/mock_foos/_list_header.html.erb
+test/shway_core/views/mock_foos/_list_item.html.erb
+test/shway_core/views/model_list/list_for_action.html.erb
+test/shway_core/views/model_list/list_item_for_action.html.erb
+test/shway_core/views/shway_helper_test.html.erb

data/README

@@ -0,0 +1,14 @@
+Shway
+=============
+
+shway is a Rails gem that provides powerful UI programming with dynamic css and presenters. Shway was developed by Ryan Owens.
+
+
+== Install
+
+gem install shway
+
+== Usage
+
+...coming soon
+

data/Rakefile

@@ -0,0 +1,47 @@
+require 'rake'
+require 'rake/testtask'
+require 'rake/rdoctask'
+
+#desc 'Default: run unit tests.'
+task :default => :test
+
+#desc 'Test the simply_helpful plugin.'
+Rake::TestTask.new(:test) do |t|
+ t.libs << 'lib'
+ t.pattern = 'test/**/*_test.rb'
+ t.verbose = true
+end
+
+#desc 'Generate documentation for the simply_helpful plugin.'
+#Rake::RDocTask.new(:rdoc) do |rdoc|
+#  rdoc.rdoc_dir = 'rdoc'
+#  rdoc.title    = 'SimplyHelpful'
+#  rdoc.options << '--line-numbers' << '--inline-source'
+#  rdoc.rdoc_files.include('README')
+#  rdoc.rdoc_files.include('lib/**/*.rb')
+#end
+
+desc 'Measures test coverage using rcov'
+task :rcov do
+  rm_f "coverage"
+  rm_f "coverage.data"
+  project_name = ENV["PWD"].split(File::SEPARATOR)[-4]
+  rcov = %{rcov --rails --aggregate coverage.data --text-summary --exclude "#{File.join project_name, 'app'}|#{File.join project_name, 'lib'}|gems|rubygems" -Ilib}
+  system("#{rcov} --html #{Dir.glob('test/**/*_test.rb').join(' ')}")
+  system("open coverage/index.html") if PLATFORM['darwin']
+end
+
+require 'rubygems'
+require 'echoe'
+
+Echoe.new('shway', '3.0') do |p|
+  p.description    = "Provides powerful UI programming with dynamic css and presenters.."
+  p.project        = 'shway'
+  p.url            = "http://rubyforge.org/projects/shway"
+  p.author         = "Ryan Owens"
+  p.email          = "ryan@infoether.com"
+  p.ignore_pattern = ["tmp/*", "script/*", "*_notes.txt"]
+  p.development_dependencies = []
+end
+
+# Dir["#{File.dirname(__FILE__)}/tasks/*.rake"].sort.each { |ext| load ext }

data/init.rb

@@ -0,0 +1,2 @@
+require 'shway'
+

data/install_files/javascripts/iepngfix.htc

@@ -0,0 +1,193 @@
+<public:component>
+<public:attach event="oncontentready"
+	onevent="IEPNGFix.process(element, 1)" />
+
+<script type="text/javascript">
+
+// IE5.5+ PNG Alpha Fix v2.0 Alpha 2
+// (c) 2004-2008 Angus Turnbull http://www.twinhelix.com
+
+// This is licensed under the GNU LGPL, version 2.1 or later.
+// For details, see: http://creativecommons.org/licenses/LGPL/2.1/
+
+if (!window.IEPNGFix) {
+	window.IEPNGFix = {};
+}
+
+
+// This must be a path to a blank image, relative to the HTML document(s).
+// In production use I suggest '/images/blank.gif' or similar. That's all!
+IEPNGFix.blankImg = '/images/blank.gif';
+
+
+if (!IEPNGFix.data) {
+	IEPNGFix.data = {};
+}
+
+
+IEPNGFix.fix = function(elm, src, t) {
+	// Applies an image 'src' to an element 'elm' using the DirectX filter.
+	// If 'src' is null, filter is disabled.
+	// Disables the 'hook' to prevent infinite recursion on setting BG/src.
+	// 't' = type, where background tile = 0, background = 1, IMG SRC = 2.
+
+	var h = this.hook.enabled;
+	this.hook.enabled = 0;
+
+	var f = 'DXImageTransform.Microsoft.AlphaImageLoader';
+	src = (src || '').replace(/\(/g, '%28').replace(/\)/g, '%29');
+
+	if (
+		src && !(/IMG|INPUT/.test(elm.nodeName) && (t != 2)) &&
+		elm.currentStyle.width == 'auto' && elm.currentStyle.height == 'auto'
+	) {
+		elm.style.width = elm.offsetWidth + 'px';
+		elm.style.height = elm.clientHeight + 'px';
+		if (elm.currentStyle.display == 'inline') {
+			elm.style.display = 'inline-block';
+		}
+	}
+
+	if (t == 1) {
+		elm.style.backgroundImage = 'url("' + this.blankImg + '")';
+	}
+	if (t == 2) {
+		elm.src = this.blankImg;
+	}
+
+	if (elm.filters[f]) {
+		elm.filters[f].enabled = src ? true : false;
+		if (src) {
+			elm.filters[f].src = src;
+		}
+	} else if (src) {
+		elm.style.filter = 'progid:' + f + '(src="' + src +
+			'",sizingMethod="crop")';
+	}
+
+	this.hook.enabled = h;
+};
+
+
+IEPNGFix.process = function(elm, init) {
+	// Checks the onpropertychange event (on first 'init' run, a fake event)
+	// and calls the filter-applying-functions.
+
+	if (
+		!/MSIE (5\.5|6)/.test(navigator.userAgent) ||
+		typeof elm.filters == 'unknown'
+	) {
+		return;
+	}
+	if (!this.data[elm.uniqueID]) {
+		this.data[elm.uniqueID] = {
+			className: ''
+		};
+	}
+	var data = this.data[elm.uniqueID],
+		evt = init ? { propertyName: 'src,backgroundImage' } : event,
+		isSrc = /src/.test(evt.propertyName),
+		isBg = /backgroundImage/.test(evt.propertyName),
+		isPos = /background(Pos|Rep)/.test(evt.propertyName),
+		isClass = !init && ((elm.className != data.className) &&
+			(elm.className || data.className));
+	if (!(isSrc || isBg || isPos || isClass)) {
+		return;
+	}
+	data.className = elm.className;
+	var blank = this.blankImg.match(/([^\/]+)$/)[1],
+		eS = elm.style,
+		eCS = elm.currentStyle;
+
+	// Required for Whatever:hover - erase set BG if className changes.
+	if (
+		isClass && (eS.backgroundImage.indexOf('url(') == -1 ||
+		eS.backgroundImage.indexOf(blank) > -1)
+	) {
+		return setTimeout(function() {
+			eS.backgroundImage = '';
+		}, 0);
+	}
+
+	// Foregrounds.
+	if (isSrc && elm.src &&  { IMG: 1, INPUT: 1 }[elm.nodeName]) {
+		if ((/\.png/i).test(elm.src)) {
+			this.fix(elm, elm.src, 2);
+		} else if (elm.src.indexOf(blank) == -1) {
+			this.fix(elm, '');
+		}
+	}
+
+	// Backgrounds.
+	var bgSrc = eCS.backgroundImage || eS.backgroundImage;
+	if ((bgSrc + elm.src).indexOf(blank) == -1) {
+		var bgPNG = bgSrc.match(/url[("']+(.*\.png[^\)"']*)[\)"']/i);
+		if (bgPNG) {
+			if (this.tileBG && !{ IMG: 1, INPUT: 1 }[elm.nodeName]) {
+				this.tileBG(elm, bgPNG[1]);
+				this.fix(elm, '', 1);
+			} else {
+				if (data.tiles && data.tiles.src) {
+					this.tileBG(elm, '');
+				}
+				this.fix(elm, bgPNG[1], 1);
+				this.childFix(elm);
+			}
+		} else {
+			if (data.tiles && data.tiles.src) {
+				this.tileBG(elm, '');
+			}
+			this.fix(elm, '');
+		}
+	} else if ((isPos || isClass) && data.tiles && data.tiles.src) {
+		this.tileBG(elm, data.tiles.src);
+	}
+
+	if (init) {
+		this.hook.enabled = 1;
+		elm.attachEvent('onpropertychange', this.hook);
+	}
+};
+
+
+IEPNGFix.childFix = function(elm) {
+	// "hasLayout" fix for unclickable children inside PNG backgrounds.
+	var tags = [
+			'a',
+			'input',
+			'select',
+			'textarea',
+			'button',
+			'iframe',
+			'object'
+		],
+		t = tags.length,
+		tFix = [];
+	while (t--) {
+		var pFix = elm.all.tags(tags[t]),
+			e = pFix.length;
+		while (e--) {
+			tFix.push(pFix[e]);
+		}
+	}
+	t = tFix.length;
+	if (t && (/relative|absolute/i).test(elm.currentStyle.position)) {
+		alert('IEPNGFix: Unclickable children of element:' +
+			'\n\n<' + elm.nodeName + (id && ' id=' + id) + '>');
+	}
+	while (t--) {
+		if (!(/relative|absolute/i).test(tFix[t].currentStyle.position)) {
+			tFix[t].style.position = 'relative';
+		}
+	}
+};
+
+
+IEPNGFix.hook = function() {
+	if (IEPNGFix.hook.enabled) {
+		IEPNGFix.process(element, 0);
+	}
+};
+
+</script>
+</public:component>

data/install_files/javascripts/iepngfix_tilebg.js

@@ -0,0 +1,155 @@
+// IE5.5+ PNG Alpha Fix v2.0beta1: Background Tiling Support
+// (c) 2008 Angus Turnbull http://www.twinhelix.com
+
+// This is licensed under the GNU LGPL, version 2.1 or later.
+// For details, see: http://creativecommons.org/licenses/LGPL/2.1/
+
+if (!window.IEPNGFix) {
+	window.IEPNGFix = {};
+}
+
+IEPNGFix.tileBG = function(elm, pngSrc, ready) {
+	// Params: A reference to a DOM element, the PNG src file pathname, and a
+	// hidden "ready-to-run" passed when called back after image preloading.
+
+	var data = this.data[elm.uniqueID],
+		elmW = Math.max(elm.clientWidth, elm.scrollWidth),
+		elmH = Math.max(elm.clientHeight, elm.scrollHeight),
+		bgX = elm.currentStyle.backgroundPositionX,
+		bgY = elm.currentStyle.backgroundPositionY,
+		bgR = elm.currentStyle.backgroundRepeat;
+
+	// Cache of DIVs created per element, and image preloader/data.
+	if (!data.tiles) {
+		data.tiles = {
+			src: '',
+			cache: [],
+			img: new Image(),
+			old: {}
+		};
+	}
+	var tiles = data.tiles,
+		pngW = tiles.img.width,
+		pngH = tiles.img.height;
+
+	if (pngSrc) {
+		if (!ready && pngSrc != tiles.src) {
+			// New image? Preload it with a callback to detect dimensions.
+			tiles.img.onload = function() {
+				this.onload = null;
+				IEPNGFix.tileBG(elm, pngSrc, 1);
+			};
+			return tiles.img.src = pngSrc;
+		}
+	} else {
+		// No image?
+		if (tiles.src) ready = 1;
+		pngW = pngH = 0;
+	}
+	tiles.src = pngSrc;
+
+	if (!ready && elmW == tiles.old.w && elmH == tiles.old.h &&
+		bgX == tiles.old.x && bgY == tiles.old.y && bgR == tiles.old.r) {
+		return;
+	}
+
+	// Convert English and percentage positions to pixels.
+	var pos = {
+			top: '0%',
+			left: '0%',
+			center: '50%',
+			bottom: '100%',
+			right: '100%'
+		},
+		x,
+		y,
+		pc;
+	x = pos[bgX] || bgX;
+	y = pos[bgY] || bgY;
+	if (pc = x.match(/(\d+)%/)) {
+		x = Math.round((elmW - pngW) * (parseInt(pc[1]) / 100));
+	}
+	if (pc = y.match(/(\d+)%/)) {
+		y = Math.round((elmH - pngH) * (parseInt(pc[1]) / 100));
+	}
+	x = parseInt(x);
+	y = parseInt(y);
+
+	// Handle backgroundRepeat.
+	var repeatX = { 'repeat': 1, 'repeat-x': 1 }[bgR],
+		repeatY = { 'repeat': 1, 'repeat-y': 1 }[bgR];
+	if (repeatX) {
+		x %= pngW;
+		if (x > 0) x -= pngW;
+	}
+	if (repeatY) {
+		y %= pngH;
+		if (y > 0) y -= pngH;
+	}
+
+	// Go!
+	this.hook.enabled = 0;
+	if (!({ relative: 1, absolute: 1 }[elm.currentStyle.position])) {
+		elm.style.position = 'relative';
+	}
+	var count = 0,
+		xPos,
+		maxX = repeatX ? elmW : x + 0.1,
+		yPos,
+		maxY = repeatY ? elmH : y + 0.1,
+		d,
+		s,
+		isNew;
+	if (pngW && pngH) {
+		for (xPos = x; xPos < maxX; xPos += pngW) {
+			for (yPos = y; yPos < maxY; yPos += pngH) {
+				isNew = 0;
+				if (!tiles.cache[count]) {
+					tiles.cache[count] = document.createElement('div');
+					isNew = 1;
+				}
+				var clipR = (xPos + pngW > elmW ? elmW - xPos : pngW),
+					clipB = (yPos + pngH > elmH ? elmH - yPos : pngH);
+				d = tiles.cache[count];
+				s = d.style;
+				s.behavior = 'none';
+				s.left = xPos + 'px';
+				s.top = yPos + 'px';
+				s.width = clipR + 'px';
+				s.height = clipB + 'px';
+				s.clip = 'rect(' +
+					(yPos < 0 ? 0 - yPos : 0) + 'px,' +
+					clipR + 'px,' +
+					clipB + 'px,' +
+					(xPos < 0 ? 0 - xPos : 0) + 'px)';
+				s.display = 'block';
+				if (isNew) {
+					s.position = 'absolute';
+					s.zIndex = -999;
+					if (elm.firstChild) {
+						elm.insertBefore(d, elm.firstChild);
+					} else {
+						elm.appendChild(d);
+					}
+				}
+				this.fix(d, pngSrc, 0);
+				count++;
+			}
+		}
+	}
+	while (count < tiles.cache.length) {
+		this.fix(tiles.cache[count], '', 0);
+		tiles.cache[count++].style.display = 'none';
+	}
+
+	this.hook.enabled = 1;
+
+	// Cache so updates are infrequent.
+	tiles.old = {
+		w: elmW,
+		h: elmH,
+		x: bgX,
+		y: bgY,
+		r: bgR
+	};
+};

data/install_files/stylesheets/reset.css

@@ -0,0 +1,47 @@
+/* reset reload by Eric Meyer: http://meyerweb.com/eric/thoughts/2007/05/01/reset-reloaded/ */
+html, body, div, span, applet, object, iframe,
+h1, h2, h3, h4, h5, h6, p, blockquote, pre,
+a, abbr, acronym, address, big, cite, code,
+del, dfn, em, font, img, ins, kbd, q, s, samp,
+small, strike, strong, sub, sup, tt, var,
+dl, dt, dd, ol, ul, li,
+fieldset, form, label, legend,
+table, caption, tbody, tfoot, thead, tr, th, td {
+	margin: 0;
+	padding: 0;
+	border: 0;
+	outline: 0;
+	font-weight: inherit;
+	font-style: inherit;
+	font-size: 100%;
+	font-family: inherit;
+	vertical-align: baseline;
+}
+/* remember to define focus styles! */
+:focus {
+	outline: 0;
+}
+body {
+	line-height: 1;
+	color: black;
+	background: white;
+}
+ol, ul {
+	list-style: none;
+}
+/* tables still need 'cellspacing="0"' in the markup */
+table {
+	border-collapse: separate;
+	border-spacing: 0;
+}
+caption, th, td {
+	text-align: left;
+	font-weight: normal;
+}
+blockquote:before, blockquote:after,
+q:before, q:after {
+	content: "";
+}
+blockquote, q {
+	quotes: "" "";
+}

data/install_files/templates/example_presenter.rb

@@ -0,0 +1,12 @@
+class ApplicationPresenter < ShwayPresenter
+
+  #define renderers like this
+  renderer :default do
+    r div(:text => 'Application Presenter')
+  end
+
+  renderer :foo do
+    r div(:text => 'Foo')
+  end
+
+end    

data/install_files/templates/example_stylesheet.css.rb

@@ -0,0 +1,20 @@
+Shway.define_styles do
+
+  #define values like this
+  # values  :primary_background_color => '#fff6d8',
+  #         :primary_border_color     => :red
+
+  #define styles like this
+  # style :standard_body, {
+  #  :background_color  => :primary_background_color,
+  #  :border            => "1px solid #{get_css_value :primary_border_color}",
+  # }
+
+  #define selectors like this
+  # selector "html>body #foo", :standard_body
+  # selector "html>body #bar", {
+  #   :background_color => :yellow,
+  #   :border           => '1px solid green',
+  # }
+
+end

data/lib/rubygems/commands/shway_init_command.rb

@@ -0,0 +1,112 @@
+# require 'shellwords'
+
+require 'rubygems/command'
+require 'rubygems/dependency'
+require 'rubygems/version_option'
+
+require 'fileutils'
+
+# InitCommand will initialize a Rails app with the proper files and directories.
+class Gem::Commands::ShwayInitCommand < Gem::Command
+  include Gem::VersionOption
+  
+  def initialize
+    super 'shway_init', "Initialize a Rails app with the proper files and directories for Shway. (must be in the rails app's root dir)", 
+      :command => nil, 
+      :version=>  Gem::Requirement.default
+    
+    # add_option('-l', '--latest',
+    #            'If there are multiple versions, open the latest') do |value, options|
+    #   options[:latest] = true
+    # end
+    
+    add_version_option
+  end
+  
+  def execute
+    if is_rails_app?
+      init_shway
+    else
+      raise Gem::CommandLineError, "Could not initialize shway. Directory isn't a Rails app!"
+    end
+  end
+  
+  def is_rails_app?
+    environment_path = File.join(Dir.getwd, 'config', 'environment.rb')
+    File.exists?(environment_path)
+  end
+  
+  def init_shway
+    # init app
+
+    rails_root = Dir.getwd
+    shway_source_root_path = File.join(File.dirname(__FILE__), '..', '..', '..')
+    unless File.exists?(File.join(shway_source_root_path, 'Manifest'))
+      raise Gem::CommandLineError, "Could not initialize shway. Gem path appears to be incorrect: #{shway_source_root_path}"
+    end
+
+    app_path         = File.join(rails_root, 'app')
+    app_presenters_path   = File.join(app_path, 'presenters')
+    app_stylesheets_path  = File.join(app_path, 'stylesheets')
+
+    mkdir app_path
+    mkdir app_presenters_path
+    mkdir app_stylesheets_path
+
+    public_root_path              = File.join(rails_root, 'public')
+    public_images_path            = File.join(public_root_path, 'images')
+    public_javascripts_path       = File.join(public_root_path, 'javascripts')
+    public_javascripts_shway_path = File.join(public_javascripts_path, 'shway')
+    public_stylesheets_path       = File.join(public_root_path, 'stylesheets')
+    public_stylesheets_shway_path = File.join(public_stylesheets_path, 'shway')
+
+    shway_source_install_files_path       = File.join(shway_source_root_path, 'install_files')
+    shway_source_install_templates_path   = File.join(shway_source_install_files_path, 'templates')
+    shway_source_install_javascripts_path = File.join(shway_source_install_files_path, 'javascripts')
+    shway_source_install_stylesheets_path = File.join(shway_source_install_files_path, 'stylesheets')
+
+    application_stylesheet          = File.join(app_stylesheets_path, 'application.css.rb')
+    application_stylesheet_template = File.join(shway_source_install_templates_path,        'example_stylesheet.css.rb')
+    cp application_stylesheet_template, application_stylesheet
+
+    application_presenter          = File.join(app_presenters_path,     'application_presenter.rb')
+    application_presenter_template = File.join(shway_source_install_templates_path, 'example_presenter.rb')
+    cp application_presenter_template, application_presenter
+
+    pngfix_js_src     = File.join(shway_source_install_javascripts_path, 'iepngfix_tilebg.js')
+    pngfix_htc_src    = File.join(shway_source_install_javascripts_path, 'iepngfix.htc')
+    pngfix_js_target  = File.join(public_javascripts_shway_path, 'iepngfix_tilebg.js')
+    pngfix_htc_target = File.join(public_javascripts_shway_path, 'iepngfix.htc')
+
+    mkdir public_javascripts_shway_path
+    cp pngfix_js_src, pngfix_js_target
+    cp pngfix_htc_src, pngfix_htc_target
+
+    reset_css_src     = File.join(shway_source_install_stylesheets_path, 'reset.css')
+    reset_css_target  = File.join(public_stylesheets_shway_path, 'reset.css')
+
+    mkdir public_stylesheets_shway_path
+    cp reset_css_src, reset_css_target
+
+    say "shway successfully initialized."
+  end
+  
+  def mkdir(path)
+    if File.exist? path
+      say "...already exists: #{path}"
+    else
+      FileUtils.mkdir path
+      say "...created: #{path}"
+    end
+  end
+
+  def cp(source, target)
+    if File.exist? target
+      say "...already exists: #{target}"
+    else
+      FileUtils.cp source, target
+      say "...created: #{target}"
+    end
+  end
+
+end

data/lib/rubygems_plugin.rb

@@ -0,0 +1,3 @@
+require 'rubygems/command_manager'
+
+Gem::CommandManager.instance.register_command :shway_init

data/lib/shway/controllers/shway_controller.rb

@@ -0,0 +1,22 @@
+#this should maybe be ShwayCssController or PublicController or something eventually.
+class ShwayController < ActionController::Base
+
+  #pretty sure this isn't necessary any more.
+  session :off
+
+  helper Shway::Css::CssHelper
+  helper Shway::Helpers::HtmlHelper
+  helper Shway::Helpers::ShwayControllerHelper
+  helper Shway::Helpers::ShwayHelper
+  include Shway::Css::CssHelper
+
+  def css
+    #GOTCHA I need to keep the flash vars so they don't get lost by the app/
+    flash.keep
+    css_name = params[:css].clone
+    Shway::Css::CssStyles.cache[css_name] = css_page_for_filename(params[:css]) unless Shway::Css::CssStyles.cache.has_key? css_name
+    render :text => Shway::Css::CssStyles.cache[css_name], :content_type => "text/css"
+  end
+  
+end
+