sassy-namespaces 0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: f0bdb5ce796b20f153bb162ea5ed7ceb66d0b6dd
+  data.tar.gz: 1430c1505c5843be12216c336237831eacd812fe
+SHA512:
+  metadata.gz: 83fc0385c77870ea40e837395e08a92ee0c5d48f602ac48d0035ac46b1350d4c852d0b23292fed59d38fa6d6d06a6e864b08971736c9e1d087a0165c138dc71f
+  data.tar.gz: 895e57d52677c65180cef5f54a9595a3a58f18d015ef5b94bc1a8b923cd37f604c9b5be59349fe262fe7cae392a18d3860ba70e71a878607fe0e2d9917c3e0b6

data/README.md

@@ -0,0 +1,122 @@
+Sassy Namespaces
+================
+
+Sass 3.3 brought us maps, which are great for organizing related values into groups, but the syntax is a bit tedious. Sassy Namespaces offers pattern for creating and accessing namespaces using Sass maps.
+
+Yes, it's essentially a wrapper around the excellent [Sassy Maps](https://github.com/Team-Sass/Sassy-Maps) extension.
+
+The problem
+-----------
+
+In vanilla Sass, even single-level namespaces are a bit of hassle:
+
+```scss
+$color: ();
+$color: $map-merge($color, (primary: red));
+
+foo {
+  bar: map-get($color, primary); // bar: red
+}
+```
+
+You could define functions/mixins to streamline the process:
+
+```scss
+$color: ();
+
+// Setter
+@mixin set-color($key, $value) {
+  $color: $map-merge($color, ($key: $value));
+}
+
+// Getter
+@function color($key) {
+  @return map-get($color, $key);
+}
+
+@include set-color(primary, red);
+foo {
+  bar: color(primary); // bar: red
+}
+```
+
+But this quickly gets tiresome, especially once you try to create namespaces with more than one level of hierarchy.
+
+Sass namespaces, minus the headaches
+------------------------------------
+
+Here's how you do it with Sassy Namespaces:
+
+```scss
+@include create-namespace(color);
+@include namespace-set(color, primary, red);
+foo {
+  bar: namespace-get(color, primary); // bar: red;
+}
+```
+
+Maps are created and used internally, but you don't ever have to deal with them.
+
+It's still a good idea to create convenience functions/mixins. Pretty straightfoward:
+
+```scss
+@mixin set-color($args...) {
+  @include namespace-set(color, $args...);
+}
+
+@function color($args...) {
+  @return namespace-get(color, $args...);
+}
+
+@include set-color(primary, red);
+foo {
+  bar: color(primary); // bar: red
+}
+```
+
+
+If you want to set multiple values at once, without calling `namespace-set()` over and over, you can pass a map of keys and values (instead of a single key and a single value):
+
+```scss
+$map: (primary: red, secondary: green)
+
+@include namespace-set(color, $map);
+foo {
+  bar: namespace-get(color, primary); // bar: red
+  baz: namespace-get(color, secondary); // baz: green
+}
+```
+
+And, since Sassy Namespaces uses Sassy Maps internally, hierarchical namespaces are free:
+
+```scss
+@include namespace-set(color, text link hover, green);
+foo {
+  bar: namespace-get(color, text link hover); // bar: green
+}
+```
+
+At any time, you can return the underlying namespace map:
+
+```scss
+@include namespace-set(color, primary, red);
+$namespace-1: namespace(color);
+
+@include namespace-set(color, secondary, green);
+$namespace-2: namespace(color);
+
+/*
+  $namespace-1: (
+    color: (
+      primary: red
+    )
+  )
+
+  $namespace-2: (
+    color: (
+      primary: red,
+      secondary: green
+    )
+  )
+*/
+```

data/lib/sassy-namespaces.rb

@@ -0,0 +1,10 @@
+require 'compass'
+require 'sassy-maps'
+
+extension_path = File.expand_path(File.join(File.dirname(__FILE__), ".."))
+Compass::Frameworks.register('SassyNamespaces', :path => extension_path)
+
+module SassyNamespaces
+  VERSION = "0.1"
+  DATE = "2014-03-17"
+end

data/stylesheets/_sassy-maps.scss

@@ -0,0 +1,53 @@
+@import "sassy-maps";
+
+$__sassy-namespaces: ();
+
+@mixin create-namespace($name) {
+  $__sassy-namespaces: map-set($__sassy-namespaces, $name, ());
+}
+
+@function namespace-set($name, $args...) {
+  $length: length($args);
+  $namespace: map-get($__sassy-namespaces, $name);
+  
+  @if length($args) == 1 {
+    @if type-of(nth($args, 1)) == map {
+      $namespace: map-merge($namespace, nth($args, 1));
+    } @else {
+      @warn "Must pass either a map or 2 or more values."
+    }
+  }
+  @else {
+    $keys: nth($args, 1);
+    
+    @if length($keys) == 1 {
+      $namespace: map-set($namespace, $args...);
+    } @else {
+      $namespace: map-set-deep($namespace, $args...);
+    }
+  }
+  
+  $__sassy-namespaces: map-merge($__sassy-namespaces, ($name: $namespace));
+  @return $namespace;
+}
+
+@function namespace-get($name, $args...) {
+  $length: length($args);
+  $namespace: map-get($__sassy-namespaces, $name);
+  
+  @if $length > 0 {
+    $keys: nth($args, 1);
+    
+    @if length($keys) == 1 {
+      @return map-get($namespace, $args...);
+    } @else {
+      @return map-get-deep($namespace, $args...);
+    }
+  } @else {
+    @return $namespace;
+  }
+}
+
+@mixin namespace-set($name, $args...) {
+  $namespace: namespace-set($name, $args...);
+}

metadata

@@ -0,0 +1,88 @@
+--- !ruby/object:Gem::Specification
+name: sassy-namespaces
+version: !ruby/object:Gem::Version
+  version: '0.1'
+platform: ruby
+authors:
+- Andrew Clark
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2014-03-17 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: sass
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '3.3'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '3.3'
+- !ruby/object:Gem::Dependency
+  name: compass
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0.12'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0.12'
+- !ruby/object:Gem::Dependency
+  name: sassy-maps
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.3.2
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.3.2
+description: Namespaces in Sass, minus the headaches.
+email:
+- acdlite@me.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- README.md
+- lib/sassy-namespaces.rb
+- stylesheets/_sassy-maps.scss
+homepage: 
+licenses: []
+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: 1.3.6
+requirements: []
+rubyforge_project: sassy-namespaces
+rubygems_version: 2.2.2
+signing_key: 
+specification_version: 4
+summary: Syntactic sugar for using maps as namespaces.
+test_files: []