Merge pull request #9 from jasonlam604/develop

Release 0.3.0

Author: jasonlam604

rockspec/stringizer-lua-0.3.0-0.rockspec

@@ -0,0 +1,20 @@
+package = "stringizer-lua"
+version = "0.3.0-0"
+source = {
+  url = "git://github.com/jasonlam604/StringizerLua.git"
+}
+description = {
+  summary = "Lua String manipulation made easy!",
+  detailed = [[Handy little string library for string manipulation and checks]],
+  homepage = "https://github.com/jasonlam604/StringizerLua",
+  license = "MIT"
+}
+dependencies = {
+  "lua >= 5.1"
+}
+build = {
+  type = "builtin",
+  modules = {
+    requests = "src/stringizer.lua"
+  }
+}

spec/pad_spec.lua

@@ -0,0 +1,21 @@
+require "busted.runner"()
+
+local Stringizer = require "stringizer"
+
+describe("Stringizer", function()
+  describe("Pad Test", function()
+    
+    it("when left pad 'FizzBuzz' by 15 with - it should be '------Fizz Buzz'", function()
+       assert.equal(Stringizer.pad_left("Fizz Buzz", 15, "-"),"------Fizz Buzz")
+    end)
+
+    it("when right pad 'FizzBuzz' by 15 with - it should be 'Fizz Buzz------'", function()
+       assert.equal(Stringizer.pad_right("Fizz Buzz", 15, "-"),"Fizz Buzz------")
+    end)
+
+    it("should encode ȘŦŗÍñĝìzĕŕߓ to yJjFpsWXw43DscSdw6x6xJXFld+T", function()
+       assert.equal(Stringizer.pad("FizzBuzz", 15, "-"),"---FizzBuzz----")
+    end)
+ 
+  end)
+end)

spec/trim_spec.lua

@@ -0,0 +1,22 @@
+require "busted.runner"()
+
+local Stringizer = require "stringizer"
+
+describe("Stringizer", function()
+  describe("Test Trim", function()
+  
+    it("should trim left of '  Fizz Buzz  ' will result in 'Fizz Buzz  '", function()
+      assert.equal(Stringizer.trim_left("  Fizz Buzz  "),"Fizz Buzz  ")
+    end)
+    
+    
+    it("should trim right of '  Fizz Buzz  ' will result in '  Fizz Buzz'", function()
+      assert.equal(Stringizer.trim_right("  Fizz Buzz  "),"  Fizz Buzz")
+    end)
+    
+    it("should trim left and right of '  Fizz Buzz  ' will result in 'Fizz Buzz'", function()
+      assert.equal(Stringizer.trim("  Fizz Buzz  "),"Fizz Buzz")
+    end)
+ 
+  end)
+end)

spec/url_spec.lua

@@ -0,0 +1,17 @@
+require "busted.runner"()
+
+local Stringizer = require "stringizer"
+
+describe("Stringizer", function()
+  describe("Url Test", function()
+    
+    it("should encode !@#$%^&*()-=_+[]\\{}|;':\",./<>?`~", function()
+       assert.equal(Stringizer.url_encode("!@#$%^&*()-=_+[]\\{}|;':\",./<>?`~"),"%21%40%23%24%25%5E%26%2A%28%29-%3D_%2B%5B%5D%5C%7B%7D%7C%3B%27%3A%22%2C.%2F%3C%3E%3F%60~")
+    end)
+    
+    it("should decode %21%40%23%24%25%5E%26%2A%28%29-%3D_%2B%5B%5D%5C%7B%7D%7C%3B%27%3A%22%2C.%2F%3C%3E%3F%60~", function()
+       assert.equal(Stringizer.url_decode("%21%40%23%24%25%5E%26%2A%28%29-%3D_%2B%5B%5D%5C%7B%7D%7C%3B%27%3A%22%2C.%2F%3C%3E%3F%60~"),"!@#$%^&*()-=_+[]\\{}|;':\",./<>?`~")
+    end)
+ 
+  end)
+end)

src/encoders/url.lua

@@ -0,0 +1,36 @@
+------
+-- Url encoder and decoder
+--- @module encoders.url
+local Url = {}
+
+function Url.new()
+   local self = {}
+
+   -----
+   -- Encode given string 
+   -- @return  encoded value
+   function self.encode(value)      
+      if (value) then
+        value = string.gsub (value, "\n", "\r\n")
+        value = string.gsub (value, "([^%w %-%_%.%~])",
+            function (c) return string.format ("%%%02X", string.byte(c)) end)
+        value = string.gsub (value, " ", "+")
+      end
+    return value 
+   end
+   
+   -----
+   -- Decode encoded string
+   -- @return string
+   function self.decode(value)
+      value = string.gsub (value, "+", " ")
+      value = string.gsub (value, "%%(%x%x)",
+      function(h) return string.char(tonumber(h,16)) end)
+      value = string.gsub (value, "\r\n", "\n")
+      return value   
+   end
+
+   return self   
+end
+
+return Url

src/stringizer.lua

@@ -1,10 +1,15 @@
 -----
 -- Modules
 local Base64 = require ("encoders.base64")
+local Url = require ("encoders.url")
+
 local Container = require ("checkers.container")
+
 local Between = require ("transformers.between")
 local Chop = require ("transformers.chop")
+local Pad = require ("transformers.pad")
 local Parts = require ("transformers.parts")
+local Trim = require ("transformers.trim")
 
 ------
 -- Create the table for the class definition
@@ -116,4 +121,60 @@ function Stringizer.split(value,delimiter)
   return (Parts.new()).split(value, delimiter)
 end
 
+-----
+-- Remove whitespace on left side of string
+-- @return string
+function Stringizer.trim_left(value)
+  return (Trim.new()).left(value)
+end
+
+-----
+-- Remove whitespace on right side of string
+-- @return string
+function Stringizer.trim_right(value)
+  return (Trim.new()).right(value)
+end
+
+-----
+-- Remove whitespace on left and right side of string
+-- @return string
+function Stringizer.trim(value)
+  return (Trim.new()).both(value)
+end
+
+-----
+-- Encode URL
+-- @return string
+function Stringizer.url_encode(value)
+  return (Url.new()).encode(value)
+end
+
+-----
+-- Decode URL
+-- @return string
+function Stringizer.url_decode(value)
+  return (Url.new()).decode(value)
+end
+
+-----
+-- Pad Left
+-- @return string
+function Stringizer.pad_left(value, pad_number, value_append)
+  return (Pad.new()).left(value, pad_number, value_append)
+end
+
+-----
+-- Pad Right
+-- @return string
+function Stringizer.pad_right(value, pad_number, value_append)
+  return (Pad.new()).right(value, pad_number, value_append)
+end
+
+-----
+-- Pad Both
+-- @return string
+function Stringizer.pad(value, pad_number, value_append)
+  return (Pad.new()).both(value, pad_number, value_append)
+end
+
 return Stringizer

src/transformers/pad.lua

@@ -0,0 +1,47 @@
+------
+-- Pad - Add indicated string padding to value left, right or both sides
+--- @module transformers.between
+local Pad = {}
+
+function Pad.new()
+   local self = {}
+
+   -----
+   -- Left - Pad left of value the given char and given number of times
+   -- @return string  
+   function self.left(s, l, c)
+     local res = string.rep(c or ' ', l - #s) .. s
+     return res, res ~= s
+   end
+
+   -----
+   -- Right - Pad right of value the given char and given number of times
+   -- @return string  
+   function self.right(s, l, c)
+      local res = s .. string.rep(c or ' ', l - #s)
+      return res, res ~= s
+   end
+  
+   -----
+   -- Both - Pad right & left of value the given char and given number of times
+   -- @return string  
+   function self.both(s, l, c)
+      if( l > string.len(s)) then 
+         c = c or ' '
+         local pad_len = l - string.len(s)
+         local target_len = pad_len / 2 
+         local repeat_len = string.len(c)
+         local repeat_times = math.ceil(target_len / repeat_len)
+         local repeated_string = string.rep(c, math.max(0, repeat_times))
+         local before = string.sub(repeated_string, 0, math.floor(target_len))
+         local after = string.sub(repeated_string, 0, math.ceil(target_len))
+         return before .. s .. after
+      else
+         return s   
+      end
+   end
+   
+   return self   
+end
+
+return Pad

src/transformers/trim.lua

@@ -0,0 +1,37 @@
+------
+-- Trim - Trim whitespace from both sides, left side or right side
+--- @module transformers.chop
+local Trim = {}
+
+function Trim.new()
+   local self = {}
+  
+   -----
+   -- Remove whitespace left of string
+   -- @return string 
+   function self.left(value)
+      return value:match'^%s*(.*)'
+   end
+   
+   -----
+   -- Remove whitespace right of string
+   -- @return string 
+   function self.right(value)
+      local n = #value
+      while n > 0 and value:find("^%s", n) do 
+         n = n - 1 
+      end
+      return value:sub(1, n)
+   end
+
+   -----
+   -- Remove whitespace both left and right of string
+   -- @return string 
+   function self.both(value)
+      return value:match'^()%s*$' and '' or value:match'^%s*(.*%S)'
+   end
+     
+   return self   
+end
+
+return Trim