Merge pull request #99 from PandaHugMonster/dev

Prepared release for v1.1.0

README.md

@@ -38,6 +38,71 @@ P.S. The framework I develop for my own projects, but I'm really happy to share
 anyone who is interested in it. Feel free to participate! Suggestions, bug-reports. 
 I will be really happy hearing from you.
 
+----
+
+## Changelog
+
+### 1.1.0
+
+ * Implemented `FS::require()`, `FS::include()` and `FS::data()`
+ * Implemented `PHP::listOfExecPhpFileExtensions()`, `PHP::listOfExecPhpMimeTypes()`
+ * Now array/box argument for `File` constructor is allowed (like for `FS::locate()`)
+ * Added support of `FS::locate()` alike array/box of path components for `fl()`, 
+   `FS::file()` and `File`. So now `fl(['part1', 'part2', 'file.txt'])` will make a file
+   object with path: "{working-dir}/part1/part2/file.txt"
+ * In `BasicInitConfig` introduced component-aware `$allowed_data_dirs` for specifying
+   allowed data-dirs
+ * Introduced new exceptions: `DataDirectoryIsNotAllowed`, `IPParsingException`
+ * Implemented the shortcut for the "InitConfig". Now instead of 
+   `$config = PHP::getInitConfig()` you can use a shortcut `$config = ic()`
+ * Fixed some of the logic related to "l10n" and "default_tz" more you can find here:
+   [Nuances of l10n and default_tz](docs/notes.md#Nuances-of-l10n-and-default_tz)
+ * Implemented list of **days of the week**: `\spaf\simputils\DT::getListOfDaysOfWeek()`
+ * Implemented list of **months**: `\spaf\simputils\DT::getListOfMonths()`
+ * Incorporated all the previous minor-version patches
+   * To set the timezone for "DateTime" object now can be done by "strings" instead of
+     creation of "DateTimeZone" object every single time
+   * Other minimal changes
+ * Implemented trait `\spaf\simputils\traits\ComparablesTrait` which enables to implement 
+   common set of comparing functionality (`equalsTo`, `greaterThan`, `lessThan`, 
+   `greaterThanEqual`, `lessThanEqual`) and their shortcuts (`e`, `gt`, `lt`, 
+   `gte`, `lte`). Currently used in `Version` and `IPv4` models
+ * Implemented `\spaf\simputils\models\IPv4` and `\spaf\simputils\models\IPv4Range` models
+   with minimal but nice functionality
+ * Implemented `\spaf\simputils\models\UrlObject` model 
+   and `\spaf\simputils\models\urls\processors\HttpProtocolProcessor`
+   * The most of the stuff should work out of the box except lack 
+     of "to punycode" conversion. Cyrillic and other non-latin domains are 
+     not converted to punycode.
+ * Implemented `\spaf\simputils\System::localIp()` that gets the local IP
+ * Implemented shortcuts `url()` for `\spaf\simputils\models\UrlObject` model and
+   `ip()` for `\spaf\simputils\models\IPv4`
+ * Added `\spaf\simputils\components\normalizers\IPNormalizer` property normalizer
+ * Implementation of `\spaf\simputils\PHP::bro()` method (`\spaf\simputils\models\BoxRO`)
+   which is basically "immutable Box"
+ * Implemented shortcuts for getting `POST` and `GET` data as bros (BoxRO). Please keep 
+   in mind that they are immutable due to best-practices:
+   * `\spaf\simputils\PHP::POST()`
+   * `\spaf\simputils\PHP::GET()`
+ * Implemented `\spaf\simputils\PHP::objToNaiveString()` method to generate simple/naive
+   object representation
+ * Implemented some relevant tests
+ * Important: Functionality of the Box is slightly extended. Now you can re-define static
+   `\spaf\simputils\models\Box::$default_separator` variable value to string that should be used
+   during `\spaf\simputils\models\Box::join()` and `\spaf\simputils\models\Box::implode()` as 
+   a separator by default (initially default is ", " as it was before).
+   Additionally you can specify `\spaf\simputils\models\Box::$separator` on per object basis
+   that will be used in the object in case of "join" or "implode" without the first argument.
+   That functionality allows to create "path-ready" Box-arrays, that can by default 
+   be automatically converted into a "unix" path.
+   `\spaf\simputils\models\Box::$joined_to_str` per object variable allows to define that
+   this Box-object needs to be converted in `__toString()` method 
+   through `\spaf\simputils\models\Box::join()` method, which is really useful for "path-ready"
+   Box-arrays. See example here: [Path-alike Box-array](#Path-alike-Box-array)
+ * For convenience create method-shortcut 
+   to set Box as "Path-alike": `\spaf\simputils\models\Box::pathAlike()`
+
+
 ----
 
 ## Documentation
@@ -51,14 +116,15 @@ so documentation will come after that in the very nearest time. My apologies.
 ### Some:
  1. [Glossary](docs/glossary.md)
  2. [Structure](docs/structure.md)
+ 3. [Important notes](docs/notes.md) - this can help with troubleshooting
 
 ----
 
 ## Installation
 
 Minimal PHP version: **8.0**
 
-Current framework version: **1.0.5**
+Current framework version: **1.1.0**
 ```shell
 composer require spaf/simputils "^1"
 ```
@@ -75,6 +141,8 @@ Just a few tini-tiny examples of very condensed functionality :)
 1. [Properties](#Properties)
 2. [Date Times](#Date-Times)
 3. [Advanced PHP Info Object](#Advanced-PHP-Info-Object)
+4. [IPv4 model](#IPv4-model)
+5. [Path-alike Box-array](#Path-alike-Box-array)
 
 ### Properties
 
@@ -496,6 +564,77 @@ You can access top-level fields (those that directly on the object):
    }
    ```
 
+### IPv4 model
+
+Simple example:
+```php
+
+$ic = PHP::init([
+	'l10n' => 'AT',
+]);
+
+/**
+ * @property ?string $name
+ * @property ?IPv4 $my_ip
+ */
+class Totoro extends SimpleObject {
+
+	#[Property]
+	protected ?string $_name = null;
+
+	#[Property]
+	protected ?IPv4 $_my_ip = null;
+
+}
+
+$t = new Totoro;
+
+$t->name = 'Totoro';
+$t->my_ip = '127.0.0.1/16';
+$t->my_ip->output_with_mask = false;
+
+pr("I am {$t->name} and my address is {$t->my_ip} (and ip-mask is {$t->my_ip->mask})");
+
+```
+
+The output would be:
+```
+I am Totoro and my address is 127.0.0.1 (and ip-mask is 255.255.0.0)
+```
+
+### Path-alike Box-array
+
+This is a new feature for `Box` model/
+
+```php
+$b = new Box(['TEST', 'PATH', 'alike', 'box']);
+
+pr("{$b}"); // In this case JSON
+
+$b->joined_to_str = true;
+
+pr("{$b}");
+
+$b->separator = '/';
+
+pr("{$b}");
+
+$b->separator = ' ## ';
+
+pr("{$b}");
+
+```
+
+The output would be:
+```
+
+["TEST","PATH","alike","box"]
+TEST, PATH, alike, box
+TEST/PATH/alike/box
+TEST ## PATH ## alike ## box
+
+```
+
 ## Additional benefits
 1. All the versions are wrapped into `Version` class (out of the box version comparison, etc.)
 2. The object is created once, and can be accessed through `PHP::info()`

docs/images/Structure Scheme.drawio

@@ -1 +1 @@
-<mxfile host="Electron" modified="2022-04-17T09:39:41.523Z" agent="5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) draw.io/13.7.9 Chrome/85.0.4183.121 Electron/10.1.3 Safari/537.36" etag="XJoDbeHt9m335FpTdAOn" version="13.7.9" type="device" pages="3"><diagram id="SNXWtAcKgRUHDZNeWAuU" name="Overview groups">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</diagram><diagram id="xJXirZtkqsMOn-NrQMpA" name="Usage sequence">5Vnbcts2EP0azbQPzlCkLtSjLr5MmtZuHCdNXjoQuSIRgwQHXFpSv76ACN4VWVIs2prIHpk4uJl79iwWQMeaBqtrQSL/T+4C65iGu+pYs45pdoe2Lf8oZJ0itmGmgCeoqxsVwD39DzRoaDShLsSVhsg5QxpVQYeHIThYwYgQfFlttuCsOmtEPGgA9w5hTfQLddHXb2EOC/wGqOdnM3cHo7QmIFlj/SaxT1y+LEHWZceaCs4xfQpWU2DKeJldHj5++zz1L65Gfwfu7fvLf7/449FFOtjVIV3yVxAQ4tFD4yjoz28sozu0HPD+sFfB7Vp3MZ4IS7S9OuaABFHHmjA51UT7g4Y8BWlj4DqzsOBJ6IKapSurlz5FuI+Io2qX0qck5mPAdPWCMjbljItNX8slYC8cicco+COUagaODfOFqnkEdHzdfU9LaIs9gUBYlfxAW+YaeAAo1rJJVpuRrL3cysrLwmfyNn7JX3oaI9pNvXzoggr5oNnYzsz7x9Ug+us6QYvPLj6uP38Lva8XVsPO4ErH1kUu0OceDwm7LNBJwYQhS0WbD5xH2oDfAXGtVUoS5FV2pFXF+p9y4asa7F0/K85WevC0tNalw2iJeSIc2PHu2qZIhAf4vPcqw+wkWQAjSJ+qEeEAxh5iELfz7yo8mQYjc2DbtHKPchJHtpgyEsfbRLOTcKP0v2sHeSGRLfrqZ6vINh/Vg4dYwtOPxGVURkJDEJroVsRotShGWSyxe4A+zXPSJ4TuWK2lsuhSEvDQTcErquxwCglnS31Jwruk/moSnpOYOu8iP5J63ah4LuST1qxGMmCRhM5vv2ewnGBeNH1W3uX3+kl510XpktjP+7ai0P45KLTXyG1m8ASMR9Jwde3K3C5Sj0nAxg6qMDhR1qAyj/ygnOWOxxQpD2UTVFrNa8eMegqdc0QeVHniCTJJ0zTPbBVZrDacI6lRTE6IHikHTkVez66R1+TO2kJd/1SZTr/BUwhLCcwIwicagJLcKVLOtnLJ3OlfLZccnNNa9cIL0XDPhaj/ygvR7FPHGstfjDN/30np8PTZ4r45YVtpoPkWFxn7nKTVfho42lN9w1dW356qG7WUxLWVt5nGG5RUdnJYOZT6Qb62YLDSLl32bkftwKlTtXhj9zvafA4297NOWjJmf0citbcv6xnuOA2x4HLQq3LZtWscpeLUvcoHg7WB6vlKY6BUvY2BNnznr318dtLtNvi+E7AAQeaS7jrz0tNxF68hD6G2qGmokWDXc/iAuu4mQG+TbjVot7LLajA8aKrV3uJg5qnyyG5zS3UbqX0MYb8yT2+OpuaOqpmlFMFSm72yAJVoU/gdQUlFuEFMw8rJzG5Ujjt0PMuwaw6qbPeMI8NufaC2o+6g4SQPsbpLk/3ijvLN2umXAIcHAWzE9cMjsHYCQHoEc6D6a9sZw+hNj1j8948Kpr2d3+dSrbofvFxYGDYYn1GRpsLJTupDjtspNypOYdCF/MqvQW6AbY7aDCe9DzFgRWOMz81Rrq6OClfHnxed0FFksbivTiNJcetvXf4P</diagram><diagram name="Static classes relations with models" id="hmaTbUUPjcIly86xupPC">7Vzfe5o6GP5rvOwefguXq61tN7u6uZ6znZs9EQJkReJCrLq//oAEAaEu3boARb0o+UhC877vl3zJx+NAHS02VwQs/VvswGCgSM5moF4MFEUxZD3+k1i2qcWUlNTgEeSkJjk3zNBPyIwSs66QA6NSRYpxQNGybLRxGEKblmyAELwuV3NxUH7qEniwYpjZIKha/0UO9dkolGFuv4bI87Mny4aV3lmArDIbSeQDB68LJvVyoI4IxjS9WmxGMEjAy3C580fvXHM6fftes4fQBfAxHJ2lnY2f02Q/BAJDytv1fQTJ3fx7AqkiBWAe07preR6DD0GYdnn8sdp+kPv/M6LbDFiCV6EDkw7kgXq+9hGFsyWwk7vrWEqxzaeLgN12URCMcIDJrq3q6sk3tkeU4AdYuGPsPkkLHNKCPf3E9lgnFKAQJnYpLnNiwzB8hITCTUEZbHhXEC8gJdu4Crt7NjQY70z4cqaDdUFGzOQXFKQxG2DC9fZd5+TEFwzSrFigq14Z9PrbGZ4Y3odPhq2T+W10G9hnmTJzVqATq58VMaE+9nAIgsvcep7zlsCX15lgvGRsfYeUbpkrgxXFZS5h6LxNHDMu2gGIImSnxjEKsioprZm/yVU6JUkbWVadAMZjRvTziI3witjwWD02j1FAPHisQzYxJEAe1QmBAaDosTzNPIP0pxz0AlDA4516r73TkMreqbXPOdVGnHOD6JfC9dekqzc6K11sWM+7wjYr8Dp0nZvyu/pLO7TB6dCKKI/mk4XWHVnEw/1SLBRaJcW82a7UFzmZrZKTfpJTt+VktUpOxklOnZaTKjUdvn7mCV6NU/Da8q3lsDsTQScdesi7PuitWh/M7siiV+sDt5y0VsnJOsmp23JSGw43xjOecGN4CjdKZ2Uiw42nmLtN8isc3Jm95u4wC9HCc065mSxEf0JFi3fv166DTlnuji56tbhz66ldR1OyctJTp/WkiTqb4tRThxJ0Jz3VzU/tysTIp8xet/WkiTpqe2pLNL2e8uyIrF7viA53s0YrdrMzSjioK7w32GLqogdIbf9v83i4s1XaweM2onDBQ6XcBSrFsWc2ejBx7E2+RxCsGCvJu3X3IaKVhfpP6HIANF27li7bhHP3b9Kg/fo1uH1y8Q9p4MNcqQUdfkYL+GpBr0vfCkbdrEX9JqSQxLbXi3zNrCMYeasW+SkkCDuvFvfm55nsPZeaeeY/HL7euUatiZIEK16vIB/v/4QjLizSqS6xjTOgVbWPSH8IMBonQK0QcIXoJ7jETZMQY0rv4v4RTcDSd2dK+6JV2tzJIjnTGw+R1Gpgeo43TfMljIC6UxLBBFRj1Km/vAndxp1GGAlm82FTNVydUWA/TFCPaBg2Phlp1eh1R8O4VzQ0vnnTqqHsTYjoCIcu8l6UB9d1FbuWB8eYG7ohEndL5FLwY/Juu/Uupa+rh4t/dOdenWw+7sdQUD8UfibX3FIsMn6txV+pYN3aRKWQhOPv5kOfJ5nfSlQe85+Xy1OyplOMQlpQri4fKFc9UGQ6JNYsF2W1J9X6RU/pmCs97eS9H9ET2YH8JzjS6vkPmaiX/wM=</diagram></mxfile>
+<mxfile host="Electron" modified="2022-06-17T11:58:06.376Z" agent="5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) draw.io/13.7.9 Chrome/85.0.4183.121 Electron/10.1.3 Safari/537.36" etag="5GHBrzVI71q24DNd1lVw" version="13.7.9" type="device" pages="3"><diagram id="SNXWtAcKgRUHDZNeWAuU" name="Overview groups">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</diagram><diagram id="xJXirZtkqsMOn-NrQMpA" name="Usage sequence">5Vnbcts2EP0azbQPzlCkLtSjLr5MmtZuHCdNXjoQuSIRgwQHXFpSv76ACN4VWVIs2prIHpk4uJl79iwWQMeaBqtrQSL/T+4C65iGu+pYs45pdoe2Lf8oZJ0itmGmgCeoqxsVwD39DzRoaDShLsSVhsg5QxpVQYeHIThYwYgQfFlttuCsOmtEPGgA9w5hTfQLddHXb2EOC/wGqOdnM3cHo7QmIFlj/SaxT1y+LEHWZceaCs4xfQpWU2DKeJldHj5++zz1L65Gfwfu7fvLf7/449FFOtjVIV3yVxAQ4tFD4yjoz28sozu0HPD+sFfB7Vp3MZ4IS7S9OuaABFHHmjA51UT7g4Y8BWlj4DqzsOBJ6IKapSurlz5FuI+Io2qX0qck5mPAdPWCMjbljItNX8slYC8cicco+COUagaODfOFqnkEdHzdfU9LaIs9gUBYlfxAW+YaeAAo1rJJVpuRrL3cysrLwmfyNn7JX3oaI9pNvXzoggr5oNnYzsz7x9Ug+us6QYvPLj6uP38Lva8XVsPO4ErH1kUu0OceDwm7LNBJwYQhS0WbD5xH2oDfAXGtVUoS5FV2pFXF+p9y4asa7F0/K85WevC0tNalw2iJeSIc2PHu2qZIhAf4vPcqw+wkWQAjSJ+qEeEAxh5iELfz7yo8mQYjc2DbtHKPchJHtpgyEsfbRLOTcKP0v2sHeSGRLfrqZ6vINh/Vg4dYwtOPxGVURkJDEJroVsRotShGWSyxe4A+zXPSJ4TuWK2lsuhSEvDQTcErquxwCglnS31Jwruk/moSnpOYOu8iP5J63ah4LuST1qxGMmCRhM5vv2ewnGBeNH1W3uX3+kl510XpktjP+7ai0P45KLTXyG1m8ASMR9Jwde3K3C5Sj0nAxg6qMDhR1qAyj/ygnOWOxxQpD2UTVFrNa8eMegqdc0QeVHniCTJJ0zTPbBVZrDacI6lRTE6IHikHTkVez66R1+TO2kJd/1SZTr/BUwhLCcwIwicagJLcKVLOtnLJ3OlfLZccnNNa9cIL0XDPhaj/ygvR7FPHGstfjDN/30np8PTZ4r45YVtpoPkWFxn7nKTVfho42lN9w1dW356qG7WUxLWVt5nGG5RUdnJYOZT6Qb62YLDSLl32bkftwKlTtXhj9zvafA4297NOWjJmf0citbcv6xnuOA2x4HLQq3LZtWscpeLUvcoHg7WB6vlKY6BUvY2BNnznr318dtLtNvi+E7AAQeaS7jrz0tNxF68hD6G2qGmokWDXc/iAuu4mQG+TbjVot7LLajA8aKrV3uJg5qnyyG5zS3UbqX0MYb8yT2+OpuaOqpmlFMFSm72yAJVoU/gdQUlFuEFMw8rJzG5Ujjt0PMuwaw6qbPeMI8NufaC2o+6g4SQPsbpLk/3ijvLN2umXAIcHAWzE9cMjsHYCQHoEc6D6a9sZw+hNj1j8948Kpr2d3+dSrbofvFxYGDYYn1GRpsLJTupDjtspNypOYdCF/MqvQW6AbY7aDCe9DzFgRWOMz81Rrq6OClfHnxed0FFksbivTiNJcetvXf4P</diagram><diagram name="Static classes relations with models" id="hmaTbUUPjcIly86xupPC">7Vzfe5o6GP5rvOwefguXq61tN7u6uZ6znZs9EQJkReJCrLq//oAEAaEu3boARb0o+UhC877vl3zJx+NAHS02VwQs/VvswGCgSM5moF4MFEUxZD3+k1i2qcWUlNTgEeSkJjk3zNBPyIwSs66QA6NSRYpxQNGybLRxGEKblmyAELwuV3NxUH7qEniwYpjZIKha/0UO9dkolGFuv4bI87Mny4aV3lmArDIbSeQDB68LJvVyoI4IxjS9WmxGMEjAy3C580fvXHM6fftes4fQBfAxHJ2lnY2f02Q/BAJDytv1fQTJ3fx7AqkiBWAe07preR6DD0GYdnn8sdp+kPv/M6LbDFiCV6EDkw7kgXq+9hGFsyWwk7vrWEqxzaeLgN12URCMcIDJrq3q6sk3tkeU4AdYuGPsPkkLHNKCPf3E9lgnFKAQJnYpLnNiwzB8hITCTUEZbHhXEC8gJdu4Crt7NjQY70z4cqaDdUFGzOQXFKQxG2DC9fZd5+TEFwzSrFigq14Z9PrbGZ4Y3odPhq2T+W10G9hnmTJzVqATq58VMaE+9nAIgsvcep7zlsCX15lgvGRsfYeUbpkrgxXFZS5h6LxNHDMu2gGIImSnxjEKsioprZm/yVU6JUkbWVadAMZjRvTziI3witjwWD02j1FAPHisQzYxJEAe1QmBAaDosTzNPIP0pxz0AlDA4516r73TkMreqbXPOdVGnHOD6JfC9dekqzc6K11sWM+7wjYr8Dp0nZvyu/pLO7TB6dCKKI/mk4XWHVnEw/1SLBRaJcW82a7UFzmZrZKTfpJTt+VktUpOxklOnZaTKjUdvn7mCV6NU/Da8q3lsDsTQScdesi7PuitWh/M7siiV+sDt5y0VsnJOsmp23JSGw43xjOecGN4CjdKZ2Uiw42nmLtN8isc3Jm95u4wC9HCc065mSxEf0JFi3fv166DTlnuji56tbhz66ldR1OyctJTp/WkiTqb4tRThxJ0Jz3VzU/tysTIp8xet/WkiTpqe2pLNL2e8uyIrF7viA53s0YrdrMzSjioK7w32GLqogdIbf9v83i4s1XaweM2onDBQ6XcBSrFsWc2ejBx7E2+RxCsGCvJu3X3IaKVhfpP6HIANF27li7bhHP3b9Kg/fo1uH1y8Q9p4MNcqQUdfkYL+GpBr0vfCkbdrEX9JqSQxLbXi3zNrCMYeasW+SkkCDuvFvfm55nsPZeaeeY/HL7euUatiZIEK16vIB/v/4QjLizSqS6xjTOgVbWPSH8IMBonQK0QcIXoJ7jETZMQY0rv4v4RTcDSd2dK+6JV2tzJIjnTGw+R1Gpgeo43TfMljIC6UxLBBFRj1Km/vAndxp1GGAlm82FTNVydUWA/TFCPaBg2Phlp1eh1R8O4VzQ0vnnTqqHsTYjoCIcu8l6UB9d1FbuWB8eYG7ohEndL5FLwY/Juu/Uupa+rh4t/dOdenWw+7sdQUD8UfibX3FIsMn6txV+pYN3aRKWQhOPv5kOfJ5nfSlQe85+Xy1OyplOMQlpQri4fKFc9UGQ6JNYsF2W1J9X6RU/pmCs97eS9H9ET2YH8JzjS6vkPmaiX/wM=</diagram></mxfile>