bem 1.0.0 → 1.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 0d2af2c63a4e9b5cfaf19f80154ca2d68a166a69
-  data.tar.gz: f1f114a392a7538fd561aaad7cb92972d3555b35
+  metadata.gz: 6b0671cfc07f6456f95f35f2915f870648e847bd
+  data.tar.gz: e1a6ad054d2531e76cb276b5fda058fbf293259b
 SHA512:
-  metadata.gz: b99f58dcf4150b3e63bce1f150ad3f4d662c8c03e3f0e17f4f0a643e6e6eeac6f9f1ebce8b07d5c8540f1428a96538786c8663840be4197dbc0d0590939ca067
-  data.tar.gz: f41c04967225654d1d90a235ccdcd80c8ba2df75479c3119f94538ce94e8937bbfc2ef52dd1b0efed4b45381dbc1c68d1c08ef439d025d764da1fb1ce95f4973
+  metadata.gz: 2ed7dedeb47e34a91efaedbd518d06e9f91697cc584c8aa06ef8f01dd927c7623f6b967d5b6d3a0bd879efb1fbf71336e84ac4bc323e6891b94ccb3926e31aff
+  data.tar.gz: 7925bb652a94a4469f44c31dfd026ab806e6e8e677a712b05a919332072db3b19e3fac85ad9047e566b61db84268eb043e5ee9c3620e4b380a549dc9c9258ccd

data/README.md

@@ -1,6 +1,6 @@
 # Bem
 
-TODO: Write a gem description
+Ruby library for working with BEM(http://bem.info/) in rails projects.
 
 ## Installation
 
@@ -15,10 +15,75 @@ And then execute:
 Or install it yourself as:
 
     $ gem install bem
+    
+Then you must create config file:
+
+    $ rails g bem:install
+
+And spring config file if you want to use bem command with `spring` as `spring bem create`
+
+    $ rails g bem:spring
+    
+After that stop `spring`
+
+    $ spring stop
+    
+And now you can use command `spring bem create` instead of just `bem create`. `spring` command significantly increase speed of blocks creation.
 
 ## Usage
 
-TODO: Write usage instructions here
+You can create blocks, elements, modificators, levels and manifests with command `bem create`
+
+This command create structure like that
+
+    levelname
+        block-name
+            __element-name
+                _mode-name.scss
+                    block-name__element-name_mod-name_value.scss
+                block-name__element-name.scss
+            _mod-name
+                block-name_mod-name_value.scss
+            block_name.css.sass
+
+Which is exactly the same as shown here http://bem.info/tools/bem/bem-tools/levels/
+
+It accepts these options:
+   
+    Options:
+        -b, [--block=BLOCK]              # Create or use given block.
+        -e, [--element=ELEMENT]          # Create or use given element.
+        -m, [--modificator=MODIFICATOR]  # Create modificator.
+        -v, [--value=VALUE]              # Value for modificator.
+        -l, [--level=LEVEL]              # Create or use given level.
+        -a, [--manifest=MANIFEST]        # Manifests to append level
+        -j, [--js], [--no-js]            # Do create assets with javascripts
+                                         # Default: true
+        -s, [--css], [--no-css]          # Do create assets with stylesheets
+                                         # Default: true
+
+It will automatically include appropriate information in corresponding levels and manifests.
+For adjust technologies and css directives use config/initializers/bem.rb
+
+For detail information about this command:
+
+    $ bem help create
+    
+For destroy blocks, elements, modificators, levels and manifests use command `bem destroy`. It makes undo of `bem create` command. It accepts these options:
+
+    Options:
+        -b, [--block=BLOCK]        # Destroy or use given block.
+        -e, [--element=ELEMENT]    # Destroy or use give element.
+        -m, [--mod=MOD]            # Destroy modificator.
+        -v, [--value=VALUE]        # Value for modificator.
+        -l, [--level=LEVEL]        # Destroy or use given level.
+        -a, [--manifest=MANIFEST]  # Manifests to append level
+
+For detail information about this command:
+
+    $ bem help destroy
+    
+This application https://github.com/gkopylov/bem_with_rails_and_less_example_app was created for demonstrate of using this gem.
 
 ## Contributing
 

data/bem.gemspec

@@ -8,9 +8,9 @@ Gem::Specification.new do |spec|
   spec.version       = Bem::VERSION
   spec.authors       = ['Kopylov German']
   spec.email         = ['roverrr@gmail.com']
-  spec.summary       = ' Ruby library for working with BEM in rails projects '
-  spec.description   = ' Ruby library for working with BEM in rails projects '
-  spec.homepage      = ''
+  spec.summary       = 'Ruby library for working with BEM in rails projects'
+  spec.description   = 'Ruby library for working with BEM in rails projects'
+  spec.homepage      = 'https://github.com/gkopylov/bem'
   spec.license       = 'MIT'
 
   spec.files         = `git ls-files -z`.split("\x0")

data/lib/bem/actions.rb

@@ -6,9 +6,9 @@ module BEM
 
         handle_bem(options, tech) if options[:block].present?
 
-        handle_level(options, tech)
+        handle_level(options, tech) unless options[:include_to_manifest]
 
-        handle_manifest(options, tech) if options[:manifest].present?
+        handle_manifest(options, tech) if options[:manifest].present? || options[:include_to_manifest]
       end
     end
 
@@ -49,13 +49,16 @@ module BEM
     end
 
     def handle_manifest(options, tech)
-      manifest = File.join(Rails.root, 'app', 'assets', tech[:group], options[:manifest] + tech[:extension])
+      manifest_name = options[:manifest].present? ? options[:manifest] : 'application'
 
-      level = level_path(options[:level], tech)
+      manifest = File.join(Rails.root, 'app', 'assets', tech[:group], manifest_name + tech[:extension])
+
+      path = options[:include_to_manifest] ? build_path_for(tech[:extension], options, tech[:group]) :
+        level_path(options[:level], tech)
 
       File.exist?(manifest) ? (puts("#{ manifest } already exists") if !options[:block].present?) : create_file(manifest)
 
-      append_file manifest, string_to_append(tech, level.split("#{ tech[:group] }/").last.sub(tech[:extension], ''))
+      append_file manifest, string_to_append(tech, path.split("#{ tech[:group] }/").last.sub(tech[:extension], ''))
     end
 
     def build_path_for(extension, options, group)

data/lib/bem/commands_tasks.rb

@@ -15,6 +15,7 @@ class CommandsTasks < Thor
   method_option :manifest, :type => :string, :aliases => '-a', :desc => 'Manifests to append level'
   method_option :js, :default => true, :type => :boolean, :aliases => '-j', :desc => 'Do create assets with javascripts'
   method_option :css, :default => true, :type => :boolean, :aliases => '-s', :desc => 'Do create assets with stylesheets'
+  method_option :include_to_manifest, :type => :boolean, :aliases => '-i', :desc => 'Include css asset to manifest'
   def create
     build_with options
   end

data/lib/bem/version.rb

@@ -1,3 +1,3 @@
 module Bem
-  VERSION = '1.0.0'
+  VERSION = '1.1.0'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: bem
 version: !ruby/object:Gem::Version
-  version: 1.0.0
+  version: 1.1.0
 platform: ruby
 authors:
 - Kopylov German
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2014-07-04 00:00:00.000000000 Z
+date: 2014-07-08 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -122,7 +122,7 @@ dependencies:
     - - '>='
       - !ruby/object:Gem::Version
         version: '0'
-description: ' Ruby library for working with BEM in rails projects '
+description: Ruby library for working with BEM in rails projects
 email:
 - roverrr@gmail.com
 executables:
@@ -152,7 +152,7 @@ files:
 - lib/generators/bem/spring/templates/spring.rb
 - spec/actions_spec.rb
 - spec/spec_helper.rb
-homepage: ''
+homepage: https://github.com/gkopylov/bem
 licenses:
 - MIT
 metadata: {}