nitro 0.14.0 → 0.15.0

data/CHANGELOG

@@ -1,5 +1,122 @@
+04-04-2005  George Moschovitis  <gm@navel.gr>
+
+	* bin/nitro: fix
+
+	* bin/nitrogen: fix
+
+	* --- VERSION 0.15.0 ---
+
+	* Rakefile: added nitrogen executable.
+
+	* examples/blog/public/fcgi.rb: fixed for path.
+
+	* doc/RELEASES: updated.
+
+	* bin/new_form.rb: deprecated.
+
+	* bin/new_app.rb: deprecated.
+
+	* bin/nitrogen: implemented.
+
+	* bin/nitro: implemented to start default application,
+	use -rubygems.
+
+03-04-2005  George Moschovitis  <gm@navel.gr>
+
+	* lib/nitro/render.rb (#compile_action): handle __ separators,
+	(#template_for_action): fixed to look into subdirectories.
+
+	* test/nitro/tc_dispatcher.rb: added more tests.
+
+	* lib/nitro/dispatcher.rb (#dispatch): updated to 
+	handle actions in subdirs.
+	
+	* doc/RELEASES: updated.
+
+01-04-2005  George Moschovitis  <gm@navel.gr>
+
+	* some fixes to make the tests pass again.
+
+	* doc/RELEASES: updated.
+
+	* doc/AUTHORS: updated.
+
+	* README: updated.
+
+	* examples/no_xsl_blog/*: added localization support.
+
+	* examples/*: fixed for default environment.
+
+	* lib/nitro.rb: setups a default environment [james_b].
+
+	* lib/nitro/environment.rb: introduced and implemented.
+
+01-04-2005 James Britt  <james_b@neurogami.com>
+
+	* lib/nitro/controller.rb: fixed DEF_FILE calc for win32.
+
+31-03-2005  George Moschovitis  <gm@navel.gr>
+
+	* examples/blig/src/controller.rb (#toggle_locale): implemented.
+
+	* examples/blog/*: added localization support.
+
+	* test/nitro/localization.rb: introced and implemented tests.
+
+	* lib/nitro/localization.rb: worked on this,
+	(Locale): introduced,
+	yeah localization kinda works,
+	added support for sprintf interpolation.
+	support for procs as localization agents,
+	added some documentation.
+	(LocalizationShader): introduced.
+	(LocalizationFilter): reimplemented,
+	fixed default locale.
+	added support for parsing localization rules from yaml files.
+
+30-03-2005  George Moschovitis  <gm@navel.gr>
+
+	* examples/blog/*: use the new, easier/powerful way to set
+	the template root.
+
+	* lib/nitro/caching/stores.rb (FileStore): better handling of
+	cache_root.
+
+	* lib/nitro/controller.rb (#method_missing): use the class
+	template_root,
+	many changes to handle the template_root here.
+
+	* lib/nitro/scaffold.rb (#scaffold):
+	added new, edit, form default methods,
+	save: implemented.
+	override default rendering if a template is provided.
+
+	* lib/nitro/shaders: introduced.
+
+29-03-2005  George Moschovitis  <gm@navel.gr>
+
+	* lib/nitro/shaders.rb: cleaned up old code,
+	(MorphingShader): introduced,
+	(ElementsShader): introduced,
+	implemented times morphing,
+	after a lot of experiments got the regexp right.
+	each morphing,
+	if/unless morphing.
+
+	* lib/nitro/render.rb: add base to template root.
+
+	* lib/nitro/dispatcher.rb: return base.
+
+	* lib/nitro/part.rb: reintroduced.
+
+	* worked a lot on the high level framework.
+
 28-03-2005  George Moschovitis  <gm@navel.gr>
 
+	* lib/nitro/template.rb: added support for erb style interpolators <% %>.
+
+	* --- VERSION 0.14.0 ---
+
 	* lib/nitro/controller.rb (#inherited): made compatible with Win32.
 
 	* examples/why_wiki/run.rb: set pwd.

data/INSTALL

@@ -27,6 +27,10 @@
 
   ruby -rubygem xxx.rb
 
+4. To verify that everything works ok, run the command
+
+	nitro
+
 = Installation without RubyGems using script.
 
 Installation without RubyGems is *strongly* discouraged.

data/README

@@ -1,4 +1,4 @@
-= Nitro 0.14.0
+= Nitro 0.15.0
 
 Nitro is an efficient, yet simple engine for developing professional Web 
 Applications using the Ruby language. Nitro aims to provide a robust 
@@ -18,15 +18,15 @@ A short summary of the major features:
 * Multiparadigm web applications.
 
 	You can write applications in the ASP/JSP/PHP style, ie by writting
-	server pages that are automatically transalted to Ruby code by
+	server pages that are automatically translated to Ruby code by
 	Nitro.
 
-	Alternatively, you can write Rails style application by utilizing
-	the powerfull Controller mechanism.
+	Alternatively, you can write MVC style applications (like Rails) by 
+  utilizing the powerfull Controller mechanism.
 
 * Advanced Code generation.
 
-	Nitro in essence writes your Web application for you. The system
+	Nitro in essence writes the Web application for you. The system
 	provides a number of domain spefic language extensions (meta-languages)
 	to automate generate of common code (OR mapping, validation,
 	forms generation, syndication, markup and more).
@@ -47,7 +47,7 @@ A short summary of the major features:
 	
 	Og is a combination of the best features of Active Record and the
 	former O-R mapping library included in Nitro (NDB). Adapters for
-	PostgreSQL, MySQL and SQLite are included.
+	PostgreSQL, MySQL, SQLite3, Oracle and SQL Server are included.
 
 * XML server pages (.xhtml)
 
@@ -119,7 +119,7 @@ A short summary of the major features:
 	Runs on Linux and Windows. Has not been tested under MacOSX and
 	other Unices.
 
-* Multiple Adaptors
+* Multiple Adapters
 
 	Nitro supports multiple web server configurations. Out of the box
 	it supports WEBrick (pure ruby), Lighttpd (fastcgi), Apache (fastcgi).
@@ -130,12 +130,18 @@ A short summary of the major features:
 	Configuration files are kept to the absolute minimum. The target
 	is to have no configuration files at all.
 
+* Scaffolding
+
+	This enables the developer to get started as fast as possible.
+
 * Distributed State
 
 	Nitro provides a powerfull distributed state mechanism that utilizes
 	the DRb library. A typicall use of this infrastructure is to provide
 	distributed sessions when running your application over a server 
 	cluster. Distributed sessions are fully transparent to the developer.
+
+	Support for Memcached will be available soon.
 	
 * Request Filters
 
@@ -157,14 +163,16 @@ A short summary of the major features:
 	Other libraries of parts are expected from the Ruby community when
 	the Part API is finalized.
 	
-* Hierarchical Caching
+* Fine-grained Caching
 
 	Nitro provides a well designed and efficient caching mechanism. Caching
 	will be provided at the following levels:
 	
-	* DB Cache
-	* Object Cache (deserialized objects)
+	* Object Cache (deserialized objects) (coming soon)
 	* Fragment Caching (cache generated sub-parts of a page, or a page)
+	* Action Caching (full pages)
+	* Output Caching (the whole page is stored as html and served by
+    the front web server, thus completely bypassing Nitro)
 	* HTTP 1.1 Caching (downstream caching of whole pages)
 
 	The engine calculates intra-page dependencies automatically. A variety
@@ -202,10 +210,10 @@ A short summary of the major features:
 		p u.errors[:password]
 	end
 	
-* Support for 'nice' urls.
-	
-	Experimental.	
+* Routing 
 
+	This enables portable rewrites and 'nice' urls.
+	
 * Advanced debuging features
 
 	* When running in debug mode, all exceptions raised are logged
@@ -227,24 +235,21 @@ A short summary of the major features:
 	to make form based application development easier (for example
 	an efficient, database-aware Pager component).
 	
-* Path overloading
-
-	Experimental.
-	
 * Localization
 
-	Nitro supports efficient localization of web applications.
+	Nitro supports efficient and fully transparent localization of 
+	web applications.
 
 
 == Download
 
 The latest version of Nitro can be found at
 
-* http://www.rubyforge.com/projects/nitro
+* http://nitro.rubyforge.org
 
 Documentation for Nitro can be found at
 
-* http://www.rubyforge.com/projects/nitro
+* http://nitro.rubyforge.org
 
 
 == Requirements
@@ -307,6 +312,9 @@ gem install nitro
 Then try to run the examples/tiny Example application.
 
 A tar.gz distribution is also available on http://www.rubyforge.com/projects/nitro
+This distribution is intended to allow developers to get a
+quick look at the platform. For real development please use
+the gem distribution.
 
 
 == Running the example applications
@@ -331,7 +339,7 @@ $ vi run.rb
 
 $ ruby run.rb 
 
-browse http://127.0.0.1:8069
+browse http://127.0.0.1:9999
 
 * examples/blog
 
@@ -368,7 +376,7 @@ $ ruby run.rb
 this script starts the the blog application using the WEBrick
 adapter.
 
-browse http://127.0.0.1:8069
+browse http://127.0.0.1:9999
 
 You can run the application in debug mode with the following
 command:
@@ -399,15 +407,6 @@ examples/
 lib/nitro
 	Nitro library source files.
 
-lib/og
-	Og library source files.
-
-lib/glue
-	Common source files.
-
-lib/parts
-	Nitro Web Framework parts. A part is a module of functionality
-
 test
 	Unit and functional tests.
 

data/Rakefile

@@ -56,7 +56,7 @@ spec = Gem::Specification.new do |s|
 	s.required_ruby_version = '>= 1.8.1'
 
 	s.files = FileList[
-		'[A-Z]*', 'install.rb', '{bin,benchmark,examples,doc,lib,test,vendor}/**/*' 
+		'[A-Z]*', 'install.rb', '{bin,benchmark,examples,doc,proto,lib,test,vendor}/**/*' 
 	].exclude('.svn/**/*').exclude('*.og').exclude('**/*.log').to_a
 
 	s.require_path = 'lib'
@@ -70,7 +70,7 @@ spec = Gem::Specification.new do |s|
 	s.test_files = []
 	
 	s.bindir = 'bin'
-	s.executables = ['nitro']
+	s.executables = ['nitro', 'nitrogen']
 	s.default_executable = 'nitro'
 
 	s.author = 'George Moschovitis'

data/bin/nitro

@@ -1,3 +1,12 @@
 #!/usr/bin/env ruby
 
-puts 'Not implemented!'
+$NITRO_NO_ENVIRONMENT = true
+
+require 'nitro'
+
+if File.exist?('run.rb')
+	system('ruby -rubygems run.rb')
+else
+	puts 'No application found, starting default application.'
+	system('ruby -rubygems ' + File.join(Nitro::LibPath, '..', 'proto', 'run.rb'))
+end

data/bin/{new_app.rb → nitrogen}

@@ -1,19 +1,17 @@
 #! /usr/bin/env ruby
 
-# = New Project Wizzard
-#
-# Creates the directory structure for a new project.
-#
-# code:
 # * George Moschovitis  <gm@navel.gr>
-#
-# (c) 2004 Navel, all rights reserved.
-# $Id: new_app.rb 194 2004-12-20 20:23:57Z gmosx $
+# (c) 2004-2005 Navel, all rights reserved.
+# $Id$
 
 require 'fileutils'
 
+$NITRO_NO_ENVIRONMENT = true
+
+require 'nitro'
+
 # gmosx, TODO: move to a library
-#
+
 def ll_r(path, &block)
   Dir.foreach(path) do |f|
 		next if [".", ".."].include?(f)  
@@ -23,32 +21,24 @@ def ll_r(path, &block)
   end
 end
 
-bin_dir = File.dirname(__FILE__)
+proto_dir = File.join(Nitro::LibPath, '..', 'proto')
 
 if base_dir = ARGV[0]
 
 # remove the trailing '/' if it exists. 
+
 base_dir = base_dir.gsub(/\/$/, '')
 
 # the following code is win32 compatible.
-#
-FileUtils.cp_r "#{bin_dir}/proto", base_dir
-ll_r(base_dir) { |f| FileUtils.rm_rf(f) if /\.svn$/ =~ f } 
 
-=begin
-Unix implementation
-%x{
-	cp -R #{bin_dir}/proto #{base_dir}
-	find #{base_dir} | grep "\.svn$" | xargs rm -rf
-}
-=end
+FileUtils.cp_r proto_dir, base_dir
+ll_r(base_dir) { |f| FileUtils.rm_rf(f) if /\.svn$/ =~ f } 
 
 else
 
 puts %{
 USAGE:
-	new_app base_dir
+	nitrogen base_dir
 }
 
 end
-

data/doc/AUTHORS

@@ -6,26 +6,17 @@ MAIN DEVELOPER:
 	
 IDEAS, ADDITIONAL CODING, SUPPORT:
 
-* Michael Neumann  <mneumann@ntecs.de>
-	Design, additional coding and bug reports.
-
-*	Matt Bowen  <matt.bowen@farweststeel.com>
-	Additional code and documentation.
-
 * Anastasios Koutoumanos  <ak@navel.gr>
 	Design, additional coding.
 
-* Elias Athanasopoulos  <elathan@navel.gr>
-	Additional coding.
+*	Matt Bowen  <matt.bowen@farweststeel.com>
+	Additional code and documentation.
 
-* Gavin Sinclair <gsinclair@soyabean.com.au>
-	Logger#trace method.
+* James Britt  <james_b@neurogami.com>
+	Design, bug reports.
 
 * Thomas Quas  <tquas@yahoo.com>
 	Ideas, bug reports, unit tests.
 
 * Kostas Nasis  <kostas@nasis.com>
 	Ideas and bug reports.
-
-* Elias Karakoulakis  <ekarak@navel.gr>
-	Additional design.

data/doc/RELEASES

@@ -1,3 +1,101 @@
+== Version 0.15.0 was released on 4/03/2005.
+
+A great release. Many cool new features and tons of subtle 
+improvements. We also welcome a new core developer, Anastastios 
+Koutoumanos, who's first contribution is the new SqlServer adapter.
+
+Most notable additions:
+
+* Advanced localization support:
+
+	locale_en = {
+		'See you' => 'See you',
+		:long_paragraph => 'The best new books, up to 30% reduced price',
+		:price => 'Price: %d %s',
+		:proc_price => proc { |value, cur| "Price: #{value} #{cur}" }
+	}
+
+	locale_de = {
+		'See you' => 'Auf wieder sehen',
+		...
+	}
+
+  lc = Localization.get
+  lc['See you'] -> See you
+  lc[:price, 100, 'euro'] -> Price: 100 euro
+  lc = Localization.get[:de]
+  lc['See you'] -> Auf wiedersehen
+ 
+  Using the LocalizationShader you can have templates like this:
+
+	<h1>[[This is a localized]] String</h1>
+	<p>
+     do you [[:like]] this?
+  </p>
+
+  All strings enclosed in [[ ]] are replaced with localized
+  versions (honouring the session locale). Check out the updated
+  blog example.
+
+* Dynamic/Parametrised mixins. A great extension to Ruby's mixin
+	feature. The Og::list implementation is replaced with the new
+  Orderable dynamic mixin, here is an example:
+
+  class Comment
+    property :body, String
+		belongs_to :article, Article
+    include Orderable, :scope => article
+  end
+
+  c.move_higher
+
+  The Orderable mixin uses the :scope parameter to dynamically alter
+  the methods appended to the Comment class. This new feature will be 
+  used throughout the platform.
+
+* NestedSets mixin:
+
+  class Comment
+		include NestedSets
+	end
+
+	or
+
+	class Comment
+		include Hierarchical, :method => :nested_sets
+	end
+
+	c.add_comment(child_comment)
+	c.full_children
+	c.direct_children
+	c.children
+ 
+	this is a reimplementation of the SqlTraversable mixin
+	available in older versions.
+
+* Improved templating system. Now allows <% %> intrerpolators
+  and provides a number of html morphing effects:
+
+  <div if="admin">
+    admin interface
+  </div>
+
+  <ul>
+    <li each="u in @users">#{u.first_name} #{u.last_name}
+	</ul>
+
+	and more...
+
+* Og provides an SqlServer adapter out of the box.
+
+* Improved scaffolding code (still a lot more to come).
+
+* Build default environment, introduced nitro and nitrogen 
+  commands to help new users.
+
+* Many, many small improvements and fixes.
+
+
 == Version 0.14.0 was released on 28/03/2005.
 
 This release fixes *important* bugs amd improves various