polygon 0.0.1

data/CHANGELOG.md

@@ -0,0 +1,5 @@
+# 0.0.1 / FIX ME
+
+* Enhancements
+
+  * Birthday!

data/Gemfile

@@ -0,0 +1,16 @@
+source 'http://rubygems.org'
+
+group :runtime do
+  gem "sinatra", "~> 1.3"
+  gem "epath", "~> 0.2.0"
+  gem "json", ">= 0"
+  gem "wlang", "~> 0.10.2"
+end
+
+group :development do
+  gem "rake", "~> 0.9.2"
+  gem "bundler", "~> 1.0"
+  gem "rspec", "~> 2.10"
+  gem "yard", "~> 0.7.2"
+  gem "bluecloth", "~> 2.2"
+end

data/Gemfile.lock

@@ -0,0 +1,40 @@
+GEM
+  remote: http://rubygems.org/
+  specs:
+    bluecloth (2.2.0)
+    diff-lcs (1.1.3)
+    epath (0.2.0)
+    json (1.7.3)
+    rack (1.4.1)
+    rack-protection (1.2.0)
+      rack
+    rake (0.9.2.2)
+    rspec (2.10.0)
+      rspec-core (~> 2.10.0)
+      rspec-expectations (~> 2.10.0)
+      rspec-mocks (~> 2.10.0)
+    rspec-core (2.10.1)
+    rspec-expectations (2.10.0)
+      diff-lcs (~> 1.1.3)
+    rspec-mocks (2.10.1)
+    sinatra (1.3.2)
+      rack (~> 1.3, >= 1.3.6)
+      rack-protection (~> 1.2)
+      tilt (~> 1.3, >= 1.3.3)
+    tilt (1.3.3)
+    wlang (0.10.2)
+    yard (0.7.5)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  bluecloth (~> 2.2)
+  bundler (~> 1.0)
+  epath (~> 0.2.0)
+  json
+  rake (~> 0.9.2)
+  rspec (~> 2.10)
+  sinatra (~> 1.3)
+  wlang (~> 0.10.2)
+  yard (~> 0.7.2)

data/LICENCE.md

@@ -0,0 +1,22 @@
+# The MIT Licence
+
+    Copyright (c) 2012 - Bernard Lambeau
+
+    Permission is hereby granted, free of charge, to any person obtaining
+    a copy of this software and associated documentation files (the
+    "Software"), to deal in the Software without restriction, including
+    without limitation the rights to use, copy, modify, merge, publish,
+    distribute, sublicense, and/or sell copies of the Software, and to
+    permit persons to whom the Software is furnished to do so, subject to
+    the following conditions:
+
+    The above copyright notice and this permission notice shall be
+    included in all copies or substantial portions of the Software.
+
+    THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+    EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+    MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+    NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+    LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+    OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+    WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/Manifest.txt

@@ -0,0 +1,14 @@
+polygon.gemspec
+polygon.noespec
+CHANGELOG.md
+Gemfile
+Gemfile.lock
+bin/**/*
+lib/**/*
+LICENCE.md
+Manifest.txt
+Rakefile
+README.md
+spec/**/*
+tasks/**/*
+test/**/*

data/README.md

@@ -0,0 +1,7 @@
+# Polygon
+
+A web framework powered by sinatra for mostly static websites
+
+## Links
+
+http://github.com/blambeau/polygon

data/Rakefile

@@ -0,0 +1,11 @@
+# We run tests by default
+task :default => :test
+
+#
+# Install all tasks found in tasks folder
+#
+# See .rake files there for complete documentation.
+#
+Dir["tasks/*.rake"].each do |taskfile|
+  load taskfile
+end

data/lib/polygon.rb

@@ -0,0 +1,23 @@
+require "polygon/version"
+require "polygon/loader"
+#
+# A web framework powered by sinatra for mostly static websites
+#
+module Polygon
+
+  def default_loader
+    @default_loader ||= ContentLoader.new.enable_all!
+  end
+  module_function :default_loader
+
+  def default_loader=(loader)
+    @default_loader = loader
+  end
+  module_function :default_loader=
+
+end # module Polygon
+require 'polygon/content_loader'
+require 'polygon/content'
+require 'polygon/helpers'
+require 'polygon/base'
+

data/lib/polygon/base.rb

@@ -0,0 +1,22 @@
+module Polygon
+  class Base < Sinatra::Base
+
+    configure do
+      set :static,        Proc.new { root && root/:content/:static   }
+      set :public_folder, Proc.new { root && root/:content/:static   }
+      set :dynamic,       Proc.new { root && root/:content/:dynamic  }
+      set :templates,     Proc.new { root && root/:design/:templates }
+      set :views,         Proc.new { root && root/:design/:templates }
+      enable  :logging
+      enable  :raise_errors
+      disable :show_exceptions
+    end
+
+    get '/sitemap.xml' do
+      content_type "application/xml"
+      wlang :sitemap
+    end
+
+    helpers Polygon::Helpers
+  end # Base
+end # module Polygon

data/lib/polygon/content.rb

@@ -0,0 +1,131 @@
+require 'yaml'
+require 'epath'
+module Polygon
+  class Content
+    
+    # Root of the content folders
+    attr_reader :path
+
+    # Underlying content loader
+    attr_reader :loader
+
+    # Creates a Content instance
+    def initialize(path, loader = Polygon.default_loader)
+      @path = path
+      @loader = loader
+    end
+
+    def entry(path)
+      if path.relative?
+        path = @path/path
+      elsif path.outside?(@path)
+        return nil
+      end
+      Entry.new(self, path)
+    end
+
+    class Entry
+
+      # The parent content
+      attr_reader :content
+
+      # Path to the file containing this content
+      attr_reader :path
+
+      def initialize(content, path)
+        @content, @path = content, path
+      end
+
+      def exist?
+        path.exist?
+      end
+
+      def /(arg)
+        content.entry(path/arg)
+      end
+
+      def ==(other)
+        other.is_a?(Entry) and 
+        other.content == content and 
+        other.path == path
+      end
+
+      def to_s
+        path.to_s
+      end
+
+      def to_hash(with_ancestors = true)
+        if with_ancestors
+          ancestors_or_self(true).inject({}) do |h,content|
+            merge(h, content.data)
+          end
+        else
+          data
+        end
+      end
+
+      protected
+
+      def loader
+        content.loader
+      end
+
+      def extensions
+        loader.extensions
+      end
+
+      def index_files
+        extensions.map{|ext| "index#{ext}"}
+      end
+
+      def parent
+        @parent ||= begin
+          return nil unless base = self/".."
+          idx = -1
+          if index?
+            idx = index_files.index(path.basename.to_s) - 1
+            base = base/".." if idx == -1
+          end
+          base ? base/index_files[idx] : nil
+        end
+      end
+
+      def ancestors_or_self(filter = false)
+        res = _ancestors_or_self
+        filter ? res.select{|f| f.path.exist?} : res
+      end
+
+      def _ancestors_or_self
+        return [ self ] unless parent
+        parent.ancestors_or_self + [ self ]
+      end
+
+      def index?
+        index_files.include?(path.basename.to_s)
+      end
+
+      def merge(left, right)
+        raise "Unexpected #{left.class} vs. #{right.class}" \
+          unless left.class == right.class
+        case left
+        when Array
+          (right | left).uniq
+        when Hash
+          left.merge(right){|k,l,r|
+            merge(l,r)
+          }
+        else
+          right
+        end
+      end
+
+      def data
+        loader.load(path).merge({
+          "__path__" => path, 
+          "__url__"  => path.relative_to(content.path).to_s[0..-(path.extname.length+1)]
+        })
+      end
+
+    end # class Entry
+  end # class Content
+end # module Polygon

data/lib/polygon/content_loader.rb

@@ -0,0 +1,78 @@
+module Polygon
+  class ContentLoader
+
+    def register(*extensions, &loader)
+      raise ArgumentError, "Extensions expected" if extensions.empty?
+      loaders << [extensions, loader]
+      self
+    end
+
+    def extensions
+      loaders.map(&:first).flatten
+    end
+
+    def load(file)
+      file = Path(file)
+      unless l = loader(file)
+        raise "Unable to load #{file.basename} (unrecognized extension)" 
+      end
+      l.call(file)
+    end
+
+    ################################################################### Loaders
+
+    def enable_yaml!(*ext)
+      require 'yaml'
+      ext = [".yml", ".yaml"] if ext.empty?
+      register(*ext) do |f| 
+        YAML.load(f.read) 
+      end
+    end
+
+    def enable_json!(*ext)
+      require 'json'
+      ext = [".json"] if ext.empty?
+      register(*ext) do |f| 
+        JSON.load(f.read) 
+      end
+    end
+
+    def enable_ruby!(*ext)
+      ext = [".rb", ".ruby"] if ext.empty?
+      register(*ext) do |f| 
+        ::Kernel.eval(f.read, TOPLEVEL_BINDING, f.to_s) 
+      end
+    end
+
+    def enable_yaml_front_matter!(*ext)
+      ext = [".md"] if ext.empty?
+      register(*ext) do |f| 
+        content = f.read
+        if content =~ /^(---\s*\n.*?\n?)^(---\s*$\n?)/m
+          YAML::load($1).merge("content" => $')
+        else
+          {"content" => content}
+        end
+      end
+    end
+
+    def enable_all!
+      enable_yaml!
+      enable_json!
+      enable_ruby!
+      enable_yaml_front_matter!
+    end
+
+    private
+
+    def loaders
+      @loaders ||= []
+    end
+
+    def loader(file, extname = Path(file).extname)
+      loader = loaders.find{|ext,_| ext.include?(extname)}
+      loader && loader.last
+    end
+
+  end # class ContentLoader
+end # module Polygon

data/lib/polygon/helpers.rb

@@ -0,0 +1,20 @@
+module Polygon
+  module Helpers
+
+    def static;    settings.static;    end
+    def dynamic;   settings.dynamic;   end
+    def templates; settings.templates; end
+
+    def default_wlang_context
+      { "environment" => settings.environment }
+    end
+
+    def wlang(tpl, ctx = {})
+      tpl = templates/"#{tpl}.whtml" if tpl.is_a?(Symbol)
+      ctx = (ctx && ctx.to_hash) || {}
+      ctx = default_wlang_context.to_hash.merge(ctx)
+      WLang::file_instantiate tpl, ctx
+    end
+
+  end # module Helpers
+end # module Polygon

data/lib/polygon/loader.rb

@@ -0,0 +1,4 @@
+require "sinatra"
+require "epath"
+require "json"
+require "wlang"

data/lib/polygon/version.rb

@@ -0,0 +1,14 @@
+module Polygon
+  module Version
+
+    MAJOR = 0
+    MINOR = 0
+    TINY  = 1
+
+    def self.to_s
+      [ MAJOR, MINOR, TINY ].join('.')
+    end
+
+  end
+  VERSION = Version.to_s
+end

data/polygon.gemspec

@@ -0,0 +1,192 @@
+# We require your library, mainly to have access to the VERSION number.
+# Feel free to set $version manually.
+$LOAD_PATH.unshift File.expand_path('../lib', __FILE__)
+require "polygon/version"
+$version = Polygon::Version.to_s
+
+#
+# This is your Gem specification. Default values are provided so that your library
+# should be correctly packaged given what you have described in the .noespec file.
+#
+Gem::Specification.new do |s|
+
+  ################################################################### ABOUT YOUR GEM
+
+  # Gem name (required)
+  s.name = "polygon"
+
+  # Gem version (required)
+  s.version = $version
+
+  # A short summary of this gem
+  #
+  # This is displayed in `gem list -d`.
+  s.summary = "A web framework powered by sinatra for mostly static websites"
+
+  # A long description of this gem (required)
+  #
+  # The description should be more detailed than the summary.  For example,
+  # you might wish to copy the entire README into the description.
+  s.description = "Polygon provides a framework with strong separation of concerns between \nclients, developers and web designers"
+
+  # The URL of this gem home page (optional)
+  s.homepage = "http://github.com/blambeau/polygon"
+
+  # Gem publication date (required but auto)
+  #
+  # Today is automatically used by default, uncomment only if
+  # you know what you do!
+  #
+  # s.date = Time.now.strftime('%Y-%m-%d')
+
+  # The license(s) for the library.  Each license must be a short name, no
+  # more than 64 characters.
+  #
+  # s.licences = %w{}
+
+  # The rubyforge project this gem lives under (optional)
+  #
+  # s.rubyforge_project = nil
+
+  ################################################################### ABOUT THE AUTHORS
+
+  # The list of author names who wrote this gem.
+  #
+  # If you are providing multiple authors and multiple emails they should be
+  # in the same order.
+  #
+  s.authors = ["Bernard Lambeau"]
+
+  # Contact emails for this gem
+  #
+  # If you are providing multiple authors and multiple emails they should be
+  # in the same order.
+  #
+  # NOTE: Somewhat strangly this attribute is always singular!
+  #       Don't replace by s.emails = ...
+  s.email  = ["blambeau@gmail.com"]
+
+  ################################################################### PATHS, FILES, BINARIES
+
+  # Paths in the gem to add to $LOAD_PATH when this gem is
+  # activated (required).
+  #
+  # The default 'lib' is typically sufficient.
+  s.require_paths = ["lib"]
+
+  # Files included in this gem.
+  #
+  # By default, we take all files included in the Manifest.txt file on root
+  # of the project. Entries of the manifest are interpreted as Dir[...]
+  # patterns so that lazy people may use wilcards like lib/**/*
+  #
+  here = File.expand_path(File.dirname(__FILE__))
+  s.files = File.readlines(File.join(here, 'Manifest.txt')).
+                 inject([]){|files, pattern| files + Dir[File.join(here, pattern.strip)]}.
+                 collect{|x| x[(1+here.size)..-1]}
+
+  # Test files included in this gem.
+  #
+  s.test_files = Dir["test/**/*"] + Dir["spec/**/*"]
+
+  # The path in the gem for executable scripts (optional)
+  #
+  s.bindir = "bin"
+
+  # Executables included in the gem.
+  #
+  s.executables = (Dir["bin/*"]).collect{|f| File.basename(f)}
+
+  ################################################################### REQUIREMENTS & INSTALL
+  # Remember the gem version requirements operators and schemes:
+  #   =  Equals version
+  #   != Not equal to version
+  #   >  Greater than version
+  #   <  Less than version
+  #   >= Greater than or equal to
+  #   <= Less than or equal to
+  #   ~> Approximately greater than
+  #
+  # Don't forget to have a look at http://lmgtfy.com/?q=Ruby+Versioning+Policies
+  # for setting your gem version.
+  #
+  # For your requirements to other gems, remember that
+  #   ">= 2.2.0"              (optimistic:  specify minimal version)
+  #   ">= 2.2.0", "< 3.0"     (pessimistic: not greater than the next major)
+  #   "~> 2.2"                (shortcut for ">= 2.2.0", "< 3.0")
+  #   "~> 2.2.0"              (shortcut for ">= 2.2.0", "< 2.3.0")
+  #
+
+  #
+  # One call to add_dependency('gem_name', 'gem version requirement') for each
+  # runtime dependency. These gems will be installed with your gem.
+  # One call to add_development_dependency('gem_name', 'gem version requirement')
+  # for each development dependency. These gems are required for developers
+  #
+  s.add_development_dependency("rake", "~> 0.9.2")
+  s.add_development_dependency("bundler", "~> 1.0")
+  s.add_development_dependency("rspec", "~> 2.10")
+  s.add_development_dependency("yard", "~> 0.7.2")
+  s.add_development_dependency("bluecloth", "~> 2.2")
+  s.add_dependency("sinatra", "~> 1.3")
+  s.add_dependency("epath", "~> 0.2.0")
+  s.add_dependency("json", ">= 0")
+  s.add_dependency("wlang", "~> 0.10.2")
+
+  # The version of ruby required by this gem
+  #
+  # Uncomment and set this if your gem requires specific ruby versions.
+  #
+  # s.required_ruby_version = ">= 0"
+
+  # The RubyGems version required by this gem
+  #
+  # s.required_rubygems_version = ">= 0"
+
+  # The platform this gem runs on.  See Gem::Platform for details.
+  #
+  # s.platform = nil
+
+  # Extensions to build when installing the gem.
+  #
+  # Valid types of extensions are extconf.rb files, configure scripts
+  # and rakefiles or mkrf_conf files.
+  #
+  s.extensions = []
+
+  # External (to RubyGems) requirements that must be met for this gem to work.
+  # It’s simply information for the user.
+  #
+  s.requirements = nil
+
+  # A message that gets displayed after the gem is installed
+  #
+  # Uncomment and set this if you want to say something to the user
+  # after gem installation
+  #
+  s.post_install_message = nil
+
+  ################################################################### SECURITY
+
+  # The key used to sign this gem.  See Gem::Security for details.
+  #
+  # s.signing_key = nil
+
+  # The certificate chain used to sign this gem.  See Gem::Security for
+  # details.
+  #
+  # s.cert_chain = []
+
+  ################################################################### RDOC
+
+  # An ARGV style array of options to RDoc
+  #
+  # See 'rdoc --help' about this
+  #
+  s.rdoc_options = []
+
+  # Extra files to add to RDoc such as README
+  #
+  s.extra_rdoc_files = Dir["README.md"] + Dir["CHANGELOG.md"] + Dir["LICENCE.md"]
+
+end