IOWA 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 6e1a4cbacdd91f5aa3423245bcc0c213083a6bc9
+  data.tar.gz: 0c7123a789e8ef431dce5872dc6c1de328060c2c
+SHA512:
+  metadata.gz: a2b6f68212cb8f07e43edc3c8dab8298c5aab1ddc26b650b6f01b3949164cbc5c60a02a53c800b2d764af63e471ceaec302e97958150ba465acae82fd707f05b
+  data.tar.gz: 1acfedee6923bcdaec33767afff53ef0dbc7e2fba85bf7565672a8bf6daa10db7d589a9995fcdecc0754c46f805a968c50b8dafa9425c2f3a06ec4e5a0dcf205

data/CONTRIBUTORS

@@ -0,0 +1,14 @@
+The following people have made code contributions to the development of Iowa.
+
+	*	David Naseby <naseby@ihug.com.au>: Contributed an initial
+		implementation of both the webrick support and the inline content
+		generation code.
+		
+	*	Daniel Berger <djberge@qwest.com>: Daniel contributed a better
+		implementation of the Hash::downcase_keys method found in iowa.rb.
+
+	*	Daniel Cremer
+
+	*	Stefan Schmiedl <s@xss.de>: Numerous bugs found, and contributions
+		of the component navigation convenience methods, prodeed() and
+		proceed_with().

data/README.md

@@ -0,0 +1,23 @@
+# IOWA v1.0.0
+
+## History
+
+IOWA is a web development framework for Ruby. The name is an acronym for
+Internet Objects for Web Applications. It started life in 2001 as a proof of
+concept idea written by Avi Bryant. In 2002, it was taken over by Kirk Haines
+and developed into a framework suitable for production application use. In the
+intervening years, it is has been used on hundreds of production applications.
+
+## What Is It?
+
+IOWA is a web development framework that, while providing all of the typical
+tools for request parsing, response generation, and separation of concerns
+between views, controllers, and models, it also provides a facility for
+simplifying the job of state management in an application by making it
+transparent. Applications can set state during one request/response cycle, and
+that state will still exist on the following request/response cycle.
+
+
+
+Copyright 2002-2017 Kirk Haines
+Copyright 2001, 2002 Avi Bryant

data/RELEASE_NOTES

@@ -0,0 +1,77 @@
+0.99.2.19
+
+	*	Numerous bug fixes, including a major one involving nested Repeats, and association
+		caching which wasn't accomodating the nested Repeats.
+
+	*	CSS DSL first release.  Implements CSS1, CSS2, CSS3.
+
+0.99.2.17
+
+	* iowa_webrick.rb rejoins the world of the working.
+
+	* Misc bug fixes revealed by running a new site in production under 0.99.2.16.
+
+
+0.99.2.16
+
+	*	More bug fixes.
+
+	*	Better httpmachine support, but depends on the 0.0.6 monorail gem so far, so is EXPERIMENTAL.
+		Use the hybrid run mode to use EM (which offers great performance characteristics).
+
+	* File uploads are BROKEN.  Will be fixed for 0.99.2.17
+
+	* All in all, much closer to stability again.
+
+
+0.99.2.14
+
+	*	Okay, 0.99.2.9 was not the last release before 0.99.3.0.
+
+	*	Numerous bug fixes.
+
+	* Mongrel integration working better.
+
+	* Hybrid EventMachine/Mongrel support working well.
+
+
+0.99.2.9
+
+	*	The last release before 0.99.3.0.
+
+	*	Mongrel support.
+
+	*	EventMachine/HTTPMachine support.
+
+	*	Testing/bug fixes.  Install fixes.
+
+	*	Much improved StandardDispatcher.
+
+	*	A custom Mutex class that adds some capabilities and works around issues with the standard Mutex.
+
+	*	A workaround for a Ruby memory leak with Hash.
+
+
+0.99.2.8
+
+	*	Fixes more install problems with Win32 platforms.
+
+	*	Bundled win32-process and windows-pr.
+
+	*	Fixed a few misc bugs with iowa_root/root_path.
+
+
+0.99.2.7
+
+	*	Fixes some install problems with Win32 platforms.
+
+	*	Adds a simple hello world demo app.
+
+	*	Fixes a few bugs between the new config structure and the webrick code.
+
+
+0.99.2.6
+
+	*	Bug fix release.  Had a dumb error in setup.rb and a bad little bug
+		related to persistence of old session/context information in 
+		requests which should be looking at current information.

data/ToDo

@@ -0,0 +1,21 @@
+	*	Expand the Policies available so that sessions can be tracked
+		via cookies, automatically.
+	*	Improve the parsing of custom tags so that kludges like:
+
+		<PageHeader oid="pageHeader"/>
+
+		are not needed.  Really, we shouldn't have to pass an oid
+		with an attribute if we aren't actually doing anything with it.
+
+		<PageHeader/>
+
+		would be great.  This requires a much smarter TemplateParser.
+	*	On this same note, improve the header so that it handles certain
+		kinds of nesting, such as
+
+		<!-- <PageHeader oid="pageHeader" /> -->
+
+		Or the use of CDATA sections that wrap IOWA tags.  Right now
+		both of those cause the parser to get confused.
+	
+

data/components/CRUDList/CRUDList.html

@@ -0,0 +1,13 @@
+<form oid="handleForm" class="IWACL">
+<table class="IWACLtable" border="1">
+<if oid="doHeader?">	<tr>
+		<if oid="doOpt1?"><th></th></if><repeat oid="header_list"><th>@column_header</th></repeat><if oid="doOpt2?"><th></th></if>
+	</tr></if>
+<repeat oid="record_list">	<tr>
+<if oid="doOpt1?">		<td><input type="submit" oid="do_opt1_button" value="<opt1_label>"></td></if>
+		<repeat oid="field_list"><td>@field</td></repeat>
+<if oid="doOpt2?">		<td><input type="submit" oid="do_opt2_button" value="<opt2_label>"></td></if>
+	</tr>
+</repeat>
+</table>
+</form>

data/components/CRUDList/CRUDList.iwa

@@ -0,0 +1,136 @@
+class CRUDList < Iowa::Component
+	#TODO:
+	#  - Address the internal caching.
+	#  - Address the butt-ugly method of manipulating appearance.
+	#  - See what sort of helpers Iowa might be able to provide. 
+
+	attr_binding :records, :order, :alias, :header, :opt1_button, :opt2_button
+	attr_accessor :column_header, :record, :field
+	
+	def awake
+		@@cache ||= PageStore.new(initial_cache_size)
+	end
+
+	def initial_cache_size
+		30
+	end
+	
+	def setup
+		@record_order = []
+		if self.records.kind_of?(Array) and self.records.length > 0
+			if self.order
+				@record_order = self.order.collect {|r| r.to_s}
+			#elsif self.records.kind_of?(Array) and self.records[0].length > 0
+			else
+				self.records[0].class.all_fields.each do |f|
+					@record_order << f.name
+				end
+			end
+		end
+		
+		key = ''
+
+		key << @record_order.join('|')
+		key << "_#{opt1_label}"
+		key << "_#{opt2_label}"
+		unless @@cache.include?(key)
+			my_content = content
+			@@cache[key] = TemplateParser.new(my_content,self.class.template.raw_bindings).root
+		end
+		@template = @@cache[key]
+	end
+
+	def opt1_label
+		if self.opt1_button and self.opt1_button.has_key?(:label)
+			self.opt1_button[:label].to_s
+		else
+			'Edit'
+		end
+	end
+	
+	def opt2_label
+		if self.opt2_button and self.opt2_button.has_key?(:label)
+			self.opt2_button[:label].to_s
+		else
+			'Delete'
+		end
+	end
+	
+	def content
+		raw_template = self.class.template.raw_template
+		raw_template.sub(/<opt1_label>/,opt1_label).sub(/<opt2_label>/,opt2_label)
+	end
+	
+	# Override for special tasks.
+	def handleForm
+	end
+
+	# Override for special tasks.
+	def do_opt1_button(&block)
+		self.opt1_button[:proc].call(@record,block)
+	end
+
+	def do_opt2_button(&block)
+		self.opt2_button[:proc].call(@record,block)
+	end
+	
+	def doHeader?
+		self.header
+	end
+	
+	def doOpt1?
+		self.opt1_button.kind_of?(Hash) and self.opt1_button[:proc] != nil
+	end
+	
+	def doOpt2?
+		self.opt2_button.kind_of?(Hash) and self.opt2_button[:proc] != nil
+	end
+
+	def headers
+		@record_order.collect {|r|
+			n = r
+			if self.alias.respond_to?(:has_key?) and self.alias.has_key?(n.to_sym)
+				n = self.alias[n.to_sym].to_s
+			end
+			n.gsub(/\./,':')
+		}
+	end
+	
+	def records_list
+		self.records.kind_of?(Array) ? self.records : []
+	end
+	
+	def fields
+		r = []
+		@record_order.each do |f|
+			unless /\./.match(f)
+				r << @record.__send__(f)
+			else
+				keys = f.split('.')
+				last_key = keys.pop
+				current = @record
+				keys.each {|k| current = current.__send__(k)}
+				r << current.__send__(last_key)
+			end
+		end
+		r
+	end
+	
+end
+
+<?
+	header_list {
+		item = column_header
+		list = headers
+	}
+	
+	record_list {
+		item = record
+		list = records_list
+	}
+	
+	field_list {
+		item = field
+		list = fields
+	}
+?>

data/components/Content/Content.iwa

@@ -0,0 +1,143 @@
+require 'thread'
+class Content < Iowa::DetachedComponent
+
+	# This component displays no content of its own.  Rather, it retrieves content
+	# from some content repository, called a library. The retrieveed content is
+	# treated like an IOWA template and is parsed with the TemplateParser.
+	# The parsed template is ccahed, and is used as the template for the component.
+	# Because the template content is parsed with the TemplateParser, that content
+	# may also have Content tags in it.  There is no limit to the depth of embedding
+	# which will be traversed.
+	
+	@mutex = Mutex.new
+
+	attr_accessor :content, :predecessors
+	
+	def Content.default_cache_size; 100; end
+	def Content.default_cache_ttl; nil; end
+	
+	class ConfObj_ < Hash
+		def library; @library; end
+		def library=(val); self[val] ||= {}; @library = val; end
+
+		def query; self[@library][:query]; end
+		def query=(val); self[@library][:query] = val; end
+		def retrieve; self[@library][:retrieve]; end
+		def retrieve=(val); self[@library][:retrieve] = val; end
+
+		def cache; self[@library][:cache]; end
+		def cache=(args)
+			#self[@library][:cache] = Util.get_cache(args,{Cmaxsize => Content.default_cache_size, Cttl => Content.default_cache_ttl})
+			self[@library][:cache] = Util.get_cache(args)
+		end
+	end
+
+	@confobj = ConfObj_.new
+
+	# The Content component can serev content from multiple libraries
+	# at he same time.  To set or reference a configuration item for
+	# a given library, pass it's name as an argument to Content.config.
+	# i.e. Content.config('generaldb').cache = Hash.new
+	#
+	def Content.config(library = C_default)
+		if block_given?
+			@mutex.synchronize do
+				begin
+					oldlib = @confobj.library
+					@confobj.library = library
+					yield @confobj
+				ensure
+					@confobj.library = oldlib
+				end
+			end
+		else
+			@confobj.library = library
+			@confobj
+		end
+	end
+
+	# Default cache is a basic LRUCache.
+	Content.config.cache = [:LRUCache, {:maxsize => 100}]
+
+	# Default query mechanism is flatfile based, looking in
+	# #{Iowa.app.root_path}/_content
+	Content.config.query = Proc.new do |name, attributes|
+		File.stat(File.join(Iowa.app.root_path,C_content,name)).mtime
+	end
+
+	Content.config.retrieve = Proc.new do |name, attributes|
+		r = {}
+		name.gsub!(/[\\\/]/,File::SEPARATOR)
+		filename = File.join(Iowa.app.root_path,C_content,name)
+		# Race condition here....
+		r[Cchecksum] = r[Clast_modification] = File.stat(filename).mtime
+		r[Clabel] = name
+		r[Ctitle],r[Cbody] =File.read(filename).split(/\n/,2)
+		r
+	end
+
+	def initialize(*args)
+		super(*args)
+		@dataname = @bindings.has_key?('id') ? getBinding('id') : @name
+		@predecessors = {@dataname => true}
+		if @parent.respond_to?(:predecessors)
+			@predecessors.merge! @parent.predecessors
+		end
+	end
+
+	def setup
+		parsed_template = nil
+		library = @attributes[Clibrary] || C_default
+		Content.config(library) do |content_config|
+			cache_entry = content_config.cache[@dataname]
+		
+			if !cache_entry or (cache_entry and cache_entry[0] != content_config.query.call(@dataname, @attributes, session)) or session.context.request.params.has_key?(Crefresh) or @attributes[Crefresh] =~ /(true|enabled)/
+
+				cobj = content_config.retrieve.call(@dataname, @attributes, session)
+				my_content = generate_wrapped_content(cobj)
+				parsed_template = TemplateParser.new(my_content,{},self.class).root
+				content_config.cache[@dataname] = [cobj[Cchecksum], parsed_template]
+			else
+				parsed_template = cache_entry[1]
+			end
+		end
+
+		# This prevents infinite loops.
+		if @parent.respond_to?(:predecessors) and @parent.predecessors[@dataname]
+			@template = TemplateParser.new(C_empty,{}).root
+		else
+			@template = parsed_template
+		end
+	end
+
+	def generate_wrapped_content(content)
+		_container = true
+		_title = false
+		_content = true
+		_container = false if @attributes['showcontainer'] =~ /^\s*(disabled|0|false)\s*$/
+		_title = false if @attributes['showtitle'] =~ /^\s*(disabled|0|false)\s*$/
+		_content = false if @attributes['showcontent'] =~ /^\s*(disabled|0|false)\s*$/
+		r = ''
+		r << "<div class=\"#{@attributes['class']||container_ctnt}\">" if _container
+		r << "<div class=\"#{@attributes['titleclass']||title_ctnt}\">#{content[Ctitle]}</div>" if _title
+		r << "<div class=\"#{@attributes['contentclass']||content_ctnt}\">#{content[Cbody]}</div>" if _content
+		r << "</div>" if _container
+		r
+	end
+
+	def container_ctnt
+		#"#{@dataname}_container_ctnt"
+		"container_ctnt"
+	end
+
+	def title_ctnt
+		#"#{@dataname}_title_ctnt"
+		"title_ctnt"
+	end
+
+	def content_ctnt
+		#"#{@dataname}_content_ctnt"
+		"content_ctnt"
+	end
+
+end

data/components/Content/example/README

@@ -0,0 +1,9 @@
+This is a very simple demo of the Content component.
+
+To access the demo:
+
+ruby demo.rb
+
+Then point your web browser at port 47990 if your system.
+
+To exit from the demo, use ctrl-c.