Initial commit

Author: norberttech

.gitignore

@@ -0,0 +1,5 @@
+vendor/
+bin/
+composer.lock
+.DS_Store
+.idea

.travis.yml

@@ -0,0 +1,12 @@
+language: php
+
+php:
+    - 5.3
+    - 5.4
+    - 5.5
+
+before_script:
+    - curl -s http://getcomposer.org/installer | php
+    - php composer.phar --dev install
+
+script: phpspec r -v

LICENCE

@@ -0,0 +1,22 @@
+Copyright (c) 2014 Michal Dabrowski, Norbert Orzechowicz
+
+Permission is hereby granted, free of charge, to any person
+obtaining a copy of this software and associated documentation
+files (the "Software"), to deal in the Software without
+restriction, including without limitation the rights to use,
+copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the
+Software is furnished to do so, subject to the following
+conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
+OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
+HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
+OTHER DEALINGS IN THE SOFTWARE.

README.md

@@ -0,0 +1,40 @@
+# PHP To String
+
+Simple library that allows you to cast any php value into string
+
+##Installation
+
+Add to your composer.json
+
+```
+require: {
+   "coduo/php-to-string": "dev-master"
+}
+```
+
+##Usage
+
+Supported types:
+
+* string
+* integer
+* float/double
+* objec
+* array
+* resource
+
+```php
+$double = new \Coduo\ToString\String(1.12312);
+echo $double; // "1.12312"
+
+$datetime = new \Coduo\ToString\String(new \DateTime());
+echo $datetime; // "\DateTime"
+
+$array = new \Coduo\ToString\String(array('foo', 'bar', 'baz'));
+echo $array; // "Array(3)"
+
+$res = fopen(sys_get_temp_dir() . "/foo", "w");
+$resource = new \Coduo\ToString\String($res);
+echo $resource; // "Resource(stream)"
+
+```

composer.json

@@ -0,0 +1,33 @@
+{
+    "name": "coduo/php-to-string",
+    "type": "library",
+    "keywords": ["string", "php", "to string", "to"],
+    "license": "MIT", 
+    "authors": [
+        {
+            "name": "Michał Dąbrowski",
+            "email": "dabrowski@brillante.pl"
+        },
+        {
+            "name": "Norbert Orzechowicz",
+            "email": "norbert@orzechowicz.pl"
+        }
+    ],
+    "require": {
+        "php": ">=5.3.0"
+    },
+    "require-dev": {
+        "phpspec/phpspec": "2.0.*"
+    },
+    "autoload": {
+        "psr-0": {"" : "src"}
+    },
+    "config": {
+        "bin-dir": "bin"
+    },
+    "extra": {
+        "branch-alias": {
+            "dev-master": "1.0-dev"
+        }
+    }
+}

spec/Coduo/ToString/StringSpec.php

@@ -0,0 +1,74 @@
+<?php
+
+namespace spec\Coduo\ToString;
+
+use PhpSpec\ObjectBehavior;
+
+class Foo
+{
+    public function __toString()
+    {
+        return 'This is Foo';
+    }
+}
+
+class StringSpec extends ObjectBehavior
+{
+    function it_convert_double_to_string()
+    {
+        $this->beConstructedWith(1.1);
+        $this->__toString()->shouldReturn('1.1');
+    }
+
+    function it_convert_double_to_string_for_specific_locale()
+    {
+        $this->beConstructedWith(1.1, 'pl');
+        $this->__toString()->shouldReturn('1,1');
+    }
+
+    function it_convert_integer_to_string()
+    {
+        $this->beConstructedWith(20);
+        $this->__toString()->shouldReturn('20');
+    }
+
+    function it_convert_boolean_to_string()
+    {
+        $this->beConstructedWith(true);
+        $this->__toString()->shouldReturn('true');
+    }
+
+    function it_convert_object_to_string()
+    {
+        $this->beConstructedWith(new \stdClass());
+        $this->__toString()->shouldReturn('\stdClass');
+    }
+
+    function it_convert_object_with_toString_method_to_string()
+    {
+        $this->beConstructedWith(new Foo());
+        $this->__toString()->shouldReturn('This is Foo');
+    }
+
+    function it_convert_array_to_string()
+    {
+        $this->beConstructedWith(array('foo', 'bar'));
+        $this->__toString()->shouldReturn('Array(2)');
+    }
+
+    function it_convert_resource_to_string()
+    {
+        $resource = fopen(sys_get_temp_dir() . "/foo", "w");
+        $this->beConstructedWith($resource);
+        $this->__toString()->shouldReturn('Resource(stream)');
+        fclose($resource);
+        unlink(sys_get_temp_dir() . "/foo");
+    }
+
+    function it_convert_callback_string()
+    {
+        $func = function() {return 'test';};
+        $this->beConstructedWith($func);
+        $this->__toString()->shouldReturn('\Closure');
+    }
+}

src/Coduo/ToString/String.php

@@ -0,0 +1,73 @@
+<?php
+
+namespace Coduo\ToString;
+
+class String
+{
+    /**
+     * @var mixed
+     */
+    private $value;
+
+    /**
+     * @var string
+     */
+    private $locale;
+
+    /**
+     * @param mixed $value
+     * @param string $locale
+     */
+    public function __construct($value, $locale = 'en')
+    {
+        $this->value = $value;
+        $this->locale = $locale;
+    }
+
+    public function __toString()
+    {
+        $type = gettype($this->value);
+        switch ($type) {
+            case 'float':
+            case 'double':
+                return $this->castDoubleToString();
+            case 'boolean':
+                return $this->castBooleanToString();
+            case 'object':
+                return $this->castObjectToString();
+            case 'array':
+                return sprintf('Array(%d)', count($this->value));
+            case 'resource':
+                return sprintf("Resource(%s)", get_resource_type($this->value));
+            default:
+                return (string) $this->value;
+        }
+    }
+
+    /**
+     * @return string
+     */
+    private function castObjectToString()
+    {
+        return (method_exists($this->value, '__toString'))
+            ? (string)$this->value
+            : '\\' . get_class($this->value);
+    }
+
+    /**
+     * @return string
+     */
+    private function castBooleanToString()
+    {
+        return ($this->value) ? 'true' : 'false';
+    }
+
+    /**
+     * @return string
+     */
+    private function castDoubleToString()
+    {
+        $formatter = new \NumberFormatter($this->locale, \NumberFormatter::PATTERN_DECIMAL);
+        return $formatter->format($this->value);
+    }
+}