Updated to 1.1.5 version

Author: josantonius

.gitattributes

@@ -1,6 +1,4 @@
 /tests export-ignore
-/src/bootstrap.php export-ignore
-/vendor export-ignore
 .gitattributes export-ignore
 .gitignore export-ignore
 _config.yml export-ignore
@@ -10,6 +8,7 @@ phpunit.xml.dist export-ignore
 CONDUCT.md export-ignore
 contributors.txt export-ignore
 README.md export-ignore
+phpcs.ruleset.xml export-ignore
 README-ES.md export-ignore
 .editorconfig export-ignore
 composer.lock export-ignore

.gitignore

@@ -3,10 +3,9 @@ composer.phar
 composer.lock
 composer-test.lock
 build/artifacts/
-artifacts/
+vendor/
 docs/_build
 docs/*.pyc
 .git*/
 .idea
 .DS_STORE
-vendor

.travis.yml

@@ -4,24 +4,42 @@ sudo: false
 
 dist: trusty
 
+branches:
+  only:
+    - master
+
 git:
   depth: 5
 
 php:
   - 5.6
   - 7.0
   - 7.1
+  - 7.2
   - hhvm
   - nightly
 
 matrix:
   fast_finish: true
+  include:
+    - php: 7.1
+      env: PHPCS=PSR2
+
   allow_failures:
     - php: nightly
 
 before_script:
-  - composer self-update
-  - composer install
+  - export PATH="./vendor/bin:$PATH"
+  - travis_retry composer self-update
+  - travis_retry composer install --no-interaction --prefer-source --dev
 
 script:
-  - composer test
+  - phpunit
+  - |
+    if [[ "$PHPCS" ]] ; then
+      phpcs --standard=phpcs.ruleset.xml $(find . -name '*.php')
+    fi
+    phpunit --coverage-clover=coverage.xml
+
+after_success:
+ - bash <(curl -s https://codecov.io/bash)

CHANGELOG.md

@@ -1,5 +1,29 @@
 # CHANGELOG
 
+## 1.1.5 - 2017-11-01
+
+* Implemented `PSR-4 autoloader standard` from all library files.
+
+* Implemented `PSR-2 coding standard` from all library PHP files.
+
+* Implemented `PHPCS` to ensure that PHP code complies with `PSR2` code standards.
+
+* Implemented `Codacy` to automates code reviews and monitors code quality over time.
+
+* Implemented `Codecov` to coverage reports.
+
+* Added `Ip/phpcs.ruleset.xml` file.
+
+* Deleted `Ip/src/bootstrap.php` file.
+
+* Deleted `Ip/tests/bootstrap.php` file.
+
+* Deleted `Ip/vendor` folder.
+
+* Changed `Josantonius\Ip\Test\IpTest` class to  `Josantonius\Ip\IpTest` class.
+
+* Added `Josantonius\Ip\Ip::getGlobalValue()` method.
+
 ## 1.1.4 - 2017-09-14
 
 * Unit tests supported by `PHPUnit` were added.

README-ES.md

@@ -1,17 +1,17 @@
 # PHP Ip library
 
-[![Latest Stable Version](https://poser.pugx.org/josantonius/ip/v/stable)](https://packagist.org/packages/josantonius/ip) [![Total Downloads](https://poser.pugx.org/josantonius/ip/downloads)](https://packagist.org/packages/josantonius/ip) [![Latest Unstable Version](https://poser.pugx.org/josantonius/ip/v/unstable)](https://packagist.org/packages/josantonius/ip) [![License](https://poser.pugx.org/josantonius/ip/license)](https://packagist.org/packages/josantonius/ip) [![Travis](https://travis-ci.org/Josantonius/PHP-Ip.svg)](https://travis-ci.org/Josantonius/PHP-Ip)
+[![Latest Stable Version](https://poser.pugx.org/josantonius/Ip/v/stable)](https://packagist.org/packages/josantonius/Ip) [![Latest Unstable Version](https://poser.pugx.org/josantonius/Ip/v/unstable)](https://packagist.org/packages/josantonius/Ip) [![License](https://poser.pugx.org/josantonius/Ip/license)](LICENSE) [![Codacy Badge](https://api.codacy.com/project/badge/Grade/9a38ca1727464eb2bbac06a1bb163bce)](https://www.codacy.com/app/Josantonius/PHP-Ip?utm_source=github.com&utm_medium=referral&utm_content=Josantonius/PHP-Ip&utm_campaign=Badge_Grade) [![Total Downloads](https://poser.pugx.org/josantonius/Ip/downloads)](https://packagist.org/packages/josantonius/Ip) [![Travis](https://travis-ci.org/Josantonius/PHP-Ip.svg)](https://travis-ci.org/Josantonius/PHP-Ip) [![PSR2](https://img.shields.io/badge/PSR-2-1abc9c.svg)](http://www.php-fig.org/psr/psr-2/) [![PSR4](https://img.shields.io/badge/PSR-4-9b59b6.svg)](http://www.php-fig.org/psr/psr-4/) [![CodeCov](https://codecov.io/gh/Josantonius/PHP-Ip/branch/master/graph/badge.svg)](https://codecov.io/gh/Josantonius/PHP-Ip)
 
 [English version](README.md)
 
 Biblioteca PHP para obtener la IP del usuario.
 
 ---
 
-- [Instalación](#instalación)
 - [Requisitos](#requisitos)
-- [Cómo empezar y ejemplos](#cómo-empezar-y-ejemplos)
+- [Instalación](#instalación)
 - [Métodos disponibles](#métodos-disponibles)
+- [Cómo empezar](#cómo-empezar)
 - [Uso](#uso)
 - [Tests](#tests)
 - [Tareas pendientes](#-tareas-pendientes)
@@ -22,71 +22,120 @@ Biblioteca PHP para obtener la IP del usuario.
 
 ---
 
-### Instalación 
+## Requisitos
+
+Esta clase es soportada por versiones de **PHP 5.6** o superiores y es compatible con versiones de **HHVM 3.0** o superiores.
 
-La mejor forma de instalar esta extensión es a través de [composer](http://getcomposer.org/download/).
+## Instalación 
 
-Para instalar PHP Ip library, simplemente escribe:
+La mejor forma de instalar esta extensión es a través de [Composer](http://getcomposer.org/download/).
+
+Para instalar **PHP Ip library**, simplemente escribe:
 
     $ composer require Josantonius/Ip
 
-El comando anterior sólo instalará los archivos necesarios, si prefieres descargar todo el código fuente (incluyendo tests, directorio vendor, excepciones no utilizadas, documentos...) puedes utilizar:
+El comando anterior sólo instalará los archivos necesarios, si prefieres **descargar todo el código fuente** puedes utilizar:
 
     $ composer require Josantonius/Ip --prefer-source
 
-También puedes clonar el repositorio completo con Git:
+También puedes **clonar el repositorio** completo con Git:
+
+  $ git clone https://github.com/Josantonius/PHP-Ip.git
 
-	$ git clone https://github.com/Josantonius/PHP-Ip.git
+O **instalarlo manualmente**:
+
+[Descargar Ip.php](https://raw.githubusercontent.com/Josantonius/PHP-Ip/master/src/Ip.php):
+
+    $ wget https://raw.githubusercontent.com/Josantonius/PHP-Ip/master/src/Ip.php
+
+## Métodos disponibles
+
+Métodos disponibles en esta biblioteca:
+
+### - Obtener IP del usuario:
+
+```php
+Ip::get();
+```
+
+**# Return** (string|false) → IP o falso
+
+### - Validar IP:
+
+```php
+Ip::validate($ip);
+```
 
-### Requisitos
+| Atributo | Descripción | Tipo | Requerido | Predeterminado
+| --- | --- | --- | --- | --- |
+| $ip | Dirección IP a validar. | string | Sí | |
 
-Esta biblioteca es soportada por versiones de PHP 5.6 o superiores y es compatible con versiones de HHVM 3.0 o superiores.
+**# Return** (boolean)
 
-### Cómo empezar y ejemplos
+## Cómo empezar
 
-Para utilizar esta biblioteca, simplemente:
+Para utilizar esta biblioteca con **Composer**:
 
 ```php
 require __DIR__ . '/vendor/autoload.php';
 
 use Josantonius\Ip\Ip;
 ```
-### Métodos disponibles
 
-Métodos disponibles en esta biblioteca:
+Si la instalaste **manualmente**, utiliza:
 
 ```php
-Ip::get();
+require_once __DIR__ . '/Ip.php';
+
+use Josantonius\Ip\Ip;
 ```
-### Uso
+
+## Uso
 
 Ejemplo de uso para esta biblioteca:
 
+### - Obtener IP del usuario:
+
 ```php
-<?php
-require __DIR__ . '/vendor/autoload.php';
+Ip::get();
+```
 
-use Josantonius\Ip\Ip;
+### - Validar IP:
+
+```php
+$ip = Ip::get();
 
-print_r(Ip::get()); # 66.249.76.29
+Ip::validate($ip);
 ```
 
-### Tests 
+## Tests 
 
-Para ejecutar las [pruebas](tests/Ip/Test) simplemente:
+Para ejecutar las [pruebas](tests) necesitarás [Composer](http://getcomposer.org/download/) y seguir los siguientes pasos:
 
     $ git clone https://github.com/Josantonius/PHP-Ip.git
 
     $ cd PHP-Ip
 
-    $ phpunit
+    $ composer install
+
+Ejecutar pruebas unitarias con [PHPUnit](https://phpunit.de/):
+
+    $ composer phpunit
+
+Ejecutar pruebas de estándares de código [PSR2](http://www.php-fig.org/psr/psr-2/) con [PHPCS](https://github.com/squizlabs/PHP_CodeSniffer):
+
+    $ composer phpcs
+
+Ejecutar todas las pruebas anteriores:
+
+    $ composer tests
 
-### ☑ Tareas pendientes
+## ☑ Tareas pendientes
 
 - [x] Completar tests
-- [ ] Mejorar la documentación
+- [x] Mejorar la documentación
 
-### Contribuir
+## Contribuir
 
 1. Comprobar si hay incidencias abiertas o abrir una nueva para iniciar una discusión en torno a un fallo o función.
 1. Bifurca la rama del repositorio en GitHub para iniciar la operación de ajuste.
@@ -96,15 +145,15 @@ Para ejecutar las [pruebas](tests/Ip/Test) simplemente:
 
 Esto está pensado para proyectos grandes y de larga duración.
 
-### Repositorio
+## Repositorio
 
 Los archivos de este repositorio se crearon y subieron automáticamente con [Reposgit Creator](https://github.com/Josantonius/BASH-Reposgit).
 
-### Licencia
+## Licencia
 
 Este proyecto está licenciado bajo **licencia MIT**. Consulta el archivo [LICENSE](LICENSE) para más información.
 
-### Copyright
+## Copyright
 
 2017 Josantonius, [josantonius.com](https://josantonius.com/)