nitro 0.19.0 → 0.20.0

data/CHANGELOG

@@ -1,5 +1,192 @@
+12-07-2005  George Moschovitis <gm@navel.gr>
+
+	* doc/RELEASES: updated.
+	
+	* test/nitro/mixin/tc_pager.rb: added.
+	
+	* lib/nitro/mixin/pager.rb: copied old code,
+	added support for in-memory pagination,
+	small fixes: it WORKS!
+	
+	* lib/nitro/uri.rb: moved to glue.
+	
+	* lib/nitro/helper/*: moved to mixin/*
+	
+	* lib/nitro/builder/atom.rb: removed.
+
+11-07-2005  George Moschovitis <gm@navel.gr>
+
+	* lib/nitro/mixin/pager.rb: introduced,
+	(Pager): introduced,
+	(PagerMixin): introduced,
+	(#paginate): implemented.
+	
+	* lib/nitro/mixin: introduced.
+		
+	* test/nitro/tc_dispatcher.rb: removed deprecated multiapi
+	tests.
+	
+	* test/*: many changes and fixes to pass again.
+		
+	* lib/nitro/adapter/webrick.rb (XhtmlFileAdapter): implemented,
+	don't return xhtml source [james_b].
+	
+	* doc/RELEASES: updated.
+
+09-07-2005  George Moschovitis <gm@navel.gr>
+
+	* doc/RELEASES: updated.
+	
+	* lib/nitro/helper/javascript.rb (#live_request): implemented,
+	get the href from the actual element.
+	(#autocomplete): implemented.
+	added effects.js to the default js libraries.
+	set autocomplete="off" with a behaviour.
+	
+08-07-2005  George Moschovitis <gm@navel.gr>
+
+	* lib/nitro/helper/javascript.rb: introduced.
+	(#dragable): implemented,
+	yeah drag and drop works!
+	(#escape_javascript): added.
+	(#behaviour): ULTRA COOL added.
+
+07-07-2005  George Moschovitis <gm@navel.gr>
+
+	* proto/public/js/behaviour.js: introduced.
+
+	* proto/public/js/controls.js: introduced.
+
+	* proto/public/js/dragdrop.js: upgraded to latest version.
+
+	* proto/public/js/effects.js: upgraded to latest version.
+
+	* proto/public/js/effects2.js: deprecated.
+	
+	* proto/public/js/prototype.js: upgrated to latest version.
+	
+	* README: updated.
+
+06-07-2005  George Moschovitis <gm@navel.gr>
+
+	* test/nitro/tc_cookie.rb: added.
+	
+	* lib/nitro/cookie.rb: set path = '/' by default, fixes NASTY
+	session bug [mneumann].
+
+04-07-2005  George Moschovitis <gm@navel.gr>
+
+	* lib/nitro/builder/rss.rb: small fixes.
+	
+03-07-2005  George Moschovitis <gm@navel.gr>
+
+	* lib/nitro/controller.rb (#alias_action): added, experimental.
+	
+	* added more const_defined? checks.
+
+01-07-2005  George Moschovitis <gm@navel.gr>
+
+	* lib/nitro/request.rb (#fetch): implemented as shorthand [drak].
+	
+	* lib/nitro/render.rb: added controller_name [mneumann].
+
+30-06-2005  George Moschovitis <gm@navel.gr>
+
+	* test/nitro/tc_server.rb: introduced and implemented.
+	
+	* lib/nitro/server.rb: don't use as singleton,
+	(Mounter): implements really cool CherryPy style publishing!
+	
+	* lib/nitro/controller.rb: added default action.
+
+29-06-2005  George Moschovitis <gm@navel.gr>
+
+	* lib/nitro/dispatcher.rb (#update_routes): fixed.
+		
+	* lib/nitro/simple.rb: removed.
+	
+	* lib/nitro/part.rb: removed.
+
+28-06-2005  George Moschovitis <gm@navel.gr>
+	
+	* lib/nitro.rb (##start): implemented.
+	
+	* yeah, the new hello world example passes.
+	
+	* lib/nitro/controller.rb: moved SimpleController here,
+	removed the dangerous (and no longer needed) #inherited override,
+	SimpleController in Nitro namespace,
+	(ControllerMixin): started implementing,
+	renamed to Publishable.
+	
+	* started using the unless const_defined? trick.
+	
+	* lib/nitro/dispatcher.rb: simplified (no context passed),
+	(#dispatch): more natural mount points, no :root.
+	publish alias for add_controller.
+
+27-06-2005  George Moschovitis <gm@navel.gr>
+
+	* lib/nitro/server.rb: introduced.
+
+27-06-2005  George Moschovitis <gm@navel.gr>
+
+	* lib/nitro/element.rb: fixed bugs.
+
+	* lib/nitro/builder/form.rb: fixed bugs.
+
+25-06-2005  George Moschovitis <gm@navel.gr>
+
+	* lib/nitro/helper/debug.rb: implemented.
+	
+	* lib/nitro/controller.rb: include HelperSupport.
+
+	* test/nitro/tc_helper.rb: introduced.
+	
+	* lib/nitro/helper.rb: introduced,
+	helper macro to make the helpers methods private,
+	(#include_auto_helpers): implemented.
+	(Helper): include debug helper by default.
+
+24-06-2005  George Moschovitis <gm@navel.gr>
+
+	* lib/nitro/*: beutified/updated/commented many files.
+
+	* lib/nitro/element/java_script.rb: implemented.
+	
+	* doc/AUTHORS: updated.
+	
+	* proto/public/js/*: added scriptacoulous libraries.
+
+	* proto/public/settings.xhtml: cooler, shows all configuration
+	variables. [epiperak]
+	
+	* lib/nitro/*: started adding settings keywords everywhere.
+	
+	* lib/nitro/runner.rb: include configuration.
+
+23-06-2005  George Moschovitis <gm@navel.gr>
+
+	* lib/nitro/markup.rb (MarkupShader): call expand_html.
+
+21-06-2005  George Moschovitis <gm@navel.gr>
+
+	* lib/nitro/caching.rb: temporarily dissabled per controller
+	caching.
+
+20-06-2005  George Moschovitis <gm@navel.gr>
+
+	* README: facet/redcloth pointers. [bcandler]
+
+	* INSTALL: facet/redcloth pointers. [bcandler]
+
 17-06-2005  George Moschovitis <gm@navel.gr>
 
+	* lib/nitro/caching.rb (##caching_enabled): added singleton
+	method too!
+
+	* --- VERSION 0.19.0 ---
+
 	* README: updated.
 	
 	* doc/RELEASES: updated.

data/INSTALL

@@ -69,6 +69,11 @@ or, at windows
 
 > set RUBYOPT=Ic:\dev\nitro\lib;c:\dev\og\lib;c:\dev\glue\lib
 
+You also have to manualy install the following libraries:
+
+* Facets
+* RedCloth
+
 = Additional libraries
 
 Nitro uses a number of additional libraries. RubyGems

data/README

@@ -1,4 +1,4 @@
-= Nitro 0.19.0 README
+= Nitro 0.20.0 README
 
 Nitro is an efficient, yet simple engine for developing professional Web 
 Applications using the Ruby language. Nitro aims to provide a robust 
@@ -253,13 +253,13 @@ doc/RELEASES
 
 The latest version of Nitro can be found at
 
-* http://nitro.rubyforge.org
+* http://www.nitrohq.com
 
 == Documentation
 
 Documentation for Nitro can be found at
 
-* http://nitro.rubyforge.org
+* http://www.nitrohq.com
 
 Don't forget to read the file doc/RELEASES for usefull
 documentation bits. Also, have a look at the test cases in
@@ -274,6 +274,9 @@ Nitro requires the following applications or libraries:
 	http://www.ruby-lang.org
 	Version 1.8.2 is recomended
 
+* Facets
+	http://rubyforge.org/frs/?group_id=483
+	
 The following applications or libraries are OPTIONAL:
 
 * PostgreSQL 
@@ -312,6 +315,9 @@ The following applications or libraries are OPTIONAL:
 	http://www.fastcgi.com/dist/fcgi.tar.gz
 	Needed to compile the C-version of the ruby fcgi library.
 
+* RedCloth
+	http://rubyforge.org/projects/redcloth/
+	
 Please install the required applications and libraries before continuing
 with the installation of Nitro.
 
@@ -461,7 +467,7 @@ http://rubyforge.org/mailman/listinfo/nitro-general
 Copyright (c) 2004-2005, George 'tml' Moschovitis.
 Copyright (c) 2004-2005, Navel Ltd (http://www.navel.gr)
 
-Nitro (http://www.rubyforge.com/projects/nitro) is copyrighted free 
-software created and maintained by George Moschovitis (mailto:gm@navel.gr)
+Nitro (http://www.nitrohq.com) is copyrighted free software 
+created and maintained by George Moschovitis (mailto:gm@navel.gr)
 and released under the standard BSD Licence. For details consult
 the file LICENCE.

data/doc/AUTHORS

@@ -1,6 +1,6 @@
 MAIN DEVELOPER:
 
-* George Moschovitis  <gm@navel.gr>
+* George Moschovitis <gm@navel.gr>
 	Project leader, architecture and design, main coder, 
 	documentation, maintainer.
 	
@@ -17,3 +17,13 @@ IDEAS, ADDITIONAL CODING, SUPPORT:
 
 * Kostas Nasis <kostas@nasis.com>
 	Ideas and bug reports.
+
+INTEGRATED LIBRARIES:
+
+Nitro integrates several open source libraries:
+
+* Prototype: Object Oriented Javascript library
+	Sam Stepherson, http://www.conio.net
+	
+* Srciptacolous: Special FX Javascript library
+	Thomas Fuchs, http://script.aculo.us

data/doc/RELEASES

@@ -1,3 +1,220 @@
+== Version 0.20.0
+
+Another superb release! State of the art AJAX/Javascript support,
+Wee components / programmatic renderer integration, a beginners
+tutorial, self documenting configuration and many important bug 
+fixes. Don't forget to check out our new community site at
+http://www.nitrohq.com
+
+Some notable changes:
+
+* Ajax is THE buzzword at the moment, and Nitro provides the 
+	best support you can find. Nitro fully separates the behaviour
+	from the template using the behaviour.js library and allowing
+	for dynamic injection of ajax functionality. The generated code
+	contains clean html and all the javascript organized in a
+	single <script> block. Here is an example:
+	
+	in the Controller:
+	
+	def index
+		# Inject functionality to the DOM elements of the template.
+		
+		behaviour '#alert', %{
+			el.onclick = function() {
+				alert('Hello world');
+			}		
+		}	
+		auto_complete :country # convert to autocomplete field
+		live :live # convert to async link!
+		draggable :dragger, :revert => false
+	end		
+
+	def a_simple_action
+		puts 'LIVE!'
+	end
+	
+	def country_auto_complete # data for auto complete.
+		%{
+		<ul>
+		  <li>Greece</li>
+		  <li>England</li>
+		  ...
+		</ul>
+		}
+	end
+	
+	in the Template:
+	
+	<label>Enter a country:</label>
+	<input type="text" id="country" />
+	<div id="country_auto_complete" class="auto_complete"> </div>
+	
+	Behaviour example:<br />
+	<button id="alert">Click to alert</button>
+
+	Drag and Drop example:<br />
+	<div id="dragger">DRAG ME</div>
+
+	Live/Asynchonous request (AJAX) example:<br />
+	Here comes a <a id="live" href="a_simple_action">live link</a>.<br />
+	(Check out the log to see the action called in the background!)
+
+	All you have to do is define id's for your DOM elements. Here
+	comes the generated code:
+	
+	<label>Enter a country:</label>
+	...
+	(Check out the log to see the action called in the background!)
+
+	<script type="text/javascript">
+			var _behaviours = {
+			'#alert': function(el) { 
+			el.onclick = function() {
+				alert('Hello world');
+			}		
+			},'#country': function(el) { 
+			el.autocomplete = 'off';
+		 
+		  },'#live': function(el) { 
+				el.onclick = function() {
+					new Ajax.Request(el.href, {});
+					return false;
+				}
+			 }
+			}
+			Behaviour.register(_behaviours);		
+				
+			new Ajax.Autocompleter('country', 'country_auto_complete', 'country_auto_complete');
+			new Draggable('dragger', {revert:false});
+	</script>
+	
+	See how a normal <a> tag is converted transparently to an Ajax request.
+	The prototype, scriptacoulous and behaviour js libraries are used.
+
+	The ajax support in this release is a PREVIEW. Stay tuned for
+	major improvements (and some surprises) in the next version.
+
+* Wee Components integration. Nitro now transparently integrates
+  Wee components. This is truly a win-win situation. Wee applications
+  can use Nitro's infrastructure. Nitro applications can use 
+  extremely reusable, stateful Components. For a demonstration 
+  check out the new Wee example in the examples distribution! 
+  Wee 0.9.0 is needed!
+  
+  Even better interoperability with Wee is coming soon. Nitro
+  plays well with the others, and always provides more options.
+
+* Mixins are modules of functionality that can be mixed into
+  Controllers. The developer can explicitly include Mixins or
+  use Nitro conventions to have helper Mixins automatically 
+  included:
+  
+  class MyController
+  ..
+  end
+  
+  module MyControlllerMixin
+  	# gets automatically mixed in
+  end
+  
+  This works just like Og Mixins.
+
+* Brand new, self-documenting configuration system. There is a new
+  keyword for defining configuration settings:
+  
+  Here is an example:
+  
+  class Render
+  	setting :template_extension, :default => 'xhtml', :doc => 'The default template extension'
+  end
+
+  class Session
+  	setting :store, :default => 'memory', :doc => 'The session store'
+  end
+  
+  You can configure the Application using ruby code or yaml files:
+  
+  Render.template_extension = 'xhtml'
+  Session.store = 'drb'
+  
+  or
+  
+  Render:
+  	template_extension: xhtml
+  Session:
+  	store: drb
+  	
+  You can access all defined settings:
+  
+  Configuration.settings.each { |s| ... }
+  
+  You can view the settings of the application along with documentation
+  on the following url:
+  
+  www.myapp.com/settings
+  
+  This feature is also a PREVIEW. Will be used a lot more in the 
+  next release.
+  
+* CherryPy style published objects. Nitro allows you to publish
+  any Ruby object. Here is the new hello world example:
+  
+  class HelloWorld
+    def index 
+    	print 'Hello World'
+    end
+    
+    def add(val)
+    	print "added: #{val + 2}"
+    end
+	end
+	
+	App.start(HelloWorld)
+    
+	Now, point your browser to localhost:/ or localhost/add?val=2
+	
+	If you need the advanced controller functionality just extend
+	your published object from the Controller base class. The normal
+	heuristics to decide which method is safe to publish are aplied.
+
+* CherryPy-style dispatcher configuration, provides another way
+	to define mounting points for Controllers and published objects.
+	Here is an example:
+	
+	server = Server.new
+	server.root = MainController							# /
+	server.root.fora = ForaController					# /fora
+	server.root.wiki = WikiController					# /wiki
+	server.root.really.deep = DeepController	# /really/deap
+
+* Improved pager interface. Thanks to the new PagerMixin, presenting
+	paged lists is easier (and as efficient) than ever:
+	
+	items, pager = paginate(Article, :per_page => 5, :order => 'date DESC')
+	
+* Added better sql injection protection in Og sql stores.
+
+* Fixed Mysql store reconnect bug.
+
+* Og falls back to pure ruby adapters for Mysql and Postgres, to 
+	make it easier to run out of the box. Please, don't forget to 
+	switch to the natively compiled adapters for production sites.
+
+* This is surely the most request feature: Nitro Step by Step
+	by James Britt, a beginers guide to Nitro. Available in the
+	brand-new, Nitro-powered, www.nitrohq.com Community wiki.
+
+* New examples: The totaly recoded and ultra cool ajax example,
+	a Wee/Nitro example and the new Hello world example.
+
+* Cleaned up a lot of source files.
+	
+* Many, many, many bug fixes and small improvements. This release
+	fixes all reported bugs in the spirit of out zero-bug tolerance
+	philosophy.
+	
+
 == Version 0.19.0
 
 Og reloaded part 2: Another superb release introducing a balanced