Prepare release v1.0.0

[henri-hulski]

@Daverball Can you take a look?

[coveralls]

coverage: 100.0% (+5.1%) from 94.861% — prep_1.0.0 into master

[Daverball]

Looks good to me apart from the pyright failures on the CI due to the missing sphinx dependency in that tox environment. mypy only seems to succeed because the mypy configuration currently still ignores errors in dectate.sphinxext, so it's not in sync with the pyright config that no longer excludes that module.

[Daverball]

This seems to be inconsistent with the pyright config, but pyright also currently fails to type check. I assume it's missing the sphinx dependency in that specific tox environment.

[henri-hulski]

I fixed also the scenarios folder. I was still using the old API before dectate 0.12.
Also removed now sphinxext ignore from mypy.

[Daverball]

I'm not thrilled about the prospect of adding import-time overhead for some typing-only symbols only so the docs can cross reference them.

Maybe we build the docs with Python 3.15 and leverage the new lazy imports, like this:

if TYPE_CHECKING:
    from collections.abc import Callable, Sequence
elif sys.version_info >= (3, 15):
    __lazy_modules__ = ["collections.abc"]
    from collections.abc import Callable, Sequence

Or if we're fine with changing the annotations from Callable to abc.Callable we could write it like this:

if TYPE_CHECKING:
    from collections import abc
elif sys.version_info >= (3, 15):
   abc = __lazy_import__("collections.abc")

That would also let you deal with the symbols that currently lead to circular references, since sphinx won't inspect the annotations until the modules have fully loaded, so the lazy imports won't trigger until that happens.

[henri-hulski]

I guess you're right. I will take a look.
Same for importscan. I did there some similar changes.

BTW I made the changes for importscan directly to the master branch. Would you prefer if I always create a PR so it's easier to review?

[Daverball]

A PR definitely can't hurt if you want a second pair of eyes looking over the changes, but I'll leave it up to your judgement.

[henri-hulski]

I added a doc-build-only shim add the end of doc/conf.py.
That should fix it.

[Daverball]

That works too, yeah. Can't we use the same trick to resolve the circularity issue with Configurable in dectate.app?

[henri-hulski]

Yep - I was able to fix Configurable in the same way.
importscan was a bit trickier. You can take a look at the last commit.