fix absolute address detection

README.md

@@ -12,7 +12,7 @@ Network Library for PHP with native Yggdrasil support
 
 #### Check socket is open
 
-```
+``` php
 var_dump(
     \Yggverse\Net\Socket::isOpen('yo.index', 80)
 );
@@ -20,7 +20,7 @@ var_dump(
 
 #### Check host valid
 
-```
+``` php
 var_dump(
     \Yggverse\Net\Socket::isHost('yo.index')
 );
@@ -28,7 +28,7 @@ var_dump(
 
 #### Check port valid
 
-```
+``` php
 var_dump(
     \Yggverse\Net\Socket::isPort(80)
 );
@@ -38,7 +38,7 @@ var_dump(
 
 #### Resolve records
 
-```
+``` php
 var_dump(
     \Yggverse\Net\Dig::records('yo.index', ['A', 'AAAA'], &$result = [], &$error = [], $provider = null, $timeout = 5)
 );
@@ -46,7 +46,7 @@ var_dump(
 
 #### Check hostname valid
 
-```
+``` php
 var_dump(
     \Yggverse\Net\Dig::isHostName('yo.index')
 );
@@ -54,7 +54,7 @@ var_dump(
 
 #### Check record valid
 
-```
+``` php
 var_dump(
     \Yggverse\Net\Dig::isRecord('A')
 );
@@ -62,7 +62,7 @@ var_dump(
 
 #### Check record value valid
 
-```
+``` php
 var_dump(
     \Yggverse\Net\Dig::isRecordValue('A', '127.0.0.1')
 );
@@ -72,7 +72,7 @@ var_dump(
 
 #### Init resolver
 
-```
+``` php
 $resolve = new \Yggverse\Net\Resolve(
     [
         'A',
@@ -88,7 +88,7 @@ $resolve = new \Yggverse\Net\Resolve(
 
 #### Get resolved URL string
 
-```
+``` php
 $resolved = $resolve->url(
     'https://en.wikipedia.org/wiki/Domain_Name_System'
     // next arguments contain debug variables and new address object
@@ -104,7 +104,7 @@ if ($resolved)
 
 #### Resolve Address object
 
-```
+``` php
 $resolved = $resolve->address(
     new \Yggverse\Net\Address(
         'https://en.wikipedia.org/wiki/Domain_Name_System'
@@ -144,7 +144,7 @@ Different operations with address parts:
 
 **Document root**
 
-```
+``` php
 $base = new \Yggverse\Net\Address(
     'http://yo.ygg/a1/b1/c1'
 );
@@ -162,7 +162,7 @@ var_dump(
 
 **Current folder**
 
-```
+``` php
 $base = new \Yggverse\Net\Address(
     'http://yo.ygg/a1/b1/c1'
 );
@@ -180,7 +180,7 @@ var_dump(
 
 **Ending slash**
 
-```
+``` php
 $base = new \Yggverse\Net\Address(
     'http://yo.ygg/a1/b1/c1/'
 );
@@ -198,7 +198,7 @@ var_dump(
 
 **All options**
 
-```
+``` php
 $base = new \Yggverse\Net\Address(
     'http://user:password@yo.ygg/a1/b1/c1?attribute=value#anchor'
 );
@@ -214,7 +214,20 @@ var_dump(
 );
 ```
 
+### Valid
+
+Network entities validation
+
+**Supported methods**
+
+* `Valid::ip`
+* `Valid::ip4`
+* `Valid::ip6`
+* `Valid::domainHostName`
+
 ## Integrations
 
-* [Network API with native Yggdrasil/IPv6 support](https://github.com/YGGverse/web-api)
+* [gemini-dl](https://github.com/YGGverse/gemini-dl) - CLI batch downloader for Gemini protocol
-* [Yo! Crawler for different networks](https://github.com/YGGverse/Yo)
+* [web-api](https://github.com/YGGverse/web-api) - Network API with native Yggdrasil/IPv6 support
+* [Yo!](https://github.com/YGGverse/Yo) - Crawler and search engine for different networks
+* [Yoda](https://github.com/YGGverse/Yoda) - Experimental PHP-GTK browser for Gemini protocol

src/Address.php

@@ -83,7 +83,9 @@ class Address
 
     public function isAbsolute(): bool
     {
-        return ($this->_scheme && $this->_host);
+        return boolval(
+            $this->_scheme || $this->_host
+        );
     }
 
     public function isRelative(): bool
@@ -198,28 +200,37 @@ class Address
         $this->_separator = $value;
     }
 
-    public function get(): string
+    public function get(
+        bool $scheme   = true,
+        bool $user     = true,
+        bool $pass     = true,
+        bool $host     = true,
+        bool $port     = true,
+        bool $path     = true,
+        bool $query    = true,
+        bool $fragment = true,
+    ): string
     {
         $address = '';
 
-        if ($scheme = $this->getScheme())
+        if ($scheme && $this->getScheme())
         {
             $address .= sprintf(
                 '%s:%s%s',
-                $scheme,
+                $this->getScheme(),
                 $this->getSeparator(),
                 $this->getSeparator()
             );
         }
 
-        if ($user = $this->getUser())
+        if ($user && $this->getUser())
         {
-            if ($pass = $this->getPass())
+            if ($pass && $this->getPass())
             {
                 $address .= sprintf(
                     '%s:%s@',
-                    $user,
+                    $this->getUser(),
-                    $pass
+                    $this->getPass()
                 );
             }
 
@@ -227,65 +238,65 @@ class Address
             {
                 $address .= sprintf(
                     '%s@',
-                    $user
+                    $this->getUser()
                 );
             }
         }
 
-        if ($host = $this->getHost())
+        if ($host && $this->getHost())
         {
-            $address .= $host;
+            $address .= $this->getHost();
         }
 
-        if ($port = $this->getPort())
+        if ($port && $this->getPort())
         {
             $address .= sprintf(
                 ':%d',
-                $port
+                $this->getPort()
             );
         }
 
-        if ($path = $this->getPath())
+        if ($path && $this->getPath())
         {
-            if (!str_starts_with($path, $this->getSeparator()))
+            if (!str_starts_with($this->getPath(), $this->getSeparator()))
             {
                 $address .= $this->getSeparator();
             }
 
-            $address .= $path;
+            $address .= $this->getPath();
         }
 
-        if ($query = $this->getQuery())
+        if ($query && $this->getQuery())
         {
             $address .= sprintf(
                 '?%s',
-                $query
+                $this->getQuery()
             );
         }
 
-        if ($fragment = $this->getFragment())
+        if ($fragment && $this->getFragment())
         {
             $address .= sprintf(
                 '#%s',
-                $fragment
+                $this->getFragment()
             );
         }
 
         return $address;
     }
 
-    public function getAbsolute(
+    public function toAbsolute(
         \Yggverse\Net\Address $base
-    ): ?string
+    ): bool
     {
         if ($this->isAbsolute())
         {
-            return $this->get();
+            return true;
         }
 
         if ($base->isRelative())
         {
-            return null;
+            return false;
         }
 
         $this->setScheme(
@@ -314,7 +325,7 @@ class Address
 
         if (str_starts_with((string) $this->getPath(), $this->getSeparator()))
         {
-            return $this->get();
+            return true;
         }
 
         if ($path = $this->getPath())
@@ -342,7 +353,7 @@ class Address
                 {
                     if (empty($prefix[$index]))
                     {
-                        return null;
+                        return false;
                     }
 
                     unset(
@@ -368,8 +379,23 @@ class Address
                     )
                 )
             );
+
+            return true;
         }
 
+        return false;
+    }
+
+    // @TODO deprecated, legacy needs only
+    public function getAbsolute(
+        \Yggverse\Net\Address $base
+    ): ?string
+    {
+        if ($this->toAbsolute($base))
+        {
             return $this->get();
         }
+
+        return null;
+    }
 }