11 commits

Author	SHA1	Message	Date
Alexandre Gomes Gaigalas	16148e9593	Standardize and improve validation message templates ... - Remove redundant "valid" prefix: Date, DateTime, DateTimeDiff, Domain, Email, Iban, Imei, Ip, Isbn, Json, LanguageCode, LeapDate, LeapYear, Luhn, MacAddress, NfeAccessKey, Nif, Nip, Pesel, Phone, Pis, PolishIdCard, PostalCode, Roman, Slug, Tld, Url, Uuid, Version. - Remove redundant "value" suffix ArrayVal, BoolVal, Countable, FloatVal, IntVal, IterableVal, NumericVal, ScalarVal, StringVal. - Standardize "consist only of" phrasing Alnum, Alpha, Cntrl, Consonant, Digit, Graph, Lowercase, Printable, Punct, Space, Spaced, Uppercase, Vowel, Xdigit. - Improve file accessibility messages Directory, Executable, File, Image, Readable, SymbolicLink, Writable. - Improve grammar and article usage CreditCard, Extension, Mimetype, Regex, Size.	2026-02-03 19:58:55 +00:00
Henrique Moody	7c681fec66	Fix SPDX headers in all files ... I ran the `bin/console spdx --fix` with different strategies for different files. For most of the core classes, since they've been drastically rebuilt, I've run it with the `git-blame` strategy, for for the `src/Validators`, in which the API changed completely but the logic remains the same, I use the `git-log` strategy.	2026-02-03 15:23:23 +01:00
Alexandre Gomes Gaigalas	a64e33168f	Improve Url validator to be more strict ... Previously, the URL validator accepted all kinds of URLs. Combining it with other validators like `Domain` and `Ip` manually is clumbersome, since the rules are extensive and require small tweaks such as understanding bracketed IP addresses. This change makes that composition built-in. The validator still uses the FILTER_VALIDATE_URL from PHP, but now it also goes deeper and validate portions of the URL that other validators support. Changes to `Call` were made so that it can be serialized under certain circumstances (when invoking a static method call), making it more flexible. A static internal method helper for trimming the IP was added to the Url validator class and marked as internal, as it cannot be both private, serializable and accessible to the `Call` instance all at the same time. The `@internal` annotation should advise users that it's not a public API according to phpdoc conventions.	2026-02-02 00:26:40 +00:00
Alexandre Gomes Gaigalas	d9cdc118b2	Introduce REUSE compliance ... This commit introduces REUSE compliance by annotating all files with SPDX information and placing the reused licences in the LICENSES folder. We additionally removed the docheader tool which is made obsolete by this change. The main LICENSE and copyright text of the project is now not under my personal name anymore, and it belongs to "The Respect Project Contributors" instead. This change restores author names to several files, giving the appropriate attribution for contributions.	2026-01-21 06:28:11 +00:00
Henrique Moody	0a45eaf9e4	Create All rule and all prefix ... This rule behaves similarly to ``Each, but the difference is that it presents the messages in a simpler manner. This allows users to have a simpler message when validating all items in an array or iterable value. I’m also introducing the `all` prefix, making it easier for users to apply the `All` rule in combination with other rules.	2026-01-04 12:23:01 +01:00
Henrique Moody	cfeb01e89e	Bump respect/coding-standard from 4 to 5	2025-12-18 19:03:39 +01:00
Henrique Moody	d3239e878d	Change how we're writing Pest tests ... The problem with the current approach is that the "expect()" calls happen inside "tests/Pest.php". That means that when something fails, we can't easily know which exact expectation has failed. This commit will change the helper functions, and will make the tests more verbose, but event with that, the developer experience is better.	2025-12-18 14:02:33 +01:00
Henrique Moody	1915b6fff7	Use paths to identify when a rule fails ... When nested-structural validation fails, it's challenging to identify which rule failed from the main exception message. A great example is the `Issue796Test.php` file. The exception message says: host must be a string But you're left unsure whether it's the `host` key from the `mysql` key or the `postgresql` key. This commit changes that behaviour by introducing the concept of "Path." The `path` represents the path that a rule has taken, and we can use it in structural rules to identify the path of an array or object. Here's what it looks like before and after: ```diff -host must be a string +`.mysql.host` must be a string ``` Because paths are a specific concept, I added a dot (`.`) at the beginning of all paths when displaying them. I was inspired by the `jq` syntax. I also added backticks around paths to distinguish them from any other value. I didn't manage to fix a test, and I skipped it instead of fixing it because I want to make changes in how we display error messages as arrays, and it will be easier to fix it then.	2024-12-27 23:28:35 +01:00
Henrique Moody	aa633db46a	Improve format of Pest files ... I added some trailing commas to the files.	2024-12-22 06:53:36 +01:00
Dominick Johnson	243f91c3d4	Allow Min and Max to wrap chained rules ... This follows the same pattern as the `Length` rule. I've also removed the separate named and standard templates from these rules. I didn't see a good way to implement these in the new pattern, and also felt the language of the old standard template was somewhat difficult to read anyway.	2024-12-20 15:08:31 +01:00
Henrique Moody	94daa8d669	Use Pest instead of PHPT files ... Although I love PHPT files, and I've done my fair share of making it easier to write them in this library, they're very slow, and running them has become a hindrance. I've been fidgeting with the idea of using Pest for a while, and I think it's the right tool for the job. I had to create a couple of functions to make it easier to run those tests, and now they're working really alright. I migrated all the PHPT files into Pest files -- I automated most of the work with a little script using "nikic/php-parser"; this commit should contain all the previous PHPT tests as Pest tests. The previous integration tests would take sixteen seconds, and the Pest tests take less than a second.	2024-12-16 17:07:47 +01:00