[main] Add more concepts

Author: crypto-scythe

CHANGELOG.md

@@ -5,6 +5,15 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [2.2.0] - 2023-04-30
+### Added
+- Concepts:
+  - ForwardedParameters
+  - LinkRelations
+  - Preferences
+  - RangeUnits
+  - TransferCodings
+
 ## [2.1.0] - 2023-04-30
 ### Added
 - More concepts:

README.md

@@ -72,6 +72,21 @@ public const MAX_AGE = 'max-age';
 public const GZIP = 'gzip';
 ```
 
+### Example for `ForwardedParameters.php`
+
+```php
+/**
+ * Forwarded parameter for
+ *
+ * The "for" parameter is used to disclose information about the client that initiated the request and
+ * subsequent proxies in a chain of proxies.
+ *
+ * @see https://webconcepts.info/specs/IETF/RFC/7239
+ * @see https://datatracker.ietf.org/doc/html/rfc7239#section-5.2
+ */
+public const FOR = 'for';
+```
+
 ### Example for `HeaderFields.php`
 ```php
 /**
@@ -89,6 +104,21 @@ public const GZIP = 'gzip';
 public const CONTENT_TYPE = 'Content-Type';
 ```
 
+### Example for `LinkRelations.php`
+
+```php
+/**
+ * Link relation canonical
+ *
+ * The target (canonical) IRI MUST identify content that is either duplicative or a superset of the content at
+ * the context (referring) IRI.
+ *
+ * @see https://webconcepts.info/specs/IETF/RFC/6596
+ * @see https://datatracker.ietf.org/doc/html/rfc6596#section-3
+ */
+public const CANONICAL = 'canonical';
+```
+
 ### Example for `MediaTypes.php`
 
 ```php
@@ -113,6 +143,37 @@ public const CONTENT_TYPE = 'Content-Type';
 public const APPLICATION_JSON = 'application/json';
 ```
 
+### Example for `Preferences.php`
+
+```php
+/**
+ * Preference wait
+ *
+ * The "wait" preference can be used to establish an upper bound on the length of time, in seconds, the client
+ * expects it will take the server to process the request once it has been received.
+ *
+ * @see https://webconcepts.info/specs/IETF/RFC/7240
+ * @see https://datatracker.ietf.org/doc/html/rfc7240#section-4.3
+ */
+public const WAIT = 'wait';
+```
+
+### Example for `RangeUnits.php`
+
+```php
+/**
+ * Range unit bytes
+ *
+ * Since representation data is transferred in payloads as a sequence of octets, a byte range is a meaningful
+ * substructure for any representation transferable over HTTP. The "bytes" range unit is defined for expressing
+ * subranges of the data's octet sequence.
+ *
+ * @see https://webconcepts.info/specs/IETF/RFC/7233
+ * @see https://datatracker.ietf.org/doc/html/rfc7233#section-2.1
+ */
+public const BYTES = 'bytes';
+```
+
 ### Example for `RequestMethods.php`
 
 ```php
@@ -150,3 +211,20 @@ public const MESSAGE_404 = 'Not Found';
 public const STATUS_NOT_FOUND = self::STATUS_404;
 public const MESSAGE_NOT_FOUND = self::MESSAGE_404;
 ```
+
+### Example for `TransferCodings.php`
+
+```php
+/**
+ * Transfer coding chunked
+ *
+ * The chunked transfer coding wraps the payload body in order to transfer it as a series of chunks, each with
+ * its own size indicator, followed by an OPTIONAL trailer containing header fields.  Chunked enables content
+ * streams of unknown size to be transferred as a sequence of length-delimited buffers, which enables the sender
+ * to retain connection persistence and the recipient to know when it has received the entire message.
+ *
+ * @see https://webconcepts.info/specs/IETF/RFC/7230
+ * @see https://datatracker.ietf.org/doc/html/rfc7230#section-4.1
+ */
+public const CHUNKED = 'chunked';
+```

bin/http_generate.php

@@ -12,10 +12,15 @@
 use CryptoScythe\Http\Generator\Renderer\AuthenticationSchemesRenderer;
 use CryptoScythe\Http\Generator\Renderer\CacheDirectivesRenderer;
 use CryptoScythe\Http\Generator\Renderer\ContentCodingsRenderer;
+use CryptoScythe\Http\Generator\Renderer\ForwardedParametersRenderer;
 use CryptoScythe\Http\Generator\Renderer\HeaderFieldsRenderer;
+use CryptoScythe\Http\Generator\Renderer\LinkRelationsRenderer;
 use CryptoScythe\Http\Generator\Renderer\MediaTypesRenderer;
+use CryptoScythe\Http\Generator\Renderer\PreferencesRenderer;
+use CryptoScythe\Http\Generator\Renderer\RangeUnitsRenderer;
 use CryptoScythe\Http\Generator\Renderer\RequestMethodsRenderer;
 use CryptoScythe\Http\Generator\Renderer\StatusCodeRenderer;
+use CryptoScythe\Http\Generator\Renderer\TransferCodingsRenderer;
 
 set_error_handler(
     function (int $severity, string $message, string $file, int $line): void {
@@ -60,18 +65,42 @@ function (int $severity, string $message, string $file, int $line): void {
             new ContentCodingsRenderer(),
             $namespace,
         ),
+        new Definition(
+            'http-forwarded-parameter.json',
+            'ForwardedParameters',
+            new ForwardedParametersRenderer(),
+            $namespace,
+        ),
         new Definition(
             'http-header.json',
             'HeaderFields',
             new HeaderFieldsRenderer(),
             $namespace,
         ),
+        new Definition(
+            'link-relation.json',
+            'LinkRelations',
+            new LinkRelationsRenderer(),
+            $namespace,
+        ),
         new Definition(
             'media-type.json',
             'MediaTypes',
             new MediaTypesRenderer(),
             $namespace,
         ),
+        new Definition(
+            'http-preference.json',
+            'Preferences',
+            new PreferencesRenderer(),
+            $namespace,
+        ),
+        new Definition(
+            'http-range-unit.json',
+            'RangeUnits',
+            new RangeUnitsRenderer(),
+            $namespace,
+        ),
         new Definition(
             'http-method.json',
             'RequestMethods',
@@ -84,6 +113,12 @@ function (int $severity, string $message, string $file, int $line): void {
             new StatusCodeRenderer(),
             $namespace,
         ),
+        new Definition(
+            'http-transfer-coding.json',
+            'TransferCodings',
+            new TransferCodingsRenderer(),
+            $namespace,
+        ),
     ];
 
     echo 'Generating classes' . PHP_EOL;

composer.json

@@ -1,6 +1,6 @@
 {
     "name": "crypto_scythe/http_generator",
-    "version": "2.1.0",
+    "version": "2.2.0",
     "description": "HTTP header fields, media types and status codes",
     "license": "MIT",
     "keywords": [

composer.lock

@@ -0,0 +1,8 @@
+<?php
+
+namespace CryptoScythe\Http\Generator\Renderer;
+
+final class ForwardedParametersRenderer extends AbstractRenderer
+{
+    protected const HEADLINE_INTRO = 'Forwarded parameter';
+}

src/Renderer/ForwardedParametersRenderer.php

@@ -0,0 +1,8 @@
+<?php
+
+namespace CryptoScythe\Http\Generator\Renderer;
+
+final class LinkRelationsRenderer extends AbstractRenderer
+{
+    protected const HEADLINE_INTRO = 'Link relation';
+}

src/Renderer/LinkRelationsRenderer.php

@@ -0,0 +1,8 @@
+<?php
+
+namespace CryptoScythe\Http\Generator\Renderer;
+
+final class PreferencesRenderer extends AbstractRenderer
+{
+    protected const HEADLINE_INTRO = 'Preference';
+}

src/Renderer/PreferencesRenderer.php

@@ -0,0 +1,8 @@
+<?php
+
+namespace CryptoScythe\Http\Generator\Renderer;
+
+final class RangeUnitsRenderer extends AbstractRenderer
+{
+    protected const HEADLINE_INTRO = 'Range unit';
+}

src/Renderer/RangeUnitsRenderer.php

@@ -0,0 +1,8 @@
+<?php
+
+namespace CryptoScythe\Http\Generator\Renderer;
+
+class TransferCodingsRenderer extends AbstractRenderer
+{
+    protected const HEADLINE_INTRO = 'Transfer coding';
+}