Sassy
Sassy eases the pain for object-oriented programmers and makes getting around in SASS a little easier.
Overview
Sassy provides some essential functionality and makes working with maps much easier.
It also includes a debugging utility for unit-testing (see notes at the bottom).
Methods:
- get
- set
- has
- compare
- type
- types
- types-same
- contains
- explode
- implode
- thru
- apply
- increase
- decrease
Method Uses:
@note All methods that use a ( map, key, ... ) signature allow for nested maps using a key list!
######Signatures and Supported Types
Signature:
- get( map, key )
- get( map, ( nested, key ) )
Supported types: map
######Signatures and Supported Types
Signature:
- set( map, key, value )
- set( map, ( nested, key ), value )
@note Remember SASS objects are immutable. Replace your map reference each time!
Supported types: map
######Signatures and Supported Types
Signature: has( map, key, [return], [default] )
Optional default value IF NO KEY (otherwise returns null).
Supported types: map
######Signatures and Supported Types
Signature: compare( A, B )
Supported types: any
######Signatures and Supported Types
Signature: type( var, [against] )
Supported types: any
######Signatures and Supported Types
Signature: types ( varN... )
Supported types: any
######Signatures and Supported Types
Signature: types-same ( varN... )
Supported types: any
######Signatures and Supported Types
Signature: contains( haystack, needle )
Supported types: map, list, string
######Signatures and Supported Types
Signature: explode( string, [delimiter='-'] )
Supported types: string
######Signatures and Supported Types
Signature: implode( list, [wrap=false], [glue=', '] )
@note wrap is optional. if true, adds ( ) to string before returning
Supported types: list
######Signatures and Supported Types
Signature: thru( any )
Supported types: any
######Signatures and Supported Types
Signature: print( map )
Supported types: map
######Signatures and Supported Types
Signature:
- apply( method_name, argslist... )
- apply( method_name, ( list, of, args ) )
- apply( method_name, argsmap )
Supported types: function
######Signatures and Supported Types
Signature:
- increase( number, [x=1] )
- increase( map, key, [x=1] )
Supported types: number, map with number as value to a key
######Signatures and Supported Types
Signature:
- decrease( number, [x=1] )
- decrease( map, key, [x=1] )
Supported types: number, map with number as value to a key
######Signatures and Supported Types
Signature: pluck( key, maps.. )
@note also accepts a list of maps
Supported types: map
Sassy Debugger
I put together a SASS debug utility based loosely on my much more robust JS debugger.
There are only 3 mixins you need (really only "test", but it's better to use all 3).
######Signatures and Supported Types
Signature: @include start(debug_name)
######Signatures and Supported Types
Signature:
- @include test( method_name, arguments, [expect=true] )
- @include test( name, result, [expect=true] )
You should always use a list of arguments instead of a result boolean.
The result boolean option is there for edge cases where comparing the result isn't so easy.
If you need to pass a single list, use an argsmap
( args: ( your, list ) )
You can add a variation string as the 4th parameter. Useful if debugging similar signatures.
Mixin: complete
reports a summary of pass/fail
@note fire this after all of your tests. it will tell you that all tests passed or which ones failed (and why).
--
That's all! Enjoy the software!