create-berna-stencil 1.0.52 → 1.0.53

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (168) hide show
  1. package/.eleventy.js +1 -1
  2. package/docs/Assistant CLI.md +59 -1
  3. package/docs/Backend.md +210 -1
  4. package/docs/Styling with SCSS.md +53 -53
  5. package/package.json +58 -58
  6. package/src/backend/_core/vendor/composer/autoload_static.php +10 -10
  7. package/src/backend/_core/vendor/composer/installed.json +6 -6
  8. package/src/backend/_core/vendor/composer/installed.php +2 -2
  9. package/src/backend/_core/vendor/graham-campbell/result-type/.gitattributes +9 -0
  10. package/src/backend/_core/vendor/graham-campbell/result-type/.github/CODE_OF_CONDUCT.md +132 -0
  11. package/src/backend/_core/vendor/graham-campbell/result-type/.github/CONTRIBUTING.md +31 -0
  12. package/src/backend/_core/vendor/graham-campbell/result-type/.github/FUNDING.yml +2 -0
  13. package/src/backend/_core/vendor/graham-campbell/result-type/.github/SECURITY.md +14 -0
  14. package/src/backend/_core/vendor/graham-campbell/result-type/.github/workflows/stale.yml +11 -0
  15. package/src/backend/_core/vendor/graham-campbell/result-type/.github/workflows/tests.yml +40 -0
  16. package/src/backend/_core/vendor/graham-campbell/result-type/CHANGELOG.md +53 -0
  17. package/src/backend/_core/vendor/graham-campbell/result-type/LICENSE +21 -21
  18. package/src/backend/_core/vendor/graham-campbell/result-type/README.md +42 -0
  19. package/src/backend/_core/vendor/graham-campbell/result-type/composer.json +33 -33
  20. package/src/backend/_core/vendor/graham-campbell/result-type/phpunit.xml.dist +13 -0
  21. package/src/backend/_core/vendor/graham-campbell/result-type/src/Error.php +121 -121
  22. package/src/backend/_core/vendor/graham-campbell/result-type/src/Result.php +69 -69
  23. package/src/backend/_core/vendor/graham-campbell/result-type/src/Success.php +120 -120
  24. package/src/backend/_core/vendor/graham-campbell/result-type/tests/ResultTest.php +95 -0
  25. package/src/backend/_core/vendor/phpoption/phpoption/.gitattributes +13 -0
  26. package/src/backend/_core/vendor/phpoption/phpoption/.github/CODE_OF_CONDUCT.md +132 -0
  27. package/src/backend/_core/vendor/phpoption/phpoption/.github/CONTRIBUTING.md +30 -0
  28. package/src/backend/_core/vendor/phpoption/phpoption/.github/FUNDING.yml +2 -0
  29. package/src/backend/_core/vendor/phpoption/phpoption/.github/SECURITY.md +14 -0
  30. package/src/backend/_core/vendor/phpoption/phpoption/.github/workflows/static.yml +40 -0
  31. package/src/backend/_core/vendor/phpoption/phpoption/.github/workflows/tests.yml +40 -0
  32. package/src/backend/_core/vendor/phpoption/phpoption/LICENSE +200 -200
  33. package/src/backend/_core/vendor/phpoption/phpoption/Makefile +17 -0
  34. package/src/backend/_core/vendor/phpoption/phpoption/README.md +201 -0
  35. package/src/backend/_core/vendor/phpoption/phpoption/composer.json +50 -50
  36. package/src/backend/_core/vendor/phpoption/phpoption/phpstan-baseline.neon +44 -0
  37. package/src/backend/_core/vendor/phpoption/phpoption/phpstan.neon.dist +7 -0
  38. package/src/backend/_core/vendor/phpoption/phpoption/phpunit.xml.dist +13 -0
  39. package/src/backend/_core/vendor/phpoption/phpoption/src/PhpOption/LazyOption.php +175 -175
  40. package/src/backend/_core/vendor/phpoption/phpoption/src/PhpOption/None.php +136 -136
  41. package/src/backend/_core/vendor/phpoption/phpoption/src/PhpOption/Option.php +434 -434
  42. package/src/backend/_core/vendor/phpoption/phpoption/src/PhpOption/Some.php +169 -169
  43. package/src/backend/_core/vendor/phpoption/phpoption/tests/PhpOption/Tests/EnsureTest.php +72 -0
  44. package/src/backend/_core/vendor/phpoption/phpoption/tests/PhpOption/Tests/LazyOptionTest.php +357 -0
  45. package/src/backend/_core/vendor/phpoption/phpoption/tests/PhpOption/Tests/NoneTest.php +153 -0
  46. package/src/backend/_core/vendor/phpoption/phpoption/tests/PhpOption/Tests/OptionTest.php +166 -0
  47. package/src/backend/_core/vendor/phpoption/phpoption/tests/PhpOption/Tests/SomeTest.php +194 -0
  48. package/src/backend/_core/vendor/phpoption/phpoption/tests/bootstrap.php +8 -0
  49. package/src/backend/_core/vendor/phpoption/phpoption/vendor-bin/phpstan/composer.json +8 -0
  50. package/src/backend/_core/vendor/symfony/polyfill-ctype/Ctype.php +232 -232
  51. package/src/backend/_core/vendor/symfony/polyfill-ctype/LICENSE +19 -19
  52. package/src/backend/_core/vendor/symfony/polyfill-ctype/README.md +12 -12
  53. package/src/backend/_core/vendor/symfony/polyfill-ctype/bootstrap.php +50 -50
  54. package/src/backend/_core/vendor/symfony/polyfill-ctype/bootstrap80.php +46 -46
  55. package/src/backend/_core/vendor/symfony/polyfill-ctype/composer.json +38 -38
  56. package/src/backend/_core/vendor/symfony/polyfill-mbstring/LICENSE +19 -19
  57. package/src/backend/_core/vendor/symfony/polyfill-mbstring/Mbstring.php +1077 -1077
  58. package/src/backend/_core/vendor/symfony/polyfill-mbstring/README.md +13 -13
  59. package/src/backend/_core/vendor/symfony/polyfill-mbstring/Resources/unidata/caseFolding.php +119 -119
  60. package/src/backend/_core/vendor/symfony/polyfill-mbstring/Resources/unidata/lowerCase.php +1397 -1397
  61. package/src/backend/_core/vendor/symfony/polyfill-mbstring/Resources/unidata/titleCaseRegexp.php +5 -5
  62. package/src/backend/_core/vendor/symfony/polyfill-mbstring/Resources/unidata/upperCase.php +1489 -1489
  63. package/src/backend/_core/vendor/symfony/polyfill-mbstring/bootstrap.php +171 -171
  64. package/src/backend/_core/vendor/symfony/polyfill-mbstring/bootstrap80.php +167 -167
  65. package/src/backend/_core/vendor/symfony/polyfill-mbstring/composer.json +39 -39
  66. package/src/backend/_core/vendor/symfony/polyfill-php80/LICENSE +19 -19
  67. package/src/backend/_core/vendor/symfony/polyfill-php80/Php80.php +115 -115
  68. package/src/backend/_core/vendor/symfony/polyfill-php80/PhpToken.php +106 -106
  69. package/src/backend/_core/vendor/symfony/polyfill-php80/README.md +25 -25
  70. package/src/backend/_core/vendor/symfony/polyfill-php80/Resources/stubs/Attribute.php +31 -31
  71. package/src/backend/_core/vendor/symfony/polyfill-php80/Resources/stubs/PhpToken.php +16 -16
  72. package/src/backend/_core/vendor/symfony/polyfill-php80/Resources/stubs/Stringable.php +20 -20
  73. package/src/backend/_core/vendor/symfony/polyfill-php80/Resources/stubs/UnhandledMatchError.php +16 -16
  74. package/src/backend/_core/vendor/symfony/polyfill-php80/Resources/stubs/ValueError.php +16 -16
  75. package/src/backend/_core/vendor/symfony/polyfill-php80/bootstrap.php +42 -42
  76. package/src/backend/_core/vendor/symfony/polyfill-php80/composer.json +37 -37
  77. package/src/backend/_core/vendor/vlucas/phpdotenv/.editorconfig +15 -0
  78. package/src/backend/_core/vendor/vlucas/phpdotenv/.gitattributes +15 -0
  79. package/src/backend/_core/vendor/vlucas/phpdotenv/.github/CODE_OF_CONDUCT.md +132 -0
  80. package/src/backend/_core/vendor/vlucas/phpdotenv/.github/CONTRIBUTING.md +30 -0
  81. package/src/backend/_core/vendor/vlucas/phpdotenv/.github/FUNDING.yml +2 -0
  82. package/src/backend/_core/vendor/vlucas/phpdotenv/.github/SECURITY.md +14 -0
  83. package/src/backend/_core/vendor/vlucas/phpdotenv/.github/workflows/static.yml +40 -0
  84. package/src/backend/_core/vendor/vlucas/phpdotenv/.github/workflows/tests.yml +70 -0
  85. package/src/backend/_core/vendor/vlucas/phpdotenv/LICENSE +30 -30
  86. package/src/backend/_core/vendor/vlucas/phpdotenv/Makefile +17 -0
  87. package/src/backend/_core/vendor/vlucas/phpdotenv/README.md +370 -0
  88. package/src/backend/_core/vendor/vlucas/phpdotenv/UPGRADING.md +196 -0
  89. package/src/backend/_core/vendor/vlucas/phpdotenv/composer.json +60 -60
  90. package/src/backend/_core/vendor/vlucas/phpdotenv/phpstan-baseline.neon +157 -0
  91. package/src/backend/_core/vendor/vlucas/phpdotenv/phpstan.neon.dist +7 -0
  92. package/src/backend/_core/vendor/vlucas/phpdotenv/phpunit.xml.dist +13 -0
  93. package/src/backend/_core/vendor/vlucas/phpdotenv/src/Dotenv.php +267 -267
  94. package/src/backend/_core/vendor/vlucas/phpdotenv/src/Exception/ExceptionInterface.php +12 -12
  95. package/src/backend/_core/vendor/vlucas/phpdotenv/src/Exception/InvalidEncodingException.php +12 -12
  96. package/src/backend/_core/vendor/vlucas/phpdotenv/src/Exception/InvalidFileException.php +12 -12
  97. package/src/backend/_core/vendor/vlucas/phpdotenv/src/Exception/InvalidPathException.php +12 -12
  98. package/src/backend/_core/vendor/vlucas/phpdotenv/src/Exception/ValidationException.php +12 -12
  99. package/src/backend/_core/vendor/vlucas/phpdotenv/src/Loader/Loader.php +48 -48
  100. package/src/backend/_core/vendor/vlucas/phpdotenv/src/Loader/LoaderInterface.php +20 -20
  101. package/src/backend/_core/vendor/vlucas/phpdotenv/src/Loader/Resolver.php +65 -65
  102. package/src/backend/_core/vendor/vlucas/phpdotenv/src/Parser/Entry.php +59 -59
  103. package/src/backend/_core/vendor/vlucas/phpdotenv/src/Parser/EntryParser.php +299 -299
  104. package/src/backend/_core/vendor/vlucas/phpdotenv/src/Parser/Lexer.php +58 -58
  105. package/src/backend/_core/vendor/vlucas/phpdotenv/src/Parser/Lines.php +127 -127
  106. package/src/backend/_core/vendor/vlucas/phpdotenv/src/Parser/Parser.php +53 -53
  107. package/src/backend/_core/vendor/vlucas/phpdotenv/src/Parser/ParserInterface.php +19 -19
  108. package/src/backend/_core/vendor/vlucas/phpdotenv/src/Parser/Value.php +88 -88
  109. package/src/backend/_core/vendor/vlucas/phpdotenv/src/Repository/Adapter/AdapterInterface.php +15 -15
  110. package/src/backend/_core/vendor/vlucas/phpdotenv/src/Repository/Adapter/ApacheAdapter.php +89 -89
  111. package/src/backend/_core/vendor/vlucas/phpdotenv/src/Repository/Adapter/ArrayAdapter.php +80 -80
  112. package/src/backend/_core/vendor/vlucas/phpdotenv/src/Repository/Adapter/EnvConstAdapter.php +88 -88
  113. package/src/backend/_core/vendor/vlucas/phpdotenv/src/Repository/Adapter/GuardedWriter.php +85 -85
  114. package/src/backend/_core/vendor/vlucas/phpdotenv/src/Repository/Adapter/ImmutableWriter.php +110 -110
  115. package/src/backend/_core/vendor/vlucas/phpdotenv/src/Repository/Adapter/MultiReader.php +48 -48
  116. package/src/backend/_core/vendor/vlucas/phpdotenv/src/Repository/Adapter/MultiWriter.php +64 -64
  117. package/src/backend/_core/vendor/vlucas/phpdotenv/src/Repository/Adapter/PutenvAdapter.php +91 -91
  118. package/src/backend/_core/vendor/vlucas/phpdotenv/src/Repository/Adapter/ReaderInterface.php +17 -17
  119. package/src/backend/_core/vendor/vlucas/phpdotenv/src/Repository/Adapter/ReplacingWriter.php +104 -104
  120. package/src/backend/_core/vendor/vlucas/phpdotenv/src/Repository/Adapter/ServerConstAdapter.php +88 -88
  121. package/src/backend/_core/vendor/vlucas/phpdotenv/src/Repository/Adapter/WriterInterface.php +27 -27
  122. package/src/backend/_core/vendor/vlucas/phpdotenv/src/Repository/AdapterRepository.php +107 -107
  123. package/src/backend/_core/vendor/vlucas/phpdotenv/src/Repository/RepositoryBuilder.php +272 -272
  124. package/src/backend/_core/vendor/vlucas/phpdotenv/src/Repository/RepositoryInterface.php +51 -51
  125. package/src/backend/_core/vendor/vlucas/phpdotenv/src/Store/File/Paths.php +44 -44
  126. package/src/backend/_core/vendor/vlucas/phpdotenv/src/Store/File/Reader.php +81 -81
  127. package/src/backend/_core/vendor/vlucas/phpdotenv/src/Store/FileStore.php +72 -72
  128. package/src/backend/_core/vendor/vlucas/phpdotenv/src/Store/StoreBuilder.php +141 -141
  129. package/src/backend/_core/vendor/vlucas/phpdotenv/src/Store/StoreInterface.php +17 -17
  130. package/src/backend/_core/vendor/vlucas/phpdotenv/src/Store/StringStore.php +37 -37
  131. package/src/backend/_core/vendor/vlucas/phpdotenv/src/Util/Regex.php +112 -112
  132. package/src/backend/_core/vendor/vlucas/phpdotenv/src/Util/Str.php +108 -108
  133. package/src/backend/_core/vendor/vlucas/phpdotenv/src/Validator.php +207 -207
  134. package/src/backend/_core/vendor/vlucas/phpdotenv/tests/Dotenv/DotenvTest.php +387 -0
  135. package/src/backend/_core/vendor/vlucas/phpdotenv/tests/Dotenv/Loader/LoaderTest.php +86 -0
  136. package/src/backend/_core/vendor/vlucas/phpdotenv/tests/Dotenv/Parser/EntryParserTest.php +234 -0
  137. package/src/backend/_core/vendor/vlucas/phpdotenv/tests/Dotenv/Parser/LexerTest.php +40 -0
  138. package/src/backend/_core/vendor/vlucas/phpdotenv/tests/Dotenv/Parser/LinesTest.php +53 -0
  139. package/src/backend/_core/vendor/vlucas/phpdotenv/tests/Dotenv/Parser/ParserTest.php +98 -0
  140. package/src/backend/_core/vendor/vlucas/phpdotenv/tests/Dotenv/Repository/Adapter/ArrayAdapterTest.php +57 -0
  141. package/src/backend/_core/vendor/vlucas/phpdotenv/tests/Dotenv/Repository/Adapter/EnvConstAdapterTest.php +75 -0
  142. package/src/backend/_core/vendor/vlucas/phpdotenv/tests/Dotenv/Repository/Adapter/PutenvAdapterTest.php +52 -0
  143. package/src/backend/_core/vendor/vlucas/phpdotenv/tests/Dotenv/Repository/Adapter/ServerConstAdapterTest.php +75 -0
  144. package/src/backend/_core/vendor/vlucas/phpdotenv/tests/Dotenv/Repository/RepositoryTest.php +305 -0
  145. package/src/backend/_core/vendor/vlucas/phpdotenv/tests/Dotenv/Store/StoreTest.php +141 -0
  146. package/src/backend/_core/vendor/vlucas/phpdotenv/tests/Dotenv/ValidatorTest.php +479 -0
  147. package/src/backend/_core/vendor/vlucas/phpdotenv/tests/fixtures/env/.env +5 -0
  148. package/src/backend/_core/vendor/vlucas/phpdotenv/tests/fixtures/env/assertions.env +18 -0
  149. package/src/backend/_core/vendor/vlucas/phpdotenv/tests/fixtures/env/booleans.env +33 -0
  150. package/src/backend/_core/vendor/vlucas/phpdotenv/tests/fixtures/env/commented.env +15 -0
  151. package/src/backend/_core/vendor/vlucas/phpdotenv/tests/fixtures/env/empty.env +1 -0
  152. package/src/backend/_core/vendor/vlucas/phpdotenv/tests/fixtures/env/example.env +1 -0
  153. package/src/backend/_core/vendor/vlucas/phpdotenv/tests/fixtures/env/exported.env +7 -0
  154. package/src/backend/_core/vendor/vlucas/phpdotenv/tests/fixtures/env/immutable.env +1 -0
  155. package/src/backend/_core/vendor/vlucas/phpdotenv/tests/fixtures/env/integers.env +17 -0
  156. package/src/backend/_core/vendor/vlucas/phpdotenv/tests/fixtures/env/large.env +2 -0
  157. package/src/backend/_core/vendor/vlucas/phpdotenv/tests/fixtures/env/multibyte.env +3 -0
  158. package/src/backend/_core/vendor/vlucas/phpdotenv/tests/fixtures/env/multiline.env +14 -0
  159. package/src/backend/_core/vendor/vlucas/phpdotenv/tests/fixtures/env/multiple.env +4 -0
  160. package/src/backend/_core/vendor/vlucas/phpdotenv/tests/fixtures/env/mutable.env +1 -0
  161. package/src/backend/_core/vendor/vlucas/phpdotenv/tests/fixtures/env/nested.env +15 -0
  162. package/src/backend/_core/vendor/vlucas/phpdotenv/tests/fixtures/env/quoted.env +11 -0
  163. package/src/backend/_core/vendor/vlucas/phpdotenv/tests/fixtures/env/specialchars.env +8 -0
  164. package/src/backend/_core/vendor/vlucas/phpdotenv/tests/fixtures/env/unicodevarnames.env +2 -0
  165. package/src/backend/_core/vendor/vlucas/phpdotenv/tests/fixtures/env/utf8-with-bom-encoding.env +3 -0
  166. package/src/backend/_core/vendor/vlucas/phpdotenv/tests/fixtures/env/windows.env +1 -0
  167. package/src/backend/_core/vendor/vlucas/phpdotenv/vendor-bin/phpstan/composer.json +15 -0
  168. package/src/frontend/data/site.json +43 -43
@@ -1,17 +1,17 @@
1
- <?php
2
-
3
- declare(strict_types=1);
4
-
5
- namespace Dotenv\Store;
6
-
7
- interface StoreInterface
8
- {
9
- /**
10
- * Read the content of the environment file(s).
11
- *
12
- * @throws \Dotenv\Exception\InvalidEncodingException|\Dotenv\Exception\InvalidPathException
13
- *
14
- * @return string
15
- */
16
- public function read();
17
- }
1
+ <?php
2
+
3
+ declare(strict_types=1);
4
+
5
+ namespace Dotenv\Store;
6
+
7
+ interface StoreInterface
8
+ {
9
+ /**
10
+ * Read the content of the environment file(s).
11
+ *
12
+ * @throws \Dotenv\Exception\InvalidEncodingException|\Dotenv\Exception\InvalidPathException
13
+ *
14
+ * @return string
15
+ */
16
+ public function read();
17
+ }
@@ -1,37 +1,37 @@
1
- <?php
2
-
3
- declare(strict_types=1);
4
-
5
- namespace Dotenv\Store;
6
-
7
- final class StringStore implements StoreInterface
8
- {
9
- /**
10
- * The file content.
11
- *
12
- * @var string
13
- */
14
- private $content;
15
-
16
- /**
17
- * Create a new string store instance.
18
- *
19
- * @param string $content
20
- *
21
- * @return void
22
- */
23
- public function __construct(string $content)
24
- {
25
- $this->content = $content;
26
- }
27
-
28
- /**
29
- * Read the content of the environment file(s).
30
- *
31
- * @return string
32
- */
33
- public function read()
34
- {
35
- return $this->content;
36
- }
37
- }
1
+ <?php
2
+
3
+ declare(strict_types=1);
4
+
5
+ namespace Dotenv\Store;
6
+
7
+ final class StringStore implements StoreInterface
8
+ {
9
+ /**
10
+ * The file content.
11
+ *
12
+ * @var string
13
+ */
14
+ private $content;
15
+
16
+ /**
17
+ * Create a new string store instance.
18
+ *
19
+ * @param string $content
20
+ *
21
+ * @return void
22
+ */
23
+ public function __construct(string $content)
24
+ {
25
+ $this->content = $content;
26
+ }
27
+
28
+ /**
29
+ * Read the content of the environment file(s).
30
+ *
31
+ * @return string
32
+ */
33
+ public function read()
34
+ {
35
+ return $this->content;
36
+ }
37
+ }
@@ -1,112 +1,112 @@
1
- <?php
2
-
3
- declare(strict_types=1);
4
-
5
- namespace Dotenv\Util;
6
-
7
- use GrahamCampbell\ResultType\Error;
8
- use GrahamCampbell\ResultType\Success;
9
-
10
- /**
11
- * @internal
12
- */
13
- final class Regex
14
- {
15
- /**
16
- * This class is a singleton.
17
- *
18
- * @codeCoverageIgnore
19
- *
20
- * @return void
21
- */
22
- private function __construct()
23
- {
24
- //
25
- }
26
-
27
- /**
28
- * Perform a preg match, wrapping up the result.
29
- *
30
- * @param string $pattern
31
- * @param string $subject
32
- *
33
- * @return \GrahamCampbell\ResultType\Result<bool, string>
34
- */
35
- public static function matches(string $pattern, string $subject)
36
- {
37
- return self::pregAndWrap(static function (string $subject) use ($pattern) {
38
- return @\preg_match($pattern, $subject) === 1;
39
- }, $subject);
40
- }
41
-
42
- /**
43
- * Perform a preg match all, wrapping up the result.
44
- *
45
- * @param string $pattern
46
- * @param string $subject
47
- *
48
- * @return \GrahamCampbell\ResultType\Result<int, string>
49
- */
50
- public static function occurrences(string $pattern, string $subject)
51
- {
52
- return self::pregAndWrap(static function (string $subject) use ($pattern) {
53
- return (int) @\preg_match_all($pattern, $subject);
54
- }, $subject);
55
- }
56
-
57
- /**
58
- * Perform a preg replace callback, wrapping up the result.
59
- *
60
- * @param string $pattern
61
- * @param callable(string[]): string $callback
62
- * @param string $subject
63
- * @param int|null $limit
64
- *
65
- * @return \GrahamCampbell\ResultType\Result<string, string>
66
- */
67
- public static function replaceCallback(string $pattern, callable $callback, string $subject, ?int $limit = null)
68
- {
69
- return self::pregAndWrap(static function (string $subject) use ($pattern, $callback, $limit) {
70
- return (string) @\preg_replace_callback($pattern, $callback, $subject, $limit ?? -1);
71
- }, $subject);
72
- }
73
-
74
- /**
75
- * Perform a preg split, wrapping up the result.
76
- *
77
- * @param string $pattern
78
- * @param string $subject
79
- *
80
- * @return \GrahamCampbell\ResultType\Result<string[], string>
81
- */
82
- public static function split(string $pattern, string $subject)
83
- {
84
- return self::pregAndWrap(static function (string $subject) use ($pattern) {
85
- /** @var string[] */
86
- return (array) @\preg_split($pattern, $subject);
87
- }, $subject);
88
- }
89
-
90
- /**
91
- * Perform a preg operation, wrapping up the result.
92
- *
93
- * @template V
94
- *
95
- * @param callable(string): V $operation
96
- * @param string $subject
97
- *
98
- * @return \GrahamCampbell\ResultType\Result<V, string>
99
- */
100
- private static function pregAndWrap(callable $operation, string $subject)
101
- {
102
- $result = $operation($subject);
103
-
104
- if (\preg_last_error() !== \PREG_NO_ERROR) {
105
- /** @var \GrahamCampbell\ResultType\Result<V,string> */
106
- return Error::create(\preg_last_error_msg());
107
- }
108
-
109
- /** @var \GrahamCampbell\ResultType\Result<V,string> */
110
- return Success::create($result);
111
- }
112
- }
1
+ <?php
2
+
3
+ declare(strict_types=1);
4
+
5
+ namespace Dotenv\Util;
6
+
7
+ use GrahamCampbell\ResultType\Error;
8
+ use GrahamCampbell\ResultType\Success;
9
+
10
+ /**
11
+ * @internal
12
+ */
13
+ final class Regex
14
+ {
15
+ /**
16
+ * This class is a singleton.
17
+ *
18
+ * @codeCoverageIgnore
19
+ *
20
+ * @return void
21
+ */
22
+ private function __construct()
23
+ {
24
+ //
25
+ }
26
+
27
+ /**
28
+ * Perform a preg match, wrapping up the result.
29
+ *
30
+ * @param string $pattern
31
+ * @param string $subject
32
+ *
33
+ * @return \GrahamCampbell\ResultType\Result<bool, string>
34
+ */
35
+ public static function matches(string $pattern, string $subject)
36
+ {
37
+ return self::pregAndWrap(static function (string $subject) use ($pattern) {
38
+ return @\preg_match($pattern, $subject) === 1;
39
+ }, $subject);
40
+ }
41
+
42
+ /**
43
+ * Perform a preg match all, wrapping up the result.
44
+ *
45
+ * @param string $pattern
46
+ * @param string $subject
47
+ *
48
+ * @return \GrahamCampbell\ResultType\Result<int, string>
49
+ */
50
+ public static function occurrences(string $pattern, string $subject)
51
+ {
52
+ return self::pregAndWrap(static function (string $subject) use ($pattern) {
53
+ return (int) @\preg_match_all($pattern, $subject);
54
+ }, $subject);
55
+ }
56
+
57
+ /**
58
+ * Perform a preg replace callback, wrapping up the result.
59
+ *
60
+ * @param string $pattern
61
+ * @param callable(string[]): string $callback
62
+ * @param string $subject
63
+ * @param int|null $limit
64
+ *
65
+ * @return \GrahamCampbell\ResultType\Result<string, string>
66
+ */
67
+ public static function replaceCallback(string $pattern, callable $callback, string $subject, ?int $limit = null)
68
+ {
69
+ return self::pregAndWrap(static function (string $subject) use ($pattern, $callback, $limit) {
70
+ return (string) @\preg_replace_callback($pattern, $callback, $subject, $limit ?? -1);
71
+ }, $subject);
72
+ }
73
+
74
+ /**
75
+ * Perform a preg split, wrapping up the result.
76
+ *
77
+ * @param string $pattern
78
+ * @param string $subject
79
+ *
80
+ * @return \GrahamCampbell\ResultType\Result<string[], string>
81
+ */
82
+ public static function split(string $pattern, string $subject)
83
+ {
84
+ return self::pregAndWrap(static function (string $subject) use ($pattern) {
85
+ /** @var string[] */
86
+ return (array) @\preg_split($pattern, $subject);
87
+ }, $subject);
88
+ }
89
+
90
+ /**
91
+ * Perform a preg operation, wrapping up the result.
92
+ *
93
+ * @template V
94
+ *
95
+ * @param callable(string): V $operation
96
+ * @param string $subject
97
+ *
98
+ * @return \GrahamCampbell\ResultType\Result<V, string>
99
+ */
100
+ private static function pregAndWrap(callable $operation, string $subject)
101
+ {
102
+ $result = $operation($subject);
103
+
104
+ if (\preg_last_error() !== \PREG_NO_ERROR) {
105
+ /** @var \GrahamCampbell\ResultType\Result<V,string> */
106
+ return Error::create(\preg_last_error_msg());
107
+ }
108
+
109
+ /** @var \GrahamCampbell\ResultType\Result<V,string> */
110
+ return Success::create($result);
111
+ }
112
+ }
@@ -1,108 +1,108 @@
1
- <?php
2
-
3
- declare(strict_types=1);
4
-
5
- namespace Dotenv\Util;
6
-
7
- use GrahamCampbell\ResultType\Error;
8
- use GrahamCampbell\ResultType\Success;
9
- use PhpOption\Option;
10
-
11
- /**
12
- * @internal
13
- */
14
- final class Str
15
- {
16
- /**
17
- * This class is a singleton.
18
- *
19
- * @codeCoverageIgnore
20
- *
21
- * @return void
22
- */
23
- private function __construct()
24
- {
25
- //
26
- }
27
-
28
- /**
29
- * Convert a string to UTF-8 from the given encoding.
30
- *
31
- * @param string $input
32
- * @param string|null $encoding
33
- *
34
- * @return \GrahamCampbell\ResultType\Result<string, string>
35
- */
36
- public static function utf8(string $input, ?string $encoding = null)
37
- {
38
- if ($encoding !== null && !\in_array($encoding, \mb_list_encodings(), true)) {
39
- /** @var \GrahamCampbell\ResultType\Result<string, string> */
40
- return Error::create(
41
- \sprintf('Illegal character encoding [%s] specified.', $encoding)
42
- );
43
- }
44
-
45
- $converted = $encoding === null ?
46
- @\mb_convert_encoding($input, 'UTF-8') :
47
- @\mb_convert_encoding($input, 'UTF-8', $encoding);
48
-
49
- if (!is_string($converted)) {
50
- /** @var \GrahamCampbell\ResultType\Result<string, string> */
51
- return Error::create(
52
- \sprintf('Conversion from encoding [%s] failed.', $encoding ?? 'NULL')
53
- );
54
- }
55
-
56
- /**
57
- * this is for support UTF-8 with BOM encoding
58
- * @see https://en.wikipedia.org/wiki/Byte_order_mark
59
- * @see https://github.com/vlucas/phpdotenv/issues/500
60
- */
61
- if (\substr($converted, 0, 3) == "\xEF\xBB\xBF") {
62
- $converted = \substr($converted, 3);
63
- }
64
-
65
- /** @var \GrahamCampbell\ResultType\Result<string, string> */
66
- return Success::create($converted);
67
- }
68
-
69
- /**
70
- * Search for a given substring of the input.
71
- *
72
- * @param string $haystack
73
- * @param string $needle
74
- *
75
- * @return \PhpOption\Option<int>
76
- */
77
- public static function pos(string $haystack, string $needle)
78
- {
79
- /** @var \PhpOption\Option<int> */
80
- return Option::fromValue(\mb_strpos($haystack, $needle, 0, 'UTF-8'), false);
81
- }
82
-
83
- /**
84
- * Grab the specified substring of the input.
85
- *
86
- * @param string $input
87
- * @param int $start
88
- * @param int|null $length
89
- *
90
- * @return string
91
- */
92
- public static function substr(string $input, int $start, ?int $length = null)
93
- {
94
- return \mb_substr($input, $start, $length, 'UTF-8');
95
- }
96
-
97
- /**
98
- * Compute the length of the given string.
99
- *
100
- * @param string $input
101
- *
102
- * @return int
103
- */
104
- public static function len(string $input)
105
- {
106
- return \mb_strlen($input, 'UTF-8');
107
- }
108
- }
1
+ <?php
2
+
3
+ declare(strict_types=1);
4
+
5
+ namespace Dotenv\Util;
6
+
7
+ use GrahamCampbell\ResultType\Error;
8
+ use GrahamCampbell\ResultType\Success;
9
+ use PhpOption\Option;
10
+
11
+ /**
12
+ * @internal
13
+ */
14
+ final class Str
15
+ {
16
+ /**
17
+ * This class is a singleton.
18
+ *
19
+ * @codeCoverageIgnore
20
+ *
21
+ * @return void
22
+ */
23
+ private function __construct()
24
+ {
25
+ //
26
+ }
27
+
28
+ /**
29
+ * Convert a string to UTF-8 from the given encoding.
30
+ *
31
+ * @param string $input
32
+ * @param string|null $encoding
33
+ *
34
+ * @return \GrahamCampbell\ResultType\Result<string, string>
35
+ */
36
+ public static function utf8(string $input, ?string $encoding = null)
37
+ {
38
+ if ($encoding !== null && !\in_array($encoding, \mb_list_encodings(), true)) {
39
+ /** @var \GrahamCampbell\ResultType\Result<string, string> */
40
+ return Error::create(
41
+ \sprintf('Illegal character encoding [%s] specified.', $encoding)
42
+ );
43
+ }
44
+
45
+ $converted = $encoding === null ?
46
+ @\mb_convert_encoding($input, 'UTF-8') :
47
+ @\mb_convert_encoding($input, 'UTF-8', $encoding);
48
+
49
+ if (!is_string($converted)) {
50
+ /** @var \GrahamCampbell\ResultType\Result<string, string> */
51
+ return Error::create(
52
+ \sprintf('Conversion from encoding [%s] failed.', $encoding ?? 'NULL')
53
+ );
54
+ }
55
+
56
+ /**
57
+ * this is for support UTF-8 with BOM encoding
58
+ * @see https://en.wikipedia.org/wiki/Byte_order_mark
59
+ * @see https://github.com/vlucas/phpdotenv/issues/500
60
+ */
61
+ if (\substr($converted, 0, 3) == "\xEF\xBB\xBF") {
62
+ $converted = \substr($converted, 3);
63
+ }
64
+
65
+ /** @var \GrahamCampbell\ResultType\Result<string, string> */
66
+ return Success::create($converted);
67
+ }
68
+
69
+ /**
70
+ * Search for a given substring of the input.
71
+ *
72
+ * @param string $haystack
73
+ * @param string $needle
74
+ *
75
+ * @return \PhpOption\Option<int>
76
+ */
77
+ public static function pos(string $haystack, string $needle)
78
+ {
79
+ /** @var \PhpOption\Option<int> */
80
+ return Option::fromValue(\mb_strpos($haystack, $needle, 0, 'UTF-8'), false);
81
+ }
82
+
83
+ /**
84
+ * Grab the specified substring of the input.
85
+ *
86
+ * @param string $input
87
+ * @param int $start
88
+ * @param int|null $length
89
+ *
90
+ * @return string
91
+ */
92
+ public static function substr(string $input, int $start, ?int $length = null)
93
+ {
94
+ return \mb_substr($input, $start, $length, 'UTF-8');
95
+ }
96
+
97
+ /**
98
+ * Compute the length of the given string.
99
+ *
100
+ * @param string $input
101
+ *
102
+ * @return int
103
+ */
104
+ public static function len(string $input)
105
+ {
106
+ return \mb_strlen($input, 'UTF-8');
107
+ }
108
+ }