baron 1.0.3 → 1.0.4

data/VERSION

@@ -1 +1 @@
-1.0.3
+1.0.4

data/baron.gemspec

@@ -5,11 +5,11 @@
 
 Gem::Specification.new do |s|
   s.name = "baron"
-  s.version = "1.0.3"
+  s.version = "1.0.4"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
   s.authors = ["Nathan Buggia"]
-  s.date = "2013-03-13"
+  s.date = "2013-03-18"
   s.description = "What's in the box: (1) Publish to Heroku using Git (2) Author articles in markdown (3) Article categories (4) Multiple permalink formats supported (5) Redirects (6) Advanced SEO optimizations and Google Analytics/ Webmaster Tools support. Uses Rack, RSpec, Bootstrap, JQuery, Disqus, Thin"
   s.email = "nbuggia@gmail.com"
   s.extra_rdoc_files = [
@@ -25,34 +25,43 @@ Gem::Specification.new do |s|
     "spec/baron_article_spec.rb",
     "spec/baron_blog_engine_spec.rb",
     "spec/baron_spec.rb",
+    "spec/sample_data/.gitignore",
     "spec/sample_data/Gemfile",
+    "spec/sample_data/README.md",
     "spec/sample_data/Rakefile",
-    "spec/sample_data/articles/2012-11-09-sample-post.txt",
-    "spec/sample_data/articles/poems/1909-01-02-If.txt",
-    "spec/sample_data/articles/poems/1916-01-01-the-road-not-taken.txt",
+    "spec/sample_data/articles/favorites/1916-01-01-the-road-not-taken.txt",
+    "spec/sample_data/articles/north of boston/1914-01-01-the-pasture.txt",
+    "spec/sample_data/articles/north of boston/1914-01-02-mending-wall.txt",
+    "spec/sample_data/articles/north of boston/1914-01-03-the-death-of-the-hired-man.txt",
+    "spec/sample_data/articles/north of boston/1914-01-04-the-mountain.txt",
+    "spec/sample_data/articles/north of boston/1914-01-05-A-Hundred-callers.txt",
+    "spec/sample_data/articles/other authors/1909-01-02-If.txt",
     "spec/sample_data/config.ru",
-    "spec/sample_data/images/import-csv-file-1.png",
-    "spec/sample_data/images/import-csv-file-2.png",
-    "spec/sample_data/images/import-csv-file-3.png",
-    "spec/sample_data/images/instagram.png",
+    "spec/sample_data/images/robert-frost-small.png",
+    "spec/sample_data/images/robert-frost.png",
     "spec/sample_data/pages/about.rhtml",
     "spec/sample_data/resources/feed.rss",
     "spec/sample_data/resources/redirects.txt",
     "spec/sample_data/resources/robots.txt",
-    "spec/sample_data/themes/test/css/app.css",
-    "spec/sample_data/themes/test/css/bootstrap-responsive.css",
-    "spec/sample_data/themes/test/css/bootstrap-responsive.min.css",
-    "spec/sample_data/themes/test/css/bootstrap.css",
-    "spec/sample_data/themes/test/css/bootstrap.min.css",
-    "spec/sample_data/themes/test/img/glyphicons-halflings-white.png",
-    "spec/sample_data/themes/test/img/glyphicons-halflings.png",
-    "spec/sample_data/themes/test/img/instagram.png",
-    "spec/sample_data/themes/test/templates/archives.rhtml",
-    "spec/sample_data/themes/test/templates/article.rhtml",
-    "spec/sample_data/themes/test/templates/category.rhtml",
-    "spec/sample_data/themes/test/templates/error.rhtml",
-    "spec/sample_data/themes/test/templates/home.rhtml",
-    "spec/sample_data/themes/test/templates/layout.rhtml",
+    "spec/sample_data/themes/typography/css/app.css",
+    "spec/sample_data/themes/typography/css/bootstrap-responsive.css",
+    "spec/sample_data/themes/typography/css/bootstrap-responsive.min.css",
+    "spec/sample_data/themes/typography/css/bootstrap.css",
+    "spec/sample_data/themes/typography/css/bootstrap.min.css",
+    "spec/sample_data/themes/typography/img/github.png",
+    "spec/sample_data/themes/typography/img/glyphicons-halflings-white.png",
+    "spec/sample_data/themes/typography/img/glyphicons-halflings.png",
+    "spec/sample_data/themes/typography/img/instagram.png",
+    "spec/sample_data/themes/typography/js/bootstrap.js",
+    "spec/sample_data/themes/typography/js/bootstrap.min.js",
+    "spec/sample_data/themes/typography/js/image_alt.js",
+    "spec/sample_data/themes/typography/js/read_later.js",
+    "spec/sample_data/themes/typography/templates/archives.rhtml",
+    "spec/sample_data/themes/typography/templates/article.rhtml",
+    "spec/sample_data/themes/typography/templates/category.rhtml",
+    "spec/sample_data/themes/typography/templates/error.rhtml",
+    "spec/sample_data/themes/typography/templates/home.rhtml",
+    "spec/sample_data/themes/typography/templates/layout.rhtml",
     "spec/spec_helper.rb"
   ]
   s.homepage = "https://github.com/nbuggia/baron-blog-engine-gem"

data/lib/baron.rb

@@ -99,8 +99,8 @@ module Baron
       route = (path || '/').split('/').reject { |i| i.empty? }
       route << @config[:root] if route.empty?
       mime_type = (mime_type =~ /txt|rss|json/) ? mime_type.to_sym : :html
-      categories = get_all_categories()
-      params = {:page_name => route.first}
+      categories = get_all_categories
+      params = {:page_name => route.first, :rss_feed => get_feed_path}
       params[:page_title] = (route.first == @config[:root] ? '' : "#{route.first.capitalize} #{@config[:title_delimiter]} ") + "#{@config[:title]}"          
     
       begin
@@ -112,19 +112,20 @@ module Baron
             
         # Robots... /robots.txt
         elsif route.first == 'robots'
-          File.read(get_system_resource('robots.txt')) rescue raise(Errno::ENOENT, 'Page not found')
+          PageController.new(get_all_articles, categories, @config[:article_max], params, @config) . 
+            render_rss(get_system_resource('robots.txt'))
         
         # Home page... /
         elsif route.first == @config[:root]
-          all_articles = get_all_articles()
+          all_articles = get_all_articles
           params[:page_forward] = '/page/2/' if @config[:article_max] < all_articles.count
           PageController.new(all_articles, categories, @config[:article_max], params, @config) . 
             render_html(get_theme_template(route.first), get_theme_template('layout'))
             
         # Pagination... /page/2, /page/2/
         elsif route.first == 'page' && route.count == 2
-          page_num = route.last.to_i() rescue page_num = -1
-          all_articles = get_all_articles()
+          page_num = route.last.to_i rescue page_num = -1
+          all_articles = get_all_articles
           max_pages = (all_articles.count.to_f / @config[:article_max].to_f).ceil
           raise(Errno::ENOENT, 'Page not found') if page_num < 1 or page_num > max_pages
           
@@ -142,18 +143,18 @@ module Baron
         # System routes... /robots.txt, /archives
         elsif route.first == 'archives' or route.first == 'robots'
           max_articles = ('archives' == route.first) ? :all : @config[:article_max]
-          PageController.new(get_all_articles(), categories, max_articles, params, @config) . 
+          PageController.new(get_all_articles, categories, max_articles, params, @config) . 
             render_html(get_theme_template(route.first), get_theme_template('layout'))
         
         # Custom pages... /about, /contact-us
         elsif is_route_custom_page? route.first
-          PageController.new(get_all_articles(), categories, @config[:article_max], params, @config) . 
+          PageController.new(get_all_articles, categories, @config[:article_max], params, @config) . 
             render_html(get_page_template(route.first), get_theme_template('layout'))
       
         # Category home pages... /projects/, /photography/, /poems/, etc
         elsif is_route_category_home? route.last
-          filtered_articles = get_all_articles().select { |h| h[:category] == route.last }
-          params[:page_name] = route.last.gsub('-', ' ').titleize()
+          filtered_articles = get_all_articles.select { |h| h[:category] == route.last }
+          params[:page_name] = route.last.gsub('-', ' ').titleize
           PageController.new(filtered_articles, categories, :all, params, @config) .
             render_html(get_theme_template('category'), get_theme_template('layout'))
       
@@ -186,7 +187,7 @@ module Baron
     end
 
     def get_all_articles
-      get_all_category_folder_paths().map do |folder_name|
+      get_all_category_folder_paths.map do |folder_name|
         Dir["#{folder_name}/*"].map do |e|
           if e.end_with? @config[:ext]
             parts = e.split('/')
@@ -219,7 +220,7 @@ module Baron
     end
     
     def find_single_article article_slug
-      get_all_articles().each { |fileparts| return fileparts if fileparts[:filename] == article_slug }
+      get_all_articles.each { |fileparts| return fileparts if fileparts[:filename] == article_slug }
       raise Errno::ENOENT, 'Article not found'
     end    
     
@@ -228,7 +229,7 @@ module Baron
     end
     
     def is_route_category_home? path_node
-      get_all_categories().each { |h| return true if h[:node_name] == path_node }
+      get_all_categories.each { |h| return true if h[:node_name] == path_node }
       return false
     end
 
@@ -237,6 +238,7 @@ module Baron
     def get_page_template(name)   "#{@config[:sample_data_path]}pages/#{name}.rhtml"                                end
     def get_theme_template(name)  "#{@config[:sample_data_path]}themes/#{@config[:theme]}/templates/#{name}.rhtml"  end
     def get_system_resource(name) "#{@config[:sample_data_path]}resources/#{name}"                                  end
+    def get_feed_path()           "#{@config[:url]}/feed.rss"                                                       end 
   end
 
   class Article < Hash

data/spec/baron_article_spec.rb

@@ -8,7 +8,7 @@ require 'spec_helper'
 describe "Baron::ArticleModel" do
   before :all do
     @config = load_config()
-    @article_parts = {:filename_and_path => "#{SAMPLE_DATA_PATH}articles/poems/1916-01-01-the-road-not-taken.txt", 
+    @article_parts = {:filename_and_path => "#{SAMPLE_DATA_PATH}articles/favorites/1916-01-01-the-road-not-taken.txt", 
                       :date => '1916-01-01', 
                       :filename => 'the-road-not-taken', 
                       :category => 'poems'}

data/spec/baron_blog_engine_spec.rb

@@ -17,11 +17,11 @@ describe "Baron::BlogEngine" do
       @blog_engine.get_pages_path.should == SAMPLE_DATA_PATH + 'pages/'
       @blog_engine.get_articles_path.should == SAMPLE_DATA_PATH + 'articles'
       @blog_engine.get_page_template('about').should == SAMPLE_DATA_PATH + 'pages/about.rhtml'
-      @blog_engine.get_theme_template('article').should == SAMPLE_DATA_PATH + 'themes/test/templates/article.rhtml'
-      @blog_engine.get_theme_template('category').should == SAMPLE_DATA_PATH + 'themes/test/templates/category.rhtml'
-      @blog_engine.get_theme_template('error').should == SAMPLE_DATA_PATH + 'themes/test/templates/error.rhtml'
-      @blog_engine.get_theme_template('home').should == SAMPLE_DATA_PATH + 'themes/test/templates/home.rhtml'
-      @blog_engine.get_theme_template('layout').should == SAMPLE_DATA_PATH + 'themes/test/templates/layout.rhtml'
+      @blog_engine.get_theme_template('article').should == SAMPLE_DATA_PATH + 'themes/typography/templates/article.rhtml'
+      @blog_engine.get_theme_template('category').should == SAMPLE_DATA_PATH + 'themes/typography/templates/category.rhtml'
+      @blog_engine.get_theme_template('error').should == SAMPLE_DATA_PATH + 'themes/typography/templates/error.rhtml'
+      @blog_engine.get_theme_template('home').should == SAMPLE_DATA_PATH + 'themes/typography/templates/home.rhtml'
+      @blog_engine.get_theme_template('layout').should == SAMPLE_DATA_PATH + 'themes/typography/templates/layout.rhtml'
       @blog_engine.get_system_resource('redirects.txt').should == SAMPLE_DATA_PATH + 'resources/redirects.txt'
       @blog_engine.get_system_resource('robots.txt').should == SAMPLE_DATA_PATH + 'resources/robots.txt'
       @blog_engine.get_system_resource('feeds.rss').should == SAMPLE_DATA_PATH + 'resources/feeds.rss'
@@ -29,26 +29,28 @@ describe "Baron::BlogEngine" do
     
     it "finds all categories" do
       categories = @blog_engine.get_all_categories
-      categories.count.should == 2
-      categories.first[:name].should == 'Code Projects'
-      categories.first[:path].should == '/code-projects/'
-      categories.first[:count].should == 0
-      categories.last[:name].should == 'Poems'
-      categories.last[:path].should == '/poems/'
-      categories.last[:count].should == 2
+      categories.count.should == 4
+      categories.first[:name].should == 'Favorites'
+      categories.first[:path].should == '/favorites/'
+      categories.first[:count].should == 1
+      categories.last[:name].should == 'Other Authors'
+      categories.last[:path].should == '/other-authors/'
+      categories.last[:count].should == 1
     end
-    
+
+    # todo, refactor to break out testing that we're appropriately breaking the fileparts down
+
     it "finds all articles" do
       articles_fileparts = @blog_engine.get_all_articles()
-      articles_fileparts.count.should == 3
-      articles_fileparts.first[:filename_and_path].should == SAMPLE_DATA_PATH + 'articles/2012-11-09-sample-post.txt' 
-      articles_fileparts.first[:date].should == '2012-11-09' 
-      articles_fileparts.first[:filename].should == 'sample-post' 
-      articles_fileparts.first[:category].should == ''
-      articles_fileparts.last[:filename_and_path].should == SAMPLE_DATA_PATH + 'articles/poems/1909-01-02-If.txt' 
+      articles_fileparts.count.should == 7
+      articles_fileparts.first[:filename_and_path].should == SAMPLE_DATA_PATH + 'articles/favorites/1916-01-01-the-road-not-taken.txt' 
+      articles_fileparts.first[:date].should == '1916-01-01' 
+      articles_fileparts.first[:filename].should == 'the-road-not-taken' 
+      articles_fileparts.first[:category].should == 'favorites'
+      articles_fileparts.last[:filename_and_path].should == SAMPLE_DATA_PATH + 'articles/other authors/1909-01-02-If.txt' 
       articles_fileparts.last[:date].should == '1909-01-02' 
       articles_fileparts.last[:filename].should == 'if' 
-      articles_fileparts.last[:category].should == 'poems' 
+      articles_fileparts.last[:category].should == 'other authors' 
     end
     
     it "returns all article parts" do

data/spec/baron_spec.rb

@@ -65,7 +65,7 @@ describe "Baron" do
 
   describe "GET category home page" do
     before :all do
-      @response = @baron.get('/poems/')
+      @response = @baron.get('/north-of-boston/')
     end
 
     it_behaves_like "Server Response"
@@ -113,7 +113,6 @@ describe "Baron" do
       response.body.should include('404')
       # should not render in the layout.rhtml if <html is in the first 100 chars
       response.body.should_not include("<meta name=\"description\" content="">")
-      response.body.should include ('Error')
     end
     
   end
@@ -128,11 +127,11 @@ describe "Baron" do
     it "returns expected content" do
       @response.body.should include(@config[:title])
       @response.body.should include("#{@config[:url]}/feed.rss")
-      @response.body.scan(/<entry>/).count.should == 3
-      @response.body.scan(/<\/entry>/).count.should == 3
+      @response.body.scan(/<entry>/).count.should == 5
+      @response.body.scan(/<\/entry>/).count.should == 5
       @response.body.should include('<feed')
       @response.body.should include('</feed>')
-    end 
+    end    
   end
   
   describe "GET /robots.txt" do
@@ -140,19 +139,14 @@ describe "Baron" do
       @response = @baron.get('/robots.txt')
     end
     
-    it_behaves_like "Server Response"    
+    it_behaves_like "Server Response"
+    
+    it "renders expected parameters" do
+      @response.body.should include("#{@config[:url]}/feed.rss")
+    end
   end
   
   describe "Redirect URLs" do
-    it "should redirect with 301" do
-      @response = @baron.get('/foobar-test-1')
-      @response.status.should == 301
-      @response['Location'].should == '/'
-      @response = @baron.get('/foobar-test-2')
-      @response.status.should == 301
-      @response['Location'].should == '/archives'
-    end
-    
     it "should canonicalize pagination at page 1" do
       @response = @baron.get('/page/1/')
       @response.status.should == 301
@@ -160,13 +154,7 @@ describe "Baron" do
       @response = @baron.get('/page/1')
       @response.status.should == 301
       @response['Location'].should == '/'
-    end
-    
-    it "should redirect with 302" do
-      @response = @baron.get('/foobar-test-3')
-      @response.status.should == 302
-      @response['Location'].should == '/posts/poems/the-road-not-taken/'
-    end
+    end    
   end
   
   describe "Helper Functions" do

data/spec/sample_data/.gitignore

@@ -0,0 +1,5 @@
+*.sw?
+.DS_Store
+coverage
+rdoc
+pkg

data/spec/sample_data/Gemfile

@@ -3,4 +3,4 @@ source 'https://rubygems.org'
 ruby '1.9.3'
 gem 'baron'
 gem 'rack'
-gem 'rdiscount'
+gem 'rdiscount'

data/spec/sample_data/README.md

@@ -0,0 +1,243 @@
+#The Baron Blog
+
+A full-featured, yet minimalist, blog engine for developers
+
+I know what you're thinking, the world doesn't need another Ruby blog 
+engine. And, okay, you're right, however Baron is a little bit different from
+all the others in that it is a lot more full-featured, and still only a scant 
+400 lines of easy-to-ready code.
+
+**Features**
+* Publish to heroku (or similar PaaS) using Git
+* Author articles or custom pages in markdown, text or HTML
+* Article categories supported by simply putting articles in a folder
+* Many permalink formats are supported, including a custom prefix and several 
+date formats
+* 301 or 302 redirects are support for easy porting from your current blog
+* SEO optimized with built-in support for Robots.txt, Google Analytics, Google 
+web master tools
+* Easy to customize the look & feel via a common site layout template
+* Frameworks used: Rack, RSpec, Bootstrap, JQuery, Disqus, Thin
+
+##Quick Start
+
+Dependencies: <a href="http://git-scm.com/">git</a>, 
+<a href="https://devcenter.heroku.com/articles/quickstart">heroku</a>, 
+<a href="http://www.ruby-lang.org/en/downloads/">ruby</a>
+
+	$ git clone https://github.com/nbuggia/baron-blog.git
+	$ mv baron-blog my-blog
+	$ heroku create my-blog
+	$ TODO: heroku add local...????
+	$ git init
+	$ git add .
+	$ git commit -m 'First commit of my new blog!'
+	$ git push heroku master
+	$ heroku open
+
+Yay! Now you probably are going to want to customize this thing, read on for 
+all the bells and whistles.
+
+##Quick How To's
+
+###Customize Your Blog
+
+	$ less config.ru
+
+There are many bells and whistles available for your blog, most of them can be 
+set from inside <code>config.ru</code>. The file is well documented for all the 
+options.
+
+The other big customization route is to hack the theme to either make your own,
+or to just modify it the way you'd like. Check out the 
+**Creating Your Own Themes*** section for more information.
+
+###Adding a Custom Domain Name (with Heroku)
+
+Go to the config section of your blog app and then enter in one or more new
+domain names. Next step is to redirect your DNS server to to heroku
+
+**GoDaddy**
+
+
+**FOOBAR**
+
+
+If you have a different hoster, just ask google how to set it up.
+
+Finally, you'll want to redirect the nude domain name to www, like this:
+
+my-domain.com &rarr; www.my-domain.com
+
+###Create New Post
+
+	$ rake new
+	Title: My Blog Title
+
+This command creates a new blog post with the current date in your 
+<code>drafts/</code> folder.
+
+To create a new post, you simply create a new text file in your favorite 
+editor. Simply save the file somewhere in your <code>articles/</code> folder in
+the format of <code>YYYY-MM-DD-article-title.txt</code>. Where YYYY means the
+year in 4 digits, MM means the month in two digits and DD means the day of the 
+month in 2 digits.
+
+**Attributes**
+
+The first few lines of the file are where you can place attribute value
+pairs in YAML format (e.g. <code>my_attribute: 'attribute'</code>). Add two new 
+lines to start the article, and then you can write it using markdown, HTML, 
+plain text, or a combination of all 3.
+
+* You can add additional attributes you want and then access them in the rhtml 
+template with <code>@article[:my_attribute]</code>.
+* If you need to use ':' or other special characters in your value, wrap it in 
+quotes (e.g. <code>title: "My article: Lots & Lots of Smiles"</code>)
+
+Notes
+
+* Baron forces all folder names and file names to lower case for canonicalization
+* You can't have periods in the file name
+
+###Create A New Custom Page
+
+use the directory structure
+
+###Setup redirects
+
+
+###SEO
+
+###Explore the Project
+
+Project structure:
+
+		├── Gemfile
+		├── Rakefile
+		├── articles/							place your published articles here
+		│   ├── 2012-11-09-sample-1.txt			the date and URL slug are the filename
+		│   └── category/						creating folders puts these articles in a category
+		│   ├── another category/				spaces in folder names will be replaces with '-'s
+		├── config.ru							configure features of the blog here
+		├── downloads/							files in here are publicly accessible	
+		├── drafts/								place for your unfinished articles
+		├── images/								images in here are publicly accessible
+		├── pages/								you can create custom pages in here
+		│   └── about.rhtml
+		├── resources/							
+		│   ├── feed.rss						your rss feed's rendering template
+		│   ├── redirects.txt					list of redirects the blog will process
+		│   └── robots.txt						your robots.txt file
+		└── themes/
+		    └── my-theme/						each theme has the same folder structure
+		        ├── css/
+		        ├── img/
+		        ├── js/
+		        └── templates/					rhtml rendering templates for each page type
+
+###Create a New Article
+
+
+###Create a New Page
+
+
+###Add a Custom Domain Name in Heroku (free!)
+
+TODO
+
+###Deploy to Heroku (free!)
+
+TODO
+
+###Domain Name Configuration
+
+Then setup use the Forwarding feature in GoDaddy to send buggia.org --> www.buggia.org
+
+http://stackoverflow.com/questions/11492563/heroku-godaddy-send-naked-domain-to-www
+
+
+###Run Blog Locally
+
+Uses Thin to run the blog
+
+	> cd my-blog
+	> sudo gem install thin
+	> thin start
+
+If you make a change to config.ru, you will need to restart thin.
+
+###Creating Your Own Themes
+
+
+##Next Steps
+
+I wrote this as an excuse to learn a handful of new technologies and approaches, 
+like Ruby and TDD. There are an ambitious set of features I'd like to add that 
+each align to something else I would like to learn:
+
+* Themes - I'm designing 3-4 fancy, shmancy themes to try out this new 'flat'
+and minimalist thing everyone's excited about. Also a good excuse to dig into
+HTML5, CSS3, JQuery, Instagram's API and a few other things.
+
+* Pre-rendering - the platform nerd in me doesn't understand why the whole 
+blog isn't pre-rendered at deploy time so heroku just serves static HTML and
+assets (a la <a href="https://github.com/mojombo/jekyll">Jekyll</a>)
+
+* JavaScript Comments - the blog engine currently uses Disqus for comments,
+which is free and cool, but I hate letting other people own my data. I want 
+to build something similar to Disqus on top of 
+<a href="https://www.parse.com/">Parse</a> / 
+<a href="https://github.com/documentcloud/backbone">Backbone</a> and make it 
+really easy to use
+
+* Simple Plugin Model - I've always wanted to write a plug-in model. I tried
+to write one in C++ in college and was only able to do static linking (lame). I
+think an interpreted language will make it much easier, right?
+
+##Namesake
+
+Pictures of the adorable baron von underbite
+
+##Thanks
+
+While writing this blog engine, I barrowed a lot of code and design approaches
+from the Toto project by Cloudhead and the Scanty project by Adam Wiggins. The
+primary purpose of this project was a learning one for me, and both of these
+folks provided a lot of good code an examples. I'm not sure how much code or 
+design awesomeness one needs to use before they are obligated to include their 
+license, so I'm included a link to each of them just in case (and thank you 
+both for your awesomeness!)
+
+Toto
+ - URL: https://github.com/cloudhead/toto
+ - Author: http://cloudhead.io/ (Alexis Sellier)
+ - License: https://github.com/cloudhead/toto/blob/master/LICENSE
+
+Scanty
+ - URL: https://github.com/adamwiggins/scanty
+ - Author: http://about.adamwiggins.com/ (Adam Wiggins)
+
+##License
+
+This software is licensed under the MIT Software License
+
+Copyright (c) 2013 Nathan Buggia
+
+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.