Update changelog for 1.3.0

Require objects to have a __toString method, update readme
Merge Pull Request #18
2025-09-01 09:03:03 +02:00 · 2013-12-16 21:04:30 -05:00 · 2013-12-15 01:08:23 -05:00 · 2013-12-15 00:15:34 -05:00 · 2013-12-13 06:32:34 -08:00 · 2013-12-13 11:05:23 +00:00
8 changed files with 415 additions and 429 deletions
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,3 +1,22 @@
+### 1.3.0 (2013-12-16)
+
+  * Additional Bulgarian support for toAscii
+  * str property made private
+  * Constructor casts first argument to string
+  * Constructor throws an InvalidArgumentException when given an array
+  * Constructor throws an InvalidArgumentException when given an object without
+    a __toString method
+
+### 1.2.2 (2013-12-04)
+
+  * Updated create function to use late static binding
+  * Added optional $replacement param to slugify
+
+### 1.2.1 (2013-10-11)
+
+  * Cleaned up tests
+  * Added homepage to composer.json
+
 ### 1.2.0 (2013-09-15)

  * Fixed pad's use of InvalidArgumentException
--- a/README.md
+++ b/README.md
@@ -1,4 +1,4 @@
-# Stringy
+![Stringy](http://danielstjules.com/stringy/logo.png)

 A PHP library with a variety of string manipulation functions with multibyte support. Offers both OO method chaining and a procedural-style static wrapper. Compatible with PHP 5.3+. Inspired by underscore.string.js.

@@ -67,13 +67,15 @@ A PHP library with a variety of string manipulation functions with multibyte sup

 ## Requiring/Loading

-If you're using Composer to manage dependencies, you can include the following in your composer.json file:
+If you're using Composer to manage dependencies, you can include the following
+in your composer.json file:

    "require": {
        "danielstjules/stringy": "dev-master"
    }

-Then, after running `composer update` or `php composer.phar update`, you can load the class using Composer's autoloading:
+Then, after running `composer update` or `php composer.phar update`, you can
+load the class using Composer's autoloading:

 ```php
 require 'vendor/autoload.php';
@@ -106,9 +108,9 @@ use Stringy\Stringy as S;
 echo S::create('Fòô     Bàř', 'UTF-8')->collapseWhitespace()->swapCase();  // 'fÒÔ bÀŘ'
 ```

-`Stringy\Stringy` contains a __toString() method, which returns the current
-string when the object is used in a string context. Its $str property is also
-public, and can be accessed directly if required, ie: `S::create('foo')->str  // 'foo'`
+`Stringy\Stringy` has a __toString() method, which returns the current string
+when the object is used in a string context, ie:
+`(string) S::create('foo')  // 'foo'`

 Using the static wrapper, an alternative is the following:

@@ -120,8 +122,10 @@ echo S::swapCase($string, 'UTF-8');  // 'fÒÔ bÀŘ'

 ## Methods

-In the list below, any static method other than S::create refers to a
-method in `Stringy\StaticStringy`. For all others, they're found in `Stringy\Stringy`. Furthermore, all methods that return a Stringy object or string do not modify the original.
+In the list below, any static method other than S::create refers to a method in
+`Stringy\StaticStringy`. For all others, they're found in `Stringy\Stringy`.
+Furthermore, all methods that return a Stringy object or string do not modify
+the original.

 *Note: If `$encoding` is not given, it defaults to `mb_internal_encoding()`.*

@@ -200,11 +204,13 @@ S::count('Ο συγγραφέας είπε', 'α', 'UTF-8');  // 2

 #### create

-S::create(string $str, [, $encoding ])
+S::create(mixed $str, [, $encoding ])

 Creates a Stringy object and assigns both str and encoding properties
-the supplied values. If $encoding is not specified, it defaults to
-mb_internal_encoding(). It then returns the initialized object.
+the supplied values. $str is cast to a string prior to assignment, and if
+$encoding is not specified, it defaults to mb_internal_encoding(). It
+then returns the initialized object. Throws an InvalidArgumentException
+if the first argument is an array or object without a __toString method.

 ```php
 $stringy = S::create('fòô bàř', 'UTF-8');  // 'fòô bàř'
@@ -503,7 +509,7 @@ string used for padding is a space, and the default type (one of 'left',
 $padType isn't one of those 3 values.

 ```php
-S::create('fòô bàř', 'UTF-8')->pad( 10, '¬ø', 'left',);
+S::create('fòô bàř', 'UTF-8')->pad( 10, '¬ø', 'left');
 S::pad('fòô bàř', 10, '¬ø', 'left', 'UTF-8');  // '¬ø¬fòô bàř'
 ```

@@ -639,7 +645,8 @@ $stringy->shuffle()

 S::shuffle(string $str [, string $encoding ])

-A multibyte str_shuffle() function. It returns a string with its characters in random order.
+A multibyte str_shuffle() function. It returns a string with its characters in
+random order.

 ```php
 S::create('fòô bàř', 'UTF-8')->shuffle();
@@ -648,14 +655,15 @@ S::shuffle('fòô bàř', 'UTF-8');  // 'àôřb òf'

 #### slugify

-$stringy->slugify()
+$stringy->slugify([ string $replacement = '-' ])

-S::slugify(string $str)
+S::slugify(string $str [, string $replacement = '-' ])

 Converts the string into an URL slug. This includes replacing non-ASCII
 characters with their closest ASCII equivalents, removing non-alphanumeric
-and non-ASCII characters, and replacing whitespace with dashes. The string
-is also converted to lowercase.
+and non-ASCII characters, and replacing whitespace with $replacement.
+The replacement defaults to a single dash, and the string is also
+converted to lowercase.

 ```php
 S::create('Using strings like fòô bàř')->slugify();
--- a/composer.json
+++ b/composer.json
@@ -5,6 +5,7 @@
        "multibyte", "string", "manipulation", "utility", "methods", "utf-8",
        "helpers", "utils", "utf"
    ],
+    "homepage": "https://github.com/danielstjules/Stringy",
    "license": "MIT",
    "authors": [
        {
--- a/src/Stringy/StaticStringy.php
+++ b/src/Stringy/StaticStringy.php
@@ -13,7 +13,7 @@ class StaticStringy
     */
    public static function upperCaseFirst($str, $encoding = null)
    {
-        return Stringy::create($str, $encoding)->upperCaseFirst()->str;
+        return (string) Stringy::create($str, $encoding)->upperCaseFirst();
    }

    /**
@@ -25,7 +25,7 @@ class StaticStringy
     */
    public static function lowerCaseFirst($str, $encoding = null)
    {
-        return Stringy::create($str, $encoding)->lowerCaseFirst()->str;
+        return (string) Stringy::create($str, $encoding)->lowerCaseFirst();
    }

    /**
@@ -39,7 +39,7 @@ class StaticStringy
     */
    public static function camelize($str, $encoding = null)
    {
-        return Stringy::create($str, $encoding)->camelize()->str;
+        return (string) Stringy::create($str, $encoding)->camelize();
    }

    /**
@@ -53,7 +53,7 @@ class StaticStringy
     */
    public static function upperCamelize($str, $encoding = null)
    {
-        return Stringy::create($str, $encoding)->upperCamelize()->str;
+        return (string) Stringy::create($str, $encoding)->upperCamelize();
    }

    /**
@@ -67,7 +67,7 @@ class StaticStringy
     */
    public static function dasherize($str, $encoding = null)
    {
-        return Stringy::create($str, $encoding)->dasherize()->str;
+        return (string) Stringy::create($str, $encoding)->dasherize();
    }

    /**
@@ -82,7 +82,7 @@ class StaticStringy
     */
    public static function underscored($str, $encoding = null)
    {
-        return $result = Stringy::create($str, $encoding)->underscored()->str;
+        return (string) Stringy::create($str, $encoding)->underscored();
    }

    /**
@@ -94,7 +94,7 @@ class StaticStringy
     */
    public static function swapCase($str, $encoding = null)
    {
-        return $result = Stringy::create($str, $encoding)->swapCase()->str;
+        return (string) Stringy::create($str, $encoding)->swapCase();
    }

    /**
@@ -110,7 +110,7 @@ class StaticStringy
     */
    public static function titleize($str, $ignore = null, $encoding = null)
    {
-        return $result = Stringy::create($str, $encoding)->titleize($ignore)->str;
+        return (string) Stringy::create($str, $encoding)->titleize($ignore);
    }

    /**
@@ -123,7 +123,7 @@ class StaticStringy
     */
    public static function humanize($str, $encoding = null)
    {
-        return $result = Stringy::create($str, $encoding)->humanize()->str;
+        return (string) Stringy::create($str, $encoding)->humanize();
    }

    /**
@@ -136,7 +136,7 @@ class StaticStringy
     */
    public static function tidy($str)
    {
-        return $result = Stringy::create($str)->tidy()->str;
+        return (string) Stringy::create($str)->tidy();
    }

    /**
@@ -150,7 +150,7 @@ class StaticStringy
     */
    public static function collapseWhitespace($str, $encoding = null)
    {
-        return $result = Stringy::create($str, $encoding)->collapseWhitespace()->str;
+        return (string) Stringy::create($str, $encoding)->collapseWhitespace();
    }

    /**
@@ -162,7 +162,7 @@ class StaticStringy
     */
    public static function toAscii($str)
    {
-        return $result = Stringy::create($str)->toAscii()->str;
+        return (string) Stringy::create($str)->toAscii();
    }

    /**
@@ -178,14 +178,14 @@ class StaticStringy
     * @param   string  $padType   One of 'left', 'right', 'both'
     * @param   string  $encoding  The character encoding
     * @return  string  The padded string
-     * @throws  InvalidArgumentException If $padType isn't one of 'right',
+     * @throws  \InvalidArgumentException If $padType isn't one of 'right',
     *          'left' or 'both'
     */
    public static function pad($str, $length, $padStr = ' ', $padType = 'right',
                               $encoding = null)
    {
-        return $result = Stringy::create($str, $encoding)
-                                ->pad($length, $padStr, $padType)->str;
+        return (string) Stringy::create($str, $encoding)
+                               ->pad($length, $padStr, $padType);
    }

    /**
@@ -200,7 +200,7 @@ class StaticStringy
     */
    public static function padLeft($str, $length, $padStr = ' ', $encoding = null)
    {
-        return Stringy::create($str, $encoding)->padLeft($length, $padStr)->str;
+        return (string) Stringy::create($str, $encoding)->padLeft($length, $padStr);
    }

    /**
@@ -215,7 +215,7 @@ class StaticStringy
     */
    public static function padRight($str, $length, $padStr = ' ', $encoding = null)
    {
-        return Stringy::create($str, $encoding)->padRight($length, $padStr)->str;
+        return (string) Stringy::create($str, $encoding)->padRight($length, $padStr);
    }

    /**
@@ -230,7 +230,7 @@ class StaticStringy
     */
    public static function padBoth($str, $length, $padStr = ' ', $encoding = null)
    {
-        return Stringy::create($str, $encoding)->padBoth($length, $padStr)->str;
+        return (string) Stringy::create($str, $encoding)->padBoth($length, $padStr);
    }

    /**
@@ -279,7 +279,7 @@ class StaticStringy
     */
    public static function toSpaces($str, $tabLength = 4)
    {
-        return Stringy::create($str)->toSpaces($tabLength)->str;
+        return (string) Stringy::create($str)->toSpaces($tabLength);
    }

    /**
@@ -293,7 +293,7 @@ class StaticStringy
     */
    public static function toTabs($str, $tabLength = 4)
    {
-        return Stringy::create($str)->toTabs($tabLength)->str;
+        return (string) Stringy::create($str)->toTabs($tabLength);
    }

    /**
@@ -306,7 +306,7 @@ class StaticStringy
     */
    public static function toLowerCase($str, $encoding = null)
    {
-        return Stringy::create($str, $encoding)->toLowerCase()->str;
+        return (string) Stringy::create($str, $encoding)->toLowerCase();
    }

    /**
@@ -319,21 +319,23 @@ class StaticStringy
     */
    public static function toUpperCase($str, $encoding = null)
    {
-        return Stringy::create($str, $encoding)->toUpperCase()->str;
+        return (string) Stringy::create($str, $encoding)->toUpperCase();
    }

    /**
     * Converts the string into an URL slug. This includes replacing non-ASCII
     * characters with their closest ASCII equivalents, removing non-alphanumeric
-     * and non-ASCII characters, and replacing whitespace with dashes. The string
-     * is also converted to lowercase.
+     * and non-ASCII characters, and replacing whitespace with $replacement.
+     * The replacement defaults to a single dash, and the string is also
+     * converted to lowercase.
     *
-     * @param   string  $str  Text to transform into an URL slug
+     * @param   string  $str          Text to transform into an URL slug
+     * @param   string  $replacement  The string used to replace whitespace
     * @return  string  The corresponding URL slug
     */
-    public static function slugify($str)
+    public static function slugify($str, $replacement = '-')
    {
-        return Stringy::create($str)->slugify()->str;
+        return (string) Stringy::create($str)->slugify($replacement);
    }

    /**
@@ -362,7 +364,7 @@ class StaticStringy
     */
    public static function surround($str, $substring)
    {
-        return Stringy::create($str)->surround($substring)->str;
+        return (string) Stringy::create($str)->surround($substring);
    }

    /**
@@ -376,7 +378,7 @@ class StaticStringy
     */
    public static function insert($str, $substring, $index, $encoding = null)
    {
-        return Stringy::create($str, $encoding)->insert($substring, $index)->str;
+        return (string) Stringy::create($str, $encoding)->insert($substring, $index);
    }

    /**
@@ -393,8 +395,8 @@ class StaticStringy
    public static function truncate($str, $length, $substring = '',
                                    $encoding = null)
    {
-        return Stringy::create($str, $encoding)
-                      ->truncate($length, $substring)->str;
+        return (string) Stringy::create($str, $encoding)
+                               ->truncate($length, $substring);
    }

    /**
@@ -412,8 +414,8 @@ class StaticStringy
    public static function safeTruncate($str, $length, $substring = '',
                                    $encoding = null)
    {
-        return Stringy::create($str, $encoding)
-                      ->safeTruncate($length, $substring)->str;
+        return (string) Stringy::create($str, $encoding)
+                               ->safeTruncate($length, $substring);
    }

    /**
@@ -425,7 +427,7 @@ class StaticStringy
     */
    public static function reverse($str, $encoding = null)
    {
-        return Stringy::create($str, $encoding)->reverse()->str;
+        return (string) Stringy::create($str, $encoding)->reverse();
    }

    /**
@@ -438,7 +440,7 @@ class StaticStringy
     */
    public static function shuffle($str, $encoding = null)
    {
-        return Stringy::create($str, $encoding)->shuffle()->str;
+        return (string) Stringy::create($str, $encoding)->shuffle();
    }

    /**
@@ -462,8 +464,8 @@ class StaticStringy
     */
    public static function longestCommonPrefix($str, $otherStr, $encoding = null)
    {
-        return Stringy::create($str, $encoding)
-                      ->longestCommonPrefix($otherStr)->str;
+        return (string) Stringy::create($str, $encoding)
+                               ->longestCommonPrefix($otherStr);
    }

    /**
@@ -476,8 +478,8 @@ class StaticStringy
     */
    public static function longestCommonSuffix($str, $otherStr, $encoding = null)
    {
-        return Stringy::create($str, $encoding)
-                      ->longestCommonSuffix($otherStr)->str;
+        return (string) Stringy::create($str, $encoding)
+                               ->longestCommonSuffix($otherStr);
    }

    /**
@@ -492,8 +494,8 @@ class StaticStringy
    public static function longestCommonSubstring($str, $otherStr,
                                                  $encoding = null)
    {
-        return Stringy::create($str, $encoding)
-                      ->longestCommonSubstring($otherStr)->str;
+        return (string) Stringy::create($str, $encoding)
+                               ->longestCommonSubstring($otherStr);
    }

    /**
@@ -521,7 +523,7 @@ class StaticStringy
     */
    public static function substr($str, $start, $length = null, $encoding = null)
    {
-        return Stringy::create($str, $encoding)->substr($start, $length)->str;
+        return (string) Stringy::create($str, $encoding)->substr($start, $length);
    }

    /**
@@ -534,7 +536,7 @@ class StaticStringy
     */
    public static function at($str, $index, $encoding = null)
    {
-        return Stringy::create($str, $encoding)->at($index)->str;
+        return (string) Stringy::create($str, $encoding)->at($index);
    }

    /**
@@ -547,7 +549,7 @@ class StaticStringy
     */
    public static function first($str, $n, $encoding = null)
    {
-        return Stringy::create($str, $encoding)->first($n)->str;
+        return (string) Stringy::create($str, $encoding)->first($n);
    }

    /**
@@ -560,7 +562,7 @@ class StaticStringy
     */
    public static function last($str, $n, $encoding = null)
    {
-        return Stringy::create($str, $encoding)->last($n)->str;
+        return (string) Stringy::create($str, $encoding)->last($n);
    }

    /**
@@ -574,7 +576,7 @@ class StaticStringy
     */
    public static function ensureLeft($str, $substring, $encoding = null)
    {
-        return Stringy::create($str, $encoding)->ensureLeft($substring)->str;
+        return (string) Stringy::create($str, $encoding)->ensureLeft($substring);
    }

    /**
@@ -588,7 +590,7 @@ class StaticStringy
     */
    public static function ensureRight($str, $substring, $encoding = null)
    {
-        return Stringy::create($str, $encoding)->ensureRight($substring)->str;
+        return (string) Stringy::create($str, $encoding)->ensureRight($substring);
    }

    /**
@@ -601,7 +603,7 @@ class StaticStringy
     */
    public static function removeLeft($str, $substring, $encoding = null)
    {
-        return Stringy::create($str, $encoding)->removeLeft($substring)->str;
+        return (string) Stringy::create($str, $encoding)->removeLeft($substring);
    }

    /**
@@ -614,7 +616,7 @@ class StaticStringy
     */
    public static function removeRight($str, $substring, $encoding = null)
    {
-        return Stringy::create($str, $encoding)->removeRight($substring)->str;
+        return (string) Stringy::create($str, $encoding)->removeRight($substring);
    }

    /**
@@ -742,7 +744,7 @@ class StaticStringy
     */
    public static function replace($str, $search, $replacement, $encoding = null)
    {
-        return Stringy::create($str, $encoding)->replace($search, $replacement)->str;
+        return (string) Stringy::create($str, $encoding)->replace($search, $replacement);
    }

    /**
@@ -761,7 +763,7 @@ class StaticStringy
    public static function regexReplace($str, $pattern, $replacement,
                                        $options = 'msr', $encoding = null)
    {
-        return Stringy::create($str, $encoding)->regexReplace($pattern,
-            $replacement, $options, $encoding)->str;
+        return (string) Stringy::create($str, $encoding)->regexReplace($pattern,
+            $replacement, $options, $encoding);
    }
 }
--- a/src/Stringy/Stringy.php
+++ b/src/Stringy/Stringy.php
@@ -4,36 +4,54 @@ namespace Stringy;

 class Stringy
 {
-    public $str;
+    private $str;

    public $encoding;

    /**
     * Initializes a Stringy object and assigns both str and encoding properties
-     * the supplied values. If $encoding is not specified, it defaults to
-     * mb_internal_encoding().
+     * the supplied values. $str is cast to a string prior to assignment, and if
+     * $encoding is not specified, it defaults to mb_internal_encoding(). Throws
+     * an InvalidArgumentException if the first argument is an array or object
+     * without a __toString method.
     *
-     * @param  string  $str       String to modify
-     * @param  string  $encoding  The character encoding
+     * @param   mixed   $str       Value to modify, after being cast to string
+     * @param   string  $encoding  The character encoding
+     * @throws  \InvalidArgumentException if an array or object without a
+     *          __toString method is passed as the first argument
     */
    public function __construct($str, $encoding = null)
    {
-        $this->str = $str;
+        if (is_array($str)) {
+            throw new \InvalidArgumentException(
+                'Passed value cannot be an array'
+            );
+        } else if (is_object($str) && !method_exists($str, '__toString')) {
+            throw new \InvalidArgumentException(
+                'Passed object must have a __toString method'
+            );
+        }
+
+        $this->str = (string) $str;
        $this->encoding = $encoding ?: mb_internal_encoding();
    }

    /**
     * Creates a Stringy object and assigns both str and encoding properties
-     * the supplied values. If $encoding is not specified, it defaults to
-     * mb_internal_encoding(). It then returns the initialized object.
+     * the supplied values. $str is cast to a string prior to assignment, and if
+     * $encoding is not specified, it defaults to mb_internal_encoding(). It
+     * then returns the initialized object. Throws an InvalidArgumentException
+     * if the first argument is an array or object without a __toString method.
     *
-     * @param   string   $str       String to modify
+     * @param   mixed    $str       Value to modify, after being cast to string
     * @param   string   $encoding  The character encoding
     * @return  Stringy  A Stringy object
+     * @throws  \InvalidArgumentException if an array or object without a
+     *          __toString method is passed as the first argument
     */
    public static function create($str, $encoding = null)
    {
-        return new self($str, $encoding);
+        return new static($str, $encoding);
    }

    /**
@@ -203,21 +221,23 @@ class Stringy
     */
    public function titleize($ignore = null)
    {
-        $stringy = self::create($this->str, $this->encoding)->trim();
-        $encoding = $stringy->encoding;
+        $buffer = $this->trim();
+        $encoding = $this->encoding;

-        $stringy->str = preg_replace_callback(
+        $buffer = preg_replace_callback(
            '/([\S]+)/u',
-            function ($match) use (&$encoding, &$ignore, &$stringy) {
-                if ($ignore && in_array($match[0], $ignore))
+            function ($match) use (&$encoding, &$ignore) {
+                if ($ignore && in_array($match[0], $ignore)) {
                    return $match[0];
-                $stringy->str = $match[0];
-                return $stringy->upperCaseFirst();
+                } else {
+                    $stringy = new Stringy($match[0], $encoding);
+                    return (string) $stringy->upperCaseFirst();
+                }
            },
-            $stringy->str
+            $buffer
        );

-        return $stringy;
+        return new Stringy($buffer, $encoding);
    }

    /**
@@ -287,7 +307,7 @@ class Stringy
            'a'    => array('à', 'á', 'â', 'ã', 'ā', 'ą', 'ă', 'å', 'α', 'ά', 'ἀ',
                            'ἁ', 'ἂ', 'ἃ', 'ἄ', 'ἅ', 'ἆ', 'ἇ', 'ᾀ', 'ᾁ', 'ᾂ', 'ᾃ',
                            'ᾄ', 'ᾅ', 'ᾆ', 'ᾇ', 'ὰ', 'ά', 'ᾰ', 'ᾱ', 'ᾲ', 'ᾳ', 'ᾴ',
-                            'ᾶ', 'ᾷ', 'а'),
+                            'ᾶ', 'ᾷ', 'а', 'ъ'),
            'b'    => array('б', 'β'),
            'c'    => array('ç', 'ć', 'č', 'ĉ', 'ċ'),
            'd'    => array('ď', 'ð', 'đ', 'ƌ', 'ȡ', 'ɖ', 'ɗ', 'ᵭ', 'ᶁ', 'ᶑ', 'д'),
@@ -326,7 +346,7 @@ class Stringy
            'zh'   => array('ж'),
            'A'    => array('Á', 'Â', 'Ã', 'Å', 'Ā', 'Ą', 'Ă', 'Α', 'Ά', 'Ἀ', 'Ἁ',
                            'Ἂ', 'Ἃ', 'Ἄ', 'Ἅ', 'Ἆ', 'Ἇ', 'ᾈ', 'ᾉ', 'ᾊ', 'ᾋ', 'ᾌ',
-                            'ᾍ', 'ᾎ', 'ᾏ', 'Ᾰ', 'Ᾱ', 'Ὰ', 'Ά', 'ᾼ', 'А'),
+                            'ᾍ', 'ᾎ', 'ᾏ', 'Ᾰ', 'Ᾱ', 'Ὰ', 'Ά', 'ᾼ', 'А', 'Ъ'),
            'B'    => array('Б'),
            'C'    => array('Ć', 'Č', 'Ĉ', 'Ċ'),
            'D'    => array('Ď', 'Ð', 'Đ', 'Ɖ', 'Ɗ', 'Ƌ', 'ᴅ', 'ᴆ', 'Д'),
@@ -577,18 +597,20 @@ class Stringy
    /**
     * Converts the string into an URL slug. This includes replacing non-ASCII
     * characters with their closest ASCII equivalents, removing non-alphanumeric
-     * and non-ASCII characters, and replacing whitespace with dashes. The string
-     * is also converted to lowercase.
+     * and non-ASCII characters, and replacing whitespace with $replacement.
+     * The replacement defaults to a single dash, and the string is also
+     * converted to lowercase.
     *
+     * @param   string   $replacement  The string used to replace whitespace
     * @return  Stringy  Object whose $str has been converted to an URL slug
     */
-    public function slugify()
+    public function slugify($replacement = '-')
    {
        $stringy = self::create($this->str, $this->encoding);

-        $stringy->str = preg_replace('/[^a-zA-Z\d -]/u', '', $stringy->toAscii());
+        $stringy->str = preg_replace("/[^a-zA-Z\d $replacement]/u", '', $stringy->toAscii());
        $stringy->str = $stringy->collapseWhitespace()->str;
-        $stringy->str = str_replace(' ', '-', strtolower($stringy->str));
+        $stringy->str = str_replace(' ', $replacement, strtolower($stringy->str));

        return $stringy;
    }
--- a/tests/Stringy/CommonTest.php
+++ b/tests/Stringy/CommonTest.php
@@ -2,35 +2,31 @@

 abstract class CommonTest extends PHPUnit_Framework_TestCase
 {
-    public function stringsForUpperCaseFirst()
+    public function upperCaseFirstProvider()
    {
-        $testData = array(
+        return array(
            array('Test', 'Test'),
            array('Test', 'test'),
            array('1a', '1a'),
            array('Σ test', 'σ test', 'UTF-8'),
            array(' σ test', ' σ test', 'UTF-8')
        );
-
-        return $testData;
    }

-    public function stringsForLowerCaseFirst()
+    public function lowerCaseFirstProvider()
    {
-        $testData = array(
+        return array(
            array('test', 'Test'),
            array('test', 'test'),
            array('1a', '1a'),
            array('σ test', 'Σ test', 'UTF-8'),
            array(' Σ test', ' Σ test', 'UTF-8')
        );
-
-        return $testData;
    }

-    public function stringsForCamelize()
+    public function camelizeProvider()
    {
-        $testData = array(
+        return array(
            array('camelCase', 'CamelCase'),
            array('camelCase', 'Camel-Case'),
            array('camelCase', 'camel case'),
@@ -45,13 +41,11 @@ abstract class CommonTest extends PHPUnit_Framework_TestCase
            array('στανιλCase', 'Στανιλ case', 'UTF-8'),
            array('σamelCase', 'σamel  Case', 'UTF-8')
        );
-
-        return $testData;
    }

-    public function stringsForUpperCamelize()
+    public function upperCamelizeProvider()
    {
-        $testData = array(
+        return array(
            array('CamelCase', 'camelCase'),
            array('CamelCase', 'Camel-Case'),
            array('CamelCase', 'camel case'),
@@ -66,13 +60,11 @@ abstract class CommonTest extends PHPUnit_Framework_TestCase
            array('ΣτανιλCase', 'στανιλ case', 'UTF-8'),
            array('ΣamelCase', 'Σamel  Case', 'UTF-8')
        );
-
-        return $testData;
    }

-    public function stringsForDasherize()
+    public function dasherizeProvider()
    {
-        $testData = array(
+        return array(
            array('test-case', 'testCase'),
            array('test-case', 'Test-Case'),
            array('test-case', 'test case'),
@@ -89,13 +81,11 @@ abstract class CommonTest extends PHPUnit_Framework_TestCase
            array('στανιλ-case', 'Στανιλ case', 'UTF-8'),
            array('σash-case', 'Σash  Case', 'UTF-8')
        );
-
-        return $testData;
    }

-    public function stringsForUnderscored()
+    public function underscoredProvider()
    {
-        $testData = array(
+        return array(
            array('test_case', 'testCase'),
            array('test_case', 'Test-Case'),
            array('test_case', 'test case'),
@@ -112,63 +102,53 @@ abstract class CommonTest extends PHPUnit_Framework_TestCase
            array('στανιλ_case', 'Στανιλ case', 'UTF-8'),
            array('σash_case', 'Σash  Case', 'UTF-8')
        );
-
-        return $testData;
    }

-    public function stringsForSwapCase()
+    public function swapCaseProvider()
    {
-        $testData = array(
+        return array(
            array('TESTcASE', 'testCase'),
            array('tEST-cASE', 'Test-Case'),
            array(' - σASH  cASE', ' - Σash  Case', 'UTF-8'),
            array('νΤΑΝΙΛ', 'Ντανιλ', 'UTF-8')
        );
-
-        return $testData;
    }

-    public function stringsForTitleize()
+    public function titleizeProvider()
    {
        $ignore = array('at', 'by', 'for', 'in', 'of', 'on', 'out', 'to', 'the');

-        $testData = array(
+        return array(
            array('Testing The Method', 'testing the method'),
            array('Testing the Method', 'testing the method', $ignore, 'UTF-8'),
            array('I Like to Watch DVDs at Home', 'i like to watch DVDs at home',
                $ignore, 'UTF-8'),
            array('Θα Ήθελα Να Φύγει', '  Θα ήθελα να φύγει  ', null, 'UTF-8')
        );
-
-        return $testData;
    }

-    public function stringsForHumanize()
+    public function humanizeProvider()
    {
-        $testData = array(
+        return array(
            array('Author', 'author_id'),
            array('Test user', ' _test_user_'),
            array('Συγγραφέας', ' συγγραφέας_id ', 'UTF-8')
        );
-
-        return $testData;
    }

-    public function stringsForTidy()
+    public function tidyProvider()
    {
-        $testData = array(
+        return array(
            array('"I see..."', '“I see…”'),
            array("'This too'", "‘This too’"),
            array('test-dash', 'test—dash'),
            array('Ο συγγραφέας είπε...', 'Ο συγγραφέας είπε…')
        );
-
-        return $testData;
    }

-    public function stringsForCollapseWhitespace()
+    public function collapseWhitespaceProvider()
    {
-        $testData = array(
+        return array(
            array('foo bar', '  foo   bar  '),
            array('test string', 'test string'),
            array('Ο συγγραφέας', '   Ο     συγγραφέας  '),
@@ -178,13 +158,11 @@ abstract class CommonTest extends PHPUnit_Framework_TestCase
            array('', ' '),
            array('', ''),
        );
-
-        return $testData;
    }

-    public function stringsForToAscii()
+    public function toAsciiProvider()
    {
-        $testData = array(
+        return array(
            array('foo bar', 'fòô bàř'),
            array(' TEST ', ' ŤÉŚŢ '),
            array('φ = z = 3', 'φ = ź = 3'),
@@ -192,13 +170,11 @@ abstract class CommonTest extends PHPUnit_Framework_TestCase
            array('lysaya gora', 'лысая гора'),
            array('shchuka', 'щука')
        );
-
-        return $testData;
    }

-    public function stringsForPad()
+    public function padProvider()
    {
-        $testData = array(
+        return array(
            // $length <= $str
            array('foo bar', 'foo bar', -1),
            array('foo bar', 'foo bar', 7),
@@ -235,47 +211,39 @@ abstract class CommonTest extends PHPUnit_Framework_TestCase
            array('¬øfòô bàř¬ø', 'fòô bàř', 11, '¬øÿ', 'both', 'UTF-8'),
            array('¬øfòô bàř¬øÿ', 'fòô bàř', 12, '¬øÿ', 'both', 'UTF-8')
        );
-
-        return $testData;
    }

-    public function stringsForPadLeft()
+    public function padLeftProvider()
    {
-        $testData = array(
+        return array(
            array('  foo bar', 'foo bar', 9),
            array('_*_foo bar', 'foo bar', 10, '_*'),
            array('¬ø¬øfòô bàř', 'fòô bàř', 11, '¬ø', 'UTF-8'),
        );
-
-        return $testData;
    }

-    public function stringsForPadRight()
+    public function padRightProvider()
    {
-        $testData = array(
+        return array(
            array('foo bar  ', 'foo bar', 9),
            array('foo bar_*_', 'foo bar', 10, '_*'),
            array('fòô bàř¬ø¬ø', 'fòô bàř', 11, '¬ø', 'UTF-8'),
        );
-
-        return $testData;
    }

-    public function stringsForPadBoth()
+    public function padBothProvider()
    {
-        $testData = array(
+        return array(
            array('foo bar ', 'foo bar', 8),
            array(' foo bar ', 'foo bar', 9, ' '),
            array('¬fòô bàř¬ø', 'fòô bàř', 10, '¬øÿ', 'UTF-8'),
            array('¬øfòô bàř¬øÿ', 'fòô bàř', 12, '¬øÿ', 'UTF-8')
        );
-
-        return $testData;
    }

-    public function stringsForStartsWith()
+    public function startsWithProvider()
    {
-        $testData = array(
+        return array(
            array(true, 'foo bars', 'foo bar'),
            array(true, 'FOO bars', 'foo bar', false),
            array(true, 'FOO bars', 'foo BAR', false),
@@ -288,13 +256,11 @@ abstract class CommonTest extends PHPUnit_Framework_TestCase
            array(false, 'FÒÔ bàřs', 'fòô bàř', true, 'UTF-8'),
            array(false, 'fòô bàřs', 'fòô BÀŘ', true, 'UTF-8'),
        );
-
-        return $testData;
    }

-    public function stringsForEndsWith()
+    public function endsWithProvider()
    {
-        $testData = array(
+        return array(
            array(true, 'foo bars', 'o bars'),
            array(true, 'FOO bars', 'o bars', false),
            array(true, 'FOO bars', 'o BARs', false),
@@ -307,13 +273,11 @@ abstract class CommonTest extends PHPUnit_Framework_TestCase
            array(false, 'FÒÔ bàřs', 'fòô bàřs', true, 'UTF-8'),
            array(false, 'fòô bàřs', 'fòô BÀŘS', true, 'UTF-8'),
        );
-
-        return $testData;
    }

-    public function stringsForToSpaces()
+    public function toSpacesProvider()
    {
-        $testData = array(
+        return array(
            array('    foo    bar    ', '	foo	bar	'),
            array('     foo     bar     ', '	foo	bar	', 5),
            array('    foo  bar  ', '		foo	bar	', 2),
@@ -321,52 +285,44 @@ abstract class CommonTest extends PHPUnit_Framework_TestCase
            array("    foo\n    bar", "	foo\n	bar"),
            array("    fòô\n    bàř", "	fòô\n	bàř")
        );
-
-        return $testData;
    }

-    public function stringsForToTabs()
+    public function toTabsProvider()
    {
-        $testData = array(
+        return array(
            array('	foo	bar	', '    foo    bar    '),
            array('	foo	bar	', '     foo     bar     ', 5),
            array('		foo	bar	', '    foo  bar  ', 2),
            array("	foo\n	bar", "    foo\n    bar"),
            array("	fòô\n	bàř", "    fòô\n    bàř")
        );
-
-        return $testData;
    }

-    public function stringsForToLowerCase()
+    public function toLowerCaseProvider()
    {
-        $testData = array(
+        return array(
            array('foo bar', 'FOO BAR'),
            array(' foo_bar ', ' FOO_bar '),
            array('fòô bàř', 'FÒÔ BÀŘ', 'UTF-8'),
            array(' fòô_bàř ', ' FÒÔ_bàř ', 'UTF-8'),
            array('αυτοκίνητο', 'ΑΥΤΟΚΊΝΗΤΟ', 'UTF-8'),
        );
-
-        return $testData;
    }

-    public function stringsForToUpperCase()
+    public function toUpperCaseProvider()
    {
-        $testData = array(
+        return array(
            array('FOO BAR', 'foo bar'),
            array(' FOO_BAR ', ' FOO_bar '),
            array('FÒÔ BÀŘ', 'fòô bàř', 'UTF-8'),
            array(' FÒÔ_BÀŘ ', ' FÒÔ_bàř ', 'UTF-8'),
            array('ΑΥΤΟΚΊΝΗΤΟ', 'αυτοκίνητο', 'UTF-8'),
        );
-
-        return $testData;
    }

-    public function stringsForSlugify()
+    public function slugifyProvider()
    {
-        $testData = array(
+        return array(
            array('foo-bar', ' foo  bar '),
            array('foo-dbar', " Foo d'Bar "),
            array('a-string-with-dashes', 'A string-with-dashes'),
@@ -374,15 +330,16 @@ abstract class CommonTest extends PHPUnit_Framework_TestCase
            array('unrecognized-chars-like', 'unrecognized chars like συγγρ'),
            array('numbers-1234', 'numbers 1234'),
            array('perevirka-ryadka', 'перевірка рядка'),
-            array('bukvar-s-bukvoy-y', 'букварь с буквой ы')
+            array('bukvar-s-bukvoy-y', 'букварь с буквой ы'),
+            array('barzi-i-yarostni', 'бързи и яростни'),
+            array('foo:bar:baz', 'Foo bar baz', ':'),
+            array('a_string_with_underscores', 'A_string with_underscores', '_')
        );
-
-        return $testData;
    }

-    public function stringsForContains()
+    public function containsProvider()
    {
-        $testData = array(
+        return array(
            array(true, 'This string contains foo bar', 'foo bar'),
            array(true, '12398!@(*%!@# @!%#*&^%',  ' @!%#*&^%'),
            array(true, 'Ο συγγραφέας είπε', 'συγγραφέας', 'UTF-8'),
@@ -405,26 +362,22 @@ abstract class CommonTest extends PHPUnit_Framework_TestCase
            array(false, 'Ο συγγραφέας είπε', '  συγγραφέας ', false, 'UTF-8'),
            array(false, 'å´¥©¨ˆßå˚ ∆∂˙©å∑¥øœ¬', ' ßÅ˚', false, 'UTF-8')
        );
-
-        return $testData;
    }

-    public function stringsForSurround()
+    public function surroundProvider()
    {
-        $testData = array(
+        return array(
            array('__foobar__', 'foobar', '__'),
            array('test', 'test', ''),
            array('**', '', '*'),
            array('¬fòô bàř¬', 'fòô bàř', '¬'),
            array('ßå∆˚ test ßå∆˚', ' test ', 'ßå∆˚')
        );
-
-        return $testData;
    }

-    public function stringsForInsert()
+    public function insertProvider()
    {
-        $testData = array(
+        return array(
            array('foo bar', 'oo bar', 'f', 0),
            array('foo bar', 'f bar', 'oo', 1),
            array('f bar', 'f bar', 'oo', 20),
@@ -433,13 +386,11 @@ abstract class CommonTest extends PHPUnit_Framework_TestCase
            array('fòô bàř', 'f bàř', 'òô', 1, 'UTF-8'),
            array('fòô bàř', 'fòô bà', 'ř', 6, 'UTF-8')
        );
-
-        return $testData;
    }

-    public function stringsForTruncate()
+    public function truncateProvider()
    {
-        $testData = array(
+        return array(
            array('Test foo bar', 'Test foo bar', 12),
            array('Test foo ba', 'Test foo bar', 11),
            array('Test foo', 'Test foo bar', 8),
@@ -463,13 +414,11 @@ abstract class CommonTest extends PHPUnit_Framework_TestCase
            array('Teϰϰ', 'Test fòô bàř', 4, 'ϰϰ', 'UTF-8'),
            array('What are your pl...', 'What are your plans today?', 19, '...')
        );
-
-        return $testData;
    }

-    public function stringsForSafeTruncate()
+    public function safeTruncateProvider()
    {
-        $testData = array(
+        return array(
            array('Test foo bar', 'Test foo bar', 12),
            array('Test foo', 'Test foo bar', 11),
            array('Test foo', 'Test foo bar', 8),
@@ -493,37 +442,31 @@ abstract class CommonTest extends PHPUnit_Framework_TestCase
            array('ϰϰ', 'Test fòô bàř', 4, 'ϰϰ', 'UTF-8'),
            array('What are your plans...', 'What are your plans today?', 22, '...')
        );
-
-        return $testData;
    }

-    public function stringsForReverse()
+    public function reverseProvider()
    {
-        $testData = array(
+        return array(
            array('', ''),
            array('raboof', 'foobar'),
            array('řàbôòf', 'fòôbàř', 'UTF-8'),
            array('řàb ôòf', 'fòô bàř', 'UTF-8'),
            array('∂∆ ˚åß', 'ßå˚ ∆∂', 'UTF-8')
        );
-
-        return $testData;
    }

-    public function stringsForShuffle()
+    public function shuffleProvider()
    {
-        $testData = array(
+        return array(
            array('foo bar'),
            array('∂∆ ˚åß', 'UTF-8'),
            array('å´¥©¨ˆßå˚ ∆∂˙©å∑¥øœ¬', 'UTF-8')
        );
-
-        return $testData;
    }

-    public function stringsForTrim()
+    public function trimProvider()
    {
-        $testData = array(
+        return array(
            array('foo   bar', '  foo   bar  '),
            array('foo bar', ' foo bar'),
            array('foo bar', 'foo bar '),
@@ -533,13 +476,11 @@ abstract class CommonTest extends PHPUnit_Framework_TestCase
            array('fòô bàř', 'fòô bàř '),
            array('fòô bàř', "\n\t fòô bàř \n\t")
        );
-
-        return $testData;
    }

-    public function stringsForLongestCommonPrefix()
+    public function longestCommonPrefixProvider()
    {
-        $testData = array(
+        return array(
            array('foo', 'foobar', 'foo bar'),
            array('foo bar', 'foo bar', 'foo bar'),
            array('f', 'foo bar', 'far boo'),
@@ -551,13 +492,11 @@ abstract class CommonTest extends PHPUnit_Framework_TestCase
            array('', 'toy car', 'fòô bar', 'UTF-8'),
            array('', 'fòô bar', '', 'UTF-8'),
        );
-
-        return $testData;
    }

-    public function stringsForLongestCommonSuffix()
+    public function longestCommonSuffixProvider()
    {
-        $testData = array(
+        return array(
            array('bar', 'foobar', 'foo bar'),
            array('foo bar', 'foo bar', 'foo bar'),
            array('ar', 'foo bar', 'boo far'),
@@ -569,13 +508,11 @@ abstract class CommonTest extends PHPUnit_Framework_TestCase
            array('', 'toy car', 'fòô bàř', 'UTF-8'),
            array('', 'fòô bàř', '', 'UTF-8'),
        );
-
-        return $testData;
    }

-    public function stringsForLongestCommonSubstring()
+    public function longestCommonSubstringProvider()
    {
-        $testData = array(
+        return array(
            array('foo', 'foobar', 'foo bar'),
            array('foo bar', 'foo bar', 'foo bar'),
            array('oo ', 'foo bar', 'boo far'),
@@ -587,25 +524,21 @@ abstract class CommonTest extends PHPUnit_Framework_TestCase
            array(' ', 'toy car', 'fòô bàř', 'UTF-8'),
            array('', 'fòô bàř', '', 'UTF-8'),
        );
-
-        return $testData;
    }

-    public function stringsForLength()
+    public function lengthProvider()
    {
-        $testData = array(
+        return array(
            array(11, '  foo bar  '),
            array(1, 'f'),
            array(0, ''),
            array(7, 'fòô bàř', 'UTF-8')
        );
-
-        return $testData;
    }

-    public function stringsForSubstr()
+    public function substrProvider()
    {
-        $testData = array(
+        return array(
            array('foo bar', 'foo bar', 0),
            array('bar', 'foo bar', 4),
            array('bar', 'foo bar', 4, null),
@@ -616,13 +549,11 @@ abstract class CommonTest extends PHPUnit_Framework_TestCase
            array('ô b', 'fòô bàř', 2, 3, 'UTF-8'),
            array('', 'fòô bàř', 4, 0, 'UTF-8')
        );
-
-        return $testData;
    }

-    public function stringsForAt()
+    public function atProvider()
    {
-        $testData = array(
+        return array(
            array('f', 'foo bar', 0),
            array('o', 'foo bar', 1),
            array('r', 'foo bar', 6),
@@ -632,13 +563,11 @@ abstract class CommonTest extends PHPUnit_Framework_TestCase
            array('ř', 'fòô bàř', 6, 'UTF-8'),
            array('', 'fòô bàř', 7, 'UTF-8'),
        );
-
-        return $testData;
    }

-    public function stringsForFirst()
+    public function firstProvider()
    {
-        $testData = array(
+        return array(
            array('', 'foo bar', -5),
            array('', 'foo bar', 0),
            array('f', 'foo bar', 1),
@@ -652,13 +581,11 @@ abstract class CommonTest extends PHPUnit_Framework_TestCase
            array('fòô bàř', 'fòô bàř', 7, 'UTF-8'),
            array('fòô bàř', 'fòô bàř', 8, 'UTF-8'),
        );
-
-        return $testData;
    }

-    public function stringsForLast()
+    public function lastProvider()
    {
-        $testData = array(
+        return array(
            array('', 'foo bar', -5),
            array('', 'foo bar', 0),
            array('r', 'foo bar', 1),
@@ -672,13 +599,11 @@ abstract class CommonTest extends PHPUnit_Framework_TestCase
            array('fòô bàř', 'fòô bàř', 7, 'UTF-8'),
            array('fòô bàř', 'fòô bàř', 8, 'UTF-8'),
        );
-
-        return $testData;
    }

-    public function stringsForEnsureLeft()
+    public function ensureLeftProvider()
    {
-        $testData = array(
+        return array(
            array('foobar', 'foobar', 'f'),
            array('foobar', 'foobar', 'foo'),
            array('foo/foobar', 'foobar', 'foo/'),
@@ -690,13 +615,11 @@ abstract class CommonTest extends PHPUnit_Framework_TestCase
            array('http://fòôbàř', 'fòôbàř', 'http://', 'UTF-8'),
            array('http://fòôbàř', 'http://fòôbàř', 'http://', 'UTF-8'),
        );
-
-        return $testData;
    }

-    public function stringsForEnsureRight()
+    public function ensureRightProvider()
    {
-        $testData = array(
+        return array(
            array('foobar', 'foobar', 'r'),
            array('foobar', 'foobar', 'bar'),
            array('foobar/bar', 'foobar', '/bar'),
@@ -708,13 +631,11 @@ abstract class CommonTest extends PHPUnit_Framework_TestCase
            array('fòôbàř.com/', 'fòôbàř', '.com/', 'UTF-8'),
            array('fòôbàř.com/', 'fòôbàř.com/', '.com/', 'UTF-8'),
        );
-
-        return $testData;
    }

-    public function stringsForRemoveLeft()
+    public function removeLeftProvider()
    {
-        $testData = array(
+        return array(
            array('foo bar', 'foo bar', ''),
            array('oo bar', 'foo bar', 'f'),
            array('bar', 'foo bar', 'foo '),
@@ -726,13 +647,11 @@ abstract class CommonTest extends PHPUnit_Framework_TestCase
            array('fòô bàř', 'fòô bàř', 'òô', 'UTF-8'),
            array('fòô bàř', 'fòô bàř', 'òô bàř', 'UTF-8')
        );
-
-        return $testData;
    }

-    public function stringsForRemoveRight()
+    public function removeRightProvider()
    {
-        $testData = array(
+        return array(
            array('foo bar', 'foo bar', ''),
            array('foo ba', 'foo bar', 'r'),
            array('foo', 'foo bar', ' bar'),
@@ -744,13 +663,11 @@ abstract class CommonTest extends PHPUnit_Framework_TestCase
            array('fòô bàř', 'fòô bàř', 'bà', 'UTF-8'),
            array('fòô bàř', 'fòô bàř', 'fòô bà', 'UTF-8')
        );
-
-        return $testData;
    }

-    public function stringsForIsAlpha()
+    public function isAlphaProvider()
    {
-        $testData = array(
+        return array(
            array(true, ''),
            array(true, 'foobar'),
            array(false, 'foo bar'),
@@ -762,13 +679,11 @@ abstract class CommonTest extends PHPUnit_Framework_TestCase
            array(false, 'ҠѨњ¨ˆфгШ', 'UTF-8'),
            array(true, '丹尼爾', 'UTF-8')
        );
-
-        return $testData;
    }

-    public function stringsForIsAlphanumeric()
+    public function isAlphanumericProvider()
    {
-        $testData = array(
+        return array(
            array(true, ''),
            array(true, 'foobar1'),
            array(false, 'foo bar'),
@@ -783,13 +698,11 @@ abstract class CommonTest extends PHPUnit_Framework_TestCase
            array(true, 'دانيال1', 'UTF-8'),
            array(false, 'دانيال1 ', 'UTF-8')
        );
-
-        return $testData;
    }

-    public function stringsForIsBlank()
+    public function isBlankProvider()
    {
-        $testData = array(
+        return array(
            array(true, ''),
            array(true, ' '),
            array(true, "\n\t "),
@@ -803,13 +716,11 @@ abstract class CommonTest extends PHPUnit_Framework_TestCase
            array(false, '　z', 'UTF-8'),
            array(false, '　1', 'UTF-8'),
        );
-
-        return $testData;
    }

-    public function stringsForIsJson()
+    public function isJsonProvider()
    {
-        $testData = array(
+        return array(
            array(false, ''),
            array(false, '123'),
            array(true, '{"foo": "bar"}'),
@@ -825,13 +736,11 @@ abstract class CommonTest extends PHPUnit_Framework_TestCase
            array(true, '["fòô"]', 'UTF-8'),
            array(false, '{"fòô": "bàř"]', 'UTF-8'),
        );
-
-        return $testData;
    }

-    public function stringsForIsLowerCase()
+    public function isLowerCaseProvider()
    {
-        $testData = array(
+        return array(
            array(true, ''),
            array(true, 'foobar'),
            array(false, 'foo bar'),
@@ -841,13 +750,11 @@ abstract class CommonTest extends PHPUnit_Framework_TestCase
            array(false, 'fòô bàř', 'UTF-8'),
            array(false, 'fòôbÀŘ', 'UTF-8'),
        );
-
-        return $testData;
    }

-    public function stringsForIsSerialized()
+    public function isSerializedProvider()
    {
-        $testData = array(
+        return array(
            array(false, ''),
            array(true, 'a:1:{s:3:"foo";s:3:"bar";}'),
            array(false, 'a:1:{s:3:"foo";s:3:"bar"}'),
@@ -856,13 +763,11 @@ abstract class CommonTest extends PHPUnit_Framework_TestCase
            array(false, 'a:1:{s:5:"fòô";s:5:"bàř"}', 'UTF-8'),
            array(true, serialize(array('fòô' => 'bár')), 'UTF-8'),
        );
-
-        return $testData;
    }

-    public function stringsForIsUpperCase()
+    public function isUpperCaseProvider()
    {
-        $testData = array(
+        return array(
            array(true, ''),
            array(true, 'FOOBAR'),
            array(false, 'FOO BAR'),
@@ -872,13 +777,11 @@ abstract class CommonTest extends PHPUnit_Framework_TestCase
            array(false, 'FÒÔ BÀŘ', 'UTF-8'),
            array(false, 'FÒÔBàř', 'UTF-8'),
        );
-
-        return $testData;
    }

-    public function stringsForIsHexadecimal()
+    public function isHexadecimalProvider()
    {
-        $testData = array(
+        return array(
            array(true, ''),
            array(true, 'abcdef'),
            array(true, 'ABCDEF'),
@@ -893,13 +796,11 @@ abstract class CommonTest extends PHPUnit_Framework_TestCase
            array(false, '0123456789x', 'UTF-8'),
            array(false, 'ABCDEFx', 'UTF-8'),
        );
-
-        return $testData;
    }

-    public function stringsForCount()
+    public function countProvider()
    {
-        $testData = array(
+        return array(
            array(0, '', 'foo'),
            array(0, 'foo', 'bar'),
            array(1, 'foo bar', 'foo'),
@@ -916,13 +817,11 @@ abstract class CommonTest extends PHPUnit_Framework_TestCase
            array(2, 'fôòô bàř', 'Ô', false, 'UTF-8'),
            array(2, 'συγγραφέας', 'Σ', false, 'UTF-8')
        );
-
-        return $testData;
    }

-    public function stringsForReplace()
+    public function replaceProvider()
    {
-        $testData = array(
+        return array(
            array('', '', '', ''),
            array('foo', '', '', 'foo'),
            array('foo', '\s', '\s', 'foo'),
@@ -938,13 +837,11 @@ abstract class CommonTest extends PHPUnit_Framework_TestCase
            array('far bàř', 'fòô bàř', 'fòô', 'far', 'UTF-8'),
            array('bàř bàř', 'fòô bàř fòô bàř', 'fòô ', '', 'UTF-8'),
        );
-
-        return $testData;
    }

-    public function stringsForRegexReplace()
+    public function regexReplaceProvider()
    {
-        $testData = array(
+        return array(
            array('', '', '', ''),
            array('bar', 'foo', 'f[o]+', 'bar'),
            array('bar', 'foo bar', 'f[O]+\s', '', 'i'),
@@ -953,7 +850,5 @@ abstract class CommonTest extends PHPUnit_Framework_TestCase
            array('bàř', 'fòô ', 'f[òô]+\s', 'bàř', 'msr', 'UTF-8'),
            array('fòô', 'bàř', '[[:alpha:]]{3}', 'fòô', 'msr', 'UTF-8')
        );
-
-        return $testData;
    }
 }
--- a/tests/Stringy/StaticStringyTest.php
+++ b/tests/Stringy/StaticStringyTest.php
@@ -8,7 +8,7 @@ use Stringy\StaticStringy as S;
 class StaticStringyTestCase extends CommonTest
 {
    /**
-     * @dataProvider stringsForUpperCaseFirst
+     * @dataProvider upperCaseFirstProvider()
     */
    public function testUpperCaseFirst($expected, $str, $encoding = null)
    {
@@ -18,7 +18,7 @@ class StaticStringyTestCase extends CommonTest
    }

    /**
-     * @dataProvider stringsForLowerCaseFirst
+     * @dataProvider lowerCaseFirstProvider()
     */
    public function testLowerCaseFirst($expected, $str, $encoding = null)
    {
@@ -28,7 +28,7 @@ class StaticStringyTestCase extends CommonTest
    }

    /**
-     * @dataProvider stringsForCamelize
+     * @dataProvider camelizeProvider()
     */
    public function testCamelize($expected, $str, $encoding = null)
    {
@@ -38,7 +38,7 @@ class StaticStringyTestCase extends CommonTest
    }

    /**
-     * @dataProvider stringsForUpperCamelize
+     * @dataProvider upperCamelizeProvider()
     */
    public function testUpperCamelize($expected, $str, $encoding = null)
    {
@@ -48,7 +48,7 @@ class StaticStringyTestCase extends CommonTest
    }

    /**
-     * @dataProvider stringsForDasherize
+     * @dataProvider dasherizeProvider()
     */
    public function testDasherize($expected, $str, $encoding = null)
    {
@@ -58,7 +58,7 @@ class StaticStringyTestCase extends CommonTest
    }

    /**
-     * @dataProvider stringsForUnderscored
+     * @dataProvider underscoredProvider()
     */
    public function testUnderscored($expected, $str, $encoding = null)
    {
@@ -68,7 +68,7 @@ class StaticStringyTestCase extends CommonTest
    }

    /**
-     * @dataProvider stringsForSwapCase
+     * @dataProvider swapCaseProvider()
     */
    public function testSwapCase($expected, $str, $encoding = null)
    {
@@ -78,7 +78,7 @@ class StaticStringyTestCase extends CommonTest
    }

    /**
-     * @dataProvider stringsForTitleize
+     * @dataProvider titleizeProvider()
     */
    public function testTitleize($expected, $str, $ignore = null,
                                 $encoding = null)
@@ -89,7 +89,7 @@ class StaticStringyTestCase extends CommonTest
    }

    /**
-     * @dataProvider stringsForHumanize
+     * @dataProvider humanizeProvider()
     */
    public function testHumanize($expected, $str, $encoding = null)
    {
@@ -99,7 +99,7 @@ class StaticStringyTestCase extends CommonTest
    }

    /**
-     * @dataProvider stringsForTidy
+     * @dataProvider tidyProvider()
     */
    public function testTidy($expected, $str)
    {
@@ -109,7 +109,7 @@ class StaticStringyTestCase extends CommonTest
    }

    /**
-     * @dataProvider stringsForCollapseWhitespace
+     * @dataProvider collapseWhitespaceProvider()
     */
    public function testCollapseWhitespace($expected, $str, $encoding = null)
    {
@@ -119,7 +119,7 @@ class StaticStringyTestCase extends CommonTest
    }

    /**
-     * @dataProvider stringsForToAscii
+     * @dataProvider toAsciiProvider()
     */
    public function testToAscii($expected, $str)
    {
@@ -129,7 +129,7 @@ class StaticStringyTestCase extends CommonTest
    }

    /**
-     * @dataProvider stringsForPad
+     * @dataProvider padProvider()
     */
    public function testPad($expected, $str, $length, $padStr = ' ',
                            $padType = 'right', $encoding = null)
@@ -148,7 +148,7 @@ class StaticStringyTestCase extends CommonTest
    }

    /**
-     * @dataProvider stringsForPadLeft
+     * @dataProvider padLeftProvider()
     */
    public function testPadLeft($expected, $str, $length, $padStr = ' ',
                                $encoding = null)
@@ -159,7 +159,7 @@ class StaticStringyTestCase extends CommonTest
    }

    /**
-     * @dataProvider stringsForPadRight
+     * @dataProvider padRightProvider()
     */
    public function testPadRight($expected, $str, $length, $padStr = ' ',
                                 $encoding = null)
@@ -170,7 +170,7 @@ class StaticStringyTestCase extends CommonTest
    }

    /**
-     * @dataProvider stringsForPadBoth
+     * @dataProvider padBothProvider()
     */
    public function testPadBoth($expected, $str, $length, $padStr = ' ',
                                $encoding = null)
@@ -181,10 +181,10 @@ class StaticStringyTestCase extends CommonTest
    }

    /**
-     * @dataProvider stringsForStartsWith
+     * @dataProvider startsWithProvider()
     */
    public function testStartsWith($expected, $str, $substring,
-                                $caseSensitive = true, $encoding = null)
+                                   $caseSensitive = true, $encoding = null)
    {
        $result = S::startsWith($str, $substring, $caseSensitive, $encoding);
        $this->assertInternalType('boolean', $result);
@@ -192,10 +192,10 @@ class StaticStringyTestCase extends CommonTest
    }

    /**
-     * @dataProvider stringsForEndsWith
+     * @dataProvider endsWithProvider()
     */
    public function testEndsWith($expected, $str, $substring,
-                                $caseSensitive = true, $encoding = null)
+                                 $caseSensitive = true, $encoding = null)
    {
        $result = S::endsWith($str, $substring, $caseSensitive, $encoding);
        $this->assertInternalType('boolean', $result);
@@ -203,7 +203,7 @@ class StaticStringyTestCase extends CommonTest
    }

    /**
-     * @dataProvider stringsForToSpaces
+     * @dataProvider toSpacesProvider()
     */
    public function testToSpaces($expected, $str, $tabLength = 4)
    {
@@ -213,7 +213,7 @@ class StaticStringyTestCase extends CommonTest
    }

    /**
-     * @dataProvider stringsForToTabs
+     * @dataProvider toTabsProvider()
     */
    public function testToTabs($expected, $str, $tabLength = 4)
    {
@@ -223,7 +223,7 @@ class StaticStringyTestCase extends CommonTest
    }

    /**
-     * @dataProvider stringsForToLowerCase
+     * @dataProvider toLowerCaseProvider()
     */
    public function testToLowerCase($expected, $str, $encoding = null)
    {
@@ -233,7 +233,7 @@ class StaticStringyTestCase extends CommonTest
    }

    /**
-     * @dataProvider stringsForToUpperCase
+     * @dataProvider toUpperCaseProvider()
     */
    public function testToUpperCase($expected, $str, $encoding = null)
    {
@@ -243,17 +243,17 @@ class StaticStringyTestCase extends CommonTest
    }

    /**
-     * @dataProvider stringsForSlugify
+     * @dataProvider slugifyProvider()
     */
-    public function testSlugify($expected, $str)
+    public function testSlugify($expected, $str, $replacement = '-')
    {
-        $result = S::slugify($str);
+        $result = S::slugify($str, $replacement);
        $this->assertInternalType('string', $result);
        $this->assertEquals($expected, $result);
    }

    /**
-     * @dataProvider stringsForContains
+     * @dataProvider containsProvider()
     */
    public function testContains($expected, $haystack, $needle,
                                 $caseSensitive = true, $encoding = null)
@@ -264,7 +264,7 @@ class StaticStringyTestCase extends CommonTest
    }

    /**
-     * @dataProvider stringsForSurround
+     * @dataProvider surroundProvider()
     */
    public function testSurround($expected, $str, $substring)
    {
@@ -274,7 +274,7 @@ class StaticStringyTestCase extends CommonTest
    }

    /**
-     * @dataProvider stringsForInsert
+     * @dataProvider insertProvider()
     */
    public function testInsert($expected, $str, $substring, $index,
                               $encoding = null)
@@ -285,7 +285,7 @@ class StaticStringyTestCase extends CommonTest
    }

    /**
-     * @dataProvider stringsForTruncate
+     * @dataProvider truncateProvider()
     */
    public function testTruncate($expected, $str, $length, $substring = '',
                                 $encoding = null)
@@ -296,7 +296,7 @@ class StaticStringyTestCase extends CommonTest
    }

    /**
-     * @dataProvider stringsForSafeTruncate
+     * @dataProvider safeTruncateProvider()
     */
    public function testSafeTruncate($expected, $str, $length, $substring = '',
                                     $encoding = null)
@@ -307,7 +307,7 @@ class StaticStringyTestCase extends CommonTest
    }

    /**
-     * @dataProvider stringsForReverse
+     * @dataProvider reverseProvider()
     */
    public function testReverse($expected, $str, $encoding = null)
    {
@@ -317,7 +317,7 @@ class StaticStringyTestCase extends CommonTest
    }

    /**
-     * @dataProvider stringsForShuffle
+     * @dataProvider shuffleProvider()
     */
    public function testShuffle($str, $encoding = null)
    {
@@ -338,7 +338,7 @@ class StaticStringyTestCase extends CommonTest
    }

    /**
-     * @dataProvider stringsForTrim
+     * @dataProvider trimProvider()
     */
    public function testTrim($expected, $str)
    {
@@ -348,7 +348,7 @@ class StaticStringyTestCase extends CommonTest
    }

    /**
-     * @dataProvider stringsForLongestCommonPrefix
+     * @dataProvider longestCommonPrefixProvider()
     */
    public function testLongestCommonPrefix($expected, $str, $otherStr,
                                            $encoding = null)
@@ -359,7 +359,7 @@ class StaticStringyTestCase extends CommonTest
    }

    /**
-     * @dataProvider stringsForLongestCommonSuffix
+     * @dataProvider longestCommonSuffixProvider()
     */
    public function testLongestCommonSuffix($expected, $str, $otherStr,
                                            $encoding = null)
@@ -370,7 +370,7 @@ class StaticStringyTestCase extends CommonTest
    }

    /**
-     * @dataProvider stringsForLongestCommonSubstring
+     * @dataProvider longestCommonSubstringProvider()
     */
    public function testLongestCommonSubstring($expected, $str, $otherStr,
                                               $encoding = null)
@@ -381,7 +381,7 @@ class StaticStringyTestCase extends CommonTest
    }

    /**
-     * @dataProvider stringsForLength
+     * @dataProvider lengthProvider()
     */
    public function testLength($expected, $str, $encoding = null)
    {
@@ -391,7 +391,7 @@ class StaticStringyTestCase extends CommonTest
    }

    /**
-     * @dataProvider stringsForSubstr
+     * @dataProvider substrProvider()
     */
    public function testSubstr($expected, $str, $start, $length = null,
                               $encoding = null)
@@ -402,7 +402,7 @@ class StaticStringyTestCase extends CommonTest
    }

    /**
-     * @dataProvider stringsForAt
+     * @dataProvider atProvider()
     */
    public function testAt($expected, $str, $index, $encoding = null)
    {
@@ -412,7 +412,7 @@ class StaticStringyTestCase extends CommonTest
    }

    /**
-     * @dataProvider stringsForFirst
+     * @dataProvider firstProvider()
     */
    public function testFirst($expected, $str, $n, $encoding = null)
    {
@@ -422,7 +422,7 @@ class StaticStringyTestCase extends CommonTest
    }

    /**
-     * @dataProvider stringsForLast
+     * @dataProvider lastProvider()
     */
    public function testLast($expected, $str, $n, $encoding = null)
    {
@@ -432,7 +432,7 @@ class StaticStringyTestCase extends CommonTest
    }

    /**
-     * @dataProvider stringsForEnsureLeft
+     * @dataProvider ensureLeftProvider()
     */
    public function testEnsureLeft($expected, $str, $substring, $encoding = null)
    {
@@ -442,7 +442,7 @@ class StaticStringyTestCase extends CommonTest
    }

    /**
-     * @dataProvider stringsForEnsureRight
+     * @dataProvider ensureRightProvider()
     */
    public function testEnsureRight($expected, $str, $substring, $encoding = null)
    {
@@ -452,7 +452,7 @@ class StaticStringyTestCase extends CommonTest
    }

    /**
-     * @dataProvider stringsForRemoveLeft
+     * @dataProvider removeLeftProvider()
     */
    public function testRemoveLeft($expected, $str, $substring, $encoding = null)
    {
@@ -462,7 +462,7 @@ class StaticStringyTestCase extends CommonTest
    }

    /**
-     * @dataProvider stringsForRemoveRight
+     * @dataProvider removeRightProvider()
     */
    public function testRemoveRight($expected, $str, $substring, $encoding = null)
    {
@@ -472,7 +472,7 @@ class StaticStringyTestCase extends CommonTest
    }

    /**
-     * @dataProvider stringsForIsAlpha
+     * @dataProvider isAlphaProvider()
     */
    public function testIsAlpha($expected, $str, $encoding = null)
    {
@@ -482,7 +482,7 @@ class StaticStringyTestCase extends CommonTest
    }

    /**
-     * @dataProvider stringsForIsAlphanumeric
+     * @dataProvider isAlphanumericProvider()
     */
    public function testIsAlphanumeric($expected, $str, $encoding = null)
    {
@@ -492,7 +492,7 @@ class StaticStringyTestCase extends CommonTest
    }

    /**
-     * @dataProvider stringsForIsBlank
+     * @dataProvider isBlankProvider()
     */
    public function testIsBlank($expected, $str, $encoding = null)
    {
@@ -500,9 +500,9 @@ class StaticStringyTestCase extends CommonTest
        $this->assertInternalType('boolean', $result);
        $this->assertEquals($expected, $result);
    }
-    
+
    /**
-     * @dataProvider stringsForIsJson
+     * @dataProvider isJsonProvider()
     */
    public function testIsJson($expected, $str, $encoding = null)
    {
@@ -512,7 +512,7 @@ class StaticStringyTestCase extends CommonTest
    }

    /**
-     * @dataProvider stringsForIsLowerCase
+     * @dataProvider isLowerCaseProvider()
     */
    public function testIsLowerCase($expected, $str, $encoding = null)
    {
@@ -522,7 +522,7 @@ class StaticStringyTestCase extends CommonTest
    }

    /**
-     * @dataProvider stringsForIsSerialized
+     * @dataProvider isSerializedProvider()
     */
    public function testIsSerialized($expected, $str, $encoding = null)
    {
@@ -532,7 +532,7 @@ class StaticStringyTestCase extends CommonTest
    }

    /**
-     * @dataProvider stringsForIsUpperCase
+     * @dataProvider isUpperCaseProvider()
     */
    public function testIsUpperCase($expected, $str, $encoding = null)
    {
@@ -542,7 +542,7 @@ class StaticStringyTestCase extends CommonTest
    }

    /**
-     * @dataProvider stringsForIsHexadecimal
+     * @dataProvider isHexadecimalProvider()
     */
    public function testIsHexadecimal($expected, $str, $encoding = null)
    {
@@ -552,7 +552,7 @@ class StaticStringyTestCase extends CommonTest
    }

    /**
-     * @dataProvider stringsForCount
+     * @dataProvider countProvider()
     */
    public function testCount($expected, $str, $substring, $caseSensitive = true,
                              $encoding = null)
@@ -563,7 +563,7 @@ class StaticStringyTestCase extends CommonTest
    }

    /**
-     * @dataProvider stringsForReplace
+     * @dataProvider replaceProvider()
     */
    public function testReplace($expected, $str, $search, $replacement,
                                $encoding = null)
@@ -574,7 +574,7 @@ class StaticStringyTestCase extends CommonTest
    }

    /**
-     * @dataProvider stringsForRegexReplace
+     * @dataProvider regexReplaceProvider()
     */
    public function testRegexReplace($expected, $str, $pattern, $replacement,
                                     $options = 'msr', $encoding = null)
--- a/tests/Stringy/StringyTest.php
+++ b/tests/Stringy/StringyTest.php
@@ -11,15 +11,54 @@ class StringyTestCase extends CommonTest
    {
        $stringy = new S('foo bar', 'UTF-8');
        $this->assertInstanceOf('Stringy\Stringy', $stringy);
-        $this->assertEquals('foo bar', $stringy->str);
+        $this->assertEquals('foo bar', (string) $stringy);
        $this->assertEquals('UTF-8', $stringy->encoding);
    }

+    /**
+     * @expectedException InvalidArgumentException
+     */
+    public function testConstructWithArray()
+    {
+        (string) new S(array());
+        $this->fail('Expecting exception when the constructor is passed an array');
+    }
+
+    /**
+     * @expectedException InvalidArgumentException
+     */
+    public function testMissingToString()
+    {
+        (string) new S(new stdClass());
+        $this->fail('Expecting exception when the constructor is passed an ' .
+                    'object without a __toString method');
+    }
+
+    /**
+     * @dataProvider toStringProvider()
+     */
+    public function testToString($expected, $str)
+    {
+        $this->assertEquals($expected, (string) new S($str));
+    }
+
+    public function toStringProvider()
+    {
+        return array(
+            array('', null),
+            array('', false),
+            array('1', true),
+            array('-9', -9),
+            array('1.18', 1.18),
+            array(' string  ', ' string  ')
+        );
+    }
+
    public function testCreate()
    {
        $stringy = S::create('foo bar', 'UTF-8');
        $this->assertInstanceOf('Stringy\Stringy', $stringy);
-        $this->assertEquals('foo bar', $stringy->str);
+        $this->assertEquals('foo bar', (string) $stringy);
        $this->assertEquals('UTF-8', $stringy->encoding);
    }

@@ -32,7 +71,7 @@ class StringyTestCase extends CommonTest
    }

    /**
-     * @dataProvider stringsForUpperCaseFirst
+     * @dataProvider upperCaseFirstProvider()
     */
    public function testUpperCaseFirst($expected, $str, $encoding = null)
    {
@@ -42,7 +81,7 @@ class StringyTestCase extends CommonTest
    }

    /**
-     * @dataProvider stringsForLowerCaseFirst
+     * @dataProvider lowerCaseFirstProvider()
     */
    public function testLowerCaseFirst($expected, $str, $encoding = null)
    {
@@ -54,7 +93,7 @@ class StringyTestCase extends CommonTest
    }

    /**
-     * @dataProvider stringsForCamelize
+     * @dataProvider camelizeProvider()
     */
    public function testCamelize($expected, $str, $encoding = null)
    {
@@ -66,7 +105,7 @@ class StringyTestCase extends CommonTest
    }

    /**
-     * @dataProvider stringsForUpperCamelize
+     * @dataProvider upperCamelizeProvider()
     */
    public function testUpperCamelize($expected, $str, $encoding = null)
    {
@@ -78,7 +117,7 @@ class StringyTestCase extends CommonTest
    }

    /**
-     * @dataProvider stringsForDasherize
+     * @dataProvider dasherizeProvider()
     */
    public function testDasherize($expected, $str, $encoding = null)
    {
@@ -90,7 +129,7 @@ class StringyTestCase extends CommonTest
    }

    /**
-     * @dataProvider stringsForUnderscored
+     * @dataProvider underscoredProvider()
     */
    public function testUnderscored($expected, $str, $encoding = null)
    {
@@ -102,7 +141,7 @@ class StringyTestCase extends CommonTest
    }

    /**
-     * @dataProvider stringsForSwapCase
+     * @dataProvider swapCaseProvider()
     */
    public function testSwapCase($expected, $str, $encoding = null)
    {
@@ -114,7 +153,7 @@ class StringyTestCase extends CommonTest
    }

    /**
-     * @dataProvider stringsForTitleize
+     * @dataProvider titleizeProvider()
     */
    public function testTitleize($expected, $str, $ignore = null,
                                 $encoding = null)
@@ -127,7 +166,7 @@ class StringyTestCase extends CommonTest
    }

    /**
-     * @dataProvider stringsForHumanize
+     * @dataProvider humanizeProvider()
     */
    public function testHumanize($expected, $str, $encoding = null)
    {
@@ -139,7 +178,7 @@ class StringyTestCase extends CommonTest
    }

    /**
-     * @dataProvider stringsForTidy
+     * @dataProvider tidyProvider()
     */
    public function testTidy($expected, $str)
    {
@@ -151,7 +190,7 @@ class StringyTestCase extends CommonTest
    }

    /**
-     * @dataProvider stringsForCollapseWhitespace
+     * @dataProvider collapseWhitespaceProvider()
     */
    public function testCollapseWhitespace($expected, $str, $encoding = null)
    {
@@ -163,7 +202,7 @@ class StringyTestCase extends CommonTest
    }

    /**
-     * @dataProvider stringsForToAscii
+     * @dataProvider toAsciiProvider()
     */
    public function testToAscii($expected, $str)
    {
@@ -175,7 +214,7 @@ class StringyTestCase extends CommonTest
    }

    /**
-     * @dataProvider stringsForPad
+     * @dataProvider padProvider()
     */
    public function testPad($expected, $str, $length, $padStr = ' ',
                            $padType = 'right', $encoding = null)
@@ -197,7 +236,7 @@ class StringyTestCase extends CommonTest
    }

    /**
-     * @dataProvider stringsForPadLeft
+     * @dataProvider padLeftProvider()
     */
    public function testPadLeft($expected, $str, $length, $padStr = ' ',
                                $encoding = null)
@@ -210,7 +249,7 @@ class StringyTestCase extends CommonTest
    }

    /**
-     * @dataProvider stringsForPadRight
+     * @dataProvider padRightProvider()
     */
    public function testPadRight($expected, $str, $length, $padStr = ' ',
                                 $encoding = null)
@@ -223,7 +262,7 @@ class StringyTestCase extends CommonTest
    }

    /**
-     * @dataProvider stringsForPadBoth
+     * @dataProvider padBothProvider()
     */
    public function testPadBoth($expected, $str, $length, $padStr = ' ',
                                $encoding = null)
@@ -236,10 +275,10 @@ class StringyTestCase extends CommonTest
    }

    /**
-     * @dataProvider stringsForStartsWith
+     * @dataProvider startsWithProvider()
     */
    public function testStartsWith($expected, $str, $substring,
-                                $caseSensitive = true, $encoding = null)
+                                   $caseSensitive = true, $encoding = null)
    {
        $stringy = S::create($str, $encoding);
        $result = $stringy->startsWith($substring, $caseSensitive);
@@ -249,10 +288,10 @@ class StringyTestCase extends CommonTest
    }

    /**
-     * @dataProvider stringsForEndsWith
+     * @dataProvider endsWithProvider()
     */
    public function testEndsWith($expected, $str, $substring,
-                                $caseSensitive = true, $encoding = null)
+                                 $caseSensitive = true, $encoding = null)
    {
        $stringy = S::create($str, $encoding);
        $result = $stringy->endsWith($substring, $caseSensitive);
@@ -262,7 +301,7 @@ class StringyTestCase extends CommonTest
    }

    /**
-     * @dataProvider stringsForToSpaces
+     * @dataProvider toSpacesProvider()
     */
    public function testToSpaces($expected, $str, $tabLength = 4)
    {
@@ -274,7 +313,7 @@ class StringyTestCase extends CommonTest
    }

    /**
-     * @dataProvider stringsForToTabs
+     * @dataProvider toTabsProvider()
     */
    public function testToTabs($expected, $str, $tabLength = 4)
    {
@@ -286,7 +325,7 @@ class StringyTestCase extends CommonTest
    }

    /**
-     * @dataProvider stringsForToLowerCase
+     * @dataProvider toLowerCaseProvider()
     */
    public function testToLowerCase($expected, $str, $encoding = null)
    {
@@ -298,7 +337,7 @@ class StringyTestCase extends CommonTest
    }

    /**
-     * @dataProvider stringsForToUpperCase
+     * @dataProvider toUpperCaseProvider()
     */
    public function testToUpperCase($expected, $str, $encoding = null)
    {
@@ -310,19 +349,19 @@ class StringyTestCase extends CommonTest
    }

    /**
-     * @dataProvider stringsForSlugify
+     * @dataProvider slugifyProvider()
     */
-    public function testSlugify($expected, $str)
+    public function testSlugify($expected, $str, $replacement = '-')
    {
        $stringy = S::create($str);
-        $result = $stringy->slugify();
+        $result = $stringy->slugify($replacement);
        $this->assertInstanceOf('Stringy\Stringy', $result);
        $this->assertEquals($expected, $result);
        $this->assertEquals($str, $stringy);
    }

    /**
-     * @dataProvider stringsForContains
+     * @dataProvider containsProvider()
     */
    public function testContains($expected, $haystack, $needle,
                                 $caseSensitive = true, $encoding = null)
@@ -335,7 +374,7 @@ class StringyTestCase extends CommonTest
    }

    /**
-     * @dataProvider stringsForSurround
+     * @dataProvider surroundProvider()
     */
    public function testSurround($expected, $str, $substring)
    {
@@ -347,7 +386,7 @@ class StringyTestCase extends CommonTest
    }

    /**
-     * @dataProvider stringsForInsert
+     * @dataProvider insertProvider()
     */
    public function testInsert($expected, $str, $substring, $index,
                               $encoding = null)
@@ -360,7 +399,7 @@ class StringyTestCase extends CommonTest
    }

    /**
-     * @dataProvider stringsForTruncate
+     * @dataProvider truncateProvider()
     */
    public function testTruncate($expected, $str, $length, $substring = '',
                                 $encoding = null)
@@ -373,7 +412,7 @@ class StringyTestCase extends CommonTest
    }

    /**
-     * @dataProvider stringsForReverse
+     * @dataProvider reverseProvider()
     */
    public function testReverse($expected, $str, $encoding = null)
    {
@@ -385,7 +424,7 @@ class StringyTestCase extends CommonTest
    }

    /**
-     * @dataProvider stringsForShuffle
+     * @dataProvider shuffleProvider()
     */
    public function testShuffle($str, $encoding = null)
    {
@@ -408,7 +447,7 @@ class StringyTestCase extends CommonTest
    }

    /**
-     * @dataProvider stringsForTrim
+     * @dataProvider trimProvider()
     */
    public function testTrim($expected, $str)
    {
@@ -420,7 +459,7 @@ class StringyTestCase extends CommonTest
    }

    /**
-     * @dataProvider stringsForLongestCommonPrefix
+     * @dataProvider longestCommonPrefixProvider()
     */
    public function testLongestCommonPrefix($expected, $str, $otherStr,
                                            $encoding = null)
@@ -433,7 +472,7 @@ class StringyTestCase extends CommonTest
    }

    /**
-     * @dataProvider stringsForLongestCommonSubstring
+     * @dataProvider longestCommonSubstringProvider()
     */
    public function testLongestCommonSubstring($expected, $str, $otherStr,
                                               $encoding = null)
@@ -446,7 +485,7 @@ class StringyTestCase extends CommonTest
    }

    /**
-     * @dataProvider stringsForLength
+     * @dataProvider lengthProvider()
     */
    public function testLength($expected, $str, $encoding = null)
    {
@@ -458,7 +497,7 @@ class StringyTestCase extends CommonTest
    }

    /**
-     * @dataProvider stringsForSubstr
+     * @dataProvider substrProvider()
     */
    public function testSubstr($expected, $str, $start, $length = null,
                               $encoding = null)
@@ -471,7 +510,7 @@ class StringyTestCase extends CommonTest
    }

    /**
-     * @dataProvider stringsForAt
+     * @dataProvider atProvider()
     */
    public function testAt($expected, $str, $index, $encoding = null)
    {
@@ -483,7 +522,7 @@ class StringyTestCase extends CommonTest
    }

    /**
-     * @dataProvider stringsForFirst
+     * @dataProvider firstProvider()
     */
    public function testFirst($expected, $str, $n, $encoding = null)
    {
@@ -495,7 +534,7 @@ class StringyTestCase extends CommonTest
    }

    /**
-     * @dataProvider stringsForLast
+     * @dataProvider lastProvider()
     */
    public function testLast($expected, $str, $n, $encoding = null)
    {
@@ -507,7 +546,7 @@ class StringyTestCase extends CommonTest
    }

    /**
-     * @dataProvider stringsForEnsureLeft
+     * @dataProvider ensureLeftProvider()
     */
    public function testEnsureLeft($expected, $str, $substring, $encoding = null)
    {
@@ -519,7 +558,7 @@ class StringyTestCase extends CommonTest
    }

    /**
-     * @dataProvider stringsForEnsureRight
+     * @dataProvider ensureRightProvider()
     */
    public function testEnsureRight($expected, $str, $substring, $encoding = null)
    {
@@ -531,7 +570,7 @@ class StringyTestCase extends CommonTest
    }

    /**
-     * @dataProvider stringsForRemoveLeft
+     * @dataProvider removeLeftProvider()
     */
    public function testRemoveLeft($expected, $str, $substring, $encoding = null)
    {
@@ -543,7 +582,7 @@ class StringyTestCase extends CommonTest
    }

    /**
-     * @dataProvider stringsForRemoveRight
+     * @dataProvider removeRightProvider()
     */
    public function testRemoveRight($expected, $str, $substring, $encoding = null)
    {
@@ -555,7 +594,7 @@ class StringyTestCase extends CommonTest
    }

    /**
-     * @dataProvider stringsForIsAlpha
+     * @dataProvider isAlphaProvider()
     */
    public function testIsAlpha($expected, $str, $encoding = null)
    {
@@ -567,7 +606,7 @@ class StringyTestCase extends CommonTest
    }

    /**
-     * @dataProvider stringsForIsAlphanumeric
+     * @dataProvider isAlphanumericProvider()
     */
    public function testIsAlphanumeric($expected, $str, $encoding = null)
    {
@@ -579,7 +618,7 @@ class StringyTestCase extends CommonTest
    }

    /**
-     * @dataProvider stringsForIsBlank
+     * @dataProvider isBlankProvider()
     */
    public function testIsBlank($expected, $str, $encoding = null)
    {
@@ -591,7 +630,7 @@ class StringyTestCase extends CommonTest
    }

    /**
-     * @dataProvider stringsForIsJson
+     * @dataProvider isJsonProvider()
     */
    public function testIsJson($expected, $str, $encoding = null)
    {
@@ -603,7 +642,7 @@ class StringyTestCase extends CommonTest
    }

    /**
-     * @dataProvider stringsForIsLowerCase
+     * @dataProvider isLowerCaseProvider()
     */
    public function testIsLowerCase($expected, $str, $encoding = null)
    {
@@ -615,7 +654,7 @@ class StringyTestCase extends CommonTest
    }

    /**
-     * @dataProvider stringsForIsSerialized
+     * @dataProvider isSerializedProvider()
     */
    public function testIsSerialized($expected, $str, $encoding = null)
    {
@@ -627,7 +666,7 @@ class StringyTestCase extends CommonTest
    }

    /**
-     * @dataProvider stringsForIsUpperCase
+     * @dataProvider isUpperCaseProvider()
     */
    public function testIsUpperCase($expected, $str, $encoding = null)
    {
@@ -639,7 +678,7 @@ class StringyTestCase extends CommonTest
    }

    /**
-     * @dataProvider stringsForIsHexadecimal
+     * @dataProvider isHexadecimalProvider()
     */
    public function testIsHexadecimal($expected, $str, $encoding = null)
    {
@@ -651,7 +690,7 @@ class StringyTestCase extends CommonTest
    }

    /**
-     * @dataProvider stringsForCount
+     * @dataProvider countProvider()
     */
    public function testCount($expected, $str, $substring, $caseSensitive = true,
                              $encoding = null)
@@ -664,7 +703,7 @@ class StringyTestCase extends CommonTest
    }

    /**
-     * @dataProvider stringsForReplace
+     * @dataProvider replaceProvider()
     */
    public function testReplace($expected, $str, $search, $replacement,
                                $encoding = null)
@@ -677,7 +716,7 @@ class StringyTestCase extends CommonTest
    }

    /**
-     * @dataProvider stringsForRegexReplace
+     * @dataProvider regexReplaceProvider()
     */
    public function testregexReplace($expected, $str, $pattern, $replacement,
                                     $options = 'msr', $encoding = null)
Author	SHA1	Message	Date
Daniel St. Jules	9f930262af	Update changelog for 1.3.0	2013-12-16 21:04:30 -05:00
Daniel St. Jules	c230885a13	Require objects to have a __toString method, update readme	2013-12-15 01:08:23 -05:00
Daniel St. Jules	1f25d0c793	Merge Pull Request #18	2013-12-15 00:15:34 -05:00
Daniel St. Jules	0e70d72352	Merge pull request #16 from ivank/patch-2 Support Bulgarian in toAscii	2013-12-13 06:32:34 -08:00
Ivan Kerin	d54628e6ae	Support Bulgarian in toAscii The “proper” bulgarian translitaration should encode ь to y [1], However, since its not really that important to understand the actual word, very rearly used and breaks compatibility with Russian, it might be best to just leave it be, since Russian is a much larger torget. [1] http://en.wikipedia.org/wiki/Romanization_of_Bulgarian	2013-12-13 11:05:23 +00:00
gotterdemarung	7335ee5c88	fixed T_OBJECT_OPERATOR issue in PHP 5.3	2013-12-10 23:10:44 +02:00
gotterdemarung	5e01d895db	titleize refactoring to avoid visibility problems in PHP 5.3	2013-12-10 22:59:10 +02:00
gotterdemarung	3458fd79fd	Stringy->$str became private to ensure its sting content and guarantee zero-exception __toString() execution	2013-12-10 22:34:19 +02:00
gotterdemarung	6e5e5e055f	primitives check in constructor & toString	2013-12-10 22:19:42 +02:00
gotterdemarung	88d5973701	Implicit cast argument to string in constructor	2013-12-10 22:15:58 +02:00
gotterdemarung	75404a0338	Stringy must correctly handle non-string arguments and implicitly cast to string to avoid problems in __toString() method	2013-12-10 22:15:28 +02:00
Daniel St. Jules	bc96cdad0c	Merge pull request #17 from floriansemm/master fix typo in pad function call	2013-12-09 20:55:26 -08:00
Florian Semm	6014ff52df	fix typo in pad function call	2013-12-09 15:15:45 +01:00
Daniel St. Jules	6ba29637b2	Updated changelog for 1.2.2	2013-12-04 23:36:17 -05:00
Daniel St. Jules	2ada00ff62	Add logo	2013-12-01 15:43:03 -05:00
Daniel St. Jules	2a197244a5	Update readme and comments for new slugify param	2013-11-27 01:14:09 -05:00
Daniel St. Jules	8b1a91fe0c	Merge pull request #15 from glynnforrest/slug Adding optional $replacement parameter to slugify.	2013-11-26 22:03:02 -08:00
Glynn Forrest	906f217dc1	Adding optional $replacement parameter to slugify.	2013-11-26 14:11:41 +00:00
Daniel St. Jules	d4baab7583	Merge pull request #14 from sergebezborodov/master Use late static bindings in Stringy::create	2013-11-05 20:00:18 -08:00
Serge Bezborodov	0c8f0e9083	changes in create function	2013-11-01 09:55:38 +02:00
Daniel St. Jules	2155447ce8	Updated changelog for 1.2.1	2013-10-11 01:19:53 -04:00
Daniel St. Jules	77efce3a38	Added homepage to composer.json	2013-10-11 01:17:17 -04:00
Daniel St. Jules	f6085ed2cb	Cleanup tests a bit Getting over my irrational fear of multi-line return statements	2013-09-27 20:13:04 -04:00