update readme

Author: medilies

README.md

@@ -16,17 +16,21 @@ composer require elaborate-code/php-json-tongue
 
 ## Usage
 
-Set the file structure
+Set the file structure.
 
 ![illustration](illustration.png)
 
-Then use the facade
+Then use the facade.
 
 ```php
 use ElaborateCode\JsonTongue\TongueFacade;
 
 $tongue = new TongueFacade('/lang');
 
-$tongue->transcribe();
+$localization = $tongue->transcribe();
 ```
 
+`$localization` will look like:
+
+![transcribed](transcribed.png)
+

tests/feature/TongueFacadeTest.php

@@ -11,7 +11,7 @@
         ->addLocale('en', [
             'en.json' => [
                 'en' => 'en',
-                'Super' => 'Super',
+                "I know. They're both good. It's hard to decide. McCain is older but he has more experience. Obama seems to have a lot of good ideas, but some people say he wants to raise taxes." => 'Lo sé. Ambos son buenos. Es difícil decidir. McCain es mayor pero tiene más experiencia. Obama parece tener muchas buenas ideas, pero algunas personas dicen que quiere aumentar los impuestos.',
             ],
             'one.json' => [
                 'one' => 'one',

tests/unit/FileTest.php

@@ -2,14 +2,11 @@
 
 use ElaborateCode\JsonTongue\Strategies\File;
 
-it('gets correct project root path', function () {
-    $root_folder = new File;
+test('getProjectRoot')
+    ->expect(fn () => (new File)->getProjectRoot())
+    ->toBe(realpath(__DIR__.'/../../'));
 
-    expect($root_folder->getProjectRoot())
-        ->toBe(realpath(__DIR__.'/../../'));
-});
-
-it('gets correct tests folder path', function () {
+test('getPath', function () {
     expect((string) new File('tests'))
         ->toBe(realpath(__DIR__.'/../'));
 
@@ -21,12 +18,12 @@
         ->toBe(realpath(__DIR__.'/../'));
 });
 
-it('throws an exception when relative path is invalid', function () {
+it('throws an exception when $rel_path is invalid', function () {
     expect(fn () => new File('i want some fruits'))
         ->toThrow(\Exception::class, "Invalid relative path. Can't get absolute path from 'i want some fruits'!");
 });
 
-it('scans directories', function () {
+test('getDirectoryContent', function () {
     $dir = new File();
 
     expect($dir->getDirectoryContent())