txprails 0.1.1 → 0.1.2

data/README.rdoc

@@ -1,23 +1,24 @@
 = TXPRrails
 
-*DISCLAIMER:*
+*DISCLAIMER*
 
-TXPRails born kind of a experiment. Please be aware that this is a work in
-progress.
+TXPRails was born kind of an experiment. Please be aware that this is a work
+in progress.
 
-= TXPRails = TextPattern Rails
+= TXPRails = Textpattern Rails
 
-This gem is a experiment for using TextPattern like templates in a Rails
+This gem is an experiment for using *Textpattern* like templates in a Rails
 environment. Rails have many template engines available, from ERB thru Haml,
 etc. However, for many of us from a more traditional PHP/like environment,
-XML-style templates seems more natural. Moreover, Txp style templates differ
+XML-style templates seems more natural. Moreover, TXP style templates differ
 from Haml or ERB in one thing: the templates are not "compiled" in the sense
 of making 1 pre-compile pass (Haml) or more-or-less-directly ruby-executed
-(ERB). Txp templates are executed while parsing, using different techniques
+(ERB). TXP templates are executed while parsing, using different techniques
 explained below.
 
 I think Haml is kind of awesome, and I'm slowly getting used to it. However,
 I'm still fascinated of the elegance and simplicity of TXP XML'ish templates.
+Liquid template fans will also find TXP templates very easy to use.
 
 So, in essence, I started this project solely for this pourposes:
 
@@ -28,9 +29,46 @@ So, in essence, I started this project solely for this pourposes:
 * Just for fun... :-)
 
 *This project and some of the code (namely the Rails plugin bootstrap) is
-heavily inspired by Haml itself.*
+heavily inspired by Haml itself*. Also, there is also some influence of the
+*fluid* template engine.
 
-Please, PLEASE, if you find this gem useful, comment and make suggestions to make it better. I think you may also benefit and learn from TXPRails.
+Please, PLEASE, if you find this gem useful, comment and make suggestions to
+make it better. I think you may also benefit and learn from TXPRails.
+
+
+= EXAMPLES
+
+TextPattern syntax templates have an extension of +.txp+, you can rename all
+your templates to use +.txp* extension and will use TXPRails as template
+engine.
+
+Please, read the {manual for Textpattern tags}[http://textpattern.net/wiki/index.php?title=Tag_Basics]
+to get the basics.
+
+Textpattern tags are XML. There are two kind of tags: Self referenced and
+container tags. Self referenced tags are XML self-closed tags like
++<txp:content />+. Container tags, on the other hand, have a block of text
+between the the tag pair like: +<txp:link to="destination"> ...blah,
+blah...</txp:link>+.
+
+Pay close attention to self-closed tags. They have a forward slash at the end,
+exactly like XHTML tags.
+
+Textpattern tags have a "domain" and "name" part, like this: +<domain:name />+. The Domain part plays an important role in TXPRails, unlike in
+Textpattern where they are simply "sintactic sugar".
+
+= Differences from Textpattern
+
+Template Tags in the Textpattern publishing system are very tight coupled. For
+example, tags like +<txp:permlink />+ requires to have a blog, a post and this
+post have a permalink. This is not the case with TXPRails, in which we
+obviously haven't a blog. In Rails we have Models:
+
+    <mod:clients limit="5">
+      The name: <var:name /><br />
+      The phone: <var:phone /><br />
+      <txp:link>View more</txp:link>
+    </mod:clients>
 
 
 == Note on Patches/Pull Requests

data/VERSION

@@ -1 +1 @@
-0.1.1
+0.1.2

data/lib/txprails.rb

@@ -36,9 +36,60 @@ module TXP
     end
   end
 
+  def txp_eval(tag)
+    eval(tag.attr["code"])
+  end
+
   def txp_include(tag)
     @view.render :partial => tag.attr["name"]
   end
 
-#  self.extend self
+  def txp_controller(tag)
+    @view.controller.instance_variable_names.to_s
+  end
+
+
+  def method_missing(method_id, *args, &block)
+    method_name = method_id.to_s
+    super if method_name !~ /^mod_/ && method_name !~ /^var_/
+    
+    # Model or variable requested...
+    tag = args.first
+    output = []
+    case method_name
+    when /^mod_/
+      if @_current_models.empty? || @_current_var.nil?
+        variables = @view.controller.instance_variable_names
+        variables -= @view.controller.protected_instance_variables if @view.controller.respond_to?(:protected_instance_variables)
+        raise "Model not found" unless variables.include?("@#{tag.name}")
+        @_current_models.push(@view.controller.instance_variable_get("@#{tag.name}")) 
+      else
+        raise "Model not found in current model" unless @_current_var.respond_to?(tag.name.to_sym)
+        @_current_models.push(@_current_var.send(tag.name.to_sym))
+      end
+      output << iterate_current_model(tag)
+      @_current_models.pop
+    when /^var/
+      unless @_current_var.nil?
+        output << @_current_var.send(tag.name.to_sym).to_s
+      else
+        output << "[UNDEFINED]"
+      end
+    else
+      raise "Invalid domain for tag"
+    end
+    output.join
+  end
+
+  private
+  def iterate_current_model(tag)
+    return if @_current_models.empty?
+    output = []
+    @_current_models.last.each do |x|
+      @_current_var = x
+      output << parse(tag.thing) unless tag.thing.nil?
+    end
+    output.join
+  end
+
 end

data/lib/txprails/template.rb

@@ -9,12 +9,13 @@ module TXPRails
 
     def initialize(view)
       @view = view
+      @_current_models = []
     end
-    
+
     def render(template, local_assigns = {})
       parse(template.source)
     end
-    
+
     def compilable?
       false
     end

data/txprails.gemspec

@@ -5,11 +5,11 @@
 
 Gem::Specification.new do |s|
   s.name = %q{txprails}
-  s.version = "0.1.1"
+  s.version = "0.1.2"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
   s.authors = ["Jose Miguel P\303\251rez Ruiz"]
-  s.date = %q{2010-01-09}
+  s.date = %q{2010-01-10}
   s.default_executable = %q{txprails}
   s.description = %q{TXPRails is a template engine based on TextPattern for Rails.}
   s.email = %q{josemiguel@perezruiz.com}

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification 
 name: txprails
 version: !ruby/object:Gem::Version 
-  version: 0.1.1
+  version: 0.1.2
 platform: ruby
 authors: 
 - "Jose Miguel P\xC3\xA9rez Ruiz"
@@ -9,7 +9,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2010-01-09 00:00:00 +01:00
+date: 2010-01-10 00:00:00 +01:00
 default_executable: txprails
 dependencies: 
 - !ruby/object:Gem::Dependency