masterview 0.0.17 → 0.1.0

data/CHANGELOG

@@ -1,3 +1,7 @@
+0.1.0 - May 27th - Major additions. Added rake admin tasks, MasterView admin controller/views. Allow user to easily have distributed files and keep sync'd. Generator defaults to generating split files.
+
+0.0.18 - May 12, 2006 - Refactored watcher
+
 0.0.17 - May 4, 2006 - Added some additional css style and generator options, change the showOne option
 
 0.0.16 - April 28, 2006 - Corrected gem version dependencies

data/README

@@ -22,7 +22,7 @@ License:: MIT open source license like Rails
 - Design it specifically for ruby and rails. Use the full power and not be limited in its capabilities over what can be done with ERb
 - Work nicely with layouts, partials, and rails html helpers.
 - Reduce complexity, work with existing rails code, no extra view logic or hashes than what is used by ERb. Scaffold generate initial templates or work from existing html prototype.
-- Use one master file to drive all related sections, simplifying editing.
+- Reduce the numbers of files, simplifying editing. Define partials and layouts naturallyl right in the template, no need to go to another file.
 - Preview in browser without running an app. Allow for dummy data in the template so that the page can be viewed and styled independently of the application.
 - Performance equal to ERb
 
@@ -61,16 +61,22 @@ This will copy entire MasterView system into your vendor/plugin/masterview direc
 
 You may add MasterView attributes to existing (x)html or you may use the masterview generator to create a complete working application. The generator can create controllers, models, and the MasterView template file similar to how the built-in generator works. Simply change directory to your rails application and run the following
 
-script/generate masterview YourModelName [YourControllerName] [--show-all | --show-only list] [--style [cssStylesheet]]
+script/generate masterview YourModelName [YourControllerName] [--style [cssStylesheet]] [--single-file] [--show-all | --show-only list] 
 
-To make it easier to use this template at design time, some design time css stylesheets are included in the file to hide all sections except one. By default the NEW section is the only one shown. Other options are --show-all which makes all sections visible or [--show-only list] which shows only the LIST section. When you are editing the masterview file you may comment/uncomment one of the other css files to show a different section. The --style param allows you to suppress default style generation and specify an existing stylesheet to use, if you exlude the stylesheet none will be used, if you include this option multiple times with different stylesheets each will be used.
+The generator by default will generate five masterview template files, one for each distinct page, list, new, edit, show, and destroy. They exist in the app/views/masterview directory with the filename controller_action.html. The layout and message partial are defined in the list template file and imported into the others. Similarly the new template defines the form partial which is imported into edit, and finally the show file defines a _show partial which is imported into destroy. Thus there is one definition of each part (layout and partial) and they are imported into the other files where needed to provide accurate WYSIWYG design time editing. By generating separate files, teams can work on a project easier, however MasterView also supports generating all parts to a single file for the ultimate in DRY.
 
-Once it is done generating, the generated MasterView template file will be created in app/views/masterview/YourModelName.html. This file is html and can be edited with any standard html editor. The rails specific logic is contained in simple attributes which are ignored by html editors. The syntax for these attributes is heavily derived from the rails helper tags themselves so it should feel natural to the rails developer.
+By adding the --single-file switch MasterView will create a single file and to make it easier to use this template at design time, some design time css stylesheets are included in the file to hide all sections except one. By default the NEW section is the only one shown. Other options are --show-all which makes all sections visible or [--show-only list] which shows only the LIST section. When you are editing the masterview file you may comment/uncomment one of the other css files to show a different section. The --style param allows you to suppress default style generation and specify an existing stylesheet to use, if you exlude the stylesheet none will be used, if you include this option multiple times with different stylesheets each will be used.
 
-Another interesting thing to know is that while all of the pages for this Model have been bundled up into one html file for ease of editing, at runtime this template gets rendered into the exact same layouts and partials that you would use if you were building from scratch. Its jsut that now you can see what your pages will render like in your wysiwyg html editor and change and layout accordingly. Additionally MasterView supplies some javascript to show only one action view at time (list, new, show, edit, delete) so you can view in your browser without running in Rails. Dummy html can be included to improve the accuracy of the page which can be easily removed at runtime. To make it easier to work with in an editor, design time stylesheets are included in the file to allow you to hide all sections except the one you are working on, simply uncomment the appropriate stylesheet for the section you would like to work with.
+Once it is done generating, the generated MasterView template file will be created in app/views/masterview/controller.html. This file is html and can be edited with any standard html editor. The rails specific logic is contained in simple attributes which are ignored by html editors. The syntax for these attributes is heavily derived from the rails helper tags themselves so it should feel natural to the rails developer.
+
+Another interesting thing to know is that while all of the pages for this Model have been bundled up into a few html file for ease of editing, at runtime these templates gets rendered into the exact same layouts and partials that you would use if you were building from scratch. Its jsut that now you can see what your pages will render like in your wysiwyg html editor and change and layout accordingly. Additionally MasterView supplies some javascript to show only one action view at time (list, new, show, edit, destroy) so you can view in your browser without running in Rails. Dummy html can be included to improve the accuracy of the page which can be easily removed at runtime. To make it easier to work with in an editor, design time stylesheets are included in the file to allow you to hide all sections except the one you are working on, simply uncomment the appropriate stylesheet for the section you would like to work with.
 
 MasterView is designed to be easy for a developer and designer to work together. By keeping the template in an html friendly format, designers can apply style, layout changes, wording changes, without causing havoc on the rails view code. The designer can be involved at anytime during the development cycle including being able to change style and layout after the system is built. This is great for allowing design or wording changes without reinvolving the developers. One can even start from a designer created prototype and add MasterView tags to make it become real. Whichever way you prefer to work, MasterView accomodates you.
 
+With Version 0.1.0 a MasterView admin controller/view was added to provide a birds-eye view of all your masterview templates, the status of those templates (OK, Invalid xhtml, Conflicts, Imports outdated), the details regarding the status, and the ultimate erb files generated from each template. By default the MasterView admin controller is enabled by the plugin and is available at http://yourserver/masterview This controller can easily be disabled if not wanted by setting the EnableMasterViewAdminPages = false in the vendor/plugins/masterview/init.rb file. Additionally all of the power of the MasterView admin controller is available via a set of rake commands as well. rake mv:list mv:list_all mv:rebuild mv:rebuild_all mv:copy_layout. rake -T will give you further information about these commands.
+
+Since it can be difficult to import a layout by hand into a new file, the MasterView admin controller has a link where you can copy the layout into a new file by providing the new files Action. It will take the layout from the template chosen and create a new file controller_action.html with the layout imported and a shell for the new Action code. You can also do this from command line using rake mv:copy_layout TEMPLATE=foo_list.html ACTION=newaction command.
+
 == MasterView attribute directive syntax
 
 These attribute directives are provided by MasterView and you can create your own custom attributes for even more power.
@@ -109,6 +115,11 @@ mv:generate="layouts/product.rhtml"
 	  <form></form>
 	</div>
 
+mv:import="layouts/product.rhtml"
+	When the import directive is used, it is a mirror image of the generate directive, except that this directive 
+	doesn't generate any output, it is only used for design time editing. The code inside this tag represents a point
+	in time capture of the real generated code and if it ever gets out of sync it can easily be sync'd back up by
+	visiting the MasterView admin page or using rake mv:rebuild_all
 
 mv:gen_render=":partial => 'product/form'"
 	This directive does two things it creates a partial and it outputs the appropriate code to render this 
@@ -146,6 +157,11 @@ mv:gen_render=":partial => 'product/form'"
 
 	which will create the partial shared/_product.rhtml and will render this partial over a collection
 
+mv:import_render="partial => 'product/form'"
+	Similar to how import directive is a mirror to generate, import_render is a mirror to gen_render. This directive
+	generates the appropriate render partial helper, but doesn't generate any additional output, it is only used for 
+	design time editing and can be easily sync'd up if it ever gets out of sync with the original code.
+
 mv:gen_replace="whatToLeave"
 	When used in conjunction with mv:generate directive it causes the value of the attribute to be erb 
 	executed output in the parent file before transferring to the child (nested) output file. for example...
@@ -589,5 +605,5 @@ in documentation, examples, test cases, additional directives, etc., so I would
 appreciate any feedback and ideas that you have. Thanks for taking the time to 
 review MasterView!
 
-Jeff Barczewski (jeff.barczewski @ gmail.com)
+Jeff Barczewski (jeff.barczewski  @   gmail.com)
 

data/RELEASE_NOTES

@@ -1,5 +1,18 @@
 = MasterView - Rails-optimized (x)html friendly template engine 
 
+== Recent changes
+
+MasterView now by default generates five masterview template files instead of one, though you can specify the --single-file option to only generate one file. Using one masterview template file gives the most DRY implementation but since all the views are in one file, it can become a point of contention and is a little more difficult for designers to work with. This Version 0.1.0 upgrade fixes that by generating one masterview template for each action (list, new, edit, show, destroy). The layout and message partials are defined in the list template and are imported into the other files so that you can have a complete page rendering when working with style and design of page. Similarly new defines the form partial which is imported into edit, and show defines a _show partial which is imported into destroy.
+
+One can edit the layout or other partials in the file they are defined in, so for instance to edit the layout, edit the list template and once finished, you can trigger the other templates to be rebuilt with the current information. MasterView now contains an MasterView admin controller/view to visually see all the status and details about the templates. You can rebuild any out of sync templates from this page. Alternatively you can view and rebuild templates from the command line as well using the built in rake commands (mv:list, mv:list_all, mv:rebuild TEMPLATE=foo.html, mv:rebuild_all).
+
+To make it easy to add additional actions which also import the layout, MasterView now has a way to generate a starter template file for your action by simply choosing from which other template file you want to import the layout from. For instance say you want to add an action called hello to your Product controller. Find the masterview template you want to get the layout imported from which could be (product_list.html, product_new.html, product_edit.html, ...), you can choose any of the templates that have the layout you want (it doesn't matter whether they defined the layout or simply imported it. To generate the starter template go to the MasterView Admin page http://yourserver/masterview and click copy link next to the appropriate template. On the next screen indicate the name of the action you wish to add (in this case 'hello') and click the submit button. MasterView generates a starter template file product_hello.html which imports the layout from the template file you chose and it creates some placeholder divs in the template that you can edit to add your hello view code. Alternatively there is also a rake mv:copy_layout TEMPLATE=product_list.html ACTION=hello command to allow you to do the same thing via command line.
+
+Note that you don't have to use the starter or generated files to use MasterView (you can just add MasterView attribute directives manually), but I found that once you had things started and wanted to reuse that same information, that having an automated way to get the layout imported makes it much easier and quicker to get things going. You can also change the default action div that is generated by simply creating your own file in app/views/masterview/admin/empty.rhtml which if found the copy_layout will use it, otherwise it uses the one from the gem/plugin.
+ 
+
+== Description
+
 MasterView is a ruby/rails optimized HTML/XHTML friendly template engine. 
 It is designed to use the full power and productivity of rails including 
 layouts, partials, and rails html helpers while still being editable/styleable 
@@ -22,7 +35,7 @@ License:: MIT open source license like Rails
 - Design it specifically for ruby and rails. Use the full power and not be limited in its capabilities over what can be done with ERb
 - Work nicely with layouts, partials, and rails html helpers.
 - Reduce complexity, work with existing rails code, no extra view logic or hashes than what is used by ERb. Scaffold generate initial templates or work from existing html prototype.
-- Use one master file to drive all related sections, simplifying editing.
+- Reduce the numbers of files, simplifying editing. Define partials and layouts naturallyl right in the template, no need to go to another file.
 - Preview in browser without running an app. Allow for dummy data in the template so that the page can be viewed and styled independently of the application.
 - Performance equal to ERb
 
@@ -61,8 +74,18 @@ This will copy entire MasterView system into your vendor/plugin/masterview direc
 
 You may add MasterView attributes to existing (x)html or you may use the masterview generator to create a complete working application. The generator can create controllers, models, and the MasterView template file similar to how the built-in generator works. Simply change directory to your rails application and run the following
 
-script/generate masterview YourModelName [YourControllerName] [--show-all | --show-only list] [--style [cssStylesheet]]
+script/generate masterview YourModelName [YourControllerName] [--style [cssStylesheet]] [--single-file] [--show-all | --show-only list] 
+
+The generator by default will generate five masterview template files, one for each distinct page, list, new, edit, show, and destroy. They exist in the app/views/masterview directory with the filename controller_action.html. The layout and message partial are defined in the list template file and imported into the others. Similarly the new template defines the form partial which is imported into edit, and finally the show file defines a _show partial which is imported into destroy. Thus there is one definition of each part (layout and partial) and they are imported into the other files where needed to provide accurate WYSIWYG design time editing. By generating separate files, teams can work on a project easier, however MasterView also supports generating all parts to a single file for the ultimate in DRY.
+
+By adding the --single-file switch MasterView will create a single file and to make it easier to use this template at design time, some design time css stylesheets are included in the file to hide all sections except one. By default the NEW section is the only one shown. Other options are --show-all which makes all sections visible or [--show-only list] which shows only the LIST section. When you are editing the masterview file you may comment/uncomment one of the other css files to show a different section. The --style param allows you to suppress default style generation and specify an existing stylesheet to use, if you exlude the stylesheet none will be used, if you include this option multiple times with different stylesheets each will be used.
+
+Once it is done generating, the generated MasterView template file will be created in app/views/masterview/controller.html. This file is html and can be edited with any standard html editor. The rails specific logic is contained in simple attributes which are ignored by html editors. The syntax for these attributes is heavily derived from the rails helper tags themselves so it should feel natural to the rails developer.
+
+Another interesting thing to know is that while all of the pages for this Model have been bundled up into a few html file for ease of editing, at runtime these templates gets rendered into the exact same layouts and partials that you would use if you were building from scratch. Its jsut that now you can see what your pages will render like in your wysiwyg html editor and change and layout accordingly. Additionally MasterView supplies some javascript to show only one action view at time (list, new, show, edit, destroy) so you can view in your browser without running in Rails. Dummy html can be included to improve the accuracy of the page which can be easily removed at runtime. To make it easier to work with in an editor, design time stylesheets are included in the file to allow you to hide all sections except the one you are working on, simply uncomment the appropriate stylesheet for the section you would like to work with.
 
-To make it easier to use this template at design time, some design time css stylesheets are included in the file to hide all sections except one. By default the NEW section is the only one shown. Other options are --show-all which makes all sections visible or [--show-only list] which shows only the LIST section. When you are editing the masterview file you may comment/uncomment one of the other css files to show a different section. The --style param allows you to suppress default style generation and specify an existing stylesheet to use, if you exlude the stylesheet none will be used, if you include this option multiple times with different stylesheets each will be used.
+MasterView is designed to be easy for a developer and designer to work together. By keeping the template in an html friendly format, designers can apply style, layout changes, wording changes, without causing havoc on the rails view code. The designer can be involved at anytime during the development cycle including being able to change style and layout after the system is built. This is great for allowing design or wording changes without reinvolving the developers. One can even start from a designer created prototype and add MasterView tags to make it become real. Whichever way you prefer to work, MasterView accomodates you.
 
+With Version 0.1.0 a MasterView admin controller/view was added to provide a birds-eye view of all your masterview templates, the status of those templates (OK, Invalid xhtml, Conflicts, Imports outdated), the details regarding the status, and the ultimate erb files generated from each template. By default the MasterView admin controller is enabled by the plugin and is available at http://yourserver/masterview This controller can easily be disabled if not wanted by setting the EnableMasterViewAdminPages = false in the vendor/plugins/masterview/init.rb file. Additionally all of the power of the MasterView admin controller is available via a set of rake commands as well. rake mv:list mv:list_all mv:rebuild mv:rebuild_all mv:copy_layout. rake -T will give you further information about these commands.
 
+Since it can be difficult to import a layout by hand into a new file, the MasterView admin controller has a link where you can copy the layout into a new file by providing the new files Action. It will take the layout from the template chosen and create a new file controller_action.html with the layout imported and a shell for the new Action code. You can also do this from command line using rake mv:copy_layout TEMPLATE=foo_list.html ACTION=newaction command.

data/Rakefile

@@ -73,6 +73,7 @@ Rake::RDocTask.new { |rdoc|
   rdoc.title    = "MasterView Template Engine"
   rdoc.options << '--line-numbers' << '--inline-source'
   rdoc.rdoc_files.include('README')
+  rdoc.rdoc_files.include('RELEASE_NOTES')
   rdoc.rdoc_files.include('lib/**/*.rb')
 }
 

data/TODO

@@ -1,6 +1,8 @@
 - create namespace for mv and publish, update generated files
 - video
 - wiki for site
+- render from db
+- skip generation of ERB, provide way to get erb output
 - app for syntax
 - include additional stylesheets
 - ajax examples

data/init.rb

@@ -37,6 +37,7 @@ module ::MasterView
   #DefaultDirectiveLoadPaths.push File.join( File.dirname(__FILE__), 'directives') #uncomment if you want to add a local directives dir
   #DefaultParserOptions = { :tidy => false, :escape_erb => true }
   #TidyPath = '/usr/lib/libtidy.so'
+  #EnableMasterViewAdminPages = true
 end
 
 require 'masterview/extras/rails_init.rb'

data/lib/masterview/analyzer.rb

@@ -0,0 +1,252 @@
+module MasterView
+  module Analyzer
+
+    ExpandAlwaysElements = %w{ script textarea }
+
+    module Common
+      def calc_hash(data)
+        #data.gsub( /\s+/, '' ).hash 
+        data.hash
+      end
+
+      def src_hash(data_orig)
+        data = data_orig.gsub MasterView::NamespacePrefix+'import_render', MasterView::NamespacePrefix+'gen_render'
+        data = data.gsub MasterView::NamespacePrefix+'import', MasterView::NamespacePrefix+'generate'
+        calc_hash(data)
+      end
+
+    end
+
+    class ContentEntry
+      include Common
+      attr_accessor :hash, :data
+      
+      def initialize(data)
+        @data = data
+        @hash = src_hash(data)
+      end
+
+    end
+    
+    class StackEntry
+      attr_accessor :name, :buffer, :depth, :import, :parts
+
+      def initialize(name, depth, import)
+        @name = name
+        @depth = depth
+        @import = import
+        @buffer = []
+        @parts = 0
+      end
+
+      def inc_parts
+        @parts += 1
+      end
+    end
+
+    class ListEntry
+      attr_accessor :name, :index, :import
+      attr_writer :hash_invalid
+      def initialize(name, index, import)
+        @name = name
+        @index = index
+        @import = import
+      end
+
+      def hash_invalid?
+        @hash_invalid
+      end
+    end
+
+    # builder class facilitates the hash_check and building process by monitoring if all parts of a
+    # file have been requested, if not when a higher index part is requested all the other previous
+    # parts will be sent along as well, this is necessary for cases where a file doesn't have as many 
+    # internal parts or none at all. This way the hash and all the parts of the file will still be there
+    # if layout has two parts and only last part -1 is requested, this builder will give back part 0 and part 1
+    # if layout would have had three parts then it would have given back all three.
+    # if a part does not exist then it will come back as empty string, same for an index out of bounds
+    class Builder
+      include Common
+      def initialize(content_hash)
+        @content_hash = content_hash
+        @builder_hash = {} #will contain next index to use
+      end
+
+      def hash(name, index)
+        src_hash(data(name, index))
+      end
+
+      def data(name, index)
+        content = ''
+        content_parts = @content_hash[name]
+        next_index_to_use = (nind = @builder_hash[name]) ? nind : 0
+        next_index_to_use = 0 if (-1 == index) && (next_index_to_use+1 > content_parts.length) # allow -1 to rerequest part as needed (singlefile)
+        return '' if content_parts.nil? || (next_index_to_use+1 > content_parts.length)
+        highest_index = content_parts.length - 1
+        requested_index = (index == -1) ? highest_index : index
+        content = content_parts[next_index_to_use..requested_index].collect do |ce| 
+          (ce.data.gsub( /\s/, '' ).empty?) ? '' : ce.data # if only white space then get rid of it
+        end.join
+        @builder_hash[name] = requested_index + 1 # store next index to use
+        content
+      end
+    end
+
+    class Listener
+      include REXML::SAX2Listener
+      include DirectiveHelpers
+      include Common
+      attr_accessor :list, :content
+
+      def initialize( options = {} )
+        @depth = 0
+        @stack = []
+        @list = []
+        @content = options[:content_hash] || {}
+        @options = options
+        @only_check_hash = options[:only_check_hash] || false
+        @builder = Builder.new(@content)
+        Log.debug { "only_check_hash => true" } if @only_check_hash
+      end
+
+      def only_check_hash?
+        @only_check_hash
+      end
+
+      def xmldecl(version, encoding, standalone)
+        #todo
+      end
+
+      def start_document
+        #todo
+      end
+
+      def doctype(name, pub, sys, long_name, uri)
+        #todo
+      end
+
+      def start_element(uri, localname, qname, attributes)
+        unescape_attributes!(attributes)
+        @depth += 1
+
+        import = false
+        if attributes[::MasterView::NamespacePrefix+'generate']
+          path = attributes[::MasterView::NamespacePrefix+'generate']
+        elsif attributes[::MasterView::NamespacePrefix+'gen_render']
+          partial = find_string_val_in_string_hash( attributes[::MasterView::NamespacePrefix+'gen_render'], :partial) 
+          path = render_partial_name_to_file_name(partial)
+        elsif attributes[::MasterView::NamespacePrefix+'import']
+          path = attributes[::MasterView::NamespacePrefix+'import']
+          import = true
+        elsif attributes[::MasterView::NamespacePrefix+'import_render']
+          partial = find_string_val_in_string_hash( attributes[::MasterView::NamespacePrefix+'import_render'], :partial) 
+          path = render_partial_name_to_file_name(partial)
+          import = true
+        end
+
+        if path
+          store_last_buffer false
+          @stack << StackEntry.new(path, @depth, import)
+        end
+
+        unless @stack.empty?
+          @stack.last.buffer << "<#{qname}" 
+          sorted_attributes = attributes.sort do |a,b| # sort import and import_render like generate and gen_render so hashs work
+            a_working = a[0]
+            b_working = b[0]
+            working_cmp = [a_working, b_working].collect do |working|
+              if working == ::MasterView::NamespacePrefix+'import_render'
+                working = ::MasterView::NamespacePrefix+'gen_render'
+              elsif working == ::MasterView::NamespacePrefix+'import'
+                working = ::MasterView::NamespacePrefix+'generate'
+              end
+              working
+            end
+            working_cmp[0] <=> working_cmp[1]
+          end
+          sorted_attributes.each do |name, value| 
+            @stack.last.buffer << " #{name}=\"#{value}\""
+          end
+          @stack.last.buffer << '>' #must output as separate string so simplify_empty_elements can find it
+        end
+      end
+
+      def characters(text)
+        @stack.last.buffer << text unless @stack.empty?
+      end
+
+      def comment(comment)
+        @stack.last.buffer << '<!--' << comment << '-->' unless @stack.empty?
+      end
+
+      def cdata(content)
+        (@stack.last.buffer << '<![CDATA[' << content << ']]>') unless @stack.empty?
+      end
+
+      def end_element(uri, localname, qname)
+        unless @stack.empty?
+          if @stack.last.buffer.last == '>' && !ExpandAlwaysElements.include?(qname) #simplify empty elements
+            @stack.last.buffer.pop
+            @stack.last.buffer << '/>'
+          else
+            @stack.last.buffer << '</' << "#{qname}>" #must output </ as separate string so simplify_empty_elements can find it
+          end
+        end
+        
+        if @depth == @stack.last.depth
+          store_last_buffer true
+          @stack.pop
+        end
+        @depth -= 1
+      end
+
+      def end_document
+        #todo
+      end
+
+      def unescape_attributes!(attributes)
+        attributes.each do |name, value|
+          value.replace CGI::unescapeHTML(value)
+          value.gsub!('&apos;', '\'')
+        end
+      end
+
+
+      def store_last_buffer(end_element)
+          unless @stack.empty?
+            @stack.last.inc_parts
+            index = end_element ? -1 : @stack.last.parts-1
+            data = @stack.last.buffer.join
+            hash_invalid = false;
+            if @stack.last.import
+              if only_check_hash?
+                hash = src_hash(data)
+                bdata = @builder.data(@stack.last.name, index)
+                hash_invalid = src_hash(bdata) != hash
+                if hash_invalid
+                  Log.debug { 'hash_invalid contents'}
+                  Log.debug { 'src='+bdata }
+                  Log.debug { 'imp='+data }
+                end
+                #hash_invalid = @builder.hash(@stack.last.name, index) != hash
+              end
+            elsif !only_check_hash?
+              @content[@stack.last.name] ||= []
+              @content[@stack.last.name] << ContentEntry.new(data)
+            end
+
+            @stack.last.buffer = []
+            @list << ListEntry.new(@stack.last.name, index, @stack.last.import)
+
+            if only_check_hash? #only set these flags if doing hash_check, not accurate for first round parse
+              @list.last.hash_invalid = hash_invalid
+            end
+          end
+      end
+
+    end
+
+  end #end Analyzer module
+
+
+end

data/lib/masterview/directive_helpers.rb

@@ -10,14 +10,24 @@ module MasterView
     #higher priority (lower value) will be executed first in chain
     module DirectivePriorities
       Highest = 0
+      VeryHigh =   0x3FFFFFFF/8
       High =   0x3FFFFFFF/4
       MediumHigh = 0x3FFFFFFF/3
       Medium = 0x3FFFFFFF/2
       MediumLow = (0x3FFFFFFF/3)*2
       Low =    (0x3FFFFFFF/4)*3
+      VeryLow = (0x3FFFFFFF/8)*7
       Lowest = 0x3FFFFFFF 
     end
 
+    # convert render_partial_name to file_name, ex foo/bar to foo/_bar.rhtml
+    def render_partial_name_to_file_name(render_partial_name)
+      dir = File.dirname(render_partial_name)
+      base = File.basename(render_partial_name, PartialExtension) 
+      filename = '_'+base+PartialExtension
+      path = ( (dir != '.') ? File.join(dir,filename) : filename )
+    end
+
     
     # find the last string that fully matches exactly the 
     # parent tags content string array

data/lib/masterview/directives/import.rb

@@ -0,0 +1,22 @@
+module MasterView
+  module Directives
+
+    # just eat this output since it is only used for design time
+    class Import < MasterView::DirectiveBase
+      def priority
+        DirectivePriorities::VeryHigh
+      end
+
+      def stag(dcs)
+        #output nothing
+      end
+      
+      def etag(dcs)
+        tag = dcs.context[:tag]
+        tag.content = [] # clear out any content including from children
+        nil
+      end
+
+    end
+  end
+end

data/lib/masterview/directives/import_render.rb

@@ -0,0 +1,23 @@
+module MasterView
+  module Directives
+
+    # just eat this output since it is only used for design time
+    class Import_render < MasterView::DirectiveBase
+      def priority
+        DirectivePriorities::VeryHigh
+      end
+
+      def stag(dcs)
+        #output nothing
+      end
+      
+      def etag(dcs)
+        tag = dcs.context[:tag]
+        tag.content = [] # clear out any content including from children
+        ret = []
+        ret << erb_content('render( '+attr_value+' )')
+      end
+
+    end
+  end
+end

data/lib/masterview/extras/app/controllers/masterview_controller.rb

@@ -0,0 +1,78 @@
+class MasterviewController < ApplicationController
+  
+  def index
+    redirect_to :action => :list
+  end
+
+  def list
+    template_specs, content_hash = MasterView::TemplateSpec.scan
+    @template_specs_sorted = template_specs.sort
+    smart_render 'masterview/admin/list'
+  end
+
+  def rebuild_all
+    files_rebuilt = []
+    MasterView::TemplateSpec.scan do |template_spec, content_hash|
+      if template_spec.status == MasterView::TemplateSpec::Status::ImportsOutdated &&
+         template_spec.rebuild_template(content_hash, :write_to_file => true)
+            files_rebuilt << template_spec.path
+      end
+    end
+    unless files_rebuilt.empty?
+      flash[:notice] = files_rebuilt.join(', ')+' were updated'
+    end
+    redirect_to :action => :list
+  end
+
+  def rebuild
+    path = params[:id]
+    template_specs, content_hash = MasterView::TemplateSpec.scan
+    template_spec = template_specs[path]
+    raise 'Template '+path+' not found' unless template_spec
+    if template_spec.rebuild_template(content_hash, :write_to_file => true)
+      flash[:notice] = 'File '+path+' updated'
+    else
+      flash[:notice] = 'Identical content - no update needed for '+path
+    end
+    redirect_to :action => :list
+  end
+
+  def create
+    if @request.post?
+      action_to_create = params[:action_name]
+      short_name = File.basename(params[:id])
+      src_file = File.join('app/views', MasterView::TemplateSrcRelativePath, short_name)
+
+      empty_file_path = find_path('app/views/masterview/admin/empty.rhtml')
+      empty_insert_erb = File.readlines(empty_file_path).join
+
+      dst_file = MasterView::TemplateSpec.create_empty_shell_for_action(src_file, action_to_create, empty_insert_erb, :write_to_file => true)
+      flash[:notice] = dst_file+' was created'
+      redirect_to :action => :list
+    else
+      smart_render 'masterview/admin/create'
+    end
+  end
+
+  private 
+
+  # checks app path first for views and files, then falls back to files in MV
+  def find_path(path)
+    local_path = File.join(RAILS_ROOT, path)
+    mv_path = File.join(File.dirname(__FILE__), '../..', path)
+    working_path = (File.exist?(local_path)) ? local_path : mv_path
+  end
+
+  # render local template file if exists otherwise render file from mv
+  def smart_render(short_path)
+    local_path = File.join(RAILS_ROOT, 'app/views', short_path)+'.rhtml'
+    if File.exist?(local_path)
+      render :template => short_path
+    else
+       mv_path = File.join(File.dirname(__FILE__), '../../app/views', short_path)+'.rhtml'
+       MasterView::Log.debug { 'mv_path='+mv_path }
+       render :file => mv_path
+    end
+  end
+
+end