<commit_before># Translate
A simple translation library for php, leans on components. Fully leans on composer for loading, easy extandable.
MIT license :).


[![<NAME>](http://mattivandeweem.nl/ci/translate-matti.jpg)](http://mattivandeweem.nl/ci/translate-matti.jpg)

|        Tool 	|                                                                                                                                                                                                                                                                  Result / badge                                                                                                                                                                                                                                                                 	|
|------------:	|:-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------:	|
|   Packagist 	| [![Latest Stable,Version](https://poser.pugx.org/mattivdweem/translate/v/stable)](https://packagist.org/packages/mattivdweem/translate) [![Total,Downloads](https://poser.pugx.org/mattivdweem/translate/downloads)](https://packagist.org/packages/mattivdweem/translate) [![Latest Unstable,Version](https://poser.pugx.org/mattivdweem/translate/v/unstable)](https://packagist.org/packages/mattivdweem/translate) [![License](https://poser.pugx.org/mattivdweem/translate/license)](https://packagist.org/packages/mattivdweem/translate) 	|
|   CodeStyle 	|                                                                                                                               [![SensioLabsInsight](https://insight.sensiolabs.com/projects/e3c879ee-a463-49f7-b041-bd5adeac93db/mini.png)](https://insight.sensiolabs.com/projects/e3c879ee-a463-49f7-b041-bd5adeac93db) [![StyleCI](https://styleci.io/repos/36128977/shield)](https://styleci.io/repos/36128977)                                                                                                                              	|
|      Travis 	|                                                                                                                                                                                                                 [![Build Status](https://travis-ci.org/MattivdWeem/Translate.svg)](https://travis-ci.org/MattivdWeem/Translate)                                                                                                                                                                                                                 	|
| Scrutinizer 	|                                                                                          [![Code Coverage](https://scrutinizer-ci.com/g/MattivdWeem/Translate/badges/coverage.png?b=master)](https://scrutinizer-ci.com/g/MattivdWeem/Translate/?branch=master) [![Scrutinizer Code Quality](https://scrutinizer-ci.com/g/MattivdWeem/Translate/badges/quality-score.png?b=master)](https://scrutinizer-ci.com/g/MattivdWeem/Translate/?branch=master) [![Build Status](https://scrutinizer-ci.com/g/MattivdWeem/Translate/badges/build.png?b=master)](https://scrutinizer-ci.com/g/MattivdWeem/Translate/build-status/master)                                                                                          	|
## How to use
Create a new instance, register your language and done. Well just take a look at the json example below.

## Composer.json
Everything should be loadable via composer. Make shure the translate is required first and the strategy's after the main class. This should be pretty strait forward. When you like your own strategy more, it's fine just use that one.

    {
        "require": {
            "mattivdweem/translate": "^1.0",
            "mattivdweem/translate-json-strategy": "^1.0"
        }
    }



## php example
Once evertying is loaded via comopser, you should require the autoloader and register a new instance of the translation class, the example below i register a `$dutch` translation with the json strategy, this will make shure i'm getting all the dutch translations from the nl.json file.

    <?php

    require('vendor/autoload.php');

    $dutch = new MattivdWeem\Translate\Translate(
        new MattivdWeem\Translate\JsonStrategy\JsonStrategy('nl')
    );

    $dutch->addTranslation('input', 'output');
    echo $dutch->translateString('input');


## How it works
Basicly the class is a simple key => $value loader, every translation is getting registered as an translation object and will be pushed in a translationSet This translation set will be returned.

The best part of this: there is only 1 request for getting all the translations on construct. This means there is only 1 time delay to receive your translations. There is a conn to this: if you have to much translations, the translationSet object could be a bit heavy and the initial request could be a bit slower. This is getting fully compensated trough the fast declaration of objects, and will be way faster when you want to use the same translation multiple times.

### mapping
I'm translating the same string multiple times, it's not working. Evertyhing gets mapped by a `md5()` hash of the original string, this means the string should be identical and there is no possible way (unless you are trying to find it ^^) to get duplicate strings.


## Extending
Extending the library is easy, as you can see the the translation gets registered with a strategy. This strategy is fully customizable as long as the interface is getting implemented.
Take a look at `mattivdweem-json-strategy` for a nice example.


## Contributing
My code sucks? my strategy sucks? my ideas suck? Just want to add something awsome, or want to make a Code Style change? create a pull request and i'll be happy to accept :).
Make shure your contribution gets trough the Travis, StyleCI and the Sensio Labs Insight tests!



License<commit_msg>Packages<commit_after># Translate
A simple translation library for php, leans on components. Fully leans on composer for loading, easy extandable.
MIT license :).


[![<NAME>](http://mattivandeweem.nl/ci/translate-matti.jpg)](http://mattivandeweem.nl/ci/translate-matti.jpg)

|        Tool 	|                                                                                                                                                                                                                                                                  Result / badge                                                                                                                                                                                                                                                                 	|
|------------:	|:-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------:	|
|   Packagist 	| [![Latest Stable,Version](https://poser.pugx.org/mattivdweem/translate/v/stable)](https://packagist.org/packages/mattivdweem/translate) [![Total,Downloads](https://poser.pugx.org/mattivdweem/translate/downloads)](https://packagist.org/packages/mattivdweem/translate) [![Latest Unstable,Version](https://poser.pugx.org/mattivdweem/translate/v/unstable)](https://packagist.org/packages/mattivdweem/translate) [![License](https://poser.pugx.org/mattivdweem/translate/license)](https://packagist.org/packages/mattivdweem/translate) 	|
|   CodeStyle 	|                                                                                                                               [![SensioLabsInsight](https://insight.sensiolabs.com/projects/e3c879ee-a463-49f7-b041-bd5adeac93db/mini.png)](https://insight.sensiolabs.com/projects/e3c879ee-a463-49f7-b041-bd5adeac93db) [![StyleCI](https://styleci.io/repos/36128977/shield)](https://styleci.io/repos/36128977)                                                                                                                              	|
|      Travis 	|                                                                                                                                                                                                                 [![Build Status](https://travis-ci.org/MattivdWeem/Translate.svg)](https://travis-ci.org/MattivdWeem/Translate)                                                                                                                                                                                                                 	|
| Scrutinizer 	|                                                                                          [![Code Coverage](https://scrutinizer-ci.com/g/MattivdWeem/Translate/badges/coverage.png?b=master)](https://scrutinizer-ci.com/g/MattivdWeem/Translate/?branch=master) [![Scrutinizer Code Quality](https://scrutinizer-ci.com/g/MattivdWeem/Translate/badges/quality-score.png?b=master)](https://scrutinizer-ci.com/g/MattivdWeem/Translate/?branch=master) [![Build Status](https://scrutinizer-ci.com/g/MattivdWeem/Translate/badges/build.png?b=master)](https://scrutinizer-ci.com/g/MattivdWeem/Translate/build-status/master)                                                                                          	|
## How to use
Create a new instance, register your language and done. Well just take a look at the json example below.

## Composer.json
Everything should be loadable via composer. Make shure the translate is required first and the strategy's after the main class. This should be pretty strait forward. When you like your own strategy more, it's fine just use that one.

    {
        "require": {
            "mattivdweem/translate": "^1.0",
            "mattivdweem/translate-json-strategy": "^1.0"
        }
    }



## php example
Once evertying is loaded via comopser, you should require the autoloader and register a new instance of the translation class, the example below i register a `$dutch` translation with the json strategy, this will make shure i'm getting all the dutch translations from the nl.json file.

    <?php

    require('vendor/autoload.php');

    $dutch = new MattivdWeem\Translate\Translate(
        new MattivdWeem\Translate\JsonStrategy\JsonStrategy('nl')
    );

    $dutch->addTranslation('input', 'output');
    echo $dutch->translateString('input');


## Known available Strategy's
| Name 	|  Completed | Package |
|:------------:	|:---------:	|
| JSON local stored | [x] | `mattivdweem/translate-json-strategy` |

## How it works
Basicly the class is a simple key => $value loader, every translation is getting registered as an translation object and will be pushed in a translationSet This translation set will be returned.

The best part of this: there is only 1 request for getting all the translations on construct. This means there is only 1 time delay to receive your translations. There is a conn to this: if you have to much translations, the translationSet object could be a bit heavy and the initial request could be a bit slower. This is getting fully compensated trough the fast declaration of objects, and will be way faster when you want to use the same translation multiple times.

### mapping
I'm translating the same string multiple times, it's not working. Evertyhing gets mapped by a `md5()` hash of the original string, this means the string should be identical and there is no possible way (unless you are trying to find it ^^) to get duplicate strings.


## Extending
Extending the library is easy, as you can see the the translation gets registered with a strategy. This strategy is fully customizable as long as the interface is getting implemented.
Take a look at `mattivdweem-json-strategy` for a nice example.


## Contributing
My code sucks? my strategy sucks? my ideas suck? Just want to add something awsome, or want to make a Code Style change? create a pull request and i'll be happy to accept :).
Make shure your contribution gets trough the Travis, StyleCI and the Sensio Labs Insight tests!



License
{'fraction_non_alphanumeric': 0.163579766536965, 'fraction_numerical': 0.008560311284046693, 'mean_word_length': 1.3584143879610937, 'pattern_counts': {'":': 6, '<': 7, '<?xml version=': 0, '>': 11, 'https://': 40, 'lorem ipsum': 0, 'www.': 0, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 126, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '1103966', 'n_tokens_mistral': 2967, 'n_tokens_neox': 2778, 'n_words': 862}