grouped_property_scss_linter 1.1.3

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: e22237fdcbef363b71f89896640289081051eeff
+  data.tar.gz: 0056fd882b1a9b93488294289b4dfa5b2c21d90e
+SHA512:
+  metadata.gz: cfece3ebdca1ca05691671646bb7530c1fc2733674911c1f63aae367688fcceba950fa14a626c780575874a35ae66f625e54971111f87e32c1e8c7c4a3d6f1fa
+  data.tar.gz: bbf00eaf2b8a150e0da8c9db5d3661274f54c94eef766e3cef375f637d792ea72a8e9cc3f97893fd4417063c721e5fc5ea521339d8f3735cb17bb86efe7b72a3

data/.gitignore

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

data/.scss-lint.yml

@@ -0,0 +1,17 @@
+linters:
+  GroupedPropertyOrder:
+    enabled: true
+
+    # defaults: applied to all groups
+    defaults:
+      space_around: true
+      max_no_space: 3
+
+    # preferred style
+    style:  grouped-smacss
+
+    # or a definition of your own. Note that this takes precedence over style
+    groups:
+
+    # whether you get extended hinting information in the output
+    extended_hinting:  false

data/Gemfile

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

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2016–2017 Jon Pearse
+
+MIT License
+
+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.textile

@@ -0,0 +1,181 @@
+h1. Grouped Property Linter for SCSS-Lint
+
+This is a plugin linter for "SCSS-Lint":https://github.com/brigade/scss-lint that provides a saner alternative to the built-in @PropertySortOrder@ linter.
+
+Instead of requiring properties to be arranged in a strict order, it instead allows groups of properties (eg: @top@, @right@, @bottom@ & @left@) to be defined, and then lints the order of the _groups_ in your SASS.
+As long as properties are grouped correctly, the order of individual properties is unimportant.
+
+h2. Examples
+
+Using the default configuration:
+
+*Bad*
+
+<pre><code lang="css">.selector {
+  padding: .625rem;
+
+  text-decoration: underline;
+  font-size: 1rem;
+  line-height: 1.3;
+  font-weight: bold;
+  color: rgba(20, 20, 20, .8);
+
+  display: inline-block;
+  background: #F00;
+}</code></pre>
+
+*Good*
+
+<pre><code lang="css">.selector {
+  display: inline-block;
+  padding: .625rem;
+
+  color: rgba(20, 20, 20, .8);
+  background: #F00;
+
+  font-size: 1rem;
+  line-height: 1.3em;
+  font-weight: bold;
+  text-decoration: underline;
+}</code></pre>
+
+Because the order of individual properties within a group is ignored, neither of the selectors below would generate a warning.
+
+<pre><code lang="css">.selector-one {
+  display: block;
+
+  height: 10em;
+  width:  90%;
+}
+
+.selector-two {
+  display: block;
+
+  width:  90%;
+  height: 10em;
+}</code></pre>
+
+h2. Usage
+
+In order to use this linter, you’ll need to modify both your Gemfile and scss-lint configuration file (typically @.scss-lint@).
+
+*Gemfile*
+
+<pre><code lang="ruby">gem 'grouped_property_scss_linter'</code></pre>
+
+*SCSS-Lint configuration file*
+
+You will need to add @grouped_property_scss_linter@ to the @plugin_gems@ variable:
+
+<pre><code lang="yaml">plugin_gems: ['grouped_property_scss_linter']</code></pre>
+
+h2. Configuration
+
+When included, this linter is enabled by default, and enforces a modified version of "SMACSS’s categories":https://smacss.com/book/categorizing
+
+The configuration may be altered in the same way as other linters, by adding a section to your SCSS-Lint configuration file.
+
+<pre><code lang="yaml">linters:
+  GroupedPropertyOrder:
+    enabled: true
+    defaults:
+      space_around: true
+      max_no_space: 3
+    style: smacss
+    groups:
+</code></pre>
+
+h3. Options
+
+- @enabled@ _(boolean)_ := switches the module on and off (default: on)
+- @defaults@ _(hash)_ := default linting settings that are applied to all groups (can be overridden per-group)
+- @style@ _(string, optional)_ := the name of a preconfigured style (see below, defaults to @grouped-smacss@)
+- @groups@ _(hash, optional)_ := a hash of configured groups. Note that specifying anything here will override the @style@ option
+- @extended_hinting@ _(boolean, optional)_ := enables additional group information in hinting output (default @false@)
+
+h4. Default options
+
+- @space_around@ _(boolean)_ := whether to require space around individual groups (default: true)
+- @max_no_space@ _(int)_ := the maximum number of properties that can be specified in a group before space is required around it (default: 3, ignored if @space_around@ is @false@)
+
+h4. Predefined styles
+
+There a number of property orders/styles supplied with the gem. These are:
+
+- @smacss@ := an implementation of "SMACSS":https://smacss.com/book/formatting
+- @grouped-smacss@ _(default)_ := a tweaked version of SMACSS with slightly more granular grouping
+- @concentric@ := an implementation of "Concentric CSS":https://github.com/brandon-rhodes/Concentric-CSS
+- @personal@ := my personal ordering, just cuz…
+
+
+h3. Specifying your own configuration
+
+Groups are specified as a YAML hash, in the order in which they should appear in your SASS. Each group *must* have a @properties@ member, containing an array of properties that may appear in this group.
+
+<pre><code lang="yaml">groups:
+  tables:
+    properties:
+      - table-layout
+      - border-collapse
+      - empty-cells</code></pre>
+
+Specifies a group called @tables@, which may contain @table-layout@, @border-collapse@ and @empty-cells@ properties.
+
+h4. Wildcard properties
+
+In cases where a number of properties may have the same prefix, wildcard properties may used instead.
+Thus, the following group definitions are equivalent.
+
+<pre><code lang="yaml">groups:
+  text:
+    properties:
+      - font
+      - font-size
+      - font-family
+      - font-style
+  text_two:
+    properties:
+      - font*</code></pre>
+
+Naturally, you might want to use this functionality carefully…
+
+h4. Overriding defaults
+
+In some cases, you may wish to override the default linting options. This can be done by adding the appropriate option to the group hash:
+
+<pre><code lang="yaml">groups:
+  tables:
+    max_no_space: 1
+    properties:
+      - table-layout
+      - border-collapse
+      - empty-cells</code></pre>
+
+This defines a @tables@ group as earlier, but requires a space around it at all times.
+
+h2. Why?
+
+I’ve written a "blog post":https://jonpearse.net/articles/2016/07/on-linting-and-bringing-order-to-sass about this, but the short version is that I really don’t get on with SCSS-Lint’s default @PropertySortOrder@ linter =)
+
+h2. Version History
+
+h3. 1.1.2 _(March 18th, 2017)_
+
+* eventually pushing this up to RubyGems
+
+h3. 1.1.1 _(July 15th, 2016)_
+
+* fixing dumb typoes in the readme
+
+h3. 1.1.0 _(July 15th, 2016)_
+
+* improved hint messages to be somewhat more useful to the average developer
+
+h3. 1.0.0 _(June 12th, 2016)_
+
+* initial release
+
+h2. Mandatory sales pitch
+
+When I’m not hacking at random things, I’m a freelance web developer specialising in all things front-end, based in the beautiful city of Cardiff, UK.
+I’m usually kept fairly busy with project work, but I’m always on the lookout for new people to do cool stuff with. "Drop me a line":mailto:hello@jonpearse.net – I’d love to hear from you!

data/Rakefile

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

data/data/concentric.yaml

@@ -0,0 +1,82 @@
+# Concentric CSS [ http://rhodesmill.org/brandon/2011/concentric-css/ ]
+#
+# This is roughly based on SCSS-Lint‘s specification, found at
+# [ https://github.com/brigade/scss-lint/blob/master/data/property-sort-orders/concentric.txt ]
+groups:
+  directions:
+    - display
+    - position
+    - top
+    - right
+    - bottom
+    - left
+
+  columns:
+    - columns
+    - column*
+
+  float:
+    - float
+    - clear
+
+  transform:
+    - transform*
+    - transition
+    - animation*
+
+  visibility:
+    - visibility
+    - opacity
+    - z-index
+
+  box:
+    - margin*
+    - outline
+    - border
+    - border-style
+    - border-color
+    - border-radius
+    - border-width
+    - border-image
+    - border-top*
+    - border-right*
+    - border-bottom*
+    - border-left*
+    - box-shadow
+    - background*
+    - cursor
+    - padding*
+
+  dimensions:
+    - width
+    - min-width
+    - max-width
+    - height
+    - min-height
+    - max-height
+    - overflow*
+
+  lists:
+    - list-style*
+
+  tables:
+    - caption-side
+    - table-layout
+    - border-collapse
+    - border-spacing
+    - empty-cells
+
+  content:
+    - vertical-align
+    - text*
+    - line-height
+    - word-spacing
+    - letter-spacing
+    - white-space
+    - color
+    - font*
+
+  generated:
+    - content
+    - quotes
+    - counter*  # it strikes me that this should be in lists, but it’s generated, so…

data/data/grouped-smacss.yaml

@@ -0,0 +1,151 @@
+# This is a variation on SMACSS that specifies a more granular grouping of properties, rather than the five Jonathan
+# Snook proposes. YMMV =)
+groups:
+  box-position:
+    - display
+    - position
+    - top
+    - right
+    - bottom
+    - left
+
+  flex:
+    - flex
+    - flex-basis
+    - flex-direction
+    - flex-flow
+    - flex-grow
+    - flex-shrink
+    - flex-wrap
+    - align-content
+    - align-items
+    - align-self
+    - justify-content
+    - order
+
+  box-dimensions:
+    - width
+    - min-width
+    - max-width
+    - height
+    - min-height
+    - max-height
+    - margin
+    - margin-top
+    - margin-right
+    - margin-bottom
+    - margin-left
+    - padding
+    - padding-top
+    - padding-right
+    - padding-bottom
+    - padding-left
+
+  float:
+    - float
+    - clear
+    - clip
+
+  columns:
+    - columns
+    - column-gap
+    - column-fill
+    - column-rule
+    - column-span
+    - column-count
+    - column-width
+
+  transform:
+    - transform
+    - transform-box
+    - transform-origin
+    - transform-style
+
+  transition:
+    - transition
+    - transition-delay
+    - transition-duration
+    - transition-property
+    - transition-timing-function
+
+  border:
+    - border
+    - border-top
+    - border-right
+    - border-bottom
+    - border-left
+    - border-width
+    - border-top-width
+    - border-right-width
+    - border-bottom-width
+    - border-left-width
+    - border-style
+    - border-top-style
+    - border-right-style
+    - border-bottom-style
+    - border-left-style
+    - border-radius
+    - border-top-left-radius
+    - border-top-right-radius
+    - border-bottom-left-radius
+    - border-bottom-right-radius
+    - border-color
+    - border-top-color
+    - border-right-color
+    - border-bottom-color
+    - border-left-color
+    - outline
+    - outline-color
+    - outline-offset
+    - outline-style
+    - outline-width
+
+  background:
+    - background
+    - background-attachment
+    - background-clip
+    - background-color
+    - background-image
+    - background-repeat
+    - background-position
+    - background-size
+
+  text:
+    - color
+    - font
+    - font-family
+    - font-size
+    - font-smoothing
+    - font-style
+    - font-variant
+    - font-weight
+    - letter-spacing
+    - line-height
+    - list-style
+    - text-align
+    - text-decoration
+    - text-indent
+    - text-overflow
+    - text-rendering
+    - text-shadow
+    - text-transform
+    - text-wrap
+    - white-space
+    - word-spacing
+
+  other:
+    - border-collapse
+    - border-spacing
+    - box-shadow
+    - caption-side
+    - content
+    - cursor
+    - empty-cells
+    - opacity
+    - overflow
+    - quotes
+    - speak
+    - table-layout
+    - vertical-align
+    - visibility
+    - z-index

data/data/personal.yaml

@@ -0,0 +1,100 @@
+# This is my own personal preference, included [a] to make my life easier, and [b] in case anyone is interested.
+#
+# Note that this is very much an ongoing process and may change at any time as I tweak and change things. Let me know
+# what you think!
+groups:
+  display:
+    properties:
+      - position
+      - display
+      - visibility
+      - overflow*
+      - float
+      - clear
+      - content
+      - box-sizing
+
+  flex-parent:
+    properties:
+      - flex-direction
+      - flex-wrap
+      - flex-flow
+      - justify-content
+      - align-items
+      - align-content
+
+  flex-child:
+    properties:
+      - flex
+      - order
+      - flex-grow
+      - flex-shrink
+      - flex-basis
+      - align-self
+
+  tables:
+    max_no_space: 1
+    properties:
+      - table-layout
+      - border-collapse
+      - empty-cells
+
+  dimensional:
+    properties:
+      - top
+      - left
+      - bottom
+      - right
+      - height
+      - min-height
+      - max-height
+      - width
+      - min-width
+      - max-width
+      - padding*
+      - margin*
+      - transform
+
+  presentational:
+    properties:
+      - outline*
+      - border
+      - border-style
+      - border-color
+      - border-radius
+      - border-width
+      - border-image
+      - border-top*
+      - border-right*
+      - border-bottom*
+      - border-left*
+      - background*
+      - opacity
+      - z-index
+      - color
+      - box-shadow
+      - filter
+
+  lists:
+    space_around: false
+    properties:
+      - counter*
+      - list-style*
+
+  text:
+    properties:
+      - font*
+      - line-height
+      - letter-spacing
+      - text-align
+      - text-decoration
+      - text-indent
+      - text-transform
+      - text-shadow
+      - white-space
+      - content
+      
+  interaction:
+    properties:
+      - transition
+      - animation

data/data/smacss.yaml

@@ -0,0 +1,142 @@
+# Note: whilst SMACSS defines groups, it doesn’t seem overly fussy about the order of properties within those groups.
+#       I could enforce some kind of subgrouping, but… that‘s not what SMACSS says and I don’t want to enforce something
+#       non-standard.
+#
+#       You may wish to adapt this style to your own personal tastes =)
+groups:
+  box:
+    - display
+    - position
+    - top
+    - right
+    - bottom
+    - left
+    - flex
+    - flex-basis
+    - flex-direction
+    - flex-flow
+    - flex-grow
+    - flex-shrink
+    - flex-wrap
+    - align-content
+    - align-items
+    - align-self
+    - justify-content
+    - order
+    - width
+    - min-width
+    - max-width
+    - height
+    - min-height
+    - max-height
+    - margin
+    - margin-top
+    - margin-right
+    - margin-bottom
+    - margin-left
+    - padding
+    - padding-top
+    - padding-right
+    - padding-bottom
+    - padding-left
+    - float
+    - clear
+    - clip
+    - columns
+    - column-gap
+    - column-fill
+    - column-rule
+    - column-span
+    - column-count
+    - column-width
+    - transform
+    - transform-box
+    - transform-origin
+    - transform-style
+    - transition
+    - transition-delay
+    - transition-duration
+    - transition-property
+    - transition-timing-function
+
+  border:
+    - border
+    - border-top
+    - border-right
+    - border-bottom
+    - border-left
+    - border-width
+    - border-top-width
+    - border-right-width
+    - border-bottom-width
+    - border-left-width
+    - border-style
+    - border-top-style
+    - border-right-style
+    - border-bottom-style
+    - border-left-style
+    - border-radius
+    - border-top-left-radius
+    - border-top-right-radius
+    - border-bottom-left-radius
+    - border-bottom-right-radius
+    - border-color
+    - border-top-color
+    - border-right-color
+    - border-bottom-color
+    - border-left-color
+    - outline
+    - outline-color
+    - outline-offset
+    - outline-style
+    - outline-width
+
+  background:
+    - background
+    - background-attachment
+    - background-clip
+    - background-color
+    - background-image
+    - background-repeat
+    - background-position
+    - background-size
+
+  text:
+    - color
+    - font
+    - font-family
+    - font-size
+    - font-smoothing
+    - font-style
+    - font-variant
+    - font-weight
+    - letter-spacing
+    - line-height
+    - list-style
+    - text-align
+    - text-decoration
+    - text-indent
+    - text-overflow
+    - text-rendering
+    - text-shadow
+    - text-transform
+    - text-wrap
+    - white-space
+    - word-spacing
+
+  other:
+    - border-collapse
+    - border-spacing
+    - box-shadow
+    - caption-side
+    - content
+    - cursor
+    - empty-cells
+    - opacity
+    - overflow
+    - quotes
+    - speak
+    - table-layout
+    - vertical-align
+    - visibility
+    - z-index

data/grouped_property_scss_linter.gemspec

@@ -0,0 +1,23 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'grouped_property_scss_linter/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "grouped_property_scss_linter"
+  spec.version       = GroupedPropertyScssLinter::VERSION
+  spec.authors       = ["Jon Pearse"]
+  spec.email         = ["jon@jonpearse.net"]
+  spec.summary       = "SCSS Lint plugin"
+  spec.description   = "Plugin for SCSS lint that lints the order of properties based on fuzzy groups"
+  spec.homepage      = "https://github.com/jonpearse/grouped_property_scss_linter"
+  spec.license       = "MIT"
+
+  spec.files         = `git ls-files -z`.split("\x0")
+  spec.require_paths = ["lib"]
+
+  spec.add_development_dependency "bundler", "~> 1.6"
+  spec.add_development_dependency "rake", '~> 0'
+
+  spec.add_dependency 'scss_lint', '~> 0'
+end

data/lib/ext/string.rb

@@ -0,0 +1,9 @@
+class String
+
+  def bold
+
+    "\e[1m#{self}\e[0m"
+
+  end
+
+end

data/lib/grouped_property_scss_linter.rb

@@ -0,0 +1,9 @@
+require "grouped_property_scss_linter/version"
+require "grouped_property_scss_linter/grouped_property_order"
+require "ext/string"
+
+module GroupedPropertyScssLinter
+
+  STYLES_DIR = File.realpath(File.join(File.dirname(__FILE__), '..', 'data')).freeze
+
+end

data/lib/grouped_property_scss_linter/grouped_property_order.rb

@@ -0,0 +1,310 @@
+module SCSSLint
+  class Linter::GroupedPropertyOrder < Linter
+    include LinterRegistry
+
+    # Called when the linter is fired up on a document. Acts as a pseudo-constructor
+    def visit_root( node )
+
+      # get configured order
+      @configured_groups = get_order_from_conf
+
+      # and map things around
+      @groups = []
+      @property_to_group = {}
+      count = 0
+      @configured_groups.each_pair do |name, group|
+        @groups.push name
+        group['properties'].each do |property|
+          @property_to_group[property] = { name: name, idx: count }
+        end
+        count = count+1
+      end
+
+      yield
+
+    end
+
+    # Logic that actually performs order
+    def check_order( node )
+
+      # 1. get a list of properties we can sort
+      sortable_properties = node.children.select do |child|
+        child.is_a? Sass::Tree::PropNode
+      end
+
+      # 2. group things
+      grouped_properties = {}
+      props = sortable_properties.map do |prop|
+
+        # simplify the name a little
+        name = prop.name.join
+
+        # attempt to match the name
+        group = find_match_for_property name
+
+        # if it didn’t find anything, move on
+        next if group.nil?
+
+        # if there’s no existing group
+        unless grouped_properties.key? group[:name]
+          grouped_properties[group[:name]] = { first: 1.0/0, last: 0, props: [] }
+        end
+
+        # build a concat
+        concat = { name: name, node: prop, group: group[:name], line: prop.line, group_idx: group[:idx] }
+
+        # drop things on
+        grouped_properties[group[:name]][:first] = [grouped_properties[group[:name]][:first], prop.line].min
+        grouped_properties[group[:name]][:last]  = [grouped_properties[group[:name]][:last],  prop.line].max
+        grouped_properties[group[:name]][:props] << concat
+
+        concat
+
+      end
+      props.compact!
+
+      # 3. call down
+      unless grouped_properties.empty?
+        check_sort_order props, grouped_properties
+      end
+
+      # 4. yield so we can process children
+      yield
+
+    end
+
+    # alias things out
+    alias visit_media check_order
+    alias visit_mixin check_order
+    alias visit_rule  check_order
+    alias visit_prop  check_order
+
+    def visit_if(node, &block)
+      check_order(node, &block)
+      visit(node.else) if node.else
+    end
+
+    private
+
+      # Acquires configuration and populates out a group array
+      def get_order_from_conf
+
+        # 1. acquire defaults + default them, just in case
+        defaults = config['defaults']
+        defaults['space_around']     |= true
+        defaults['max_no_space']     |= 3
+
+        # 2, acquire groups
+        groups = config['groups'] || load_groups_from_style
+
+        # 3. if it failed, bail
+        raise 'No groups configured' if groups.nil?
+
+        # 4. munge
+        groups.update(groups) do |name, group|
+
+          # a. if it’s an array, cast it
+          group = { 'properties' => group } if group.is_a? Array
+
+          # b. merge in some defaults
+          group['space_around'] = defaults['space_around'] if group['space_around'].nil?
+          group['max_no_space'] ||= defaults['max_no_space']
+
+          # c. return
+          group
+
+        end
+
+        groups
+
+      end
+
+      # Loads a group from a configured style
+      def load_groups_from_style
+
+        # 0. if the style is blank/empty…
+        (raise 'No style specified' and return) if config['style'].empty?
+
+        # 1. attempt to find the file
+        data_filename = File.join(GroupedPropertyScssLinter::STYLES_DIR, "#{config['style']}.yaml")
+
+        # 2. does it exist
+        (raise "No style ‘#{config['style']}’ found" and return) unless File.exists? data_filename
+
+        # 3. can we read it
+        (raise "Cannot read style ‘#{config['style']}’" and return) unless File.readable? data_filename
+
+        # 4. open
+        style_config = YAML.load_file data_filename
+
+        # 5. barf?
+        (raise "Bad style file found for ‘#{config['style']}’" and return) if style_config.nil? or style_config['groups'].nil?
+
+        style_config['groups']
+      end
+
+      # Finds a matching group for a specified property
+      def find_match_for_property( prop )
+
+        # sanitise the name by removing any browser prefixes
+        prop = prop.gsub(/^(-\w+(-osx)?-)?/, '')
+
+        # iteratively remove hyphens from the property…
+        while prop =~ /\-/
+
+          # if we know about this property or its splatted variety…
+          if @property_to_group.key? prop or @property_to_group.key? prop+'*'
+
+            return @property_to_group[prop] || @property_to_group[prop+'*']
+
+          end
+
+          prop.gsub! /\-(\w+)$/, ''
+
+        end
+
+        # finally…
+        if @property_to_group.key? prop or @property_to_group.key? prop+'*'
+
+          return @property_to_group[prop] || @property_to_group[prop+'*']
+
+        end
+
+        nil
+
+      end
+
+      def check_sort_order( props, grouped )
+
+        # get stats on grouped version
+        grouped.each_value do |group|
+
+          # number of properties
+          group[:num]   = group[:props].length
+          group[:delta] = group[:last] - group[:first]
+
+        end
+
+        # quick duck-type
+        quick_check_order props, grouped
+
+        # if we’re checking whitespace, do so
+        check_whitespace( grouped ) unless grouped.length < 2
+
+      end
+
+      def quick_check_order( props, grouped )
+
+        current_group = 0
+        good = true
+
+        props.each do |prop|
+
+          # if it’s the current group, move on
+          next if prop[:group] == @groups[current_group]
+
+          # find an index
+          idx = @groups.index prop[:group]
+
+          # if it’s less-than, error out
+          if idx < current_group
+
+            ext = config['extended_hinting'] ? " (assigned group ‘#{prop[:group].bold}’, found group ‘#{@groups[current_group].bold}’)" : ""
+
+            add_lint prop[:node], "property ‘#{prop[:name].bold}’ should be #{hint_text_for(prop, grouped, props)}#{ext}"
+            good = false
+          else
+            current_group = idx
+          end
+
+        end
+
+        good
+
+      end
+
+      def check_whitespace( grouped )
+
+        # get a quick handle on all the groups we’ve found
+        detected_groups = grouped.keys
+
+        # iterate through
+        curr_idx = 0
+        grouped.each_pair do |name, current|
+
+          # get a configuration
+          group_conf = @configured_groups[name]
+
+          # if we don’t care about space, bail
+          (curr_idx += 1 and next) unless group_conf['space_around']
+
+          # similarly, if this group is too small to trigger spacing, bounce
+          (curr_idx += 1 and next)unless current[:props].length > group_conf['max_no_space']
+
+          # set some easy references
+          next_group = detected_groups.length > curr_idx ? grouped[detected_groups[curr_idx + 1]] : nil
+          prev_group = curr_idx > 0 ? grouped[detected_groups[curr_idx - 1]] : nil
+
+          # if there’s something after us, and there’s no space
+          if !next_group.nil? and ((next_group[:first] - current[:last]) < 2)
+
+            # raise a lint error
+            add_lint current[:props].last[:node], "Must be at least one empty line after ‘#{current[:props].last[:name]}’"
+
+            # also, flag the next group so we don’t catch it next time ‘round
+            next_group[:raised] = true
+          end
+
+          # if there’s something before us, and there’s no space…
+          if !prev_group.nil? and ((current[:first] - prev_group[:last]) < 2) and current[:raised].nil?
+
+            # raise a lint error
+            add_lint current[:props].first[:node], "Must be at least one empty line before ‘#{current[:props].first[:name]}’"
+
+          end
+
+          # finally, increment
+          curr_idx += 1
+
+        end
+      end
+
+      def hint_text_for( prop, grouped_props, context )
+
+        # get target group
+        dst_group = prop[:group]
+
+        # if we know about the group…
+        if grouped_props.key? dst_group
+
+          # get the first property of the current group
+          dst_prop = grouped_props[dst_group][:props].first
+
+          # if it’s a different property, return
+          return "after ‘#{dst_prop[:name].bold}’" if dst_prop != prop
+        end
+
+        # either our offending property is the sole member of a group, or it’s very lost… so look for a previous marker
+        curr_idx = prop[:group_idx]
+        while curr_idx > 0
+
+          # decrement and reset
+          curr_idx  = curr_idx - 1
+          dst_group = @groups[curr_idx]
+
+          # look
+          if grouped_props.key? dst_group
+
+            # get the _last_ property of the group
+            dst_prop = grouped_props[dst_group][:props].last
+
+            # and return
+            return "after ‘#{dst_prop[:name].bold}’"
+          end
+        end
+
+        # otherwise, it probably belongs right at the start
+        "before ‘#{context.first[:name].bold}’"
+      end
+  end
+end

data/lib/grouped_property_scss_linter/version.rb

@@ -0,0 +1,3 @@
+module GroupedPropertyScssLinter
+  VERSION = "1.1.3"
+end

metadata

@@ -0,0 +1,102 @@
+--- !ruby/object:Gem::Specification
+name: grouped_property_scss_linter
+version: !ruby/object:Gem::Version
+  version: 1.1.3
+platform: ruby
+authors:
+- Jon Pearse
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2017-03-18 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.6'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.6'
+- !ruby/object:Gem::Dependency
+  name: rake
+  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: scss_lint
+  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: Plugin for SCSS lint that lints the order of properties based on fuzzy
+  groups
+email:
+- jon@jonpearse.net
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".scss-lint.yml"
+- Gemfile
+- LICENSE.txt
+- README.textile
+- Rakefile
+- data/concentric.yaml
+- data/grouped-smacss.yaml
+- data/personal.yaml
+- data/smacss.yaml
+- grouped_property_scss_linter.gemspec
+- lib/ext/string.rb
+- lib/grouped_property_scss_linter.rb
+- lib/grouped_property_scss_linter/grouped_property_order.rb
+- lib/grouped_property_scss_linter/version.rb
+homepage: https://github.com/jonpearse/grouped_property_scss_linter
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.6.10
+signing_key: 
+specification_version: 4
+summary: SCSS Lint plugin
+test_files: []