sws 0.4

data/lib/sws/slot.rb

@@ -0,0 +1,198 @@
+#!/usr/bin/env ruby
+
+
+module SWS 
+
+	# Represents a settable parameter of a component. It can have a value bound to
+	# itself, thus allowing the developer to make the component customizable.
+	class Slot 
+	
+		
+		# Component the receiver is contained within		
+		attr_accessor :component
+
+		# Name of the binding
+		attr_accessor	:name
+		
+		# The value bound to the receiver must be of this type
+		#attr_accessor :required_type
+
+		# Determines whether binding a value to the receiver is obligatory
+		attr_reader :required
+		
+		# Holds default value for the slot if none bound
+		attr_reader :default
+		
+		# Determines whether the value can be set by the slot (in order to update
+		# the bound value in the definition component)
+		attr_reader :settable
+		
+		# Literal string that was bound to the slot
+		attr_reader :bound_string
+	
+
+		# Creates new Slot object
+		# Parameters:
+		# component - the component this slot belongs to
+		# name - slot name
+		def initialize ( component, name )
+			
+			@component = component
+			@name = name
+			@synchronize = component.synchronize_slot?( name ) ? "@#{name}" : nil
+			@settable = false
+			#@required_type = nil
+			@required = nil
+			@default = nil
+			
+		end
+	
+
+		# Binds a string to the receiver. As SWS uses YAML now, the parameter can be
+		# a regular object, not only a string
+		def bind ( binding )
+			@bound_string = binding #binding is a string that is used in value=, so we keep it
+		end
+		
+		
+		# Returns an object that was bound to the slot. Can be a variable or a
+		# method (in that case its return value is used)
+		def bound_object ()
+			return object_to_binding( @bound_string )
+		end
+				
+	
+		# Sets default value for the receiver. The value is used when nothing is
+		# bound to the receiver.
+		def default= ( default )
+			@default = object_to_binding( default )
+		end
+		
+	
+		# Sets the "required" parameter of the receiver. If true, the slot must be bound
+		# or an exception will be thrown.
+		def required= ( required )
+			@required = required
+		end
+		
+	
+		# Sets the "settable" parameter of the receiver. If true, the value bound to
+		# the receiver will be updated on page submission.
+		def settable= ( settable )
+			@settable = settable
+		end
+	
+		
+		# Calculates the value that was bound to the receiver ("evaluates"
+		# @bound_string) and returns it		
+		def value () 
+			
+			#component parent is not null, because top-level components (pages)
+			#do not have slots		
+			if ( bound_object() == nil )
+				if ( @required == true )
+					raise "Slot #{@name} is a required slot for component #{@component.name}"
+				else
+					value = @default
+				end
+			elsif ( bound_object().instance_of?( Method ) )
+				value = bound_object().call() 
+			else
+				value = bound_object()
+			end
+			#if ( @required_type != nil && value.type.to_s != @required_type )
+			#	raise "Slot #{@name} requires value type #{@required_type}, but got #{value.type}"
+			#end
+			if ( @synchronize )
+				component.instance_variable_set( @synchronize, value )
+			end
+			return value
+			
+		end
+		
+	
+		# Updates the value of the object bound
+		def value= ( value )
+			
+			string = @bound_string
+			if ( @settable == true )
+				if ( string =~ /^[A-Z]/ )	# starts with uppercase - class/module method
+					module_name, method_string = string.split( /\./, 2 )
+					method_object = SWS.get_module( module_name )
+				else
+					if ( string =~ /^\^/ ) # parent binding
+						@component.definition_component.slots[ string[1 .. -1] ].value = value
+						return nil
+					else
+						method_object = @component.definition_component()
+						method_string = string
+					end
+				end
+				# if the method not exists the exception will be thrown, so we don't need to check
+				while ( md = /^([^.]+)\.(.+)$/.match( method_string ) )
+					method_object = method_object.method( md[1] ).call()
+					method_string = md [2]
+				end
+				method = method_object.method( "#{method_string}=" )
+				method.call( value )
+				if ( @synchronize )
+					component.instance_variable_set( @synchronize, value )
+				end
+			else
+				raise "Trying to set #{bound_object()} to #{value} by not settable slot #{self}!"
+			end
+			
+		end
+	
+		
+		# Converts an object retrieved by YAML from .sws file to a value to be bound
+		# to a slot
+		def object_to_binding ( object )
+		
+			unless ( object.is_a?( ::String ) )
+				return object
+			end
+			
+			if ( object =~ /^'.*'$/ ) #literal string - strip '
+				return object[1 .. -2]
+			else	#unquoted string - a method
+				if ( object =~ /^[A-Z]/ )	# starts with uppercase - class/module method
+					module_name, method_string = object.split( /\./, 2 )
+					method_object = SWS.get_module( module_name )
+				else
+					if ( object =~ /^\^/ ) # parent binding
+						return @component.definition_component.slots[ object[1 .. -1] ].bound_object()
+					else
+						method_object = @component.definition_component()
+						method_string = object
+					end
+				end
+				# if the method does not exist the exception is raised, so we don't need to check
+				while ( md = /^([^.]+)\.(.+)$/.match( method_string ) )
+					method_object = method_object.method( md[1] ).call()
+					method_string = md [2]
+				end
+				value = method_object.method( method_string )
+				return value
+			end
+			
+		end
+		
+
+		# Returns string representation of the receiver		
+		def to_s () 
+			return "Slot - name: #{@name}, component: #{@component}, binding: #{@bound_string}, required: #{@required}, default: #{@default}, settable: #{settable}"
+		end
+
+		
+		# Returns default representation of the slot as a tag attribute (that is eg.
+		# 'href="#{@slots["href"].value}' for slot named "href") if the slot is
+		# bound, empty string otherwise
+		def to_tag_attribute ()
+			return (@bound_string || @default) ? "#{name}=\"#{value()}\"" : ""
+		end
+
+
+	end
+
+end

metadata

@@ -0,0 +1,263 @@
+--- !ruby/object:Gem::Specification 
+rubygems_version: 0.8.11
+specification_version: 1
+name: sws
+version: !ruby/object:Gem::Version 
+  version: "0.4"
+date: 2006-04-25 00:00:00 +02:00
+summary: SWS is a sophisticated web development library in spirit of Apple WebObjects
+require_paths: 
+- lib
+email: marek@janukowicz.net
+homepage: http://www.starware.one.pl/software/sws
+rubyforge_project: sws
+description: 
+autorequire: sws
+default_executable: 
+bindir: bin
+has_rdoc: false
+required_ruby_version: !ruby/object:Gem::Version::Requirement 
+  requirements: 
+  - - ">"
+    - !ruby/object:Gem::Version 
+      version: 0.0.0
+  version: 
+platform: ruby
+signing_key: 
+cert_chain: 
+authors: 
+- Marek Janukowicz
+files: 
+- lib/sws
+- lib/sws.rb
+- lib/sws/JSComponents
+- lib/sws/Core
+- lib/sws/response.rb
+- lib/sws/extensions.rb
+- lib/sws/parsers.rb
+- lib/sws/slot.rb
+- lib/sws/component.rb
+- lib/sws/application.rb
+- lib/sws/session.rb
+- lib/sws/direct_action.rb
+- lib/sws/request.rb
+- lib/sws/cookie.rb
+- lib/sws/adaptor.rb
+- lib/sws/JSComponents/components
+- lib/sws/JSComponents/framework.yaml
+- lib/sws/JSComponents/components/JSMenu
+- lib/sws/JSComponents/components/JSMenu/JSMenu.rb
+- lib/sws/JSComponents/components/JSMenu/JSMenu.html
+- lib/sws/JSComponents/components/JSMenu/JSMenu.api
+- lib/sws/JSComponents/components/JSMenu/JSMenu.sws
+- lib/sws/Core/components
+- lib/sws/Core/framework.yaml
+- lib/sws/Core/components/GenericContainer
+- lib/sws/Core/components/Select
+- lib/sws/Core/components/Image
+- lib/sws/Core/components/CheckBoxList
+- lib/sws/Core/components/Repetition
+- lib/sws/Core/components/FileUpload
+- lib/sws/Core/components/GenericElement
+- lib/sws/Core/components/CheckBox
+- lib/sws/Core/components/RadioButtonList
+- lib/sws/Core/components/TextField
+- lib/sws/Core/components/RadioButton
+- lib/sws/Core/components/ExceptionPage
+- lib/sws/Core/components/Link
+- lib/sws/Core/components/HiddenField
+- lib/sws/Core/components/SubmitButton
+- lib/sws/Core/components/Form
+- lib/sws/Core/components/Conditional
+- lib/sws/Core/components/Hyperlink
+- lib/sws/Core/components/PasswordField
+- lib/sws/Core/components/String
+- lib/sws/Core/components/Content
+- lib/sws/Core/components/TextArea
+- lib/sws/Core/components/ImageButton
+- lib/sws/Core/components/ResetButton
+- lib/sws/Core/components/GenericContainer/GenericContainer.rb
+- lib/sws/Core/components/GenericContainer/GenericContainer.html
+- lib/sws/Core/components/GenericContainer/GenericContainer.api
+- lib/sws/Core/components/GenericContainer/GenericContainer.sws
+- lib/sws/Core/components/Select/Select.rb
+- lib/sws/Core/components/Select/Select.api
+- lib/sws/Core/components/Image/Image.rb
+- lib/sws/Core/components/Image/Image.api
+- lib/sws/Core/components/CheckBoxList/CheckBoxList.rb
+- lib/sws/Core/components/CheckBoxList/CheckBoxList.api
+- lib/sws/Core/components/Repetition/Repetition.rb
+- lib/sws/Core/components/Repetition/Repetition.html
+- lib/sws/Core/components/Repetition/Repetition.api
+- lib/sws/Core/components/Repetition/Repetition.sws
+- lib/sws/Core/components/FileUpload/FileUpload.rb
+- lib/sws/Core/components/FileUpload/FileUpload.api
+- lib/sws/Core/components/GenericElement/GenericElement.rb
+- lib/sws/Core/components/GenericElement/GenericElement.api
+- lib/sws/Core/components/CheckBox/CheckBox.rb
+- lib/sws/Core/components/CheckBox/CheckBox.api
+- lib/sws/Core/components/RadioButtonList/RadioButtonList.rb
+- lib/sws/Core/components/RadioButtonList/RadioButtonList.api
+- lib/sws/Core/components/TextField/TextField.api
+- lib/sws/Core/components/TextField/TextField.rb
+- lib/sws/Core/components/RadioButton/RadioButton.api
+- lib/sws/Core/components/RadioButton/RadioButton.rb
+- lib/sws/Core/components/ExceptionPage/ExceptionPage.sws
+- lib/sws/Core/components/ExceptionPage/ExceptionPage.rb
+- lib/sws/Core/components/ExceptionPage/ExceptionPage.html
+- lib/sws/Core/components/Link/Link.rb
+- lib/sws/Core/components/Link/Link.api
+- lib/sws/Core/components/HiddenField/HiddenField.rb
+- lib/sws/Core/components/HiddenField/HiddenField.api
+- lib/sws/Core/components/SubmitButton/SubmitButton.rb
+- lib/sws/Core/components/SubmitButton/SubmitButton.api
+- lib/sws/Core/components/Form/Form.rb
+- lib/sws/Core/components/Form/Form.html
+- lib/sws/Core/components/Form/Form.api
+- lib/sws/Core/components/Form/Form.sws
+- lib/sws/Core/components/Conditional/Conditional.rb
+- lib/sws/Core/components/Conditional/Conditional.html
+- lib/sws/Core/components/Conditional/Conditional.api
+- lib/sws/Core/components/Conditional/Conditional.sws
+- lib/sws/Core/components/Hyperlink/Hyperlink.sws
+- lib/sws/Core/components/Hyperlink/Hyperlink.rb
+- lib/sws/Core/components/Hyperlink/Hyperlink.html
+- lib/sws/Core/components/Hyperlink/Hyperlink.api
+- lib/sws/Core/components/PasswordField/PasswordField.rb
+- lib/sws/Core/components/PasswordField/PasswordField.api
+- lib/sws/Core/components/String/String.rb
+- lib/sws/Core/components/String/String.api
+- lib/sws/Core/components/Content/Content.rb
+- lib/sws/Core/components/TextArea/TextArea.rb
+- lib/sws/Core/components/TextArea/TextArea.api
+- lib/sws/Core/components/ImageButton/ImageButton.rb
+- lib/sws/Core/components/ImageButton/ImageButton.api
+- lib/sws/Core/components/ResetButton/ResetButton.rb
+- lib/sws/Core/components/ResetButton/ResetButton.api
+- examples/addressbook
+- examples/movies
+- examples/component_demo
+- examples/README
+- examples/addressbook/Login
+- examples/addressbook/CardBrowse
+- examples/addressbook/addressbook.rb
+- examples/addressbook/application.yaml
+- examples/addressbook/db.yaml
+- examples/addressbook/README
+- examples/addressbook/Login/LoginPage.sws
+- examples/addressbook/Login/LoginPage.rb
+- examples/addressbook/Login/LoginPage.html
+- examples/addressbook/CardBrowse/CardBrowse.sws
+- examples/addressbook/CardBrowse/CardBrowse.rb
+- examples/addressbook/CardBrowse/CardBrowse.html
+- examples/movies/UserBrowse
+- examples/movies/frameworks
+- examples/movies/MovieBrowse
+- examples/movies/Menu
+- examples/movies/images
+- examples/movies/movies_sqlite.sql
+- examples/movies/movies.sqlite
+- examples/movies/application.yaml
+- examples/movies/movies.rb
+- examples/movies/movies_mysql.sql
+- examples/movies/da.rb
+- examples/movies/movies_postgres.sql
+- examples/movies/dbmovies.rb
+- examples/movies/movies.sds
+- examples/movies/README
+- examples/movies/UserBrowse/UserBrowse.rb
+- examples/movies/UserBrowse/UserBrowse.html
+- examples/movies/UserBrowse/UserBrowse.sws
+- examples/movies/frameworks/TestFramework
+- examples/movies/frameworks/TestFramework/resources
+- examples/movies/frameworks/TestFramework/framework.yaml
+- examples/movies/frameworks/TestFramework/resources/im1.jpg
+- examples/movies/MovieBrowse/MovieBrowse.rb
+- examples/movies/MovieBrowse/MovieBrowse.html
+- examples/movies/MovieBrowse/MovieBrowse.sws
+- examples/movies/Menu/Menu.sws
+- examples/movies/Menu/Menu.rb
+- examples/movies/Menu/Menu.html
+- examples/movies/images/pbr1b.jpg
+- examples/component_demo/GenericDemo
+- examples/component_demo/RepetitionDemo
+- examples/component_demo/FormListsDemo
+- examples/component_demo/FileUploadDemo
+- examples/component_demo/CheckBoxDemo
+- examples/component_demo/FormFieldsDemo
+- examples/component_demo/ImageLinkDemo
+- examples/component_demo/ConditionalDemo
+- examples/component_demo/HyperlinkDemo
+- examples/component_demo/StringDemo
+- examples/component_demo/PageWrapper
+- examples/component_demo/poweredby.jpg
+- examples/component_demo/style.css
+- examples/component_demo/README
+- examples/component_demo/application.yaml
+- examples/component_demo/ComponentDemo.rb
+- examples/component_demo/GenericDemo/GenericDemo.rb
+- examples/component_demo/GenericDemo/GenericDemo.html
+- examples/component_demo/GenericDemo/GenericDemo.sws
+- examples/component_demo/RepetitionDemo/RepetitionDemo.sws
+- examples/component_demo/RepetitionDemo/RepetitionDemo.rb
+- examples/component_demo/RepetitionDemo/RepetitionDemo.html
+- examples/component_demo/FormListsDemo/FormListsDemo.sws
+- examples/component_demo/FormListsDemo/FormListsDemo.rb
+- examples/component_demo/FormListsDemo/FormListsDemo.html
+- examples/component_demo/FileUploadDemo/FileUploadDemo.sws
+- examples/component_demo/FileUploadDemo/FileUploadDemo.rb
+- examples/component_demo/FileUploadDemo/FileUploadDemo.html
+- examples/component_demo/CheckBoxDemo/CheckBoxDemo.sws
+- examples/component_demo/CheckBoxDemo/CheckBoxDemo.rb
+- examples/component_demo/CheckBoxDemo/CheckBoxDemo.html
+- examples/component_demo/FormFieldsDemo/FormFieldsDemo.rb
+- examples/component_demo/FormFieldsDemo/FormFieldsDemo.html
+- examples/component_demo/FormFieldsDemo/FormFieldsDemo.sws
+- examples/component_demo/ImageLinkDemo/ImageLinkDemo.sws
+- examples/component_demo/ImageLinkDemo/ImageLinkDemo.rb
+- examples/component_demo/ImageLinkDemo/ImageLinkDemo.html
+- examples/component_demo/ConditionalDemo/ConditionalDemo.sws
+- examples/component_demo/ConditionalDemo/ConditionalDemo.rb
+- examples/component_demo/ConditionalDemo/ConditionalDemo.html
+- examples/component_demo/HyperlinkDemo/HyperlinkDemo.sws
+- examples/component_demo/HyperlinkDemo/HyperlinkDemo.rb
+- examples/component_demo/HyperlinkDemo/HyperlinkDemo.html
+- examples/component_demo/StringDemo/StringDemo.sws
+- examples/component_demo/StringDemo/StringDemo.rb
+- examples/component_demo/StringDemo/StringDemo.html
+- examples/component_demo/PageWrapper/PageWrapper.rb
+- examples/component_demo/PageWrapper/PageWrapper.html
+- examples/component_demo/PageWrapper/PageWrapper.sws
+- doc/docbook
+- doc/DOC.otl
+- doc/Makefile
+- doc/architecture.dia
+- doc/docbook/installation.docbook
+- doc/docbook/introduction.docbook
+- doc/docbook/tutorial.docbook
+- doc/docbook/todo.docbook
+- doc/docbook/architecture.png
+- doc/docbook/sws_manual.docbook
+- doc/docbook/concepts.docbook
+test_files: []
+
+rdoc_options: []
+
+extra_rdoc_files: []
+
+executables: []
+
+extensions: []
+
+requirements: []
+
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: log4r
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Version::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 1.0.5
+    version: