flint-gs 2.3.6 → 2.3.7

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 04ab8c5b406e1036194b2eb4e90958a8c07f79bb
-  data.tar.gz: f5db48383b53f3114d11c94bc18ff5a64b1aada4
+  metadata.gz: da3ec92bb2f4ff67d45ef97780e765c7f8374376
+  data.tar.gz: 737c9de82a35ab9df17646cf6107e2df2515bac1
 SHA512:
-  metadata.gz: 69036ec25b836fcc4eff89344d1c045639eb7d2f6ffd7777fd0fe25fc309becdc2a2b66d47e7e81326f54308f879f83ab6a8450fe161c0770bc35ff7b13b801d
-  data.tar.gz: 0baee9a78d8cfae3b93179097ed462cb0804a0696d4fe55ad851650ee29e66096002522597aabcf4e2d0865bdbe544bf2848b8caba8c85fc088a8ea8e5fdcaf8
+  metadata.gz: 8d3e8716713e4ed5a3222e310bc1ea631e696a231021dc7a4e680a7d6392aeb7f065d32808e1d6d515b504484ee2edbbb89cfae3028f85279247bfa366e9bf14
+  data.tar.gz: 4cb75a699c69ed570c3fab5d24ea38c410c542693e1a017483184357cc7d6c0e1361f6319650f166bea97d9d7a8920bfb3e5fac463c595af92dfd0750d6dc281

data/LICENSE

@@ -1,21 +1,21 @@
-The MIT License (MIT)
-
-Copyright (c) 2014 Ezekiel Gabrielse
-
-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.
+The MIT License (MIT)
+
+Copyright (c) 2014 Ezekiel Gabrielse
+
+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.

data/README.md

@@ -1,98 +1,99 @@
-[![Flint - Grid System](http://flint.gs/wp-content/themes/flint/images/logo.png)](http://flint.gs)
-
-[![Gem](https://img.shields.io/gem/v/flint-gs.svg?style=flat-square)](https://rubygems.org/gems/flint-gs)
-[![Bower](https://img.shields.io/bower/v/flint.svg?style=flat-square)](http://bower.io/search/?q=flint)
-[![GitHub license](https://img.shields.io/github/license/ezekg/flint.svg?style=flat-square)](https://github.com/ezekg/flint/blob/master/LICENSE)
-
-## What is Flint?
-Flint is a responsive grid framework written in Sass, created to allow developers to rapidly produce responsive layouts that are built on a sophisticated foundation.
-
-## What sets Flint apart?
-Most notably? The syntax. Being a designer myself, a large amount of time was spent on this aspect. Flint is very unique in the fact that it uses only a single mixin for all output: `_(...)`.
-
-Yes, it really is just an underscore. Easy to remember, huh? It shoves the function mumbo-jumbo out of the way and allows you to focus on the aspect that matters most: the actual layout. It also allows you to type your intentions in human terms.
-
-```scss
-@include _(from tablet to desktop) { ... }
-```
-
-In addition to that, as you can tell from the snippet above, Flint also handles your breakpoints for you. Long gone are the days that you need to download a separate plugin just so that you're able to create a truly responsive layout.
-
-Flint allows you create an unlimited number of breakpoints, all of which have their own alias, column count and breakpoint. Want to name your 10 breakpoints after James Bond villians? By all means, go ahead.
-
-One more cool thing? Flint is the only self-aware Sass grid system on the planet.* What does that mean? It means that every instance of Flint is logged into an 'instance map', so child elements can know their parent element's width; meaning we can have perfectly consistent gutters, no matter how odd your layout may be. Think of it as a self-correcting grid.
-
-[Check out this short introduction over at Sitepoint.com](http://www.sitepoint.com/rapid-responsive-development-sass-flint/), and take it for a spin on [SassMeister.com](http://sassmeister.com/gist/228449011362bcdfe38c)!
-
-Enjoy.
-
-## Requirements
-
-* Sass ~> `3.4.0`
-
-## Installation
-
-1. Install via Ruby `gem install flint-gs`, or Bower `bower install flint --save-dev`
-2. If you're using Compass, add `require "flint"` to your `config.rb`
-3. Import it into your stylesheet with `@import "flint"`
-
-If you're not using Compass, you can require Flint and compile via cli:
-```
-scss --require ./lib/flint.rb example.scss > example.css
-```
-
-## Documentation
-
-Documentation is located [here](http://flint.gs/docs).
-
-_Tip: For simple projects, disable `instance-maps`, as it is has a large overhead and will increase your compile times._
-
-## Syntax support
-
-As of `1.6.0`, you can add syntax support for your preferred syntax. I built the system for BEM, but it should be easily extendable to
-support your preferred syntax. Simply create a function which parses a string of selectors into a valid list. For example, the BEM syntax
-function parses the selector string (for example, `.block__element__element`) like so,
-
-```scss
-///
-/// Parser to support BEM syntax
-///
-/// @access private
-///
-/// @param {List} $selectors - string of selectors to parse
-///
-/// @return {List} - parsed list of selectors according to syntax
-///
-/// @group Internal Functions
-///
-@function flint-support-syntax-bem($selectors) { ... }
-```
-[View Source](https://github.com/ezekg/flint/blob/master/stylesheets/flint/functions/lib/_support-syntax-bem.scss)
-
-This will be parsed into a list of selectors: `.block, .block__element, .block__element__element`. The list of selectors can then be used by the
-instance system to look up a selectors parent, etc. To support your own preferred syntax: create a `flint-support-syntax-<syntax-name>` function
-and hook into it through the config `"support-syntax": "<syntax-name>"` option -- the system will attempt to use the `call()` function in
-order to parse the selector string.
-
-#### Officially supported syntaxes
-* [BEM](http://bem.info/)
-
-If you use one that isn't here, let me know and I'll look into officially supporting it.
-
-## Support
-
-You can tweet [@FlintGrid](https://twitter.com/FlintGrid) with any questions or issues and I'll look into it. Be sure to include a [Gist](https://gist.github.com) or a [SassMeister](http://sassmeister.com) link.
-
-## Authors
-
-[Ezekiel Gabrielse](http://ezekielg.com)
-
-## Contributing
-
-As an open-source project, contributions are more than welcome, they're extremely helpful and actively encouraged. If you see any room for improvement, open an [issue](https://github.com/ezekg/flint/issues) or submit a [pull request](https://github.com/ezekg/flint/pulls). Also, make sure to take a look at the [contributing doc](CONTRIBUTING.md).
-
-## License
-
-Flint is available under the [MIT](http://opensource.org/licenses/MIT) license.
-
-_\* According to Wikipedia, not really. But, all jokes aside, it's pretty awesome._
+[![Flint - Grid System](http://flint.gs/wp-content/themes/flint/images/logo.png)](http://flint.gs)
+
+[![Gem](https://img.shields.io/gem/v/flint-gs.svg?style=flat-square)](https://rubygems.org/gems/flint-gs)
+[![Bower](https://img.shields.io/bower/v/flint.svg?style=flat-square)](http://bower.io/search/?q=flint)
+[![Travis](https://img.shields.io/travis/ezekg/flint.svg?style=flat-square)](https://travis-ci.org/ezekg/flint)
+[![GitHub license](https://img.shields.io/github/license/ezekg/flint.svg?style=flat-square)](https://github.com/ezekg/flint/blob/master/LICENSE)
+
+## What is Flint?
+Flint is a responsive grid framework written in Sass, created to allow developers to rapidly produce responsive layouts that are built on a sophisticated foundation.
+
+## What sets Flint apart?
+Most notably? The syntax. Being a designer myself, a large amount of time was spent on this aspect. Flint is very unique in the fact that it uses only a single mixin for all output: `_(...)`.
+
+Yes, it really is just an underscore. Easy to remember, huh? It shoves the function mumbo-jumbo out of the way and allows you to focus on the aspect that matters most: the actual layout. It also allows you to type your intentions in human terms.
+
+```scss
+@include _(from tablet to desktop) { ... }
+```
+
+In addition to that, as you can tell from the snippet above, Flint also handles your breakpoints for you. Long gone are the days that you need to download a separate plugin just so that you're able to create a truly responsive layout.
+
+Flint allows you create an unlimited number of breakpoints, all of which have their own alias, column count and breakpoint. Want to name your 10 breakpoints after James Bond villians? By all means, go ahead.
+
+One more cool thing? Flint is the only self-aware Sass grid system on the planet.* What does that mean? It means that every instance of Flint is logged into an 'instance map', so child elements can know their parent element's width; meaning we can have perfectly consistent gutters, no matter how odd your layout may be. Think of it as a self-correcting grid.
+
+[Check out this short introduction over at Sitepoint.com](http://www.sitepoint.com/rapid-responsive-development-sass-flint/), and take it for a spin on [SassMeister.com](http://sassmeister.com/gist/228449011362bcdfe38c)!
+
+Enjoy.
+
+## Requirements
+
+* Sass ~> `3.4.0`
+
+## Installation
+
+1. Install via Ruby `gem install flint-gs`, or Bower `bower install flint --save-dev`
+2. If you're using Compass, add `require "flint"` to your `config.rb`
+3. Import it into your stylesheet with `@import "flint"`
+
+If you're not using Compass, you can require Flint and compile via cli:
+```
+scss --require ./lib/flint.rb example.scss > example.css
+```
+
+## Documentation
+
+Documentation is located [here](http://flint.gs/docs).
+
+_Tip: For simple projects, disable `instance-maps`, as it is has a large overhead and will increase your compile times._
+
+## Syntax support
+
+As of `1.6.0`, you can add syntax support for your preferred syntax. I built the system for BEM, but it should be easily extendable to
+support your preferred syntax. Simply create a function which parses a string of selectors into a valid list. For example, the BEM syntax
+function parses the selector string (for example, `.block__element__element`) like so,
+
+```scss
+///
+/// Parser to support BEM syntax
+///
+/// @access private
+///
+/// @param {List} $selectors - string of selectors to parse
+///
+/// @return {List} - parsed list of selectors according to syntax
+///
+/// @group Internal Functions
+///
+@function flint-support-syntax-bem($selectors) { ... }
+```
+[View Source](https://github.com/ezekg/flint/blob/master/stylesheets/flint/functions/lib/_support-syntax-bem.scss)
+
+This will be parsed into a list of selectors: `.block, .block__element, .block__element__element`. The list of selectors can then be used by the
+instance system to look up a selectors parent, etc. To support your own preferred syntax: create a `flint-support-syntax-<syntax-name>` function
+and hook into it through the config `"support-syntax": "<syntax-name>"` option -- the system will attempt to use the `call()` function in
+order to parse the selector string.
+
+#### Officially supported syntaxes
+* [BEM](http://bem.info/)
+
+If you use one that isn't here, let me know and I'll look into officially supporting it.
+
+## Support
+
+You can tweet [@FlintGrid](https://twitter.com/FlintGrid) with any questions or issues and I'll look into it. Be sure to include a [Gist](https://gist.github.com) or a [SassMeister](http://sassmeister.com) link.
+
+## Authors
+
+[Ezekiel Gabrielse](http://ezekielg.com)
+
+## Contributing
+
+As an open-source project, contributions are more than welcome, they're extremely helpful and actively encouraged. If you see any room for improvement, open an [issue](https://github.com/ezekg/flint/issues) or submit a [pull request](https://github.com/ezekg/flint/pulls). Also, make sure to take a look at the [contributing doc](CONTRIBUTING.md).
+
+## License
+
+Flint is available under the [MIT](http://opensource.org/licenses/MIT) license.
+
+_\* According to Wikipedia, not really. But, all jokes aside, it's pretty awesome._

data/lib/flint-gs.rb

@@ -0,0 +1,8 @@
+# encoding: UTF-8
+
+lib = File.expand_path "../../lib/", __FILE__
+$:.unshift lib unless $:.include? lib
+
+# FIXME: Fixes an issue with Rails integration due to the gem being named
+#        `flint-gs`, but the lib being named `flint` (issue #37)
+require "flint"

data/lib/flint.rb

@@ -1,16 +1,22 @@
-require "sass"
-require_relative "flint/version"
-require_relative "flint/functions"
-
-base_directory = File.expand_path(File.join(File.dirname(__FILE__), '..'))
-flint_stylesheets_path = File.join(base_directory, 'stylesheets')
-
-if (defined? Compass)
-    Compass::Frameworks.register('flint', :path => base_directory)
-else
-    ENV["SASS_PATH"] = [ENV["SASS_PATH"], flint_stylesheets_path].compact.join(File::PATH_SEPARATOR)
-end
-
-module Flint
-    Sass::Script::Functions.send(:include, Flint)
-end
+# encoding: UTF-8
+
+lib = File.expand_path "../../lib/", __FILE__
+$:.unshift lib unless $:.include? lib
+
+require "sass"
+
+require "flint/version"
+require "flint/functions"
+
+base_directory = File.expand_path(File.join(File.dirname(__FILE__), '..'))
+flint_stylesheets_path = File.join(base_directory, 'stylesheets')
+
+if (defined? Compass)
+  Compass::Frameworks.register('flint', :path => base_directory)
+else
+  ENV["SASS_PATH"] = [ENV["SASS_PATH"], flint_stylesheets_path].compact.join(File::PATH_SEPARATOR)
+end
+
+module Flint
+  Sass::Script::Functions.send(:include, Flint)
+end

data/lib/flint/functions.rb

@@ -1,99 +1,99 @@
-module Flint
-
-  def self.declare(*args)
-    Sass::Script::Functions.declare(*args)
-  end
-
-  #
-  # Use ruby functions
-  #
-  # @return {Bool}
-  #
-  def flint_use_ruby()
-    Sass::Script::Bool.new(true)
-  end
-
-  #
-  # Fetch value from map
-  #
-  # @param {Map}     map  - map to fetch value from
-  # @param {ArgList} keys - list of keys to traverse
-  #
-  # @return {*}
-  #
-  def flint_ruby_map_fetch(map, *keys)
-    assert_type map, :Map, :map
-
-    result = map
-    keys.each { |key| result.nil? ? break : result = result.to_h.fetch(key, nil) }
-
-    unless result.nil?
-      result
-    else
-      Sass::Script::Bool.new(false)
-    end
-  end
-  declare :flint_ruby_map_fetch, :args => [:map, :keys], :var_args => true
-
-  #
-  # Joins all elements of list with passed glue
-  #
-  # @param {List}   list
-  # @param {String} glue
-  #
-  # @return {String}
-  #
-  def flint_ruby_list_to_str(list, glue)
-    assert_type list, :List, :list
-    assert_type glue, :String, :glue
-
-    arr = list.to_a.flatten.map { |item| item.value }
-
-    Sass::Script::String.new(arr.join(glue.value))
-  end
-  declare :flint_ruby_list_to_str, :args => [:list, :glue]
-
-  #
-  # Turn string into a flat list
-  #
-  # @param {String} string    - string to operate on
-  # @param {String} separator - item to find which separates substrings
-  # @param {String} ignore    - removes remaining string beyond item
-  #
-  # @return {List}
-  #
-  def flint_ruby_str_to_list(string, separator, ignore)
-    assert_type string, :String, :string
-    assert_type separator, :String, :separator
-    assert_type ignore, :String, :ignore
-
-    # Remove everything after ignore, split with separator
-    items = string.value[/[^#{ignore}]+/].split(separator.value)
-
-    if items.count == 1
-      Sass::Script::String.new(items[0], :comma)
-    else
-      Sass::Script::List.new(items.map { |i| Sass::Script::String.new(i) }, :comma)
-    end
-  end
-  declare :flint_ruby_str_to_list, :args => [:string, :separator, :ignore]
-
-  #
-  # Replace substring with string
-  #
-  # @param {String} string  - string that contains substring
-  # @param {String} find    - substring to replace
-  # @param {String} replace - new string to replace sub with
-  #
-  # @return {String}
-  #
-  def flint_ruby_str_replace(string, find, replace)
-    assert_type string, :String, :string
-    assert_type find, :String, :find
-    assert_type replace, :String, :replace
-
-    Sass::Script::String.new(string.value.gsub(find.value, replace.value))
-  end
-  declare :flint_ruby_str_replace, :args => [:string, :find, :replace]
-
-end
+module Flint
+
+  def self.declare(*args)
+    Sass::Script::Functions.declare(*args)
+  end
+
+  #
+  # Use ruby functions
+  #
+  # @return {Bool}
+  #
+  def flint_use_ruby()
+    Sass::Script::Bool.new(true)
+  end
+
+  #
+  # Fetch value from map
+  #
+  # @param {Map}     map  - map to fetch value from
+  # @param {ArgList} keys - list of keys to traverse
+  #
+  # @return {*}
+  #
+  def flint_ruby_map_fetch(map, *keys)
+    assert_type map, :Map, :map
+
+    result = map
+    keys.each { |key| result.nil? ? break : result = result.to_h.fetch(key, nil) }
+
+    unless result.nil?
+      result
+    else
+      Sass::Script::Bool.new(false)
+    end
+  end
+  declare :flint_ruby_map_fetch, :args => [:map, :keys], :var_args => true
+
+  #
+  # Joins all elements of list with passed glue
+  #
+  # @param {List}   list
+  # @param {String} glue
+  #
+  # @return {String}
+  #
+  def flint_ruby_list_to_str(list, glue)
+    assert_type list, :List, :list
+    assert_type glue, :String, :glue
+
+    arr = list.to_a.flatten.map { |item| item.value }
+
+    Sass::Script::String.new(arr.join(glue.value))
+  end
+  declare :flint_ruby_list_to_str, :args => [:list, :glue]
+
+  #
+  # Turn string into a flat list
+  #
+  # @param {String} string    - string to operate on
+  # @param {String} separator - item to find which separates substrings
+  # @param {String} ignore    - removes remaining string beyond item
+  #
+  # @return {List}
+  #
+  def flint_ruby_str_to_list(string, separator, ignore)
+    assert_type string, :String, :string
+    assert_type separator, :String, :separator
+    assert_type ignore, :String, :ignore
+
+    # Remove everything after ignore, split with separator
+    items = string.value[/[^#{ignore}]+/].split(separator.value)
+
+    if items.count == 1
+      Sass::Script::String.new(items[0], :comma)
+    else
+      Sass::Script::List.new(items.map { |i| Sass::Script::String.new(i) }, :comma)
+    end
+  end
+  declare :flint_ruby_str_to_list, :args => [:string, :separator, :ignore]
+
+  #
+  # Replace substring with string
+  #
+  # @param {String} string  - string that contains substring
+  # @param {String} find    - substring to replace
+  # @param {String} replace - new string to replace sub with
+  #
+  # @return {String}
+  #
+  def flint_ruby_str_replace(string, find, replace)
+    assert_type string, :String, :string
+    assert_type find, :String, :find
+    assert_type replace, :String, :replace
+
+    Sass::Script::String.new(string.value.gsub(find.value, replace.value))
+  end
+  declare :flint_ruby_str_replace, :args => [:string, :find, :replace]
+
+end