Screenpy

------------------

Deprecations

- Dropping support for Python 3.7. ScreenPy will probably still work in Python 3.7, but we're no longer making sure it does.

New Features

- Added a lot of new Resolutions for text and number comparisons:
- **StartsWith**
- **EndsWith**
- **Matches** for you regex-speakers
- **ContainsItemMatching** for strings-in-lists regex assertions
- **IsLessThan** and **IsLessThanOrEqualTo**
- **IsGreaterThan** and **IsGreaterThanOrEqualTo**
- **IsInRange**

Improvements

- Added convenience imports, so you can import everything directly from screenpy (from screenpy import Actor, given, See...)
- `StdOutAdapter` (now also called `LoggingAdapter` for clarity) can now accept `gravitas`, `AIRY` being equivalent to `logging.DEBUG`.
- All `staticmethods` on Actor, Action, and Resolution classes (maybe more? All of them!) are now `classmethods` and appropriately typed, which should make it much easier (and possible at all) to subclass, if you need to. Big big thanks to bandophahita for that huge effort!

------------------

New Features

- Added an `ErrorKeeper` protocol, currently only for Questions that encounter an error while being answered. This is now used by `MakeNote` to mention the exception, which will help debug some confusing test states. (h/t bandophahita!)
- Added official "extras" support for `screenpy_playwright`, install with `pip install screenpy[playwright]`!

Improvements

- A *significant* improvement on test coverage via unit tests! (h/t bandophahita!)

------------------

New Features

- Added new aliases for `IsCloseTo` and `HasLength` to use in their negated cases: `CloseTo` and `HaveLength`.
- Added official "extras" support for `screenpy_appium`, install with `pip install screenpy[appium]`!

Improvements

- Tons of typing improvements thanks to bandophahita, especially with Resolutions! Things should be a lot nicer in your IDEs.
- Added a count to `Eventually` that mentions how many times `Eventually` looped before failing. This should be helpful in the case where the performable that should eventually complete takes longer than the timeout set for `Eventually`.

------------------

2day is 2sday, by the way. Also I pushed this up at 22:22!

Breaking Changes

- ScreenPy is now broken up in2 its core (this repository), `screenpy_selenium`, `screenpy_requests`, `screenpy_pyotp`, and `screenpy_adapter_allure`. This will cause some big, big breakages in your suites, and i'm very sorry about it. To help get you back up and running, see the changes at https://screenpy-docs.readthedocs.io/en/latest/deprecations.html#breaking-changes
- Those deprecated methods mentioned on that same deprecations page are also finally removed.

Documentation

- Yet another rewrite of the documentation! This time it's much more focused, since the documentation is only for the base module.
- The rewrite includes a new Complete Example section, which shows a fictional example of a ScreenPy test file and breaks down each part of it.

Improvements

- Eventually now also tells you how many times it attempted its performable, which could be useful for debugging in certain situations.

Bugfixes

- If `See` was given a value to compare against a Resolution, the value is now properly printed to the log instead of just the string "{value}". :facepalm:

------------------

Improvements

- Added `.of_the_first_of_the` aliases to several Actions and Questions, to allow for clearer readings of tests.
- Added an `aside` of the actual value when `See` is about to compare a pre-baked value instead of asking a Question.
- Fixed `IsNot`'s descriptions, especially when they were describing when the negative (... of the negative).

------------------

Bugfixes

- Fixes the Narrator skipping narrations if they occurred within a double-kinked cable. In fact, completely rewrote how the Narrator handles multiple cable kinks in a much more understandable way (h/t bandophahita).