sassy-maps 0.3.2 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 8ce9e65eba8234ecc2b838fe86c862f767912825
-  data.tar.gz: 022e2d453f1dbaafe0645b3f1bc3b53d617d7bcd
+  metadata.gz: a09115491f465ef31bdbdaf51958e73c1811e44d
+  data.tar.gz: f0fccd177b07e76cacfb062303fc89226a609205
 SHA512:
-  metadata.gz: b7ab3cbabcfec2ef7504668e8948f9355b302d4ced2b65831200ee68ecec6f7ad8e661709b1ec551d131a3071b9a3e0e849e46e099843c0c6c39175cbaaee413
-  data.tar.gz: 0f76c8eaf043c90f1de57d5df18c8f08fda244d2c571d3839693efb15d5d6836ac3a46685413ee675121299acad936da075ec06049f62075ca0239bcff9ca388
+  metadata.gz: cd9ba6823061386181e086974dcee7b2ab5c6207a40dae43bf6187a9ae421b8c3a6e97753166eb8be6e9572aced6341bd7d1b091d82061456c47bcee11d042e1
+  data.tar.gz: 0e050fceb37f48c761f949b98ba7f8f1fc79840d676d999bef792399fbdb41402b4b385fc042bfbdc360ea8d0640897a905e0c5ffa9967529c535c31df5366fa

data/README.md

@@ -0,0 +1,100 @@
+# Sassy Maps [![Gem Version](https://badge.fury.io/rb/sassy-maps.png)](http://badge.fury.io/rb/sassy-maps) [![Build Status](https://travis-ci.org/Team-Sass/Sassy-Maps.png?branch=0.x.x)](https://travis-ci.org/Team-Sass/Sassy-Maps)
+Sassy Maps adds a variety of functions aimed at helping you work with Sass 3.3 maps much easier.
+
+## Table of Contents
+
+1. [Requirements](#requirements)
+2. [Installation](#installation)
+3. [Using Sassy Maps](#using-sassy-maps)
+4. [Functions](#functions)
+5. [Optional Modules](#optional-modules)
+	* [Memo](#memo)
+
+## Requirements
+
+Sassy Maps is a Sass extension, so you're going to need Sass installed. If you do not already have Sass installed, please read [Install Sass](http://sass-lang.com/install). Sassy Maps 0.3.x requires *Sass 3.3.0* or higher.
+
+**It is HIGHLY RECOMMENDED that you run all Sass (or Compass if using it) commands through [Bundler](http://bundler.io/)**
+
+If the compiler you are using is not compatible with the above minimum versions, it will not compile correctly.
+
+**BE AWARE that CodeKit and most other GUI compilers *do not support Bundler* and are therefore NOT RECOMMENDED**
+
+## Installation
+
+The preferred way to install and use Sassy Maps is through Bundler. To do so, add the following to your Gemfile (Sass provided to ensure the correct versions are used):
+
+```ruby
+gem "sass", "~>3.3.0"
+gem "sassy-maps", "~>0.3.2"
+```
+
+Once you have done so, run `bundle install` to install your dependencies, and remember to run all of your compilation through `bundle exec`.
+
+You can also install Sassy Maps through [Bower](http://bower.io/) as it has no Ruby requirements. To do so, run the following command:
+
+```bash
+bower install sassy-maps --save-dev
+```
+
+*BE AWARE* that while you can install Sassy Maps through Bower, Sassy Maps still only works with Sass compilers that have full compatibility with Sass 3.3.x and greater. If using Compass, you are also going to need to add the folder using Compass's [`add_import_path`](http://compass-style.org/help/tutorials/configuration-reference/) config option instead of the standard `require`.
+
+## Using Sassy Maps
+
+If you already have a project made and you'd like to use Sassy Maps with it, add the following to your `config.rb` file:
+
+`require 'sassy-maps'`
+
+Then, add the following to your Sass file towards the top:
+
+`@import "sassy-maps";`
+
+## Functions
+
+* `map-get-deep($map, $keys...)` - Returns the value of the final item in `$keys` from the map `$map`. Will return `null` if no value is present and will warn of errors in search (such as if an intermediate depth is `null` or not a `map`).
+* `map-set($map, $key, $value)` - Returns a map that has the `$key` in `$map` set to the to given `$value`.
+* `map-set-deep($map, $keys, $value)` - Returns a map that has the `$key` in `$map` set to the given `$value`. `$key` should be single-depth list of keys, for instance `map-set-deep($map, ('foo' 'bar' 'baz'), "Hello World")`.
+* `map-to-string($map)` - Returns a string representation of the given `$map`.
+
+
+## Optional Modules
+
+Sassy Maps comes with optional modules that extend upon the base functionality of Sassy Maps to provide additional map-based functionality. The following are optional modules available with Sassy Maps:
+
+* [Memo](#memo)
+
+### Memo
+
+Memo is a [Memoization](http://en.wikipedia.org/wiki/Memoization) framework for Sass. Designed with framework developers in mind, it makes it easy to store and retrieve the output of functions quickly and easily without needing to run the function again. For complex functions this should greatly speed up overall compilation time for repeat function calls with identical input.
+
+To use Memo, simply include `@import "memo";` and you're good to go (normal [Sassy Maps installation](#installation) still applies). Memo comes with two functions:
+
+* `memo-set($module, $key, $value)` - Sets a memoization `$key` to the given `$value` for the prescribed `$module` (framework). The function will return `true`. Also available as a mixin (`@include memo-set($module, $key, $value)`).
+* `memo-get($module, $key)` - Returns the value of the memoization `$key` for the prescribed `$module`.
+
+Using Memo is fairly simple, just check to see if there is a memoization value for your key (and it's not `null`); if there is, return that, if not, run through the function, set the memoization, and return that result. The following example stores whether Memo is available in a variable and uses the function name as the memoization module, but if building a framework such as [Breakpoint](http://github.com/team-sass/breakpoint), that framework should be the name of the memoization module.
+
+```scss
+$Memo-Exists: function-exists(memo-get) and function-exists(memo-set);
+
+@function percentage($target, $context) {
+  @if $Memo-Exists {
+    $result: memo-get(percentage, $target $context);
+
+    @if $result != null {
+      @return $result;
+    }
+  }
+
+  $result: $target / $context * 100%;
+
+  @if $Memo-Exists {
+    $holder: memo-set(percentage, $target $context, $result);
+  }
+
+  @return $result;
+}
+
+$half: percentage(20px, 40px); // No memoization exists, will run through the function
+$half-again: percentage(20px, 40px); // Memoization exists, will just return that result
+```

data/lib/sassy-maps.rb

@@ -1,33 +1,16 @@
-# All gems that are required for this extension to work should go here.
-# These are the requires you would normally put in your config.rb file
-# By default, you should always included Compass. Do not include your
-#  extension.
+require 'sassy-maps/version'
 require 'sass'
-require 'compass'
 
-# This tells Compass what your Compass extension is called, and where to find
-#  its files
-# Replace 'styleguide' with the name of your style guide. Spaces allowed.
-base_directory  = File.join(File.dirname(__FILE__), '..')
-stylesheets_dir = File.join(base_directory, 'stylesheets')
-templates_dir   = File.join(base_directory, 'templates')
-Compass::Frameworks.register('sassy-maps', :stylesheets_directory => stylesheets_dir, :templates_directory => templates_dir)
+sassy_maps_path = File.expand_path('../../sass', __FILE__)
 
-# Version and date of version for your Compass extension.
-# Replace Extemsopm with the name of your style guide
-#  Letters, numbers, and underscores only
-#  Version is a number. If a version contains alphas, it will be created as
-#    a prerelease version
-#  Date is in the form of YYYY-MM-DD
-module SassyMaps
-  VERSION = "0.3.2"
-  DATE = "2014-03-04"
+if (defined? Compass)
+  Compass::Frameworks.register(
+    'sassy-maps',
+    :stylesheets_directory => sassy_maps_path
+  )
+else
+  ENV["SASS_PATH"] = [ENV["SASS_PATH"], sassy_maps_path].compact.join(File::PATH_SEPARATOR)
 end
 
-# This is where any custom SassScript should be placed. The functions will be
-#  available on require of your extension without the need for users to import
-#  any partials. Uncomment below.
-
-# module Sass::Script::Functions
-#
-# end
+module SassyMaps
+end

data/lib/sassy-maps/version.rb

@@ -0,0 +1,4 @@
+module SassyMaps
+  VERSION = "0.4.0"
+  DATE = "2014-06-03"
+end

data/lib/tapout/reporters/navigator_reporter.rb

@@ -0,0 +1,16 @@
+require 'tapout'
+require 'tapout/reporters'
+
+module Tapout
+  module Reporters
+    class NavigatorReporter < RuntimeReporter
+
+      def backtrace_snippets(test)
+        ''
+      end
+
+    end
+  end
+end
+
+Tapout::Reporters.index['navigator'] = Tapout::Reporters::NavigatorReporter

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: sassy-maps
 version: !ruby/object:Gem::Version
-  version: 0.3.2
+  version: 0.4.0
 platform: ruby
 authors:
 - Sam Richard
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2014-03-04 00:00:00.000000000 Z
+date: 2014-06-03 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: sass
@@ -16,28 +16,112 @@ dependencies:
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
-        version: 3.3.0.rc.2
+        version: '3.3'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
-        version: 3.3.0.rc.2
+        version: '3.3'
 - !ruby/object:Gem::Dependency
-  name: compass
+  name: bundler
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - '>='
       - !ruby/object:Gem::Version
-        version: 1.0.0.alpha.13
-  type: :runtime
+        version: '0'
+  type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !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: minitest
+  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: minitap
+  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: tapout
+  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: term-ansicolor
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
       - !ruby/object:Gem::Version
-        version: 1.0.0.alpha.13
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: colorize
+  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'
 description: Map helper functions for Sass 3.3 Maps including get-deep and set/set-deep
 email:
 - sam@snug.ug
@@ -45,13 +129,15 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
+- README.md
+- lib/sassy-maps/version.rb
 - lib/sassy-maps.rb
-- stylesheets/_memo.scss
-- stylesheets/_sassy-maps.scss
-- stylesheets/sassy-maps/_map-get.scss
-- stylesheets/sassy-maps/_map-set.scss
-- stylesheets/sassy-maps/_map-to-string.scss
-- templates/project/Gemfile.txt
+- lib/tapout/reporters/navigator_reporter.rb
+- sass/_memo.scss
+- sass/_sassy-maps.scss
+- sass/sassy-maps/_map-get.scss
+- sass/sassy-maps/_map-set.scss
+- sass/sassy-maps/_map-to-string.scss
 homepage: https://github.com/Snugug/Sassy-Maps
 licenses:
 - MIT
@@ -69,10 +155,10 @@ required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - '>='
     - !ruby/object:Gem::Version
-      version: 1.3.6
+      version: '0'
 requirements: []
 rubyforge_project: sassy-maps
-rubygems_version: 2.0.3
+rubygems_version: 2.0.14
 signing_key: 
 specification_version: 4
 summary: Map helper functions for Sass 3.3 Maps

data/templates/project/Gemfile.txt

@@ -1,13 +0,0 @@
-# Pull gems from RubyGems
-source 'https://rubygems.org'
-
-gem 'sass',               "~> 3.3.0.rc.6"
-gem 'compass',            "~> 1.0.0.alpha.18"
-
-group :test do
-  gem 'rake'
-  gem "diffy", "~> 3.0.1"
-  gem "colorize", "~> 0.6.0"
-end
-
-gem 'Sassy Maps', '~>0.3.2'