dugway 0.5.0

data/.gitignore

@@ -0,0 +1,7 @@
+.DS_Store
+
+Gemfile.lock
+
+*.gem
+*.tmproj
+*.sublime*

data/.travis.yml

@@ -0,0 +1,3 @@
+language: ruby
+rvm:
+  - 1.9.3

data/Gemfile

@@ -0,0 +1,2 @@
+source :rubygems
+gemspec

data/README.md

@@ -0,0 +1,151 @@
+# Dugway [![Build Status](https://travis-ci.org/bigcartel/dugway.png)](https://travis-ci.org/bigcartel/dugway)
+
+**_The easy way to build Big Cartel themes._**
+
+Dugway allows you to run your Big Cartel theme on your computer, test it in any browser, write code in your favorite editor, and use fancy new tools like CoffeeScript, Sass, and LESS. It's awesome.
+
+## Disclaimer
+
+**Dugway is a very new project and likely has several bugs, rough edges, and missing features.** If you run into something weird or have a cool idea, see if it's a [known issue](https://github.com/bigcartel/dugway/issues), and otherwise [report it](https://github.com/bigcartel/dugway/issues/new) and we'll do our best to hook you up. Thanks.
+
+## Install
+
+Dugway is Ruby gem so you'll need to have Ruby installed. Ruby is usually pre-installed on Mac OS X and Linux, and Windows users can install it using [RubyInstaller](http://rubyinstaller.org). From there, simply install the **dugway** gem from the terminal.
+
+    gem install dugway
+
+## Creating a new theme
+
+With Dugway installed, you can now create a new theme, simply give it a name.
+
+    dugway create mytheme
+
+This will create a new directory named *mytheme* that contains a few configuration files and a starter theme to get you going.
+
+    mytheme
+    ├── source
+    │   ├── images
+    │   │   └── all image files for your theme
+    │   ├── javascripts
+    │   │   └── all JavaScript files for your theme
+    │   ├── stylesheets
+    │   │   └── all CSS files for your theme
+    │   ├── cart.html
+    │   ├── checkout.html
+    │   ├── contact.html
+    │   ├── home.html
+    │   ├── layout.html
+    │   ├── maintenance.html
+    │   ├── product.html
+    │   ├── products.html
+    │   ├── screenshot.jpg
+    │   ├── scripts.js
+    │   ├── settings.json
+    │   ├── styles.css
+    │   └── success.html
+    ├── config.ru
+    └── Gemfile
+
+
+## Developing your theme
+
+All of the assets and source code for your theme goes in the **source** directory.
+
+### HTML
+
+Develop the HTML for your theme using our [Theme API](http://help.bigcartel.com/customer/portal/articles/772788-creating-a-custom-theme). Barebones versions of all of the required HTML pages for your theme are provided by default, so feel free to expand on those or replace them entirely.
+
+### CSS & JavaScript
+
+All CSS for your theme is handled by the **styles.css** file, and all JavaScript by **scripts.js**. If you don't have much CSS or JavaScript, or you're just a glutton for punishment, you could simply put all of your code in these two files. However, we recommend you use [Sprockets](http://getsprockets.org) to break your code into multiple files in separate directories.
+
+#### Using Sprockets
+
+[Sprockets](http://getsprockets.org) allows you to bring in CSS and JavaScript from different directories into a single file. We've created **stylesheets** and **javascripts** directories by default that you can put your code in, but you could delete those and put files anywhere you'd like. After that, use [Sprockets directives](https://github.com/sstephenson/sprockets#the-directive-processor) to package them into **styles.css** and **scripts.js**.
+
+##### styles.css
+
+    /*
+     *= require stylesheets/example_1
+     *= require stylesheets/example_2
+     */
+
+##### scripts.js
+
+    //= require javascripts/example_1
+    //= require javascripts/example_2
+
+#### Using Sass, LESS, and CoffeeScript
+
+Sprockets also allows you to use [Sass](http://sass-lang.com) in your separate files by appending the **.sass** or **.scss** extension after **.css**. Prefer [LESS](http://lesscss.org)? No problem, just append the **.less** extension instead. For you JavaScript folks, you can use [CoffeeScript](http://coffeescript.org) in your separate files by appending the **.coffee** extension after **.js**.
+
+#### Embedding CSS & JavaScript
+
+You can embed the CSS and JavaScript into your theme by passing the theme variable to the [theme_css_url](http://help.bigcartel.com/customer/portal/articles/772749-filters#url) and [theme_js_url](http://help.bigcartel.com/customer/portal/articles/772749-filters#url) filters.
+
+##### CSS (styles.css)
+
+    <link href="{{ theme | theme_css_url }}" media="screen" rel="stylesheet" type="text/css">
+
+##### JavaScript (scripts.js)
+
+    <script src="{{ theme | theme_js_url }}" type="text/javascript"></script>
+
+### Images
+
+And as you've probably guessed by now, all images for your theme go in the **images** directory. You can reference an image in your code by passing its name to the [theme_image_url](http://help.bigcartel.com/customer/portal/articles/772749-filters#url) filter.
+
+    {{ 'sample.png' | theme_image_url }}
+
+### Settings
+
+Set your theme's name, version, and customizable options in the **settings.json** file. We'll be documenting more about this soon, but for now see the starter file generated for you.
+
+## Running your theme
+
+Run your theme in any browser by starting the Dugway server:
+
+    dugway server
+
+By default this will serve your theme at http://0.0.0.0:9292. You can then stop the server by hitting CTRL+C.
+
+### Pow
+
+Tired of all the manual starting and stopping? Good news, Dugway is built on top of Rack, which means you can use [Pow](http://pow.cx) on Mac. This also allows you to access your theme at a pretty URL like _mytheme.dev_.
+
+## Testing your theme
+
+Part of building a great theme is making sure it works well in a variety of contexts and with a variety of content. Dugway makes it easy to test your theme's versatility by customizing the **options** in the **config.ru** file. 
+
+*Note:* changing the **config.ru** file will require you to restart the [server](#running-your-theme).
+
+### Store content
+
+The best way to see your theme under a different light is by previewing it with a different store's products, categories, pages, currency, and other content. To do this, simply set the **:store** option to any Big Cartel store's subdomain, and Dugway will bring in their content using the standard [Big Cartel API](http://help.bigcartel.com/customer/portal/articles/772771-api). By default we use **dugway** for [dugway.bigcartel.com](http://dugway.bigcartel.com).
+
+    options[:store] = 'beeteeth'
+
+*Note:* don't worry, any sensitive data like inventory levels and discount codes is faked by Dugway.
+
+### Store customization
+
+Another important thing to consider is how store owners will customize your theme. You establish what can be customized in your [settings.json](#settings) file, and Dugway allows you to simulate potential values people could choose by setting them in the **:customization** option. By default we use the **default** values from your **[settings.json](#settings)** file.
+
+    options[:customization] = {
+      :logo => {
+        :url => 'http://placehold.it/200x50/000000/ffffff&text=My+Logo',
+        :width => 200,
+        :height => 50
+      },
+      :background_color => '#CCCCCC',
+      :show_search => true,
+      :twitter_username => 'mytwitter'
+    }
+
+## Building your theme
+
+When you're finished with a new version of your theme, it's time to build it.
+
+    dugway build
+
+This will create a zip file for the current version in your **build** directory containing all HTML, images, and packaged JS and CSS.

data/Rakefile

@@ -0,0 +1,12 @@
+#!/usr/bin/env rake
+require "bundler/gem_tasks"
+
+require 'rake'
+require 'rspec/core/rake_task'
+
+desc "Run all examples"
+RSpec::Core::RakeTask.new(:spec) do |t|
+  t.rspec_opts = %w[--color]
+end
+
+task :default => [:spec]

data/bin/dugway

@@ -0,0 +1,7 @@
+#!/usr/bin/env ruby
+
+$LOAD_PATH.unshift File.expand_path(File.dirname(__FILE__) + '/../lib')
+
+require 'dugway/cli'
+
+Dugway::Cli::Base.start

data/dugway.gemspec

@@ -0,0 +1,43 @@
+# encoding: utf-8
+$:.push File.expand_path('../lib', __FILE__)
+require 'dugway/version'
+
+Gem::Specification.new do |s|
+  s.name         = 'dugway'
+  s.version      = Dugway::VERSION
+  s.authors      = ['Big Cartel']
+  s.email        = 'dev@bigcartel.com'
+  s.homepage     = 'https://github.com/bigcartel/dugway'
+  s.summary      = 'Easily build and test Big Cartel themes locally.'
+  s.description  = 'Easily build and test Big Cartel themes locally.'
+
+  s.files        = `git ls-files`.split($\)
+  s.test_files   = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.platform     = Gem::Platform::RUBY
+  s.require_path = 'lib'
+  s.executable   = 'dugway'
+  
+  s.add_dependency('bundler', '~> 1.1')
+  s.add_dependency('rack', '~> 1.4.1')
+  s.add_dependency('rack-mount', '~> 0.8.3')
+  s.add_dependency('activesupport', '~> 3.2.6')
+  s.add_dependency('liquid', '~> 2.4.1')
+  s.add_dependency('therubyracer', '~> 0.11.3')
+  s.add_dependency('coffee-script', '~> 2.2.0')
+  s.add_dependency('sass', '~> 3.2.5')
+  s.add_dependency('less', '~> 2.2.2')
+  s.add_dependency('sprockets', '~> 2.0')
+  s.add_dependency('httparty', '~> 0.10.0')
+  s.add_dependency('better_errors', '~> 0.6.0')
+  s.add_dependency('binding_of_caller', '~> 0.7.1')
+  s.add_dependency('will_paginate', '~> 3.0.4')
+  s.add_dependency('i18n', '~> 0.6.1')
+  s.add_dependency('htmlentities', '~> 4.3.1')
+  s.add_dependency('thor', '~> 0.17.0')
+  s.add_dependency('rubyzip', '~> 0.9.9')
+  s.add_dependency('yui-compressor', '~> 0.9.6')
+  
+  s.add_development_dependency('rake', '~> 10.0.3')
+  s.add_development_dependency('rspec', '~> 2.12.0')
+  s.add_development_dependency('webmock', '~> 1.9.3')
+end

data/lib/dugway.rb

@@ -0,0 +1,66 @@
+require 'active_support/all'
+require 'i18n'
+
+require 'rack/builder'
+require 'rack/commonlogger'
+require 'better_errors'
+
+require 'dugway/version'
+require 'dugway/application'
+require 'dugway/cart'
+require 'dugway/liquifier'
+require 'dugway/logger'
+require 'dugway/request'
+require 'dugway/store'
+require 'dugway/template'
+require 'dugway/theme'
+require 'dugway/theme_font'
+require 'dugway/extensions/time'
+
+module Dugway
+  class << self
+    def application(options={})
+      @logger = Logger.new if options[:log]
+      @source_dir = File.join(Dir.pwd, 'source')
+      @store = Store.new(options[:store] || 'dugway')
+      @theme = Theme.new(options[:customization] || {})
+      @cart = Cart.new
+
+      I18n.load_path += Dir[File.join(File.dirname(__FILE__), 'data', 'locales', '*.yml').to_s]
+      I18n.default_locale = 'en-US'
+      I18n.locale = Dugway.store.locale
+
+      Rack::Builder.app do
+        use Rack::Session::Cookie, :secret => 'stopwarningmeaboutnothavingasecret'
+        use BetterErrors::Middleware
+        
+        if options[:log]
+          BetterErrors.logger = Dugway.logger
+          use Rack::CommonLogger, Dugway.logger
+        end
+        
+        run Application.new
+      end
+    end
+
+    def store
+      @store
+    end
+
+    def theme
+      @theme
+    end
+
+    def cart
+      @cart
+    end
+
+    def source_dir
+      @source_dir
+    end
+    
+    def logger
+      @logger
+    end
+  end
+end

data/lib/dugway/application.rb

@@ -0,0 +1,147 @@
+require 'dugway/controller'
+
+module Dugway
+  class Application < Controller
+    # Home
+
+    get '/' do
+      render_page
+    end
+
+    # Products
+
+    get '/products(.js)' do
+      if request.html?
+        render_page
+      elsif request.js?
+        render_json(store.products)
+      end
+    end
+
+    get '/category/:category(.js)' do
+      if category = store.category(params[:category])
+        if request.html?
+          page['name'] = category['name']
+          render_page(:category => category)
+        elsif request.js?
+          render_json(store.category_products(params[:category]))
+        end
+      else
+        render_not_found
+      end
+    end
+
+    get '/artist/:artist(.js)' do
+      if artist = store.artist(params[:artist])
+        if request.html?
+          page['name'] = artist['name']
+          render_page(:artist => artist)
+        elsif request.js?
+          render_json(store.artist_products(params[:artist]))
+        end
+      else
+        render_not_found
+      end
+    end
+
+    # Product
+
+    get '/product/:product(.js)' do
+      if product = store.product(params[:product])
+        if request.html?
+          page['name'] = product['name']
+          render_page(:product => product)
+        elsif request.js?
+          render_json(product)
+        end
+      else
+        render_not_found
+      end
+    end
+
+    # Cart
+
+    any '/cart(.js)' do
+      if cart_params = params[:cart].try(:with_indifferent_access)
+        cart.update(cart_params)
+      end
+
+      if params[:checkout]
+        redirect_to('/checkout')
+      else
+        if request.html?
+          render_page
+        elsif request.js?
+          render_json(cart)
+        end
+      end
+    end
+
+    # Checkout
+
+    any '/checkout' do
+      if cart.empty?
+        error('Must have at least one product to checkout')
+        redirect_to('/cart')
+      else
+        render_page
+      end
+    end
+
+    # Success
+
+    get '/success' do
+      render_page
+    end
+
+    post '/success' do
+      sleep(3) # Give the checkout page time
+      cart.reset
+      render_page
+    end
+
+    # Contact
+
+    get '/contact' do
+      render_page
+    end
+
+    post '/contact' do
+      if [ :name, :email, :subject, :message, :captcha ].any? { |f| params[f].blank? }
+        error('All fields are required')
+      elsif !(params[:email] =~ /^([^@\s]+)@((?:[-a-zA-Z0-9]+\.)+[a-zA-Z]{2,})$/)
+        error('Invalid email address')
+      elsif !(params[:captcha] =~ /^rQ9pC$/i)
+        error('Spam check was incorrect')
+      end
+
+      render_page
+    end
+
+    # Maintenance
+
+    get '/maintenance' do
+      render_page
+    end
+
+    # Custom page
+
+    get '/:permalink' do
+      render_page
+    end
+
+    # Assets
+
+    get '/styles.css' do
+      render_file('styles.css')
+    end
+
+    get '/scripts.js' do
+      render_file('scripts.js')
+    end
+
+    get %r{^/images/.+\.(jpg|jpeg|gif|png)$} do
+      Rack::File.new(Dugway.source_dir).call(request.env)
+    end
+  end
+end