🚧 Adopt the ‘to+infinitive’ Convention

[jGleitz]

Let’s get the ball rolling!

This PR will introduce the ‘to+infinitive’ convention for atrium.
It will not be merged before the convention has been applied to all of the fluent API.
It exists to gather feedback and find merge conflicts during the transition.

[jGleitz]

You’ll notice that I made cosmetical adaptions to the docs of the new functions. I think they are improvements and am happy to discuss them!

[codecov]

Codecov Report

Merging #714 (e26ed64) into master (e9da7cf) will increase coverage by 0.00%.
The diff coverage is 100.00%.

@@            Coverage Diff            @@
##             master     #714   +/-   ##
=========================================
  Coverage     87.59%   87.59%           
  Complexity       16       16           
=========================================
  Files           904      904           
  Lines          8157     8159    +2     
  Branches        378      378           
=========================================
+ Hits           7145     7147    +2     
  Misses          935      935           
  Partials         77       77           

Flag	Coverage Δ	Complexity Δ
bbc	80.16% <100.00%> (+<0.01%)	0.00 <0.00> (ø)
bc	58.44% <0.00%> (-0.02%)	0.00 <0.00> (ø)
current	58.59% <75.00%> (-0.02%)	0.00 <0.00> (ø)
current_windows	49.29% <75.00%> (-0.02%)	0.00 <0.00> (ø)

Flags with carried forward coverage won't be shown. Click here to find out more.

Impacted Files	Coverage Δ	Complexity Δ
.../tutteli/atrium/logic/impl/DefaultAnyAssertions.kt	100.00% <ø> (ø)	0.00 <0.00> (ø)
...h/tutteli/atrium/api/fluent/en_GB/anyAssertions.kt	100.00% <100.00%> (ø)	0.00 <0.00> (ø)
...ch/tutteli/atrium/api/infix/en_GB/anyAssertions.kt	66.66% <100.00%> (ø)	0.00 <0.00> (ø)
...rc/generated/kotlin/ch/tutteli/atrium/logic/any.kt	100.00% <100.00%> (ø)	0.00 <0.00> (ø)

---

Continue to review full report at Codecov.

Legend - Click here to learn more
Δ = absolute <relative> (impact), ø = not affected, ? = missing data
Powered by Codecov. Last update e9da7cf...e26ed64. Read the comment docs.

[robstoll]

Detail but more aligned with the readme:

Suggested change

	* Deprecated as atrium moves to a consistent ‘to + infinitive’ naming convention. Use [toBeTheSameAs] instead.
	* Deprecated as Atrium moves to a consistent ‘to + infinitive’ naming convention. Use [toBeTheSameAs] instead.

[robstoll]

@jGleitz IMO we should provide once again a script in order that users have a smooth migration experience. Do you see the draft release here? https://github.com/robstoll/atrium/releases/tag/untagged-c4eefbbdd8d22b72bc20

[jGleitz]

Do you see the draft release

No, I get a 404 for that link.

Writing a script feels like duplicating what the @ReplaceWith annotations do anyway. Isn’t there any IntelliJ functionality to say ‘perform all migrations’?

[robstoll]

Not that I know of, you were able to choose Replace for all for a particular ReplaceWith but last time I wanted to use it I couldn't find the option. Moreover, from my experience, the applications of the ReplaceWith by Intellij are many times buggy and don't work as they should. I was always happy that I had the scripts. I'll put a draft of the release note into the wiki so that you could provide the replacements as well
Up to you if you want to help out or not. It's also fine if I collect/write down the replacements at the end of 0.16.0

[jGleitz]

I see. I’ll prioritize work on my open pull requests, but will help on the script if I find the time.

[robstoll]

closing this in favour of #866 (other parts have been already merged into master via other PRs)