metro 0.1.4 → 0.1.5

data/lib/metro/transitions/scene_transitions.rb

@@ -6,6 +6,7 @@ module Metro
 
     def insert_transition(scene,options)
       return scene unless options.key?(:with)
+      name = options[:with]
       generate_transition(name,scene,options)
     end
 
@@ -19,11 +20,16 @@ module Metro
     end
 
     def find_transition(name)
-      supported_transitions[name]
+      transition_name = supported_transitions[name]
+      transition_name.constantize
     end
 
     def supported_transitions
-      Hash.new(FadeTransitionScene)
+      @supported_transitions ||= begin
+        hash = Hash.new("Metro::FadeTransitionScene")
+        hash[:edit] = "Metro::EditTransitionScene"
+        hash
+      end
     end
 
   end

data/lib/metro/transitions/transition_scene.rb

@@ -15,4 +15,5 @@ module Metro
   end
 end
 
-require_relative 'fade_transition_scene'
+require_relative 'fade_transition_scene'
+require_relative 'edit_transition_scene'

data/lib/metro/version.rb

@@ -1,5 +1,5 @@
 module Metro
-  VERSION = "0.1.4"
+  VERSION = "0.1.5"
   WEBSITE = "https://github.com/burtlo/metro"
   CONTACT_EMAILS = ["franklin.webber@gmail.com"]
   

data/lib/metro/views/json_view.rb

@@ -0,0 +1,60 @@
+require 'json'
+
+module Metro
+  module Views
+
+    #
+    # Provides support for a JSON Representation of a view.
+    #
+    class JSONView
+
+      #
+      # Determine if a view exists for this specified format
+      #
+      # @param [String] view_path the name of the view to find
+      # @return a true if the json view exists and false if it does not exist.
+      #
+      def self.exists?(view_path)
+        File.exists? json_view_path(view_path)
+      end
+
+      #
+      # Parse the contents of the view given the name.
+      #
+      # @param [String] view_path the name of the view to read
+      # @return a Hash that contains the contents of the view.
+      #
+      def self.parse(view_path)
+        JSON.parse File.read json_view_path(view_path)
+      end
+
+      #
+      # @return the file type format of this view.
+      # 
+      def self.format
+        :json
+      end
+
+      #
+      # Writes the content out to the spcified view path
+      #
+      def self.write(view_path,content)
+        filename = json_view_path(view_path)
+        json_content = JSON.pretty_generate(content)
+        File.write(filename,json_content)
+      end
+
+      private
+
+      #
+      # A helper method to generate the name of the json view file. In this case
+      # it is the view name with the suffix .json.
+      #
+      def self.json_view_path(view_path)
+        File.extname(view_path) == "" ? "#{view_path}.json" : view_path
+      end
+
+    end
+
+  end
+end

data/lib/metro/{scene_view → views}/no_view.rb

@@ -1,15 +1,15 @@
 module Metro
-  module SceneView
+  module Views
 
     class NoView
 
       #
       # A NoView is a last resort view which means this is will always will exist.
       #
-      # @param [String] view_name the name of the view to find
+      # @param [String] view_path the name of the view to find
       # @return a true if the json view exists and false if it does not exist.
       #
-      def self.exists?(view_name)
+      def self.exists?(view_path)
         true
       end
 
@@ -17,9 +17,17 @@ module Metro
       # A NoView will return an empty Hash to provide compatibility with other view
       # types.
       #
-      def self.parse(view_name)
+      def self.parse(view_path)
         {}
       end
+
+      #
+      # @return the file type format of this view.
+      #
+      def self.format
+        :none
+      end
+
     end
 
   end

data/lib/metro/views/parsers.rb

@@ -0,0 +1,26 @@
+require_relative 'yaml_view'
+require_relative 'json_view'
+require_relative 'no_view'
+
+module Metro
+  module Views
+
+    module Parsers
+      extend self
+
+      def register(parser)
+        parsers.push parser
+      end
+
+      def parsers
+        @parsers ||= []
+      end
+    end
+
+    Parsers.register YAMLView
+    Parsers.register JSONView
+    Parsers.register NoView
+
+  end
+end
+

data/lib/metro/views/scene_view.rb

@@ -0,0 +1,107 @@
+require_relative 'view'
+
+module Metro
+
+  #
+  # SceneView provides support for a Scene to have a view as well as giving
+  # additional tools to also help draw that view.
+  #
+  module SceneView
+
+    #
+    # A Scene by default uses the name of the Scene to find it's associated
+    # view.
+    #
+    # @example Standard View Name
+    #
+    #     class OpeningScene < Metro::Scene
+    #
+    #       def show
+    #         puts "View Brought To You By: #{view_name} # => View Brought To You By opening
+    #       end
+    #     end
+    #
+    # @example Custom View Name
+    #
+    #     class ClosingScene < Metro::Scene
+    #       view_name 'alternative'
+    #
+    #       def show
+    #         puts "View Brought To You By: #{view_name} # => View Brought To You By alternative
+    #       end
+    #     end
+    #
+    def view_name
+      self.class.view_name
+    end
+
+    #
+    # @return the view for this scene.
+    #
+    def view
+      self.class.view
+    end
+
+    #
+    # Loads and caches the view content based on the avilable view parsers and
+    # the view files defined.
+    #
+    # @return the content contained within the view
+    #
+    def view_content
+      view.content
+    end
+
+    #
+    # Saves the current content of the view back through the view's writer
+    #
+    def save_view
+      view.content = self.to_hash
+      view.save
+    end
+
+    #
+    # When the module is included insure that all the class helper methods are added
+    # at the same time.
+    #
+    def self.included(base)
+      base.extend ClassMethods
+    end
+
+    module ClassMethods
+
+      #
+      # A Scene by default uses the name of the Scene to find it's associated
+      # view.
+      #
+      # @example Custom View Name
+      #
+      #     class ClosingScene < Metro::Scene
+      #       view_name 'alternative'
+      #     end
+      #
+      #     ClosingScene.view_name # => views/alternative
+      #
+      def view_name(name = nil)
+        name ? view.name = name : view.name
+        view.name
+      end
+
+      #
+      # Loads and caches the view content based on the avilable view parsers and
+      # the view files defined.
+      #
+      # @return a view object
+      #
+      def view
+        @view ||=begin
+          view = View.new
+          view.name = scene_name
+          view
+        end
+      end
+
+    end
+
+  end
+end

data/lib/metro/views/view.rb

@@ -0,0 +1,125 @@
+require_relative 'parsers'
+require_relative 'writers'
+
+module Metro
+
+  #
+  # A view represents the representation of the content found within
+  # the view file. A view has the ability to save/load the content
+  # as well.
+  #
+  class View
+
+    #
+    # The name of the view, which is used to influence the file path.
+    #
+    attr_accessor :name
+
+    #
+    # The content contained within the view.
+    #
+    def content
+      @content ||= begin
+        parsed_content = parse
+        parsed_content.default = {}
+        parsed_content
+      end
+    end
+
+    attr_writer :content
+
+    #
+    # A Scene view path is based on the view name.
+    #
+    # @example Standard View Path
+    #
+    #     class OpeningScene < Metro::Scene
+    #     end
+    #
+    #     OpeniningScene.view_path # => views/opening
+    #
+    # @example Custom View Path
+    #
+    #     class ClosingScene < Metro::Scene
+    #       view_name 'alternative'
+    #     end
+    #
+    #     ClosingScene.view_path # => views/alternative
+    #
+    def view_path
+      File.join "views", name
+    end
+
+    #
+    # Parse the content found at the view path for the view.
+    #
+    # @return the hash of content stored within the view file.
+    #
+    def parse
+      parser.parse(view_path)
+    end
+
+    #
+    # The parser for this view is one of the supported parsers. A parser
+    # is selected if the parser is capable of finding the content to
+    # load.
+    #
+    def parser
+      @parser ||= supported_parsers.find { |parser| parser.exists? view_path }
+    end
+
+    #
+    # Supported view formats
+    #
+    def supported_parsers
+      Views::Parsers.parsers
+    end
+
+    #
+    # Ask the parser to save the current content of the view at the view path
+    #
+    def save
+      writer.write(view_path,content)
+    end
+
+    #
+    # Return the format of the view. By default the format of the view is dictated
+    # by the format of the content that is parsed.
+    #
+    def format
+      @format || parser.format
+    end
+
+    #
+    # Setting the format allows the view to be changed from the current format as
+    # dictated what is parsed by the parser.
+    #
+    # This is mostly to benefit the edit transition scene which inherits all the view
+    # related data from the scene that is being edited but does not inherit the
+    # the view (which would have the parser).
+    #
+    # @see EditTransitionScene
+    #
+    attr_writer :format
+
+    #
+    # The writer for this view. If the view has already been parsed then use
+    #
+    def writer
+      @writer ||= begin
+        writer_matching_existing_parser = supported_writers.find { |writer| writer.format == format }
+        writer_matching_existing_parser || default_writer
+      end
+    end
+
+    def supported_writers
+      Views::Writers.writers
+    end
+
+    def default_writer
+      Views::Writers.default_writer
+    end
+
+  end
+
+end

data/lib/metro/views/writers.rb

@@ -0,0 +1,28 @@
+require_relative 'yaml_view'
+require_relative 'json_view'
+
+module Metro
+  module Views
+
+    module Writers
+      extend self
+
+      def register(writer)
+        writers.push writer
+      end
+
+      def writers
+        @writers ||= []
+      end
+
+      attr_accessor :default_writer
+
+    end
+
+    Writers.register YAMLView
+    Writers.register JSONView
+    Writers.default_writer = YAMLView
+
+  end
+end
+

data/lib/metro/views/yaml_view.rb

@@ -0,0 +1,94 @@
+require 'yaml'
+
+module Metro
+  module Views
+
+    class YAMLView
+
+      #
+      # Determine if a view exists for this specified format
+      #
+      # @param [String] view_path the name of the view to find
+      # @return a true if the yaml view exists and false if it does not exist.
+      #
+      def self.exists?(view_path)
+        yaml_view_paths(view_path).find { |view_path| File.exists? view_path }
+      end
+
+      #
+      # Parse the contents of the view given the name.
+      #
+      # @param [String] view_path the name of the view to read
+      # @return a Hash that contains the contents of the view.
+      #
+      def self.parse(view_path)
+        YAML.load File.read yaml_view_path(view_path)
+      end
+
+      #
+      # @return the file type format of this view.
+      #
+      def self.format
+        :yaml
+      end
+
+      #
+      # @param [String] view_path the file path to the view which to save the content
+      # @param [Hash] content the content to save within the view
+      #
+      def self.write(view_path,content)
+        filename = write_filepath(view_path)
+        yaml_content = content.to_yaml
+        File.write(filename,yaml_content)
+      end
+
+      #
+      # @return the default extension to use when saving yaml files.
+      #
+      def self.default_extname
+        @default_extname || ".yaml"
+      end
+
+      #
+      # Set the default extname
+      #
+      # @example
+      #
+      #     Metro::Views::YAMLView.default_extname = ".yml"
+      #
+      def self.default_extname=(value)
+        @default_extname = value
+      end
+
+      private
+
+      #
+      # If a file already exists with .yaml or .yml use that extension. Otherwise, we
+      # will fall back to the default extension name.
+      #
+      def self.write_filepath(view_path)
+        if existing_file = exists?(view_path)
+          existing_file
+        else
+          "#{view_path}#{default_extname}"
+        end
+      end
+
+      #
+      # A helper method to get the view file.
+      #
+      def self.yaml_view_path(view_path)
+        yaml_view_paths(view_path).find { |view_path| File.exists? view_path }
+      end
+
+      #
+      # A helper method to generate the name of the yaml view file. In this case
+      # it is the view name with the suffix `.yaml` or `.yml`.
+      #
+      def self.yaml_view_paths(view_path)
+        File.extname(view_path) == "" ? [ "#{view_path}.yaml", "#{view_path}.yml" ] : [ view_path ]
+      end
+    end
+
+  end
+end