sassy-strings 0.3.1 → 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+--- 
+SHA1: 
+  data.tar.gz: 02b3446a1c8f82a7ec32e1a909ede9cbbe0de5ea
+  metadata.gz: 7b50362fa0e422988160e83067310698cb54bf64
+SHA512: 
+  data.tar.gz: 68b5c52349aa162c63c7a12526d5aab7db675daa3c62aa6213049b28133ef5416a95b1c0ac7c8fd89952c5c4faa14e845e35bf77e21b8033ee98c155c631b95c
+  metadata.gz: fe9217daa156966b5956e1d6febbd7283212b338a7f9249585da9971b02864edb1e2d060b961f4fd912d82b64aa229f170287e17e91b7bf485903e6479cc2de5

data/lib/sassy-strings.rb

@@ -3,14 +3,24 @@ Compass::Frameworks.register("sassy-strings", :path => "#{File.dirname(__FILE__)
 
 # Sassy String Functions
 module Sass::Script::Functions
-  # Replace String
-  def str_replace(needle, replace, haystack)
-    result = haystack.value.to_s.gsub(needle.value.to_s, replace.value.to_s)
-    Sass::Script::String.new(result)
+  # Split a string into a list using a given key
+  #
+  # @return [Sass::Script::List]
+  # @raise [ArgumentError] if `string` isn't a string
+  # @raise [ArgumentError] if `key` isn't a key
+  # @example
+  #   split-string('Hello World', ' ') => ('Hello', 'World')
+  #   str-split('Hello World', ' ') => ('Hello', 'World')
+  def split_string(string, key)
+    items = string.value.split(key.value)
+    if items.count == 1
+      Sass::Script::Bool.new(false)
+    else
+      Sass::Script::List.new(items.map{|i| Sass::Script::String.new(i)}, :comma)
+    end
   end
 
-  # Split String
-  def split_string(string, key)
+  def str_split(string, key)
     items = string.value.split(key.value)
     if items.count == 1
       Sass::Script::Bool.new(false)
@@ -19,7 +29,17 @@ module Sass::Script::Functions
     end
   end
 
-  # String Position
+  declare :split_string, [:string, :key]
+  declare :str_split, [:string, :key]
+
+  # Find the position of a substring within a string
+  #
+  # @return [Sass::Script::Number]
+  # @raise [ArgumentError] if `needle` isn't a string
+  # @raise [ArgumentError] if `haystack` isn't a key
+  # @example
+  #   str-pos('ello', 'hello') => 1
+  #   str-pos('a', 'hello') => -1
   def str_pos(needle, haystack)
     if haystack.value.to_s.index(needle.value.to_s)
       Sass::Script::Number.new(haystack.value.to_s.index(needle.value.to_s))
@@ -28,6 +48,8 @@ module Sass::Script::Functions
     end
   end
 
+  declare :str_pos, [:needle, :haystack]
+
   # Converts a String to a Number
   def str_to_number(string)
     result = Sass::Script::Parser.parse(string.value, string.line || 0, 0)
@@ -39,11 +61,166 @@ module Sass::Script::Functions
     end
   end
 
+  declare :str_split, [:string, :key]
+
+  # Returns the number of characters in a string.
+  #
+  # @return [Sass::Script::Number]
+  # @raise [ArgumentError] if `string` isn't a string
+  # @example
+  #   str-length("foo") => 3
+  def str_length(string)
+    assert_type string, :String
+    Sass::Script::Number.new(string.value.size)
+  end
+  declare :str_length, [:string]
+
+  # inserts a string into another string
+  #
+  # Inserts the `insert` string before the character at the given index.
+  # Negative indices count from the end of the string.
+  # The inserted string will starts at the given index.
+  #
+  # @return [Sass::Script::String]
+  # @raise [ArgumentError] if `original` isn't a string, `insert` isn't a string, or `index` isn't a number.
+  # @example
+  #   str-insert("abcd", "X", 1) => "Xabcd"
+  #   str-insert("abcd", "X", 4) => "abcXd"
+  #   str-insert("abcd", "X", 100) => "abcdX"
+  #   str-insert("abcd", "X", -100) => "Xabcd"
+  #   str-insert("abcd", "X", -4) => "aXbcd"
+  #   str-insert("abcd", "X", -1) => "abcdX"
+  def str_insert(original, insert, index)
+    assert_type original, :String
+    assert_type insert, :String
+    assert_type index, :Number
+    unless index.unitless?
+      raise ArgumentError.new("#{index.inspect} is not a unitless number")
+    end
+    insertion_point = index.value > 0 ? [index.value - 1, original.value.size].min : [index.value, -original.value.size - 1].max
+    Sass::Script::String.new(original.value.dup.insert(insertion_point, insert.value), original.type)
+  end
+  declare :str_insert, [:original, :insert, :index]
+
+  # A SASS Wrapper Function for Ruby's gsub method
+  #
+  # @return [Sass::Script::String]
+
+  # @example
+  #   str_replace(abcd, a, zzz)  => zzzbcd
+
+  def str_replace(string, find, replace)
+    assert_type string, :String
+    assert_type replace, :String
+    Sass::Script::String.new(string.value.gsub(find.value,replace.value), string.type)
+  end
+  declare :str_replace, [:string, :find, :replace]
+
+  # Starting at the left, finds the index of the first location
+  # where `substring` is found in `string`.
+  #
+  # @return [Sass::Script::String]
+  # @raise [ArgumentError] if `original` isn't a string, `insert` isn't a string, or `index` isn't a number.
+  # @example
+  #   str-index(abcd, a)  => 1
+  #   str-index(abcd, ab) => 1
+  #   str-index(abcd, X)  => 0
+  #   str-index(abcd, c)  => 3
+
+  def str_index(string, substring)
+    assert_type string, :String
+    assert_type substring, :String
+    index = string.value.index(substring.value) || -1
+    Sass::Script::Number.new(index + 1)
+  end
+  declare :str_index, [:string, :substring]
+
+
+
+  # Extract a substring from `string` from `start` index to `end` index.
+  #
+  # @return [Sass::Script::String]
+  # @raise [ArgumentError] if `string` isn't a string or `start` and `end` aren't unitless numbers
+  # @example
+  #  str-extract(abcd,2,3)    => bc
+  #  str-extract(abcd,2)      => cd
+  #  str-extract(abcd,-2)     => abc
+  #  str-extract(abcd,2,-2)   => bc
+  #  str-extract(abcd,3,-3)   => unquote("")
+  #  str-extract("abcd",3,-3) => ""
+  #  str-extract(abcd,1,1)    => a
+  #  str-extract(abcd,1,2)    => ab
+  #  str-extract(abcd,1,4)    => abcd
+  #  str-extract(abcd,-100,4) => abcd
+  #  str-extract(abcd,1,100)  => abcd
+  #  str-extract(abcd,2,1)    => unquote("")
+  #  str-extract("abcd",2,3)  => "bc"
+  def str_extract(string, start_at, end_at = nil)
+    assert_type string, :String
+    assert_type start_at, :Number
+    unless start_at.unitless?
+      raise ArgumentError.new("#{start_at.inspect} is not a unitless number")
+    end
+    if end_at.nil?
+      if start_at.value < 0
+        end_at = start_at
+        start_at = Sass::Script::Number.new(1)
+      else
+        end_at = Sass::Script::Number.new(-1)
+      end
+    end
+    assert_type end_at, :Number
+    unless end_at.unitless?
+      raise ArgumentError.new("#{end_at.inspect} is not a unitless number")
+    end
+    s = start_at.value > 0 ? start_at.value - 1 : start_at.value
+    e = end_at.value > 0 ? end_at.value - 1 : end_at.value
+    extracted = string.value.slice(s..e)
+    Sass::Script::String.new(extracted || "", string.type)
+  end
+  declare :str_index, [:string, :start, :end]
+  # Convert a string to upper case
+  #
+  # @return [Sass::Script::String]
+  # @raise [ArgumentError] if `string` isn't a string
+  # @example
+  #   to-upper-case(abcd) => ABCD
+  #   to-upper-case("abcd") => "ABCD"
+  def to_upper_case(string)
+    assert_type string, :String
+    Sass::Script::String.new(string.value.upcase, string.type)
+  end
+
+  def to_uppercase(string)
+    assert_type string, :String
+    Sass::Script::String.new(string.value.upcase, string.type)
+  end
+  declare :to_upper_case, [:string]
+  declare :to_uppercase, [:string]
+
+  # Convert a string to lower case
+  #
+  # @return [Sass::Script::String]
+  # @raise [ArgumentError] if `string` isn't a string
+  # @example
+  #   to-lower-case(ABCD) => abcd
+  #   to-lower-case("ABCD") => "abcd"
+  def to_lower_case(string)
+    assert_type string, :String
+    Sass::Script::String.new(string.value.downcase, string.type)
+  end
+  def to_lowercase(string)
+    assert_type string, :String
+    Sass::Script::String.new(string.value.downcase, string.type)
+  end
+  declare :to_lower_case, [:string]
+  declare :to_lowercase, [:string]
+
 end
 
 module SassyStrings
 
-  VERSION = "0.3.1"
-  DATE = "2013-01-23"
+  VERSION = "1.0.0"
+  DATE = "2013-08-16"
 
 end

metadata

@@ -1,12 +1,7 @@
 --- !ruby/object:Gem::Specification 
 name: sassy-strings
 version: !ruby/object:Gem::Version 
-  prerelease: false
-  segments: 
-  - 0
-  - 3
-  - 1
-  version: 0.3.1
+  version: 1.0.0
 platform: ruby
 authors: 
 - Sam Richard
@@ -14,8 +9,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2013-01-23 00:00:00 -05:00
-default_executable: 
+date: 2013-08-16 00:00:00 Z
 dependencies: 
 - !ruby/object:Gem::Dependency 
   name: compass
@@ -24,10 +18,6 @@ dependencies:
     requirements: 
     - - ">="
       - !ruby/object:Gem::Version 
-        segments: 
-        - 0
-        - 12
-        - 2
         version: 0.12.2
   type: :runtime
   version_requirements: *id001
@@ -42,9 +32,10 @@ extra_rdoc_files: []
 
 files: 
 - lib/sassy-strings.rb
-has_rdoc: true
 homepage: https://github.com/snugug/sassy-strings
-licenses: []
+licenses: 
+- MIT
+metadata: {}
 
 post_install_message: 
 rdoc_options: []
@@ -55,23 +46,18 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements: 
   - - ">="
     - !ruby/object:Gem::Version 
-      segments: 
-      - 0
       version: "0"
 required_rubygems_version: !ruby/object:Gem::Requirement 
   requirements: 
   - - ">="
     - !ruby/object:Gem::Version 
-      segments: 
-      - 1
-      - 2
       version: "1.2"
 requirements: []
 
 rubyforge_project: sassy-strings
-rubygems_version: 1.3.6
+rubygems_version: 2.0.3
 signing_key: 
-specification_version: 3
+specification_version: 4
 summary: Advanced String handling for Sass
 test_files: []