Roadmap to 3.0

[henriquemoody]

I wrote a blog post with the main changes of this new version: https://dev.to/henriquemoody/what-is-new-on-respectvalidation-30-37no

---

To-dos

I'm almost there, and there are some awesome improvements coming!

Core

• Make results consistent (maybe create a Subject value object)
• Remove default constructor arguments from core classes
• Create All rule (similar to Each but creates results with subsequents)
• Turn Factory into a interface
• Refactor InterpolationRenderer (it's breaking the open-close principle)
• Fix skipped feature tests
• Invert negative rules
  • NotBlank -> Blank
  • NotEmpty -> Falsy
  • NoWhitespace -> Spaced
  • NotEmoji -> Emoji
  • NotUndef -> Undef
• Improve array messages
• Create Validator::validate() that returns an object with errors
• ? Rename Result->isValid to Result->hasPassed
• Create transformer to deal with composite rules with a single argument
• Make Simple::isValid public
• Use paths to identify when a rule fails
• Create {{placeholder|quote}}
• Create custom Stringifier, removing CallableStringifier
• Replace setName() with Named rule
• Get ignored paths for ValidationException from ValidatorDefaults
• Replace setTemplate() with Templated rule
• Create class alias for old abstract classes
• Rename mode "negative" to "inverted"
• Add second parameter to Validator::assert()
• Create "key" prefix
• Create "length" prefix
• Create "max" prefix
• Create "min" prefix
• Create "nullOr" prefix
• Create "property" prefix
• Create "undefOr" prefix
• Make ComponentException extend LogicException
• Make getMessages() return __self__
• Make setName() update names, but not IDs
• Prefix ids when working with sibling results
• Update validation engine (todo: split into different tasks)
• Use PHP Attributes to define templates

Rules

• Enable Attributes to deal with inheritance
• Allow to use certain rules as class attributes
• Rename "Consecutive" to something shorter
• Only create Max with subsequents when possible
• Only create Min with subsequents when possible
• Only create Length with subsequents when possible
• Add support to PHP 8.4
• Update DateTimeDiff to generate results with subsequents
• Tentatively created a result with subsequents in UndefOr and NullOr
• Refactor KeySet rule
• Create DateDiff rule
• Delete MinAge, MaxAge, and Age rules
• Rename NotOptional to NotUndef
• Create BetweenExclusive rule
• Create Consecutive rule
• Create LazySequence rule
• Create a new Max rule
• Create a new Min rule
• Create aliases for deprecated/removed rules
• Delete KeyValue rule
• Do not use When as a sibling
• Refactor Length rule
• Rename Nullable to NullOr
• Rename Optional to UndefOr
• Rename Max rule to LessThanOrEqual
• Rename Min rule to GreaterThanOrEqual
• Rename the "Attribute" rule to "Property"
• Split the Key rule into Key, KeyExists, and KeyOptional
• Split the Property rule into Property, PropertyExists, and PropertyOptional

Other

• Make documentation up to date with the changes
• Improve documentation for rules that are prefixes
• Write a blog post with the latest changes
• Release version 2.4 with deprecations
• Fix broken documentation links
• Rename branch master to main

Nice to have

- [ ] More integration tests for `oneOf`, `allOf` and `each` validator messages.
- [ ] Create `DateTimeParseable` or (`DateTimeLenient`) rule
- [ ] Increase code coverage to 98%
- [ ] Share credentials for @TheRespectPanda with @alganet
- [ ] Extra documentation for most common support issues
  - [ ] Message translation approaches
  - [ ] Navigating the messages tree manually
  - [ ] Using validators with custom names 
  - [ ] Expressing boolean algebra

[dmitriiPopov]

Hello, guys. When will you continue working on release 3.0?

[dmjohnsson23]

Are there any of these unfinished items you've listed that would be good for a new contributor to handle? We're using this library, and this 3.0 release looks like it will fix some of the issues we've had with it, so I could probably put some time toward a few issues to help get the release out.

[henriquemoody]

I'm sorry for be belated response, peeps!

@dmitriiPopov, I've been working a lot in the last couple of weeks. I'm hoping to release version 3.0 at the beginning of next year. I think it's looking great so far, check this out: https://github.com/Respect/Validation/blob/main/docs/02-feature-guide.md

@dmjohnsson23, at the moment it's a bit tricky, because I'm at a phase that I'm myself figuring out how I really want things to work. I got most of the groundwork done, but I'm still seeing how I really want a few rules to work out. Thank you for offering help, though!

🐼

[henriquemoody]

@dmjohnsson23, if you (or anyone) could do what I did for Length in #1485 but for Each, Min, and/or Max, that would be very helpful. I've been coding intensely in the past month, I'm gonna take a break until next year, but I will probably be able to review merge requests.

[dmjohnsson23]

I'd be happy to give it a go. I looked at the referenced commit and I don't fully understand what all the changes are doing at this point, so I'll need to spend some time figuring out the code. I don't just want to copy/paste the same changes without fully understanding the intent. Any pointers would be welcome.

[andus4n]

Replace setTemplate() with Templated rule

I'm doing a lot of stuff like this:

->allOf(v::attribute(v::stringType()->length(1, 19)->digit()->intVal())->setTemplate('This should have been valid...'))
->allOf(v::attribute(v::boolType())->setTemplate('This also should have been valid...'))

Will this still be valid in 3.0?

[henriquemoody]

@andus4n, the setTemplate() method will still be present in the Validator class, just not in every rule object/class. You don't have to worry much about it if you're just calling it from the Validator.

However, a few things will need to be replaced in your code:

1. AllOf will require at least 2 rules (ref)
2. Attribute will be called Property -- assuming you forgot to type the property name there (ref)
3. Length will change a bit (ref) and you'll be able to use it as a prefix.

There will be some mechanisms in place that should allow you to run your code if you suppress deprecations.

However, even on the current versions, I think your chain could be simpler. I'm not sure why you're calling setTemplate() on the chain of the attribute rule instead of calling it in the chain of rule you're passing to attribute, could you elaborate?

I think that on version 2.3 (or 2.4), you chain could look like this:

->attribute('foo', v::stringType()->length(1, 19)->digit()->intVal()->setTemplate('This should have been valid...'))
->attribute('bar', v::boolType()->setTemplate('This also should have been valid...'))

In version 3.0, it will look like pretty much the same (just changing attribute -> property and length -> lengthBetween) not to get E_USER_DEPRECATED errors because of the renamed rules.

->property('foo', v::stringType()->lengthBetween(1, 19)->digit()->intVal()->setTemplate('This should have been valid...'))
->property('bar', v::boolType()->setTemplate('This also should have been valid...'))

But, it could be more clear on version 3.0 with the Templated rule, because it's more explicit (IMO)

->property('foo', v::templated(v::stringType()->lengthBetween(1, 19)->digit()->intVal(), 'This should have been valid...'))
->property('bar', v::templated(v::boolType(), 'This also should have been valid...'))

[andus4n]

Thank you for the response.
I'm still using v2.2.4.

AllOf will require at least 2 rules

So basically, if i have a chain like v::stringType()->lengthBetween(1, 19) inside allOf it'll still be seen as a single rule?
In other words, v::allOf(v::stringType()->lengthBetween(1, 19)) will raise an error?
I'm usin' a lot of chaining and if i'd wrap them inside allOf, this would allow me to use the setTemplate() method if anything fails.

To be more precise:
v::allOf(v::stringType()->lengthBetween(1, 19))->setTemplate('Invalid.') - this'll actually give me an exception with my custom message.
v::stringType()->lengthBetween(1, 19)->setTemplate('Invalid') - this'll generate an internal exception message, ignoring my custom template.
Is this fixed in version 2.3 / 2.4?

Attribute will be called Property -- assuming you forgot to type the property name there
Length will change a bit and you'll be able to use it as a prefix

This won't be a problem.
At this point i think that my best bet is to rewrite my rules in order to be able to properly use v3.0.

As a side-note, will version 2.2.4 work on PHP 8.4? I think a lot of developers are still using this version.

[henriquemoody]

So basically, if i have a chain like v::stringType()->lengthBetween(1, 19) inside allOf it'll still be seen as a single rule?
In other words, v::allOf(v::stringType()->lengthBetween(1, 19)) will raise an error?

By error, I mean that it won't work, because allOf will require at least two rules, while v::stringType()->lengthBetween(1, 19) is, for allOf, a single Validator rule.

I'm usin' a lot of chaining and if i'd wrap them inside allOf, this would allow me to use the setTemplate() method if anything fails.

Oh, I got it. So you're using allOf as a way to contain chains, so you can template them as a single unit. It's not the way it was intended to, but that's a smart way of using it! That would be exactly the purpose of Templated rule in version 3.0, though.

As a side-note, will version 2.2.4 work on PHP 8.4? I think a lot of developers are still using this version.

I think so! Apart form the sf rule, all tests are passing.

[andus4n]

I think so! Apart form the sf rule, all tests are passing.

That sounds really well.
What does sf mean, tho'? xD

[henriquemoody]

No worries, it's been removed anyways: https://respect-validation.readthedocs.io/en/2.2/rules/Sf/