update default options

README.md

@@ -1,6 +1,12 @@
 # gemini-php
 
-PHP 8 Library for Gemini Protocol
+PHP 8 Library for [Gemini Protocol](https://geminiprotocol.net)
+
+_For optimization reasons, some experimental features like `Dokuwiki` and `GTK3/Pango` was dropped from `1.0.0` release, but available in [previous versions](https://github.com/YGGverse/gemini-php/releases/tag/0.10.1). `Gemtext` component re-implemented as separated library (see [Extras](#extras))_
+
+## Extras
+
+* [gemtext-php](https://github.com/YGGverse/gemtext-php) - Object-oriented PHP 8 library for Gemini / Gemtext operations
 
 ## Usage
 
@@ -14,12 +20,39 @@ PHP interface for Gemini protocol queries by TLS socket connection
 
 ### Request
 
-```
+``` php
 $request = new \Yggverse\Gemini\Client\Request(
-    'gemini://betahowto.duckdns.org:1965/archive'
+    'gemini://yggverse.cities.yesterweb.org:1965/index.gmi'
 );
 ```
 
+**Resolved request (SNI)**
+
+For direct connection provide resolved IP as the second argument
+
+``` php
+$request = new \Yggverse\Gemini\Client\Request(
+    'gemini://yggverse.cities.yesterweb.org:1965/index.gmi' // target URL
+    '68.133.1.71' // resolved IP, skip to use system-wide resolver
+);
+```
+
+Alternatively, use `setResolvedHost` method of `Request` object before `getResponse`
+
+#### Request::setResolvedHost
+
+``` php
+$request->setResolvedHost(
+    '68.133.1.71'
+)
+```
+
+* to resolve network address with PHP, take a look on the [net-php](https://github.com/YGGverse/net-php) library!
+
+#### Request::getResolvedHost
+
+Get resolved host back
+
 #### Request::setHost
 #### Request::getHost
 #### Request::setPort
@@ -32,17 +65,38 @@ $request = new \Yggverse\Gemini\Client\Request(
 
 Execute requested URL and return raw response
 
-```
+``` php
 var_dump(
     $request->getResponse()
 );
 ```
 
+#### Request::getOptions
+#### Request::setOptions
+
+``` php
+$request = new \Yggverse\Gemini\Client\Request(
+    'gemini://yggverse.cities.yesterweb.org',
+    '68.133.1.71' // make direct request to the resolved host
+);
+
+$request->setOptions(
+    [
+        'ssl' =>
+        [
+            'peer_name'        => 'yggverse.cities.yesterweb.org', // SNI
+            'verify_peer'      => false,
+            'verify_peer_name' => false
+        ]
+    ]
+);
+```
+
 ### Response
 
 This class provides additional features for the raw response operations
 
-```
+``` php
 $response = new \Yggverse\Gemini\Client\Response(
     $request->getResponse()
 );
@@ -55,348 +109,15 @@ $response = new \Yggverse\Gemini\Client\Response(
 #### Response::setBody
 #### Response::getBody
 
-```
+``` php
 var_dump(
     $response->getBody()
 );
 ```
 
-## Gemtext
+## Integrations
 
-Object-oriented API for Gemtext
-
-### Body
-
-Basic methods to work with `text/gemini` documents
-
-```
-$body = new \Yggverse\Gemini\Gemtext\Body(
-    $response->getBody() // gemtext body from client response or .gmi file
-);
-```
-
-#### Body::getH1
-#### Body::getH2
-#### Body::getH3
-#### Body::getLinks
-
-```
-var_dump(
-    $body->getLinks() // returns array of inline links
-);
-```
-
-#### Body::findLinks
-
-Find context links by protocol as argument, `gemini` by default
-
-```
-var_dump(
-    $body->findLinks('http') // returns array of http links found
-);
-```
-
-### Link
-
-Inline links parser.
-
-Allows to extract address, date with timestamp and alt text from link line given
-
-```
-foreach ($body->getLinks() as $line)
-{
-    $link = new \Yggverse\Gemini\Gemtext\Link(
-        $line
-    );
-
-    var_dump(
-        $link->getAddress()
-    );
-
-    var_dump(
-        $link->getAlt()
-    );
-}
-```
-
-#### Link::getAddress
-#### Link::getDate
-
-This method also validates time format and returns the unix timestamp as linked argument
-
-```
-var_dump(
-    $link->getDate(
-        $timestamp // get unix time from this variable
-    )
-);
-
-var_dump(
-    $timestamp
-);
-```
-
-#### Link::getAlt
-
-## DokuWiki
-
-Toolkit provides DokuWiki API for Gemini.
-
-Allows to simple deploy new apps or make existing website mirror
-
-### Examples
-
-* [β-Doku](https://github.com/YGGverse/bdoku) - DokuWiki Satellite for Gemini Protocol
-
-### Reader
-
-Read DokuWiki and convert to Gemini
-
-```
-$reader = new \Yggverse\Gemini\Dokuwiki\Reader(
-    // optional regex rule set array
-);
-```
-
-#### Reader::getRules
-#### Reader::setRules
-#### Reader::getRule
-#### Reader::setRule
-
-Get or change existing regex rule (or just skip by using build-in set)
-
-```
-echo $reader->setRule(
-    '/subject/ui',
-    'replacement'
-);
-```
-
-#### Reader::getMacroses
-#### Reader::setMacroses
-#### Reader::getMacros
-#### Reader::setMacros
-
-```
-echo $reader->setMacros(
-    '~my-macros-key~',
-    '~my-macros-value~',
-);
-```
-
-#### Reader::toGemini
-
-Convert DokuWiki text to Gemini markup
-
-As wiki has lot of inline links, to make converted document well-readable, this method does not replace links with new line `=>` macros, but uses inline context: `Name ( URL )`. This model useful with `Reader::getLinks` method, that for example appends all those related links to the document footer.
-
-If you don't like this implementation, feel free to change it by `Reader::setRule` method!
-
-```
-echo $reader->toGemini(
-    file_get_contents(
-        '/host/data/pages/index.txt'
-    )
-);
-```
-
-#### Reader::getH1
-
-Get document title
-
-```
-$gemini = $reader->toGemini(
-    file_get_contents(
-        '/host/data/pages/index.txt'
-    )
-);
-
-echo $reader->getH1(
-    $gemini
-);
-```
-
-#### Reader::getLinks
-
-Get document links
-
-```
-$gemini = $reader->toGemini(
-    file_get_contents(
-        '/host/data/pages/index.txt'
-    )
-);
-
-echo $reader->getLinks(
-    $gemini
-);
-```
-
-### Filesystem
-
-Provides methods for simple and secure interaction with DokuWiki file storage
-
-```
-$filesystem = new \Yggverse\Gemini\Dokuwiki\Filesystem(
-    '/host/data' // storage location
-);
-```
-
-#### Filesystem::getList
-
-Return simple array of all files in storage
-
-```
-var_dump (
-    $filesystem->getList(
-        'hello:world'
-    )
-);
-```
-
-#### Filesystem::getTree
-
-Return all files under the storage folder in tree format
-
-```
-var_dump (
-    $filesystem->getTree(
-        'hello:world'
-    )
-);
-```
-
-#### Filesystem::getPagePathsByPath
-
-Return pages under the given data directory
-
-```
-var_dump (
-    $filesystem->getPagePathsByPath(
-        // absolute path to target data directory (e.g. Filesystem::getDirectoryPathByUri)
-    )
-);
-```
-
-#### Filesystem::getDirectoryPathByUri
-#### Filesystem::getPagePathByUri
-
-Return absolute path to stored page file
-
-```
-var_dump (
-    $filesystem->getPagePathByUri(
-        'hello:world'
-    )
-);
-```
-
-#### Filesystem::getDirectoryUriByPath
-#### Filesystem::getPageUriByPath
-
-Return page URI in `dokuwiki:format`
-
-```
-var_dump (
-    $filesystem->getPageUriByPath(
-        '/full/path/to/page.txt'
-    )
-);
-```
-
-#### Filesystem::getMediaPathByUri
-
-Return absolute path to stored media file
-
-```
-var_dump (
-    $filesystem->getMediaPathByUri(
-        'hello:world'
-    )
-);
-```
-
-#### Filesystem::getMimeByPath
-
-Return file MIME if path match storage item
-
-```
-var_dump (
-    $filesystem->getMimeByPath(
-        '/full/path/to/page.txt'
-    )
-);
-```
-
-#### Filesystem::getDataByPath
-
-Return file content if path match storage item
-
-```
-var_dump (
-    $filesystem->getDataByPath(
-        '/full/path/to/page.txt'
-    )
-);
-```
-
-#### Filesystem::isPath
-
-Check path exist and match storage item
-
-```
-var_dump (
-    $filesystem->isPath(
-        '/full/path/to/page.txt'
-    )
-);
-```
-
-### Helper
-
-Useful methods to minify controller codebase
-
-```
-$helper = new \Yggverse\Gemini\Dokuwiki\Helper(
-    new \Yggverse\Gemini\Dokuwiki\Filesystem(),
-    new \Yggverse\Gemini\Dokuwiki\Reader()
-);
-```
-
-#### Helper::getChildrenSectionLinksByUri
-
-Return simple array of children section links in Gemini format
-
-```
-var_dump (
-    $helper->getChildrenSectionLinksByUri(
-        'hello:world'
-    )
-);
-```
-
-#### Helper::getChildrenPageLinksByUri
-
-Return simple array of children page links in Gemini format
-
-```
-var_dump (
-    $helper->getChildrenPageLinksByUri(
-        'hello:world'
-    )
-);
-```
-
-#### Helper::getPageLinkByPath
-
-Return page link (that contain document name) in Gemini format
-
-```
-var_dump (
-    $helper->getPageLinkByPath(
-        $filesystem->getPagePathByUri(
-            'hello:world'
-        )
-    )
-);
-```
+* [gemini-dl](https://github.com/YGGverse/gemini-dl) - CLI Batch downloader for Gemini Protocol
+* [Yo!](https://github.com/YGGverse/Yo/tree/gemini) - Crawler for different networks
+* [Yoda](https://github.com/YGGverse/Yoda) - PHP-GTK browser for Gemini Protocol
+* [β-Doku](https://github.com/YGGverse/bdoku) - DokuWiki Satellite for Gemini Protocol

composer.json

@@ -1,7 +1,7 @@
 {
     "name": "yggverse/gemini",
     "description": "PHP 8 Library for Gemini Protocol",
-    "keywords": [ "yggverse", "gemini", "wiki", "dokuwiki", "markdown" ],
+    "keywords": [ "yggverse", "gemini", "gemini-protocol", "client", "request", "response" ],
     "homepage": "https://github.com/yggverse/gemini-php",
     "type": "library",
     "license": "MIT",
@@ -10,7 +10,5 @@
             "Yggverse\\Gemini\\": "src/"
         }
     },
-    "require": {
-        "dekor/php-array-table": "^2.0"
-    }
+    "require": {}
 }

src/Client/Request.php

@@ -6,12 +6,25 @@ namespace Yggverse\Gemini\Client;
 
 class Request
 {
+    private ?string $_ip = null;
+
     private string $_host;
     private int    $_port;
     private string $_path;
     private string $_query;
 
-    public function __construct(string $url)
+    private array $_options =
+    [
+        'ssl' =>
+        [
+            'allow_self_signed' => true,
+            'disable_compression' => true,
+            'verify_peer_name' => false,
+            'verify_peer' => false
+        ]
+    ];
+
+    public function __construct(string $url, ?string $ip = null)
     {
         if ($host = parse_url($url,  PHP_URL_HOST))
         {
@@ -22,7 +35,9 @@ class Request
 
         else
         {
-            throw new Exception(); // @TODO
+            throw new \Exception(
+                _('Host required')
+            );
         }
 
         if ($port = parse_url($url,  PHP_URL_PORT))
@@ -66,6 +81,23 @@ class Request
                 ''
             );
         }
+
+        if ($ip && false !== filter_var($ip, FILTER_VALIDATE_IP))
+        {
+            $this->setResolvedHost(
+                $ip
+            );
+        }
+    }
+
+    public function setOptions(array $value): void
+    {
+        $this->_options = $value;
+    }
+
+    public function getOptions(): array
+    {
+        return $this->_options;
     }
 
     public function setHost(string $value): void
@@ -108,11 +140,20 @@ class Request
         return $this->_query;
     }
 
+    public function setResolvedHost(?string $value): void
+    {
+        $this->_ip = $value;
+    }
+
+    public function getResolvedHost(): ?string
+    {
+        return $this->_ip;
+    }
+
     public function getResponse(
         int $timeout = 30, // socket timeout, useful for offline resources
         ?int $limit = null, // content length, null for unlimited
-        int $chunk = 1, // chunk size in bytes
-        int &$length = 0, // current response length, do not change without special needs
+        ?int &$length = 0, // initial response length, do not change without special needs
         ?int &$code = null, // error code for debug
         ?string &$message = null, // error message for debug
         string &$response = '' // response init, also returning by this method
@@ -121,7 +162,7 @@ class Request
         $connection = stream_socket_client(
             sprintf(
                 'tls://%s:%d',
-                $this->_host,
+                $this->_ip ? $this->_ip : $this->_host,
                 $this->_port
             ),
             $code,
@@ -129,13 +170,7 @@ class Request
             $timeout,
             STREAM_CLIENT_CONNECT,
             stream_context_create(
-                [
-                    'ssl' =>
-                    [
-                        'verify_peer' => false,
-                        'verify_peer_name' => false
-                    ]
-                ]
+                $this->_options
             )
         );
 
@@ -151,11 +186,14 @@ class Request
                 $this->_host,
                 $this->_port,
                 $this->_path,
-                $this->_query
+                $this->_query ? sprintf(
+                    '?%s',
+                    $this->_query
+                ) : null
             )
         );
 
-        while ($part = fgets($connection, $chunk))
+        while ($part = fgets($connection))
         {
             $length = $length + mb_strlen(
                 $part

src/Client/Response.php

@@ -10,40 +10,45 @@ class Response
     private ?string $_meta = null;
     private ?string $_body = null;
 
-    public function __construct(string $data)
+    public function __construct(?string $data = null)
     {
-        $match = [];
-
-        preg_match(
-            '/(?<status>\d{2})\s(?<meta>.*)\r\n(?<body>.*)/su',
-            $data,
-            $match
-        );
-
-        if (isset($match['code']))
+        if ($data)
         {
-            $code = (int) $match['code'];
+            $match = [];
 
-            if ($code >= 10 && $code <= 69)
+            preg_match(
+                '/^(?<code>\d{2})(?<meta>.*)$/m',
+                $data,
+                $match
+            );
+
+            if (isset($match['code']))
             {
-                $this->setCode(
-                    $code
+                $code = (int) $match['code'];
+
+                if ($code >= 10 && $code <= 69)
+                {
+                    $this->setCode(
+                        $code
+                    );
+                }
+            }
+
+            if (isset($match['meta']) && mb_strlen($match['meta']) <= 1024)
+            {
+                $this->setMeta(
+                    trim(
+                        (string) $match['meta']
+                    )
                 );
             }
-        }
 
-        if (isset($match['meta']) && mb_strlen($match['meta']) <= 1024)
-        {
-            $this->setMeta(
-                (string) $match['meta']
-            );
-        }
-
-        if (isset($match['body']))
-        {
-            $this->setBody(
-                (string) (string) $match['body']
-            );
+            if ($body = substr($data, strpos($data, chr(10)) + 1))
+            {
+                $this->setBody(
+                    (string) $body
+                );
+            }
         }
     }
 

src/Dokuwiki/Filesystem.php

@@ -1,277 +0,0 @@
-<?php
-
-declare(strict_types=1);
-
-namespace Yggverse\Gemini\Dokuwiki;
-
-class Filesystem
-{
-    private $_path;
-    private $_tree = [];
-    private $_list = [];
-
-    public function __construct(string $path)
-    {
-        $this->_path = rtrim(
-            $path,
-            '/'
-        );
-
-        $this->_index(
-            $this->_path
-        );
-    }
-
-    public function getTree(): array
-    {
-        return $this->_tree;
-    }
-
-    public function getList(): array
-    {
-        return $this->_list;
-    }
-
-    public function getPagePathsByPath(string $path): ?array
-    {
-        if (isset($this->_tree[$path]))
-        {
-            return $this->_tree[$path];
-        }
-
-        return null;
-    }
-
-    public function getPagePathByUri(string $uri): ?string
-    {
-        $path = sprintf(
-            '%s/pages/%s.txt',
-            $this->_path,
-            str_replace(
-                ':',
-                '/',
-                mb_strtolower(
-                    urldecode(
-                        $uri
-                    )
-                )
-            )
-        );
-
-        if (!$this->isPath($path))
-        {
-            return null;
-        }
-
-        return $path;
-    }
-
-    public function getPageUriByPath(string $path): ?string
-    {
-        if (!$this->isPath($path))
-        {
-            return null;
-        }
-
-        $path = str_replace(
-            sprintf(
-                '%s/pages/',
-                $this->_path
-            ),
-            '',
-            $path
-        );
-
-        $path = trim(
-            $path,
-            '/'
-        );
-
-        $path = str_replace(
-            [
-                '/',
-                '.txt'
-            ],
-            [
-                ':',
-                null
-            ],
-            $path
-        );
-
-        return $path;
-    }
-
-    public function getDirectoryPathByUri(string $uri = ''): ?string
-    {
-        $path = rtrim(
-            sprintf(
-                '%s/pages/%s',
-                $this->_path,
-                str_replace(
-                    ':',
-                    '/',
-                    mb_strtolower(
-                        urldecode(
-                            $uri
-                        )
-                    )
-                )
-            ),
-            '/'
-        );
-
-        if (!isset($this->_tree[$path]) || !is_dir($path) || !is_readable($path))
-        {
-            return null;
-        }
-
-        return $path;
-    }
-
-    public function getDirectoryUriByPath(string $path): ?string
-    {
-        if (!isset($this->_tree[$path]) || !is_dir($path) || !is_readable($path))
-        {
-            return null;
-        }
-
-        $path = str_replace(
-            sprintf(
-                '%s/pages',
-                $this->_path
-            ),
-            '',
-            $path
-        );
-
-        $path = trim(
-            $path,
-            '/'
-        );
-
-        $path = str_replace(
-            [
-                '/'
-            ],
-            [
-                ':'
-            ],
-            $path
-        );
-
-        return $path;
-    }
-
-    public function getMediaPathByUri(string $uri): ?string
-    {
-        $path = sprintf(
-            '%s/media/%s',
-            $this->_path,
-            str_replace(
-                ':',
-                '/',
-                mb_strtolower(
-                    urldecode(
-                        $uri
-                    )
-                )
-            )
-        );
-
-        if (!$this->isPath($path))
-        {
-            return null;
-        }
-
-        return $path;
-    }
-
-    public function getMimeByPath(?string $path): ?string
-    {
-        if ($this->isPath($path))
-        {
-            if ($mime = mime_content_type($path))
-            {
-                return $mime;
-            }
-        }
-
-        return null;
-    }
-
-    public function getDataByPath(?string $path): ?string
-    {
-        if ($this->isPath($path))
-        {
-            if ($data = file_get_contents($path))
-            {
-                return $data;
-            }
-        }
-
-        return null;
-    }
-
-    public function isPath(?string $path): bool
-    {
-        if (in_array($path, $this->_list) && is_file($path) && is_readable($path))
-        {
-            return true;
-        }
-
-        return false;
-    }
-
-    private function _index(
-        string $path,
-        ?array $blacklist = ['sidebar.txt', '__template.txt']
-    ): void
-    {
-        foreach ((array) scandir($path) as $file)
-        {
-            if (str_starts_with($file, '.'))
-            {
-                continue;
-            }
-
-            if (is_link($file))
-            {
-                continue;
-            }
-
-            if (in_array($file, $blacklist))
-            {
-                continue;
-            }
-
-            $file = sprintf(
-                '%s/%s',
-                $path,
-                $file
-            );
-
-            switch (true)
-            {
-                case is_dir($file):
-
-                    if (!isset($this->_tree[$path]))
-                    {
-                        $this->_tree[$path] = [];
-                    }
-
-                    $this->_index($file);
-
-                break;
-
-                case is_file($file):
-
-                    $this->_tree[$path][] = $file;
-
-                    $this->_list[] = $file;
-
-                break;
-            }
-        }
-    }
-}

src/Dokuwiki/Helper.php

@@ -1,154 +0,0 @@
-<?php
-
-declare(strict_types=1);
-
-namespace Yggverse\Gemini\Dokuwiki;
-
-class Helper
-{
-    private \Yggverse\Gemini\Dokuwiki\Filesystem $_filesystem;
-    private \Yggverse\Gemini\Dokuwiki\Reader $_reader;
-
-    public function __construct(
-        \Yggverse\Gemini\Dokuwiki\Filesystem $filesystem,
-        \Yggverse\Gemini\Dokuwiki\Reader $reader
-    ) {
-        $this->_filesystem = $filesystem;
-        $this->_reader = $reader;
-    }
-
-    public function getChildrenSectionLinksByUri(?string $uri = ''): array
-    {
-        $sections = [];
-
-        if ($directory = $this->_filesystem->getDirectoryPathByUri($uri))
-        {
-            foreach ((array) $this->_filesystem->getTree() as $path => $files)
-            {
-                if (str_starts_with($path, $directory) && $path != $directory)
-                {
-                    // Init link name
-                    $h1 = null;
-
-                    // Init this directory URI
-                    $thisUri = $this->_filesystem->getDirectoryUriByPath(
-                        $path
-                    );
-
-                    // Skip sections deeper this level
-                    if (substr_count($thisUri, ':') > ($uri ? substr_count($uri, ':') + 1 : 0))
-                    {
-                        continue;
-                    }
-
-                    // Get section names
-                    $segments = [];
-
-                    foreach ((array) explode(':', $thisUri) as $segment)
-                    {
-                        $segments[] = $segment;
-
-                        // Find section index if exists
-                        if ($file = $this->_filesystem->getPagePathByUri(implode(':', $segments) . ':' . $segment))
-                        {
-                            $h1 = $this->_reader->getH1(
-                                $this->_reader->toGemini(
-                                    $this->_filesystem->getDataByPath(
-                                        $file
-                                    )
-                                )
-                            );
-                        }
-
-                        // Find section page if exists
-                        else if ($file = $this->_filesystem->getPagePathByUri(implode(':', $segments)))
-                        {
-                            $h1 = $this->_reader->getH1(
-                                $this->_reader->toGemini(
-                                    $this->_filesystem->getDataByPath(
-                                        $file
-                                    )
-                                )
-                            );
-                        }
-
-                        // Reset title of undefined segment
-                        else
-                        {
-                            $h1 = null;
-                        }
-                    }
-
-                    // Register section link
-                    $sections[] = sprintf(
-                        '=> /%s %s',
-                        $thisUri,
-                        $h1
-                    );
-                }
-            }
-        }
-
-        // Keep unique
-        $sections = array_unique(
-            $sections
-        );
-
-        // Sort asc
-        sort(
-            $sections
-        );
-
-        return $sections;
-    }
-
-    public function getChildrenPageLinksByUri(?string $uri = ''): array
-    {
-        $pages = [];
-
-        if ($directory = $this->_filesystem->getDirectoryPathByUri($uri))
-        {
-            foreach ((array) $this->_filesystem->getPagePathsByPath($directory) as $file)
-            {
-                if ($link = $this->getPageLinkByPath($file))
-                {
-                    $pages[] = $link;
-                }
-            }
-        }
-
-        // Keep unique
-        $pages = array_unique(
-            $pages
-        );
-
-        // Sort asc
-        sort(
-            $pages
-        );
-
-        return $pages;
-    }
-
-    public function getPageLinkByPath(string $path): ?string
-    {
-        if (in_array($path, $this->_filesystem->getList()) && is_file($path) && is_readable($path))
-        {
-            return sprintf(
-                '=> /%s %s',
-                $this->_filesystem->getPageUriByPath(
-                    $path
-                ),
-                $this->_reader->getH1(
-                    $this->_reader->toGemini(
-                        $this->_filesystem->getDataByPath(
-                            $path
-                        )
-                    )
-                )
-            );
-        }
-
-        return null;
-    }
-}

src/Dokuwiki/Reader.php

@@ -1,412 +0,0 @@
-<?php
-
-declare(strict_types=1);
-
-namespace Yggverse\Gemini\Dokuwiki;
-
-use dekor\ArrayToTextTable;
-
-class Reader
-{
-    private array $_macros =
-    [
-        '~URL:base~' => null,
-        '~IPv6:open~' => '[',
-        '~IPv6:close~' => ']',
-        '~LINE:break~' => PHP_EOL
-    ];
-
-    private array $_rule =
-    [
-        // Headers
-        '/^([\s]*)#([^#]+)/' => '$1#$2' . PHP_EOL,
-        '/^([\s]*)##([^#]+)/' => '$1##$2' . PHP_EOL,
-        '/^([\s]*)###([^#]+)/' => '$1###$2' . PHP_EOL,
-        '/^([\s]*)####([^#]+)/' => '$1###$2' . PHP_EOL,
-        '/^([\s]*)#####([^#]+)/' => '$1###$2' . PHP_EOL,
-        '/^([\s]*)######([^#]+)/' => '$1###$2' . PHP_EOL,
-
-        '/^[\s]*[=]{6}([^=]+)[=]{6}/' => '# $1' . PHP_EOL,
-        '/^[\s]*[=]{5}([^=]+)[=]{5}/' => '## $1' . PHP_EOL,
-        '/^[\s]*[=]{4}([^=]+)[=]{4}/' => '### $1' . PHP_EOL,
-        '/^[\s]*[=]{3}([^=]+)[=]{3}/' => '### $1' . PHP_EOL,
-        '/^[\s]*[=]{2}([^=]+)[=]{2}/' => '### $1' . PHP_EOL,
-        '/^[\s]*[=]{1}([^=]+)[=]{1}/' => '### $1' . PHP_EOL,
-
-        // Tags
-        '/\*\*/' => '',
-        '/\'\'/' => '',
-        '/\%\%/' => '',
-        '/(?<!:)\/\//' => '',
-
-        // Remove extra spaces
-        '/(\s)\s+/' => '$1',
-
-        // Links
-
-        /// Detect IPv6 (used as no idea how to resolve square quotes in rules below)
-        '/\[\[([^\[]+)\[([A-f:0-9]*)\]([^\]]+)\]\]/' => '$1~IPv6:open~$2~IPv6:close~$3',
-
-        /// Remove extra chars
-        '/\[\[\s*\:?([^\|]+)\s*\|\s*([^\]]+)\s*\]\]/' => '[[$1|$2]]',
-        '/\[\[\s*\:?([^\]]+)\s*\]\]/' => '[[$1]]',
-
-        '/\{\{\s*\:?([^\|]+)\s*\|\s*([^\}]+)\s*\}\}/' => '{{$1|$2}}',
-        '/\{\{\s*\:?([^\}]+)\s*\}\}/' => '{{$1}}',
-
-        /// Wikipedia
-        '/\[\[wp([A-z]{2,})>([^\|]+)\|([^\]]+)\]\]/ui' => '$3 ( https://$1.wikipedia.org/wiki/$2 )',
-        '/\[\[wp>([^\|]+)\|([^\]]+)\]\]/i' => '$2 ( https://en.wikipedia.org/wiki/$1 )',
-        '/\[\[wp([A-z]{2,})>([^\]]+)\]\]/i' => '$2 ( https://$1.wikipedia.org/wiki/$2 )',
-        '/\[\[wp>([^\]]+)\]\]/i' => '$1 ( https://en.wikipedia.org/wiki/$1 )',
-
-        /// Dokuwiki
-        '/\[\[doku>([^\|]+)\|([^\]]+)\]\]/i' => '$2( https://www.dokuwiki.org/$1 )',
-        '/\[\[doku>([^\]]+)\]\]/i' => '$1( https://www.dokuwiki.org/$1 )',
-
-        /// Index
-        /// Useful with src/Dokuwiki/Helper.php
-        '/\{\{indexmenu>:([^\}]+)\}\}/i' => '',
-        '/\{\{indexmenu_n>[\d]+\}\}/i' => '',
-
-        // Related
-        '/\[\[this>([^\|]+)\|([^\]]+)\]\]/i' => '$2',
-
-        /// Relative
-        '/\[\[(?!https?:|this|doku|wp[A-z]{0,2})([^\|]+)\|([^\]]+)\]\]/i' => ' $2$3 ( ~URL:base~$1 )',
-        '/\[\[(?!https?:|this|doku|wp[A-z]{0,2})([^\]]+)\]\]/i' => ' $2 ( ~URL:base~$1 )',
-
-        /// Absolute
-        '/\[\[(https?:)([^\|]+)\|([^\]]+)\]\]/i' => '$3 ( $1$2 )',
-        '/\[\[(https?:)([^\]]+)\]\]/i' => '$1$2', // @TODO
-
-        /// Media
-        '/\{\{(?!https?:)([^\|]+)\|([^\}]+)\}\}/i' => PHP_EOL . '=> /$1$2' . PHP_EOL,
-        '/\{\{(?!https?:)([^\}]+)\}\}/i' => PHP_EOL . '=> /$1$2' . PHP_EOL,
-
-        // List
-        '/^[\s]?-/' => '* ',
-        '/^[\s]+\*/' => '*',
-
-        // Separators
-        '/[\\\]{2}/' => '~LINE:break~',
-
-        // Plugins
-        '/~~DISCUSSION~~/' => '', // @TODO
-        '/~~INFO:syntaxplugins~~/' => '', // @TODO
-
-        // Final corrections
-        '/[\n\r]+[.,;:]+/' => PHP_EOL
-    ];
-
-    public function __construct(?array $rules = null)
-    {
-        if ($rules)
-        {
-            $this->_rule = $rules;
-        }
-    }
-
-    // Macros operations
-    public function getMacroses(): array
-    {
-        $this->_macros;
-    }
-
-    public function setMacroses(array $macros)
-    {
-        $this->_macros = $macros;
-    }
-
-    public function getMacros(string $key, string $value): ?string
-    {
-        $this->_macros[$key] = isset($this->_macros[$key]) ? $value : null;
-    }
-
-    public function setMacros(string $key, ?string $value): void
-    {
-        if ($value)
-        {
-            $this->_macros[$key] = $value;
-        }
-
-        else
-        {
-            unset(
-                $this->_macros[$key]
-            );
-        }
-    }
-
-    // Rule operations
-    public function getRules(): array
-    {
-        $this->_rule;
-    }
-
-    public function setRules(array $rules)
-    {
-        $this->_rule = $rules;
-    }
-
-    public function getRule(string $key, string $value): ?string
-    {
-        $this->_rule[$key] = isset($this->_rule[$key]) ? $value : null;
-    }
-
-    public function setRule(string $key, ?string $value): void
-    {
-        if ($value)
-        {
-            $this->_rule[$key] = $value;
-        }
-
-        else
-        {
-            unset(
-                $this->_rule[$key]
-            );
-        }
-    }
-
-    // Convert DokuWiki text to Gemini
-    public function toGemini(?string $data, ?array &$lines = []): ?string
-    {
-        if (empty($data))
-        {
-            return null;
-        }
-
-        $raw = false;
-
-        $lines = [];
-
-        foreach ((array) explode(PHP_EOL, $data) as $line)
-        {
-            // Skip any formatting in lines between code tag
-            if (!$raw && preg_match('/<(code|file)([^>]*)>/i', $line, $matches))
-            {
-                // Prepend tag meta or filename as plain description
-                if (!empty($matches[0]))
-                {
-                    $lines[] = preg_replace(
-                        '/<(code|file)[\s-]*([^>]*)>/i',
-                        '$2',
-                        $matches[0]
-                    );
-                }
-
-                $lines[] = '```';
-                $lines[] = preg_replace(
-                    '/<\/?(code|file)[^>]*>/i',
-                    '',
-                    $line
-                );
-
-                $raw = true;
-
-                // Make sure inline tag closed
-                if (preg_match('/<\/(code|file)>/i', $line))
-                {
-                    $lines[] = '```';
-
-                    $raw = false;
-
-                    continue;
-                }
-
-                continue;
-            }
-
-            if ($raw && preg_match('/<\/(code|file)>/i', $line))
-            {
-                $lines[] = preg_replace(
-                    '/<\/(code|file)>/i',
-                    '',
-                    $line
-                );
-
-                $lines[] = '```';
-
-                $raw = false;
-
-                continue;
-            }
-
-            if ($raw)
-            {
-                $lines[] = preg_replace(
-                    '/^```/',
-                    ' ```',
-                    $line
-                );
-
-                continue;
-            }
-
-            // Apply config
-            $lines[] = preg_replace(
-                array_keys(
-                    $this->_rule
-                ),
-                array_values(
-                    $this->_rule
-                ),
-                strip_tags(
-                    $line
-                )
-            );
-        }
-
-        // ASCII table
-        $table = false;
-
-        $rows = [];
-
-        $th = [];
-
-        foreach ($lines as $index => $line)
-        {
-            // Strip line breaks
-            $line = str_replace(
-                '~LINE:break~',
-                ' ',
-                $line
-            );
-
-            // Header
-            if (!$table && preg_match_all('/\^([^\^]+)/', $line, $matches))
-            {
-                if (!empty($matches[1]))
-                {
-                    $table = true;
-
-                    $rows = [];
-
-                    $th = [];
-
-                    foreach ($matches[1] as $value)
-                    {
-                        $th[] = trim(
-                            $value
-                        );
-                    }
-
-                    unset(
-                        $lines[$index]
-                    );
-
-                    continue;
-                }
-            }
-
-            // Body
-            if ($table)
-            {
-                $table = false;
-
-                if (preg_match(sprintf('/%s\|/', str_repeat('\|(.*)', count($th))), $line, $matches))
-                {
-                    if (count($matches) == count($th) + 1)
-                    {
-                        $table = true;
-
-                        $row = [];
-                        foreach ($th as $offset => $column)
-                        {
-                            $row[$column] = trim(
-                                $matches[$offset + 1]
-                            );
-                        }
-
-                        $rows[] = $row;
-
-                        unset(
-                            $lines[$index]
-                        );
-                    }
-                }
-
-                if (!$table && $rows)
-                {
-                    $builder = new ArrayToTextTable(
-                        $rows
-                    );
-
-                    $lines[$index] = '```' . PHP_EOL . $builder->render() . PHP_EOL . '```';
-                }
-            }
-        }
-
-        // Merge lines
-        return preg_replace(
-            '/[\n\r]{2,}/',
-            PHP_EOL . PHP_EOL,
-            str_replace(
-                array_keys(
-                    $this->_macros
-                ),
-                array_values(
-                    $this->_macros
-                ),
-                implode(
-                    PHP_EOL,
-                    $lines
-                )
-            )
-        );
-    }
-
-    public function getH1(?string $gemini, ?string $regex = '/^[\s]?#([^#]+)/'): ?string
-    {
-        foreach ((array) explode(PHP_EOL, (string) $gemini) as $line)
-        {
-            preg_match(
-                $regex,
-                $line,
-                $matches
-            );
-
-            if (!empty($matches[1]))
-            {
-                return trim(
-                    $matches[1]
-                );
-
-                break;
-            }
-        }
-
-        return null;
-    }
-
-    public function getLinks(?string $gemini, ?string $regex = '/(https?|gemini):\/\/\S+/'): array
-    {
-        $links = [];
-
-        if (empty($gemini))
-        {
-            return $links;
-        }
-
-        preg_match_all(
-            $regex,
-            $gemini,
-            $matches
-        );
-
-        if (!empty($matches[0]))
-        {
-            foreach ((array) $matches[0] as $link)
-            {
-                $links[] = trim(
-                    $link
-                );
-            }
-        }
-
-        return array_unique(
-            $links
-        );
-    }
-}

src/Gemtext/Body.php

@@ -1,108 +0,0 @@
-<?php
-
-declare(strict_types=1);
-
-namespace Yggverse\Gemini\Gemtext;
-
-class Body
-{
-    private array $_lines = [];
-
-    public function __construct(string $gemtext)
-    {
-        foreach ((array) explode(PHP_EOL, $gemtext) as $line)
-        {
-            $this->_lines[] = $line;
-        }
-    }
-
-    public function getH1(): array
-    {
-        $matches = [];
-
-        foreach ($this->_lines as $line)
-        {
-            if (preg_match('/^#([^#]+)/', trim($line), $match))
-            {
-                $matches[] = trim(
-                    $match[1]
-                );
-            }
-        }
-
-        return $matches;
-    }
-
-    public function getH2(): array
-    {
-        $matches = [];
-
-        foreach ($this->_lines as $line)
-        {
-            if (preg_match('/^##([^#]+)/', trim($line), $match))
-            {
-                $matches[] = trim(
-                    $match[1]
-                );
-            }
-        }
-
-        return $matches;
-    }
-
-    public function getH3(): array
-    {
-        $matches = [];
-
-        foreach ($this->_lines as $line)
-        {
-            if (preg_match('/^###([^#]+)/', trim($line), $match))
-            {
-                $matches[] = trim(
-                    $match[1]
-                );
-            }
-        }
-
-        return $matches;
-    }
-
-    public function getLinks(): array
-    {
-        $matches = [];
-
-        foreach ($this->_lines as $line)
-        {
-            if (preg_match('/^=>(.*)/', trim($line), $match))
-            {
-                $matches[] = trim(
-                    $match[1]
-                );
-            }
-        }
-
-        return $matches;
-    }
-
-    public function findLinks(string $protocol = 'gemini'): array
-    {
-        $matches = [];
-
-        foreach ($this->_lines as $line)
-        {
-            if (preg_match('/' . $protocol . ':\/\/(.*)[\s\S\'"]*/', trim($line), $match))
-            {
-                $matches[] =
-                sprintf(
-                    '%s://%s',
-                    $protocol,
-                    trim(
-                        $match[1]
-                    )
-                );
-            }
-        }
-
-        return $matches;
-    }
-}

src/Gemtext/Link.php

@@ -1,63 +0,0 @@
-<?php
-
-declare(strict_types=1);
-
-namespace Yggverse\Gemini\Gemtext;
-
-class Link
-{
-    private string $_line;
-
-    public function __construct(string $line)
-    {
-        $this->_line = $line;
-    }
-
-    public function getAddress(): ?string
-    {
-        if (preg_match('/^([^\s]+)\s.*/', trim($this->_line), $match))
-        {
-            return trim(
-                $match[1]
-            );
-        }
-
-        return null;
-    }
-
-    public function getDate(?int &$timestamp = null): ?string
-    {
-        if (preg_match('/\s([\d]+-[\d+]+-[\d]+)\s/', trim($this->_line), $match))
-        {
-            if ($result = strtotime($match[1]))
-            {
-                $timestamp = $result;
-
-                return trim(
-                    $match[1]
-                );
-            }
-        }
-
-        return null;
-    }
-
-    public function getAlt(): ?string
-    {
-        if (preg_match('/\s[\d]+-[\d+]+-[\d]+\s(.*)$/', trim($this->_line), $match))
-        {
-            return trim(
-                $match[1]
-            );
-        }
-
-        else if (preg_match('/\s(.*)$/', trim($this->_line), $match))
-        {
-            return trim(
-                $match[1]
-            );
-        }
-
-        return null;
-    }
-}