Added TOML file driver

README.md

@@ -20,6 +20,7 @@ Supported file formats:
   - PHP
   - INI
   - JSON
+  - [TOML](https://github.com/toml-lang/toml)
   - YAML
   - XML
 
@@ -138,6 +139,27 @@ valid JSON object.
 
 ```
 
+#### TOML
+
+A TOML configuration file must have the `.toml` file extension and be a valid
+TOML file.
+
+```toml
+driver = 'mysql'
+
+[drivers.sqlite]
+database = 'database.sqlite'
+prefix = ''
+
+[drivers.mysql]
+host = 'localhost'
+database = 'blog'
+username = 'blogger'
+password = 'hunter2'
+charset = 'utf8'
+prefix = ''
+```
+
 #### YAML
 
 A YAML configuration file must have the `.yaml` file extension, be a valid YAML

composer.json

@@ -10,7 +10,8 @@
     ],
     "require": {
         "php": ">=7.0",
-        "symfony/yaml": "^3.0 || ^4.0"
+        "symfony/yaml": "^3.0 || ^4.0",
+        "yosymfony/toml": "^1.0"
     },
     "require-dev": {
         "friendsofphp/php-cs-fixer": "^2.3",

src/Loaders/Toml.php

@@ -0,0 +1,31 @@
+<?php
+
+namespace PHLAK\Config\Loaders;
+
+use PHLAK\Config\Exceptions\InvalidFileException;
+use Yosymfony\Toml\Toml as TomlParser;
+use Yosymfony\Toml\Exception\ParseException;
+
+class Toml extends Loader
+{
+    /**
+     * Retrieve the contents of a .toml file and convert it to an array of
+     * configuration options.
+     *
+     * @return array Array of configuration options
+     */
+    public function getArray()
+    {
+        try {
+            $parsed = TomlParser::ParseFile($this->context);
+        } catch (ParseException $e) {
+            throw new InvalidFileException($e->getMessage());
+        }
+
+        // if (! is_array($parsed)) {
+        //     throw new InvalidFileException('Unable to parse invalid TOML file at ' . $this->context);
+        // }
+
+        return $parsed;
+    }
+}

tests/TomlTest.php

@@ -0,0 +1,26 @@
+<?php
+
+namespace PHLAK\Config\Tests;
+
+use PHLAK\Config\Config;
+use PHLAK\Config\Exceptions\InvalidFileException;
+use PHLAK\Config\Tests\Traits\Initializable;
+use PHPUnit\Framework\TestCase;
+
+class TomlTest extends TestCase
+{
+    use Initializable;
+
+    public function setUp()
+    {
+        $this->validConfig = __DIR__ . '/files/toml/config.toml';
+        $this->invalidConfig = __DIR__ . '/files/toml/invalid.toml';
+    }
+
+    public function test_it_throws_an_exception_when_initializing_a_toml_file_without_an_array()
+    {
+        $this->expectException(InvalidFileException::class);
+
+        new Config(__DIR__ . '/files/toml/bad.toml');
+    }
+}

tests/files/toml/bad.toml

@@ -0,0 +1 @@
+I'm a valid YAML file but don't contain an array

tests/files/toml/config.toml

@@ -0,0 +1,21 @@
+driver = 'mysql'
+
+[drivers.sqlite]
+database = 'database.sqlite'
+prefix = ''
+
+[drivers.mysql]
+host = 'localhost'
+database = 'blog'
+username = 'blogger'
+password = 'hunter2'
+charset = 'utf8'
+prefix = ''
+
+[drivers.pgsql]
+host = 'localhost'
+database = 'blog'
+username = 'blogger'
+password = 'hunter2'
+charset = 'utf8'
+prefix = ''

tests/files/toml/invalid.toml

@@ -0,0 +1 @@
+asdf: asdf: asdf