stylish 0.0.1 → 0.0.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 3b33ad60a2813aa5b8887061222d3fa0954372fb
-  data.tar.gz: 75045d226777f0e0eb7afb273309deaba577f315
+  metadata.gz: 7ce9345eb8420e741a9234f720105fe1ce83c10c
+  data.tar.gz: 37ef0f869a327e87b03b6f11d735ea27d2d30da4
 SHA512:
-  metadata.gz: daf8a07d94d524621a0077a5be3b9660f5fa5bebd528b0f6773e59484f7d2435b1dba5d1680d9cf6aeefd6d9a2cf4b8b9152a61edbb3cb0d37762864e9d419d9
-  data.tar.gz: cb4119dfe183f89816ef1da41f6da8b039d018194e62ee32a9a31180aa8693d1734de5439d1380445e4f8772e7ed9f3fe2b712c23fc75b85645cdb1293d9ee65
+  metadata.gz: 4b7966532e811492008ac7211eb8ed9047007a9616212d9863fd27a384cbd744f022619f27ce3b4e470835791004c7a4e2240b0d6e9a84bd01457637ac6069e1
+  data.tar.gz: e14948bd5828e140f797b2bd4d741eba19b33cb3d92e90f085b88c7b30b7c83308e963ab3623884f0aca29890b4e4f5be5cf32b2c3bcd0d6a403df3b5f0b6c02

data/.gitignore

@@ -4,14 +4,11 @@
 .config
 .yardoc
 Gemfile.lock
+existing.coffee
+standard-01.json
 InstalledFiles
-_yardoc
-coverage
-doc/
-lib/bundler/man
-pkg
-rdoc
-spec/reports
-test/tmp
-test/version_tmp
-tmp
+spec/dummy/log/*.log
+spec/dummy/tmp
+bower_components/
+node_modules/
+front-end/

data/ARCHITECTURE.md

@@ -0,0 +1,96 @@
+# Stylish.io Architecture
+
+Below are some descriptions of the various parts of the Stylish domain:
+
+### Library
+
+A library is a collection of packages. A library may be persisted on
+disk, locally, or in a remote github repository.
+
+The stylish developer server sits on top of a library, providing access
+to the packages it contains, and the means of working with or previewing 
+those packages.
+
+### Package
+
+A package is a theme, a collection of components, and the supporting
+scripts, stylesheets, templates, and documentation.
+
+### Manifest
+
+The manifest describes where various files are stored that contain the
+code for the components, scripts, stylesheets, etc.
+
+### Theme
+
+A theme is a collection of stylesheets, along with specific values of
+preprocessor configuration variables. A package has at least one theme,
+and a theme can be said to inherit from a package.  In this way, a theme
+can override or extend the defaults provided by a package.
+
+### Component
+
+A component is an HTML snippet, which depends on external script, or
+stylesheet assets.
+
+### Layout
+
+A layout is a collection of components, arranged in HTML form, with
+accompanying CSS.
+
+### Script
+
+A script belongs to a package, and powers a component or a layout.
+
+### Stylesheet
+
+A stylesheet belongs to a package, and powers a component or a layout.
+
+### Template
+
+A Template is a component's HTML, along with a mapping of CSS selectors
+to field names.  This allows us to apply transformations to HTML
+snippets to output them in different templating languages.
+
+Example:
+
+We start with this generic, static HTML snippet, for a landing page
+block.
+
+```html
+<div class="hero">
+  <h1 class="main-heading"></h1>
+  <h2 class="sub-heading"></h2>
+</div>
+```
+
+To templatize this HTML snippet, we can take a configuration structure
+like such:
+
+```yaml
+---
+template_name: Hero snippet
+mappings:
+  main_heading: ".hero .main-heading"
+  sub_heading: ".hero .sub-heading"
+```
+
+and this will allow us to generate an ERB template:
+
+```erb
+<div class="hero">
+  <h1 class="main-heading"><%= data.main_heading %></h1>
+  <h2 class="sub-heading"><%= data.sub_heading %></h1>
+</div>
+```
+
+or a Slim template:
+
+```slim
+.hero
+  h1.main-heading= data.main_heading
+  h2.sub-heading= data.sub_heading
+```
+
+or whatever else we want to use, all while enabling the theme designer
+to use standard HTML to author their example components.

data/Gemfile

@@ -2,3 +2,11 @@ source 'https://rubygems.org'
 
 # Specify your gem's dependencies in stylish.gemspec
 gemspec
+
+group :test, :development do
+  gem 'coffee-rails'
+  gem 'sass-rails'
+  gem 'spawnling'
+  gem 'faye'
+  gem 'listen'
+end

data/README.md

@@ -1,29 +1,25 @@
-# Stylish
-
-TODO: Write a gem description
-
-## Installation
-
-Add this line to your application's Gemfile:
-
-    gem 'stylish'
-
-And then execute:
-
-    $ bundle
-
-Or install it yourself as:
-
-    $ gem install stylish
-
-## Usage
-
-TODO: Write usage instructions here
-
-## Contributing
-
-1. Fork it
-2. Create your feature branch (`git checkout -b my-new-feature`)
-3. Commit your changes (`git commit -am 'Add some feature'`)
-4. Push to the branch (`git push origin my-new-feature`)
-5. Create new Pull Request
+# Stylish: the front-end theming laboratory 
+
+Frameworks such as Semantic-UI, Bootstrap, Foundation, or others,
+provide a great starting point for responsive, decent looking websites.
+There are plenty of off the shelf themes one can purchase as well, but
+in my experience working with many of them they start to fall apart when
+you try to decompose them into re-usable components in your own front
+end architecture, or turn them into templates to be rendered in a Rails
+app for example.
+
+Stylish is a set of tools aimed toward front end developers who are
+developing custom themes, components, or widgets using popular CSS Frameworks as their base. 
+It helps you design, develop, distribute, maintain, update, and sell these themes.
+
+Stylish helps theme developers organize their work in such a way that
+makes their themes and example pages extremely easy to incorporate into
+the many different development frameworks which will attempt to break 
+them apart and use them.
+
+### The stylish development server 
+
+TODO: Document the process of:
+- deploying to heroku
+- customizing the configuration
+- creating a new things

data/Rakefile

@@ -1 +1,25 @@
+#!/usr/bin/env rake
+
 require "bundler/gem_tasks"
+
+begin
+  require 'bundler/setup'
+rescue LoadError
+  puts 'You must `gem install bundler` and `bundle install` to run rake tasks'
+end
+
+APP_RAKEFILE = File.expand_path("../spec/dummy/Rakefile", __FILE__)
+load 'rails/tasks/engine.rake'
+
+Bundler::GemHelper.install_tasks
+
+Dir[File.join(File.dirname(__FILE__), 'tasks/**/*.rake')].each {|f| load f }
+
+require 'rspec/core'
+require 'rspec/core/rake_task'
+
+desc "Run all specs in spec directory (excluding plugin specs)"
+
+RSpec::Core::RakeTask.new(:spec => 'app:db:test:prepare')
+
+task :default => :spec

data/bin/stylish

@@ -0,0 +1,33 @@
+#!/usr/bin/env ruby
+
+$:.unshift File.join(File.dirname(__FILE__),'..','lib')
+
+require 'rubygems'
+require 'pry'
+require 'listen'
+require 'faye'
+require 'spawnling'
+require 'stylish'
+
+if ARGV.include?("console")
+  Pry.start
+else
+  require 'commander/import'
+
+  program :name, "Stylish"
+  program :description, "Stylish Development Server"
+  program :version, "0.0.1"
+
+  command :start do |c|
+    c.syntax = 'stylish start [options]'
+    c.description = 'manually start the watcher process'
+
+    c.option '--library-root PATH', 'Specify the library root path'
+
+    c.action do |args, options|
+      Stylish::Developer::Environment.start(library_root: options.library_root)
+    end
+  end
+end
+
+

data/lib/stylish.rb

@@ -1,5 +1,40 @@
+require "hashie"
+require "singleton"
+require "set"
+require "active_support/core_ext"
+require "stylish/core_ext"
+require "github-fs"
+require 'rack'
+
 require "stylish/version"
+require "stylish/configuration"
+
+require "stylish/developer"
+require 'stylish/developer/server'
+require 'stylish/developer/route'
+require 'stylish/developer/path'
+require 'stylish/developer/listing'
+require 'stylish/developer/modification'
+require 'stylish/developer/model_delegator'
+
+require 'stylish/developer/config'
+require 'stylish/developer/environment'
+
+require "stylish/manifest"
+require "stylish/fs"
+require "stylish/models"
+require "stylish/util"
 
 module Stylish
-  # Your code goes here...
+  require 'stylish/engine' if defined?(::Rails)
+
+  def self.util
+    Stylish::Util
+  end
+
+  def self.config
+    Stylish::Configuration.instance
+  end
 end
+
+Stylish::Models.load_all()

data/lib/stylish/configuration.rb

@@ -0,0 +1,37 @@
+module Stylish
+  class Configuration
+    include Singleton
+
+    def self.method_missing(meth, *args, &block)
+      if instance.respond_to?(meth)
+        instance.send(meth, *args, &block)
+      else
+        super
+      end
+    end
+
+    def method_missing(meth, *args, &block)
+      if config.respond_to?(meth)
+        config.send(meth, *args, &block)
+      else
+        super
+      end
+    end
+
+    def config
+      @config ||= Hashie::Mash.new
+    end
+
+    def load_from_file(path)
+      path = path.to_s.to_pathname
+
+      payload = if path.extname == ".yml"
+        YAML.load path.read
+      elsif path.extname == ".json"
+        JSON.parse path.read
+      end
+
+      config.merge!(payload)
+    end
+  end
+end

data/lib/stylish/core_ext.rb

@@ -0,0 +1,20 @@
+require 'hashie'
+require 'pathname'
+
+class Hash
+  def to_mash
+    Hashie::Mash.new(self)
+  end
+end
+
+class Pathname
+  def to_pathname
+    self
+  end
+end
+
+class String
+  def to_pathname
+    Pathname(self)
+  end
+end

data/lib/stylish/developer.rb

@@ -0,0 +1,13 @@
+module Stylish
+  module Developer
+    def self.server
+      Stylish::Developer::Server
+    end
+
+    def self.config
+      @@config ||= Stylish::Developer::Config.new
+      yield(@@config) if block_given?
+      @@config
+    end
+  end
+end

data/lib/stylish/developer/config.rb

@@ -0,0 +1,19 @@
+module Stylish
+  module Developer
+    class Config < Struct.new(:environment, :root, :base, :assets_prefix, :library_root)
+      def base_url
+        base || "/stylish"
+      end
+
+      def asset_prefix
+        assets_prefix || "/assets"
+      end
+
+      def library
+        lib_root = library_root || Pathname(Dir.pwd).join("library")
+        Stylish::Library.load_from_disk(lib_root)
+        Stylish::Library.loaded.first
+      end
+    end
+  end
+end

data/lib/stylish/developer/environment.rb

@@ -0,0 +1,75 @@
+module Stylish
+  module Developer
+    class Environment
+
+      def self.start options={}, &block
+          reloader = new(options)
+          yield(reloader) if block_given?
+          reloader.start()
+          Spawnling.wait(reloader.spawns)
+      end
+
+      attr_reader :spawns, :options, :logger
+
+      def start
+        @spawns = []
+
+        @spawns << Spawnling.new { start_library_server() }
+        @spawns << Spawnling.new { start_watcher_service() }
+        #@spawns << Spawnling.new { start_push_service() }
+      end
+
+      protected
+
+      attr_accessor :options
+
+      def initialize(options={})
+        @options = options
+        @logger = options[:logger]
+        @logger ||= Logger.new(STDOUT)
+
+        if options[:library_root]
+          Stylish::Developer.config.library_root = Pathname(options[:library_root])
+        end
+
+        puts "Starting at #{ root }"
+      end
+
+      def root
+        options[:root] || Stylish::Developer::Server.root || Dir.pwd()
+      end
+
+      def puts val
+        @logger && @logger.info(val)
+      end
+
+      def on_file_change *args
+        #modified, added, removed = args
+        #puts(args.inspect)
+      end
+
+      def start_library_server
+        Rack::Server.start(:app => Stylish::Developer::Server, :Port => "8090")
+      end
+
+      def start_watcher_service
+        reload = self
+
+        begin
+          @watcher = Listen.to(root) {|*args| puts args; reload.send(:on_file_change, *args) }
+          @watcher.start()
+          sleep
+        rescue => e
+          puts e.message
+        end
+      end
+
+      def start_push_service
+        10.times do |n|
+          puts("push #{n}")
+          sleep 1
+        end
+      end
+    end
+  end
+end