toppings 0.0.1 → 0.0.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 60729af4b717dcfe8dd0dfbdd8ac686a66966bfc
-  data.tar.gz: 543166f88253600ca25de2e746090416b307ec80
+  metadata.gz: ca79397d379601222b27f744571a2522643b4fee
+  data.tar.gz: eea12d3fb3a7cc1d803faf222e4d35489886d84a
 SHA512:
-  metadata.gz: 8e54d83e0567ac3a4e633dded4b976fcc1466f091188a0a394cc207b3036c28e0b2b43ec8ac09875051161b9bd9d727f8a54b12f7cb52c15a6c4655aa866d898
-  data.tar.gz: 2702e0a41eca7cbcb0d60d9eb641be38700817d062af8745ed0d83da84c24468607fd25b88dbac05436c262836bcf1154371ce343e5777b61ff80baa32a7e54f
+  metadata.gz: aa27f4e6fa1799c625c85bf75946e7d6a5d065f5957029ebfcc30754c2ff1102807635895d4cbb97452c2e43f75534e841d25c3c86dac10f5474317867706817
+  data.tar.gz: c3f70cb264d40f3962b1dd889c1bced05258570ff506bb37e2f0ef46538ca4b4b28a4e5d97e864123ad5f04c007b9be32ce35f4234bc7838e499c961659a2d87

data/LICENSE.txt

@@ -1,4 +1,4 @@
-Copyright (c) 2013 TODO: Write your name
+Copyright (c) 2013 Falk Hoppe
 
 MIT License
 

data/README.md

@@ -1,29 +1,95 @@
-# Toppings
+[![Build Status](https://travis-ci.org/toppings/toppings.png)](https://travis-ci.org/toppings/toppings)
+[![Coverage Status](https://coveralls.io/repos/toppings/toppings/badge.png)](https://coveralls.io/r/toppings/toppings)
+[![Code Climate](https://codeclimate.com/github/toppings/toppings.png)](https://codeclimate.com/github/mechanoid/toppings)
+[![Dependency Status](https://gemnasium.com/toppings/toppings.png)](https://gemnasium.com/mechanoid/toppings)
+[![Gem Version](https://badge.fury.io/rb/toppings.png)](http://badge.fury.io/rb/toppings)
+
+## Welcome to Toppings
+
+The toppings project provides a basic generator set to create and maintain a generic structure for your css based application or framework frontend. Though the structure may be not final yet, it offers a great way of staying clean in your development base and lets you concentrate on the hard and heavy styling itself.
+
+In the last few years a lot of work was done about frontend development via css which includes precompiling frameworks like sass and less and architectural patterns like [BEM](http://bem.info/method/definitions/),  [OOCSS](http://oocss.org/) and [SMACCS](http://smacss.com/) which lead to combined framework definitions like [MVCSS](http://mvcss.github.io/) and [SMURF](http://railslove.com/blog/2012/11/09/taking-sass-to-the-next-level-with-smurf-and-extend).
+
+Aside these ideas we have developed our frontend architecture on similar principles for years now, and did not want to bother anymore about how to name folders and structures in every project again and again. Out of this we tried to combine and compress the basic ideas around the aforementioned principles to some helpful generators, that provides a more or less complete filestructure for your css and some specific generators to add new css components for your modules, settings or even your font files. Unlike the core principles like BEM, OOCSS or SMACSS this framework is based on SASS/SCSS only, because (yeah, obvious i know :)) it is all about structuring/splitting your css code to encapsulated and reusable units.
+
+While we try to make this gem highly configurable in later versions, we want to provide strong defaults, to get your application easily up and running, without fighting with five different grid frameworks, several naming strategies or something like that. But we will try to give you the possibility to easily interchange or disable most of the things, toppings provide.
+
+### Installation
+
+Installing toppings should be easy with standard gem mananig, because it does not carry any native dependencies until now :). So just try to run `gem install toppings` (with sudo, when you are not running without ruby version management) or add the gem to your Gemfile with `gem 'toppings'`.
+
+
+### Usage
+
+The toppings gem ships with a binary called `topping` which is basically a wrapper for some) [Thor LINK IS MISSING](…)-tasks and provides a similar syntax as the rails binary does for generation tasks.
+(As a little side note, keep in mind to run `rbenv rehash` when using rbenv for managing your rubies, to create a binary shim, that links properly to the installed gem.)
+
+But beforementioned there is a command for initializing your stylesheet environment called via `topping install`. Running this command will read the current configuration (give a look to the configuration section for more information) and then create a folder and file structure like you can see below.
+
+```
+stylesheets
+├── fonts
+│   └── _index.sass
+├── helper
+│   ├── _index.sass
+│   └── _debug.sass
+├── layouts
+│   └── _index.sass
+├── modules
+│   └── _index.sass
+├── settings
+│   ├── _index.sass
+│   ├── _borders.sass
+│   ├── _colors.sass
+│   ├── _dimensions.sass
+│   ├── _shadows.sass
+│   └── _typography.sass
+├── setups
+│   ├── _index.sass
+│   ├── _modular_scale.sass
+│   ├── _responsive_grid.sass
+│   └── _vertical_rhythm.sass
+└── toppings.sass
+```
+
+At first you may stumble upon the sass format of the generated files, and yes we decided for the sass style of the language as a default here. Let me start with, that this setting for sure is configurable [LINK TO SASS DIALECT CONFIG HERE](…), so it is really only a default. But lets discuss our decision over SASS vs. SCSS for short. I argued myself very often against the sass style over the newer SCSS (Sassy CSS) format, because it of course looks a lot more like CSS, as it is the case with HAML and HTML. But unlike HTML which is sometimes whitespace sensitive and where it may not make sense to keep a language layer between you and the markup output, arranging CSS rules is mainly about personal preferences,   and not about language style. Many best practices about arranging your css rules, like one rule per line do perfectly match the sassy syntax. And in the end you were writing really good and readable stylesheets without the necessity of writing curly brackets over and over again. Enough commercials for now so we can get an eye  on the structure itself.
+
+When we start bottom to the top, we will mention a toppings.sass file in the root of our stylesheets folder (and yes the name of the file and the folder name and path is configurable [LINKS TO CONFIGURATIONS FOR ROOT FILE NAME AND PATH](…)). This file is responsible for the load order of our application framework and it should not ship any other content to keep our environment clean and simple.
+That means you will find a bunch of imports including compass, your grid framework of choice (in the moment it is susy ;))  and a relative base file for each style group we listed above. These relative stylesheets encapsulate each concern by packing up the imports of the specific group, so that we just include or exclude an import of a base file to enable or disable a stylesheet group, like settings, modules and so on. More detailed information we will provide in the sass documentation of the generated files.
+
+
+### Configuration
+
+t.b.d
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
 
-TODO: Write a gem description
 
-## Installation
 
-Add this line to your application's Gemfile:
 
-    gem 'toppings'
 
-And then execute:
 
-    $ bundle
 
-Or install it yourself as:
 
-    $ gem install toppings
 
-## 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

data/bin/topping

@@ -0,0 +1,4 @@
+#!/usr/bin/env ruby
+# encoding: utf-8
+require 'toppings/cli'
+Toppings::CLI.start

data/lib/toppings/cli.rb

@@ -0,0 +1,43 @@
+# encoding: utf-8
+require 'toppings'
+
+module Toppings
+  class CLI < Thor
+    VALID_GENERATORS = %w{module setting font setup layout helper}.freeze
+
+
+    desc 'install', 'create a basic topping styles layout'
+
+    def install
+      Toppings::Generators::InstallGenerator.start
+    end
+
+    desc 'generate GENERATOR', 'generating a toppings component like modules, settings etc.'
+
+    def generate(generator = nil, *args)
+      if generator
+        if VALID_GENERATORS.include? generator
+          Toppings::Generators::ComponentsGenerator.start(args.unshift(generator))
+        else
+          args_error_message('invalid')
+        end
+      else
+        args_error_message('no')
+      end
+    end
+
+    desc 'g GENERATOR', 'shortcut for generate'
+
+    def g(generator = nil, *args)
+      generate(generator, *args)
+    end
+
+    private
+
+    def args_error_message(error_type)
+      say "ERROR: generate was called with #{error_type} generator argument"
+      say 'USAGE: valid generators are font | module | setting | setup'
+    end
+
+  end
+end

data/lib/toppings/config.rb

@@ -0,0 +1,67 @@
+# encoding: utf-8
+require 'active_support/core_ext/hash/deep_merge'
+require 'ostruct'
+
+module Toppings
+  class Config < OpenStruct
+
+    def initialize(options = {})
+      super()
+
+      options.each do |option, value|
+        send "#{option}=", value.kind_of?(Hash) ? Toppings::Config.new(value) : value
+      end
+    end
+
+    class << self
+      def load
+        @config = new(joined_config)
+      end
+
+      def joined_config
+        default_config.deep_merge(custom_config)
+      end
+
+      def custom_config
+        @customs = parsed_config(custom_config_path)
+      end
+
+      def default_config
+        @defaults = parsed_config(default_config_path)
+      end
+
+      def parsed_config(path)
+        config_file = File.read(path) if File.exists?(path)
+        JSON.parse(config_file || '{}')
+      end
+
+      def default_config_path
+        gem_config_path.join default_config_name
+      end
+
+      def custom_config_path
+        app_config_path.join custom_config_name
+      end
+
+      def default_config_name
+        'default.json'
+      end
+
+      def custom_config_name
+        'toppings.json'
+      end
+
+      def gem_config_path
+        Pathname.new(Toppings.gem_root).join('config')
+      end
+
+      # The app config path is based on the current directory,
+      # from where the toppings command is called.
+      #
+      # TODO: app_config path should be configurable by a thor param
+      def app_config_path
+        Pathname.new('.').join('config')
+      end
+    end
+  end
+end

data/lib/toppings/generators/components_generator.rb

@@ -0,0 +1,44 @@
+# encoding: utf-8
+require 'thor/group'
+
+module Toppings
+  module Generators
+    class ComponentsGenerator < Thor::Group
+      include Thor::Actions
+      include Toppings::Helper::PathHelper
+      include Toppings::Helper::BaseFileHelper
+      include Toppings::Helper::IndexFileHelper
+
+      argument :type
+      argument :name
+
+      def create_component_file
+        self.class.base_name = type.pluralize
+        template rescued_sass_partial(type), base_path.join(sassy_file_name(name, partial: true))
+        create_file index_file_path, skip: true
+        append_import name, index_file_path
+      end
+
+      private
+
+      def rescued_sass_partial(type)
+        File.exists?(self.class.source_root.join(erb_template(type))) ? erb_template(type) : default_template
+      end
+
+      def erb_template(type)
+        sassy_file_name(type, type: :erb, partial: true)
+      end
+
+      def default_template
+        sassy_file_name('default', type: :erb, partial: true)
+      end
+
+      class << self
+        def source_root
+          template_path.join('components')
+        end
+      end
+
+    end
+  end
+end

data/lib/toppings/generators/install/base_generator.rb

@@ -0,0 +1,23 @@
+# encoding: utf-8
+require 'thor/group'
+
+module Toppings
+  module Generators
+    module Install
+      class BaseGenerator < Thor::Group
+        include Thor::Actions
+        include Toppings::Helper::PathHelper
+        include Toppings::Helper::BaseFileHelper
+        include Toppings::Helper::IndexFileHelper
+
+        def notify_invoke
+          say "invoke Install::#{self.class.stripped_class_name}"
+        end
+
+        def self.source_root
+          template_path
+        end
+      end
+    end
+  end
+end

data/lib/toppings/generators/install/compass_config_generator.rb

@@ -0,0 +1,18 @@
+# encoding: utf-8
+module Toppings
+  module Generators
+    module Install
+      class CompassConfigGenerator < BaseGenerator
+        class << self
+          def source_root
+            template_path
+          end
+        end
+
+        def compass_config
+          template 'compass.rb.tt', Pathname.new('.').join('config').join('compass.rb')
+        end
+      end
+    end
+  end
+end

data/lib/toppings/generators/install/fonts_generator.rb

@@ -0,0 +1,10 @@
+# encoding: utf-8
+module Toppings
+  module Generators
+    module Install
+      class FontsGenerator < GroupGenerator
+
+      end
+    end
+  end
+end

data/lib/toppings/generators/install/group_generator.rb

@@ -0,0 +1,98 @@
+# encoding: utf-8
+require_relative 'base_generator'
+require_relative 'root_file_generator'
+
+module Toppings
+  module Generators
+    module Install
+
+      # the GroupGenerator class provides some default behavior for a given
+      # generator, that extends the GroupGenerator.
+      #
+      # For each groupfile a new group folder is created and a relative base file
+      # is added to it, where included templates will be registered with appropriate
+      # import statements.
+      #
+      # Template pathes and target pathes become available by convention over the
+      # given specific classes base name, where the base name is build upon the classes name
+      # with stripped Generator suffix.
+      class GroupGenerator < BaseGenerator
+        include Toppings::Helper::BaseFileHelper
+
+        class_attribute :templates
+
+        class << self
+          # provides a path build upon the base name of a class as
+          # source root for the thor template engine.
+          #
+          # @return [String] path to the class namespaced template folder
+          def source_root
+            template_path.join(base_name)
+          end
+
+          # dsl method to register certain template files, that should be
+          # made available for the specific generator.
+          #
+          # @param files [*String] one or more template names
+          # @return [Array] returns the list of registered templates
+          def with_templates(*files)
+            files.each { |file| templates << file }
+          end
+
+          def with_template(file, options = {})
+            library = options[:vendor_library]
+            path    = options[:template_folder]
+            Toppings::SASS_DEPENDENCIES.add(library) if library
+            file = library ? "#{library}.#{file}" : file.to_s
+            file = Pathname.new(path).join(file) if path
+            templates << file
+          end
+
+          # registered templates for a group, that will be made available in the setup
+          #
+          # @return [Set] of registered templates
+          def templates
+            @templates ||= Set.new
+          end
+        end
+
+        # creating the relative base file for a generator group and appending it
+        # to the root file located in the stylesheet root.
+        def create_base_import_file
+          create_file index_file_path, skip: true
+          append_import relative_index_name, root_file_path
+        end
+
+        # building templated files based on the beforehand registered template files
+        def create_template_files
+          templates.each { |file| group_template_file(file) } if self.templates?
+        end
+
+        private
+
+        # copies a template file for the given generator group to the relative base file base.
+        #
+        # @param file [String] template file name
+        def group_template_file(file)
+          file, path = parse_file_name(file)
+          create_sass_file(file, path: path)
+          append_import file, index_file_path
+        end
+
+        def create_sass_file(file, options = {})
+          Toppings::Generators::SassFileGenerator.new([file],
+                                                      source_root: options[:path] || self.class.source_root,
+                                                      target_path: base_path).invoke_all
+        end
+
+
+        def parse_file_name(file)
+          file = file.to_s
+          path_name = Pathname.new(file)
+          dir_name = path_name.dirname.to_s != '.' ? path_name.dirname : nil
+          [path_name.basename, dir_name]
+        end
+      end
+    end
+  end
+end

data/lib/toppings/generators/install/helper_generator.rb

@@ -0,0 +1,10 @@
+# encoding: utf-8
+module Toppings
+  module Generators
+    module Install
+      class HelperGenerator < GroupGenerator
+        with_templates :debug
+      end
+    end
+  end
+end

data/lib/toppings/generators/install/layouts_generator.rb

@@ -0,0 +1,10 @@
+# encoding: utf-8
+module Toppings
+  module Generators
+    module Install
+      class LayoutsGenerator < GroupGenerator
+        # TODO: think about adding some examples here (https://github.com/toppings/toppings/issues/43)
+      end
+    end
+  end
+end

data/lib/toppings/generators/install/modules_generator.rb

@@ -0,0 +1,10 @@
+# encoding: utf-8
+module Toppings
+  module Generators
+    module Install
+      class ModulesGenerator < GroupGenerator
+
+      end
+    end
+  end
+end

data/lib/toppings/generators/install/root_file_generator.rb

@@ -0,0 +1,36 @@
+# encoding: utf-8
+module Toppings
+  module Generators
+    module Install
+      class RootFileGenerator < BaseGenerator
+        include Toppings::Helper::SassFrameworkHelper
+
+        # the only ever fully compiled file at the moment
+        def create_root_file
+          create_file(root_file_path, skip: true) do
+            [vendor_framework_imports, blank_line, start_application_framework].flatten.join
+          end
+        end
+
+        private
+
+        def vendor_framework_imports
+          imports = sass_framework_imports.map { |import| import_format(import) }
+          imports.unshift root_file_headline('Vendor Frameworks')
+        end
+
+        def start_application_framework
+          root_file_headline 'Application Framework'
+        end
+
+        def root_file_comment(message)
+          add_line_comment message, root_file_path
+        end
+
+        def root_file_headline(message)
+          headline_comment message, root_file_path
+        end
+      end
+    end
+  end
+end

data/lib/toppings/generators/install/settings_generator.rb

@@ -0,0 +1,10 @@
+# encoding: utf-8
+module Toppings
+  module Generators
+    module Install
+      class SettingsGenerator < GroupGenerator
+        with_templates :colors, :shadows, :borders, :typography, :dimensions
+      end
+    end
+  end
+end

data/lib/toppings/generators/install/setups_generator.rb

@@ -0,0 +1,12 @@
+# encoding: utf-8
+require_relative 'group_generator'
+
+module Toppings
+  module Generators
+    module Install
+      class SetupsGenerator < GroupGenerator
+        with_templates :vertical_rhythm
+      end
+    end
+  end
+end

data/lib/toppings/generators/install_generator.rb

@@ -0,0 +1,40 @@
+# encoding: utf-8
+require 'thor/group'
+
+# require related install generator files
+Dir.glob(File.join(Toppings.gem_root, '**', 'install', '*_generator.rb')).each do |generator|
+  require generator
+end
+
+Toppings.conf.required_vendors.each do |vendor|
+  require vendor
+end
+
+module Toppings
+  module Generators
+    class InstallGenerator < Thor::Group
+      include Thor::Actions
+      include Toppings::Helper::GeneratorRegistrationHelper
+
+      register Toppings::Generators::Install::FontsGenerator,
+               Toppings::Generators::Install::SettingsGenerator,
+               Toppings::Generators::Install::HelperGenerator,
+               Toppings::Generators::Install::SetupsGenerator,
+               Toppings::Generators::Install::ModulesGenerator,
+               Toppings::Generators::Install::LayoutsGenerator,
+               Toppings::Generators::Install::CompassConfigGenerator
+
+      def notify_invoke
+        say 'invoke InstallGenerator'
+      end
+
+      def create_root_file
+        Toppings::Generators::Install::RootFileGenerator.start
+      end
+
+      def run_registered_generators
+        registered_generators.each { |generator| generator.start }
+      end
+    end
+  end
+end

data/lib/toppings/generators/sass_file_generator.rb

@@ -0,0 +1,43 @@
+# encoding: utf-8
+require 'thor/group'
+require 'toppings/helper'
+
+module Toppings
+  module Generators
+    class SassFileGenerator < Thor::Group
+      include Thor::Actions
+      include Toppings::Helper::SassConversionHelper
+      include Toppings::Helper::SassFileHelper
+
+      argument :file_name
+      class_option :target_path
+      class_option :source_root
+      class_option :standalone
+
+      class << self
+        attr_accessor :source_root
+      end
+
+      def set_current_source_root
+        self.class.source_root = options[:source_root]
+      end
+
+      def create_file_from_template
+        template sassy_file_name(file_name, dialect: Toppings.conf.sass.template_dialect), file_path(file_name) do |content|
+          content if valid_sass?(content)
+          Toppings.conf.sass.dialect == 'scss' ? convert_to_scss(content) : content
+        end
+      end
+
+      private
+
+      def file_path(file_name)
+        base_path.join(sassy_file_name(file_name))
+      end
+
+      def base_path
+        options[:target_path]
+      end
+    end
+  end
+end

data/lib/toppings/generators.rb

@@ -0,0 +1,11 @@
+# encoding: utf-8
+module Toppings::Generators
+
+end
+
+# manual require statements upfront to keep them in ordered before all others
+require 'toppings/generators/sass_file_generator'
+require 'toppings/generators/install/base_generator'
+require 'toppings/generators/install/group_generator'
+require 'toppings/generators/install_generator'
+require 'toppings/generators/components_generator'

data/lib/toppings/helper/base_file_helper.rb

@@ -0,0 +1,43 @@
+# encoding: utf-8
+module Toppings
+  module Helper
+    module BaseFileHelper
+      extend ActiveSupport::Concern
+
+      included do
+        include Toppings::Helper::SassContentHelper
+        include Toppings::Helper::SassFileHelper
+
+        self.class.send :attr_writer, :base_name
+      end
+
+      private
+
+
+      def base_path
+        @base_path ||= stylesheets_path.join(relative_base_path)
+      end
+
+      def relative_base_path
+        @relative_base_path ||= Pathname.new(base_name)
+      end
+
+      def base_name
+        self.class.base_name
+      end
+
+      module ClassMethods
+
+        def base_name
+          @base_name ||= stripped_class_name.gsub(/Generator$/, '').underscore
+        end
+
+        # As base for our naming conventions we want the class name only,
+        # without any module space
+        def stripped_class_name
+          name.demodulize
+        end
+      end
+    end
+  end
+end

data/lib/toppings/helper/generator_registration_helper.rb

@@ -0,0 +1,31 @@
+# encoding: utf-8
+module Toppings
+  module Helper
+    module GeneratorRegistrationHelper
+      extend ActiveSupport::Concern
+
+      included do
+        class_attribute :_generators
+      end
+
+      def registered_generators
+        self.class.generators
+      end
+
+      private :registered_generators
+
+      module ClassMethods
+
+        def generators
+          self._generators ||= []
+        end
+
+        def register(*new_generators)
+          generators.concat new_generators
+        end
+
+      end
+
+    end
+  end
+end

data/lib/toppings/helper/index_file_helper.rb

@@ -0,0 +1,27 @@
+# encoding: utf-8
+module Toppings
+  module Helper
+    module IndexFileHelper
+      extend ActiveSupport::Concern
+
+      included do
+        include Toppings::Helper::BaseFileHelper
+      end
+
+      private
+
+      def index_file_path
+        base_path.join(index_file_name)
+      end
+
+      def relative_index_name
+        relative_base_path.join(Toppings.conf.stylesheets.relative_index_file)
+      end
+
+      def index_file_name
+        sassy_file_name Toppings.conf.stylesheets.relative_index_file
+      end
+
+    end
+  end
+end

data/lib/toppings/helper/path_helper.rb

@@ -0,0 +1,23 @@
+# encoding: utf-8
+module Toppings
+  module Helper
+    module PathHelper
+      extend ActiveSupport::Concern
+
+      def stylesheets_path
+        @stylesheets_path ||= Pathname('.').join(Toppings.conf.stylesheets.root_folder)
+      end
+
+      def root_file_path
+        stylesheets_path.join(sassy_file_name(Toppings.conf.stylesheets.root_file, standalone: true))
+      end
+
+      module ClassMethods
+        def template_path
+          @template_path ||= Pathname(Toppings.gem_root).join('lib', 'toppings', 'templates')
+        end
+      end
+
+    end
+  end
+end

data/lib/toppings/helper/sass_content_helper.rb

@@ -0,0 +1,38 @@
+# encoding: utf-8
+module Toppings
+  module Helper
+    module SassContentHelper
+      extend ActiveSupport::Concern
+
+      private
+
+      def add_line_comment(message, file)
+        append_to_file file, "// #{message}"
+      end
+
+      def headline_comment(message, file)
+        <<-EOM
+#{devider(file)}
+// #{message}
+#{devider(file)}
+        EOM
+      end
+
+      def devider(file)
+        '// ---------------------------------------------------------------------------'
+      end
+
+      def blank_line
+        "\n"
+      end
+
+      def append_import(import_file, target_file, options = {})
+        append_to_file target_file, import_format(import_file)
+      end
+
+      def import_format(import_file)
+        "@import \"#{import_file}\"\n"
+      end
+    end
+  end
+end

data/lib/toppings/helper/sass_conversion_helper.rb

@@ -0,0 +1,81 @@
+# encoding: utf-8
+require 'tempfile'
+require 'sass'
+require 'sass/exec'
+require 'sass/util'
+require 'compass'
+require 'digest'
+
+module Toppings::Helper::SassConversionHelper
+  extend ActiveSupport::Concern
+
+  included do
+    attr_accessor :source_file, :target_file
+  end
+
+  def convert_to_scss(content)
+    init_tempfiles_for_conversion(content)
+
+    # convert source content to the target format, placed in the target file
+    # TODO: make conversion more dynamic, by allowing conversion from scss to sass too.
+    ::Sass::Util.silence_sass_warnings do
+      Sass::Exec::SassConvert.new(['-F', 'sass', '-T', 'scss', source_file, target_file]).parse
+    end
+
+    converted_content
+  ensure
+    [source_file, target_file].each(&:close)
+    [source_file, target_file].each(&:unlink)
+  end
+
+  def valid_sass?(content, file_path = nil)
+    load_dependencies(file_path)
+
+    ::Sass::Util.silence_sass_warnings do
+      begin
+        Sass::Engine.new(content, sass_engine_options.merge(check_syntax: true)).render
+      rescue ::Sass::SyntaxError => e
+        say e.message
+        false
+      end
+    end
+  end
+
+  def load_dependencies(file_path = nil)
+    Toppings::SASS_DEPENDENCIES.each { |dep| require dep.to_s }
+    load_compass_paths
+    load_paths << file_path if file_path
+  end
+
+  def load_compass_paths
+    load_paths.merge Compass.configuration.sass_load_paths
+  end
+
+  def load_paths
+    sass_engine_options[:load_paths] ||= Set.new
+  end
+
+  def sass_engine_options
+    @sass_engine_options ||= {}
+  end
+
+  private
+
+  def init_tempfiles_for_conversion(content)
+    file_name    = Digest::MD5.new.update(content)
+    @source_file = Tempfile.new("#{file_name}_source")
+    @target_file = Tempfile.new("#{file_name}_target")
+
+    write_source(content)
+  end
+
+  def write_source(content)
+    source_file.write(content)
+    source_file.rewind
+  end
+
+  def converted_content
+    target_file.rewind
+    target_file.read
+  end
+end

data/lib/toppings/helper/sass_file_helper.rb

@@ -0,0 +1,14 @@
+# encoding: utf-8
+module Toppings::Helper::SassFileHelper
+  def sassy_file_name(file, options = {})
+    sass_file = []
+
+    sass_file.tap do |f|
+      f << (options[:standalone] ? file : "_#{file}")
+      f << (options[:dialect] || Toppings.conf.sass.dialect)
+      f << 'erb' if options[:type] == :erb
+    end
+
+    sass_file.join('.')
+  end
+end

data/lib/toppings/helper/sass_framework_helper.rb

@@ -0,0 +1,30 @@
+# encoding: utf-8
+module Toppings
+  module Helper
+    module SassFrameworkHelper
+      extend ActiveSupport::Concern
+
+      included do
+        include Toppings::Helper::SassContentHelper
+      end
+
+      private
+
+      def sass_framework_imports
+        [core_framework, css3_framework, reset_framework]
+      end
+
+      def core_framework
+        Toppings.conf.sass.framework.core
+      end
+
+      def css3_framework
+        Toppings.conf.sass.framework.css3
+      end
+
+      def reset_framework
+        Toppings.conf.sass.framework.reset
+      end
+    end
+  end
+end

data/lib/toppings/helper.rb

@@ -0,0 +1,11 @@
+# encoding: utf-8
+module Toppings::Helper
+
+end
+
+# require other setup generator files
+Dir.glob(File.join(Toppings.gem_root, '**', 'helper', '*_helper.rb')).each do |helper|
+  require helper
+end
+
+

data/lib/toppings/version.rb

@@ -1,3 +1,4 @@
+# encoding: utf-8
 module Toppings
-  VERSION = "0.0.1"
+  VERSION = '0.0.3'
 end

data/lib/toppings.rb

@@ -1,5 +1,22 @@
-require "toppings/version"
+# encoding: utf-8
+require 'set'
+require 'active_support/all'
+require 'compass'
+require 'thor'
 
 module Toppings
-  # Your code goes here...
+  SASS_DEPENDENCIES ||= Set.new
+
+  def self.gem_root
+    @gem_root ||= File.expand_path('../..', __FILE__)
+  end
+
+  def self.conf
+    @conf ||= Toppings::Config.load
+  end
 end
+
+require 'toppings/version'
+require 'toppings/config'
+require 'toppings/helper'
+require 'toppings/generators'

data/toppings.gemspec

@@ -4,20 +4,36 @@ $LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
 require 'toppings/version'
 
 Gem::Specification.new do |spec|
-  spec.name          = "toppings"
-  spec.version       = Toppings::VERSION
-  spec.authors       = ["Falk Hoppe, Roman Stranghöner"]
-  spec.email         = ["falkhoppe81@gmail.com"]
-  spec.description   = %q{css frontend framework based on sass/scss}
-  spec.summary       = %q{css frontend framework based on sass/scss}
-  # spec.homepage      = ""
-  spec.license       = "MIT"
+  spec.name        = "toppings"
+  spec.version     = Toppings::VERSION
+  spec.authors     = ["Falk Hoppe, Roman Stranghöner"]
+  spec.email       = ["falkhoppe81@gmail.com"]
+  spec.description = %q{css frontend framework based on sass/scss}
+  spec.summary     = %q{css frontend framework based on sass/scss}
+  spec.homepage      = "http://toppings.github.io/toppings/"
+  spec.license     = "MIT"
 
-  spec.files         = `git ls-files`.split($/)
-  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
-  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
-  spec.require_paths = ["lib"]
+  spec.files = %w(LICENSE.txt README.md toppings.gemspec)
+  spec.files += Dir.glob("bin/**/*")
+  spec.files += Dir.glob("lib/**/*.rb")
+
+  spec.executables               = %w{topping}
+  spec.test_files                = spec.files.grep(%r{^(spec|features)/})
+  spec.require_paths             = ["lib"]
+  spec.required_rubygems_version = '>= 1.3.6'
 
   spec.add_development_dependency "bundler", "~> 1.3"
   spec.add_development_dependency "rake"
+  spec.add_development_dependency "rake-notes"
+  spec.add_development_dependency "autotest"
+  spec.add_development_dependency "rubocop"
+  spec.add_development_dependency "code_statistics"
+
+  spec.add_dependency "thor", ">= 0.18.1"
+  spec.add_dependency "activesupport", ">= 3.2"
+  spec.add_dependency "compass", ">= 0.12.2"
+  spec.add_dependency "modular-scale"
+  spec.add_dependency "toppings-normalize", "~> 0.0.3"
+  spec.add_dependency "toppings-singularity"
+  spec.add_dependency "toppings-modular_scale"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: toppings
 version: !ruby/object:Gem::Version
-  version: 0.0.1
+  version: 0.0.3
 platform: ruby
 authors:
 - Falk Hoppe, Roman Stranghöner
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-05-08 00:00:00.000000000 Z
+date: 2013-08-28 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -38,22 +38,200 @@ dependencies:
     - - '>='
       - !ruby/object:Gem::Version
         version: '0'
+- !ruby/object:Gem::Dependency
+  name: rake-notes
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: autotest
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rubocop
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: code_statistics
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: thor
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: 0.18.1
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: 0.18.1
+- !ruby/object:Gem::Dependency
+  name: activesupport
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '3.2'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '3.2'
+- !ruby/object:Gem::Dependency
+  name: compass
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: 0.12.2
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: 0.12.2
+- !ruby/object:Gem::Dependency
+  name: modular-scale
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: toppings-normalize
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.0.3
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.0.3
+- !ruby/object:Gem::Dependency
+  name: toppings-singularity
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: toppings-modular_scale
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
 description: css frontend framework based on sass/scss
 email:
 - falkhoppe81@gmail.com
-executables: []
+executables:
+- topping
 extensions: []
 extra_rdoc_files: []
 files:
-- .gitignore
-- Gemfile
 - LICENSE.txt
 - README.md
-- Rakefile
-- lib/toppings.rb
-- lib/toppings/version.rb
 - toppings.gemspec
-homepage: 
+- bin/topping
+- lib/toppings/cli.rb
+- lib/toppings/config.rb
+- lib/toppings/generators/components_generator.rb
+- lib/toppings/generators/install/base_generator.rb
+- lib/toppings/generators/install/compass_config_generator.rb
+- lib/toppings/generators/install/fonts_generator.rb
+- lib/toppings/generators/install/group_generator.rb
+- lib/toppings/generators/install/helper_generator.rb
+- lib/toppings/generators/install/layouts_generator.rb
+- lib/toppings/generators/install/modules_generator.rb
+- lib/toppings/generators/install/root_file_generator.rb
+- lib/toppings/generators/install/settings_generator.rb
+- lib/toppings/generators/install/setups_generator.rb
+- lib/toppings/generators/install_generator.rb
+- lib/toppings/generators/sass_file_generator.rb
+- lib/toppings/generators.rb
+- lib/toppings/helper/base_file_helper.rb
+- lib/toppings/helper/generator_registration_helper.rb
+- lib/toppings/helper/index_file_helper.rb
+- lib/toppings/helper/path_helper.rb
+- lib/toppings/helper/sass_content_helper.rb
+- lib/toppings/helper/sass_conversion_helper.rb
+- lib/toppings/helper/sass_file_helper.rb
+- lib/toppings/helper/sass_framework_helper.rb
+- lib/toppings/helper.rb
+- lib/toppings/version.rb
+- lib/toppings.rb
+homepage: http://toppings.github.io/toppings/
 licenses:
 - MIT
 metadata: {}
@@ -70,10 +248,10 @@ required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - '>='
     - !ruby/object:Gem::Version
-      version: '0'
+      version: 1.3.6
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.0.0
+rubygems_version: 2.0.6
 signing_key: 
 specification_version: 4
 summary: css frontend framework based on sass/scss

data/.gitignore

@@ -1,17 +0,0 @@
-*.gem
-*.rbc
-.bundle
-.config
-.yardoc
-Gemfile.lock
-InstalledFiles
-_yardoc
-coverage
-doc/
-lib/bundler/man
-pkg
-rdoc
-spec/reports
-test/tmp
-test/version_tmp
-tmp

data/Gemfile

@@ -1,4 +0,0 @@
-source 'https://rubygems.org'
-
-# Specify your gem's dependencies in toppings.gemspec
-gemspec

data/Rakefile

@@ -1 +0,0 @@
-require "bundler/gem_tasks"