Initialize project

Author: emilien.escalle

.gitignore

@@ -0,0 +1,2 @@
+/nbproject/
+/vendor/

.travis.composer.json

@@ -0,0 +1,7 @@
+{
+   "config":{
+      "github-oauth":{
+         "github.com":"069388e2ed1ad02978a005938ec140fe57edc15d"
+      }
+   }
+}

CONTRIBUTING.md

@@ -0,0 +1,23 @@
+# CONTRIBUTING
+
+## RUNNING TESTS
+
+To run tests:
+
+- Make sure you have a recent version of PHPUnit installed; 4.8.0
+  minimally.
+- Enter the `tests/` subdirectory.
+- Execute PHPUnit
+
+  ```sh
+  % phpunit
+  ```
+
+- You may also provide the `--coverage-html` switch;
+
+  ```sh
+  % phpunit --coverage-html ./_report
+  ```
+
+  This will generate code-coverage report witch can be displayed in a browser by opening `tests/_report/index.html` file
+

README.md

@@ -1,2 +1,173 @@
-# php-css-lint
-CSS Linter for PHP
+# Php CSS Lint
+
+[![Build Status](https://travis-ci.org/neilime/ansi-escapes-to-html.svg?branch=master)](https://travis-ci.org/neilime/ansi-escapes-to-html)
+[![Latest Stable Version](https://poser.pugx.org/neilime/ansi-escapes-to-html/v/stable.svg)](https://packagist.org/packages/neilime/ansi-escapes-to-html)
+[![Total Downloads](https://poser.pugx.org/neilime/ansi-escapes-to-html/downloads.svg)](https://packagist.org/packages/neilime/ansi-escapes-to-html)
+[![Coverage Status](https://coveralls.io/repos/github/neilime/ansi-escapes-to-html/badge.svg?branch=master)](https://coveralls.io/github/neilime/ansi-escapes-to-html?branch=master)
+
+_Php CSS Lint_ is a php script that lint css files and strings :
+
+```bash
+===========================================================
+
+  ____  _              ____ ____ ____    _     _       _
+ |  _ \| |__  _ __    / ___/ ___/ ___|  | |   (_)_ __ | |_
+ | |_) | '_ \| '_ \  | |   \___ \___ \  | |   | | '_ \| __|
+ |  __/| | | | |_) | | |___ ___) |__) | | |___| | | | | |_
+ |_|   |_| |_| .__/   \____|____/____/  |_____|_|_| |_|\__|
+             |_|
+
+===========================================================
+
+# Lint file "/path/to/css/file.css"...
+ => File "/path/to/css/file.css" is not valid :
+
+    - Unknown CSS property "bordr-top-style" (line: 8, char: 20)
+    - Unexpected char ":" (line: 15, char: 5)
+```
+
+# Helping Project
+
+If this project helps you reduce time to develop and/or you want to help the maintainer of this project, you can make a donation, thank you.
+<a href='https://pledgie.com/campaigns/33252'><img alt='Click here to lend your support to: php-css-lint and make a donation at pledgie.com !' src='https://pledgie.com/campaigns/33252.png?skin_name=chrome' border='0' ></a>
+
+# Contributing
+
+If you wish to contribute to this project, please read the [CONTRIBUTING.md](CONTRIBUTING.md) file.
+NOTE : If you want to contribute don't hesitate, I'll review any PR.
+
+# Requirements
+
+Name | Version
+-----|--------
+[php](https://secure.php.net/) | >=5.3.3
+
+# Installation
+
+## Main Setup
+
+### With composer (the faster way)
+
+1. Add this project in your composer.json:
+
+    ```json
+    "require": {
+        "neilime/php-css-lint": "1.*@stable"
+    }
+    ```
+
+2. Now tell composer to download __ANSI escapes to Html__ by running the command:
+
+    ```bash
+    $ php composer.phar update
+    ```
+
+### By cloning project (manual)
+
+1. Clone this project into your `./vendor/` directory.
+
+# Usage
+
+## As a bin script
+
+### Display man page
+
+In a terminal, execute :
+```bash
+bin/php-css-lint
+```
+
+Result :
+```bash
+===========================================================
+
+  ____  _              ____ ____ ____    _     _       _
+ |  _ \| |__  _ __    / ___/ ___/ ___|  | |   (_)_ __ | |_
+ | |_) | '_ \| '_ \  | |   \___ \___ \  | |   | | '_ \| __|
+ |  __/| | | | |_) | | |___ ___) |__) | | |___| | | | | |_
+ |_|   |_| |_| .__/   \____|____/____/  |_____|_|_| |_|\__|
+             |_|
+
+===========================================================
+
+Usage :
+------------------------------------------------------------
+Lint a CSS file :
+scripts/php-css-lint css_file_path_to_lint.css
+------------------------------------------------------------
+```
+
+### Lint a file
+
+In a terminal, execute :
+```bash
+bin/php-css-lint /path/to/css/file.css
+```
+
+Result :
+```bash
+===========================================================
+
+  ____  _              ____ ____ ____    _     _       _
+ |  _ \| |__  _ __    / ___/ ___/ ___|  | |   (_)_ __ | |_
+ | |_) | '_ \| '_ \  | |   \___ \___ \  | |   | | '_ \| __|
+ |  __/| | | | |_) | | |___ ___) |__) | | |___| | | | | |_
+ |_|   |_| |_| .__/   \____|____/____/  |_____|_|_| |_|\__|
+             |_|
+
+===========================================================
+
+# Lint file "/path/to/css/file.css"...
+ => File "/path/to/css/file.css" is not valid :
+
+    - Unknown CSS property "bordr-top-style" (line: 8, char: 20)
+    - Unexpected char ":" (line: 15, char: 5)
+```
+
+## In a php script
+
+### Composer autoloading
+
+```php
+// Composer autoloading
+if (!file_exists($sComposerAutoloadPath = __DIR__ . '/vendor/autoload.php')) {
+    throw new \RuntimeException('Composer autoload file "' . $sComposerAutoloadPath . '" does not exist');
+}
+if (false === (include $sComposerAutoloadPath)) {
+    throw new \RuntimeException('An error occured while including composer autoload file "' . $sComposerAutoloadPath . '"');
+}
+```
+
+### Initialize Css Linter
+
+```php
+$cssLinter = new \CssLint\Linter();
+```
+
+### Lint string
+
+```php
+if($cssLinter->lintString('
+.button.drodown::after {
+    display: block;
+    width: 0;
+}') === true){
+   echo 'Valid!';
+}
+else {
+     echo 'Not Valid :(';
+     var_dump($cssLinter->getErrors());
+}
+```
+
+### Lint file
+
+```php
+if($cssLinter->lintFile('path/to/css/file.css') === true){
+   echo 'Valid!';
+}
+else {
+     echo 'Not Valid :(';
+     var_dump($cssLinter->getErrors());
+}
+```

composer.json

@@ -0,0 +1,39 @@
+{
+    "name": "neilime/php-css-lint",
+    "type": "library",
+    "description": "Powerfull & memory efficiant CSS linter for PHP",
+    "keywords": ["CSS", "lint", "linter", "syntax", "validation"],
+    "homepage": "http://neilime.github.io/php-css-lint/",
+    "license": "MIT",
+    "authors": [
+        {
+            "name": "Neilime",
+            "homepage": "https://github.com/neilime",
+            "role": "Developer"
+        }
+    ],
+    "support": {
+        "issues": "https://github.com/neilime/php-css-lint/issues"
+    },
+    "minimum-stability": "stable",
+    "autoload": {
+        "psr-4": {
+            "CssLint\\": "src/CssLint"
+        }
+    },
+    "autoload-dev": {
+        "psr-4": {
+            "TestSuite\\": "tests/TestSuite"
+        }
+    },
+    "require": {
+        "php": ">=5.3.3"
+    },
+    "require-dev": {
+        "phpunit/phpunit": "4.*.*",
+        "satooshi/php-coveralls": "1.*.*"
+    },
+    "bin": [
+        "scripts/php-css-lint"
+    ]
+}