Initial commit.

Author: mahagr

.gitignore

@@ -0,0 +1,14 @@
+# Composer
+vendor/
+coverage/
+composer.lock
+
+# OS Generated
+.DS_Store*
+ehthumbs.db
+Icon?
+Thumbs.db
+*.swp
+
+# PhpStorm
+.idea/*

.scrutinizer.yml

@@ -0,0 +1,36 @@
+filter:
+    excluded_paths:
+        - 'vendor/*'
+        - '*/tests/*'
+checks:
+    php:
+        code_rating: true
+        remove_extra_empty_lines: true
+        remove_php_closing_tag: true
+        remove_trailing_whitespace: true
+        fix_use_statements:
+            remove_unused: true
+            preserve_multiple: false
+            preserve_blanklines: true
+            order_alphabetically: true
+        fix_php_opening_tag: true
+        fix_linefeed: true
+        fix_line_ending: true
+        fix_identation_4spaces: true
+        fix_doc_comments: true
+tools:
+    external_code_coverage:
+        timeout: 600
+        runs: 3
+    php_code_coverage: false
+    php_code_sniffer:
+        config:
+            standard: PSR2
+        filter:
+            paths: ['src']
+    php_loc:
+        enabled: true
+        excluded_dirs: [vendor, tests]
+    php_cpd:
+        enabled: true
+        excluded_dirs: [vendor, tests]

.travis.yml

@@ -0,0 +1,22 @@
+language: php
+
+php:
+  - 5.4
+  - 5.5
+  - 5.6
+  - hhvm
+
+matrix:
+  allow_failures:
+    - php: hhvm
+
+before_script:
+  - curl -s http://getcomposer.org/installer | php
+  - composer install --prefer-source --no-interaction --dev
+
+after_script:
+  - wget https://scrutinizer-ci.com/ocular.phar
+  - php ocular.phar code-coverage:upload --format=php-clover coverage.clover
+
+script:
+  phpunit --coverage-text --coverage-clover=coverage.clover

LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2014 RocketTheme
+
+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,56 @@
+# ![](https://avatars1.githubusercontent.com/u/1310198?v=2&s=50) RocketTheme Toolbox
+
+[![Latest Version](http://img.shields.io/packagist/v/rockettheme/toolbox.svg?style=flat)](https://packagist.org/packages/rockettheme/toolbox)
+[![Software License](https://img.shields.io/badge/license-MIT-brightgreen.svg?style=flat)](LICENSE)
+[![Build Status](https://img.shields.io/travis/rockettheme/toolbox/master.svg?style=flat)](https://travis-ci.org/rockettheme/toolbox)
+[![Coverage Status](https://img.shields.io/scrutinizer/coverage/g/rockettheme/toolbox.svg?style=flat)](https://scrutinizer-ci.com/g/rockettheme/toolbox/code-structure)
+[![Quality Score](https://img.shields.io/scrutinizer/g/rockettheme/toolbox.svg?style=flat)](https://scrutinizer-ci.com/g/rockettheme/toolbox)
+[![Total Downloads](https://img.shields.io/packagist/dt/rockettheme/toolbox.svg?style=flat)](https://packagist.org/packages/rockettheme/toolbox)
+
+RocketTheme\Toolbox package contains a set of reusable PHP interfaces, classes and traits.
+
+* ArrayTraits
+* DI
+* Event
+* File
+* ResourceLocator
+* Session
+* StreamWrapper
+
+## Installation
+
+You can use [Composer](http://getcomposer.org/) to download and install this package as well as its dependencies.
+
+### Composer
+
+To add this package as a local, per-project dependency to your project, simply add a dependency on `rockettheme/toolbox` to your project's `composer.json` file. Here is a minimal example of a `composer.json` file that just defines a dependency on Diff:
+
+    {
+        "require": {
+            "rockettheme/toolbox": "*"
+        }
+    }
+
+
+# Contributing
+
+We appreciate any contribution to ToolBox, whether it is related to bugs or simply a suggestion or improvement.
+However, we ask that any contribution follow our simple guidelines in order to be properly received.
+
+All our projects follow the [GitFlow branching model][gitflow-model], from development to release. If you are not familiar with it, there are several guides and tutorials to make you understand what it is about.
+
+You will probably want to get started by installing [this very good collection of git extensions][gitflow-extensions].
+
+What you mainly want to know is that:
+
+- All the main activity happens in the `develop` branch. Any pull request should be addressed only to that branch. We will not consider pull requests made to the `master`.
+- It's very well appreciated, and highly suggested, to start a new feature whenever you want to make changes or add functionalities. It will make it much easier for us to just checkout your feature branch and test it, before merging it into `develop`
+
+
+# Getting Started
+
+* Have fun!
+
+
+[gitflow-model]: http://nvie.com/posts/a-successful-git-branching-model/
+[gitflow-extensions]: https://github.com/nvie/gitflow

RocketTheme/Toolbox/ArrayTraits/src/ArrayAccess.php

@@ -0,0 +1,66 @@
+<?php
+namespace RocketTheme\Toolbox\ArrayTraits;
+
+/**
+ * Implements ArrayAccess interface.
+ *
+ * @package RocketTheme\Toolbox\ArrayTraits
+ * @author RocketTheme
+ * @license MIT
+ *
+ * @property array $items
+ */
+trait ArrayAccess
+{
+    /**
+     * Whether or not an offset exists.
+     *
+     * @param mixed $offset  An offset to check for.
+     * @return bool          Returns TRUE on success or FALSE on failure.
+     */
+    public function offsetExists($offset)
+    {
+        return isset($this->items[$offset]);
+    }
+
+    /**
+     * Returns the value at specified offset.
+     *
+     * @param mixed $offset  The offset to retrieve.
+     * @return mixed         Can return all value types.
+     */
+    public function offsetGet($offset)
+    {
+        return isset($this->items[$offset]) ? $this->items[$offset] : null;
+    }
+
+    /**
+     * Assigns a value to the specified offset.
+     *
+     * @param mixed $offset  The offset to assign the value to.
+     * @param mixed $value   The value to set.
+     */
+    public function offsetSet($offset, $value)
+    {
+        if (is_null($offset)) {
+            $this->items[] = $value;
+        } else {
+            $this->items[$offset] = $value;
+        }
+    }
+
+    /**
+     * Unsets an offset.
+     *
+     * @param mixed $offset  The offset to unset.
+     */
+    public function offsetUnset($offset)
+    {
+        // Hack to make Iterator trait work together with unset.
+        if (isset($this->iteratorUnset) && $offset == key($this->items)) {
+            $this->iteratorUnset = true;
+        }
+
+        unset($this->items[$offset]);
+    }
+}

RocketTheme/Toolbox/ArrayTraits/src/ArrayAccessWithGetters.php

@@ -0,0 +1,57 @@
+<?php
+namespace RocketTheme\Toolbox\ArrayTraits;
+
+/**
+ * Implements getters and setters.
+ *
+ * @package RocketTheme\Toolbox\ArrayTraits
+ * @author RocketTheme
+ * @license MIT
+ */
+trait ArrayAccessWithGetters
+{
+    use ArrayAccess;
+
+    /**
+     * Magic setter method
+     *
+     * @param mixed $offset Asset name value
+     * @param mixed $value  Asset value
+     */
+    public function __set($offset, $value)
+    {
+        $this->offsetSet($offset, $value);
+    }
+
+    /**
+     * Magic getter method
+     *
+     * @param  mixed $offset Asset name value
+     * @return mixed         Asset value
+     */
+    public function __get($offset)
+    {
+       return $this->offsetGet($offset);
+    }
+
+    /**
+     * Magic method to determine if the attribute is set
+     *
+     * @param  mixed   $offset Asset name value
+     * @return boolean         True if the value is set
+     */
+    public function __isset($offset)
+    {
+        return $this->offsetExists($offset);
+    }
+
+    /**
+     * Magic method to unset the attribute
+     *
+     * @param mixed $offset The name value to unset
+     */
+    public function __unset($offset)
+    {
+        $this->offsetUnset($offset);
+    }
+}

RocketTheme/Toolbox/ArrayTraits/src/Constructor.php

@@ -0,0 +1,24 @@
+<?php
+namespace RocketTheme\Toolbox\ArrayTraits;
+
+/**
+ * Implements Constructor for setting items.
+ *
+ * @package RocketTheme\Toolbox\ArrayTraits
+ * @author RocketTheme
+ * @license MIT
+ *
+ * @property array $items
+ */
+trait Constructor
+{
+    /**
+     * Constructor to initialize array.
+     *
+     * @param  array  $items  Initial items inside the iterator.
+     */
+    public function __construct(array $items = array())
+    {
+        $this->items = $items;
+    }
+}

RocketTheme/Toolbox/ArrayTraits/src/Countable.php

@@ -0,0 +1,24 @@
+<?php
+namespace RocketTheme\Toolbox\ArrayTraits;
+
+/**
+ * Implements \Countable interface.
+ *
+ * @package RocketTheme\Toolbox\ArrayTraits
+ * @author RocketTheme
+ * @license MIT
+ *
+ * @property array $items
+ */
+trait Countable
+{
+    /**
+     * Implements Countable interface.
+     *
+     * @return int
+     */
+    public function count()
+    {
+        return count($this->items);
+    }
+}

RocketTheme/Toolbox/ArrayTraits/src/Export.php

@@ -0,0 +1,46 @@
+<?php
+namespace RocketTheme\Toolbox\ArrayTraits;
+
+use Symfony\Component\Yaml\Yaml;
+
+/**
+ * Implements ExportInterface.
+ *
+ * @package RocketTheme\Toolbox\ArrayTraits
+ * @author RocketTheme
+ * @license MIT
+ *
+ * @property array $items
+ */
+trait Export
+{
+    /**
+     * Convert object into an array.
+     *
+     * @return array
+     */
+    public function toArray()
+    {
+        return $this->items;
+    }
+
+    /**
+     * Convert object into YAML string.
+     *
+     * @return string
+     */
+    public function toYaml()
+    {
+        return Yaml::dump($this->toArray());
+    }
+
+    /**
+     * Convert object into JSON string.
+     *
+     * @return string
+     */
+    public function toJson()
+    {
+        return json_encode($this->toArray());
+    }
+}