Instawow

------

- Added support for the Classic Catalysm beta.

CLI
~~~

- Relocated plug-in commands under ``plugins``.
- Removed ``--retain-strategies`` flag from ``update`` command.
Strategies are now always respected when present; to force an update with
the default strategy set, append ``=`` to the add-on definition.
- Global ``-d/--debug`` flag renamed to ``-v/--verbose``.
- ``configure --show-active`` sub-flag reimagined as the ``debug`` command.
- Allow filtering installed add-ons by source using ``list source:``, replacing
"source" with the source identifier.

------

- Added support for alternative archive openers in plug-ins.
- Reworked HTTP cache.

CLI
~~~

- Extended ``--no-cache`` flag to add-on downloads.

------

- Added support for Python 3.12.

CLI
~~~

- The CLI is now bundled as a single-file self-extracting
executable using `PyApp <https://github.com/ofek/pyapp>`_
instead of PyInstaller.

GUI
~~~

- Fixed creating non-standard configuration directories.
- Stopped bundling Mozilla's root certificate store.

------

- Reconciliation was made to cross-reference add-ons from the GitHub catalogue.
- XDG env vars are now respected on all platforms; if `$XDG_CONFIG_HOME` is set,
it will be preferred over the platform-native configuration directory.
This is a behaviour change on macOS and Windows.
- Logs and plug-in data are stored under `$XDG_STATE_HOME` on Linuxes by default.

------

CLI
~~~

- Restored asyncio event loop policy override on Windows for Python 3.9.

GUI
~~~

- Fixed add-on alias and URL search.

------

- Dropped support for Tukui add-ons other than the two headline UI suites,
having switched from the original API at https://www.tukui.org/api.php
to https://api.tukui.org/v1.
The new API is hosted by the author of
`CurseBreaker <https://github.com/AcidWeb/CurseBreaker>`_.
The original API is unmaintained and the add-on index has fallen into disuse.
- Numeric aliases are no longer valid for Tukui add-ons; use ``tukui:elvui`` for
ElvUI and ``tukui:tukui`` for Tukui.

CLI
~~~

- Added WoW installation finder (Mac only). Located installations will be
offered as suggestions bypassing manual add-on directory and flavour entry
when configuring *instawow*.
- Added add-on definition mini-DSL replacing the various strategy install options.
Strategies can now be passed as URL fragments of the add-on ``Defn``,
e.g. ``foo:barany_flavour,version_eq=1``.
- Strategies passed to ``update --retain-strategies`` will be respected *if* they result
in a change. This opens up several possibilities, e.g. a bare ``source:alias``
will unpin an add-on that was previously rolled back.
- Removed ``--version`` option from ``rollback``. Use ``update --retain-strategies`` to
roll back to a known version.
- Added ``--dry-run`` option to ``install`` and ``update``.
Issue ``instawow update --dry-run`` to check for add-on updates.
- Added ``list-sources`` command to display the active source metadata.
- Added ``--prefer-source`` option to ``search``. If an add-on is found
from a preferred source, identical add-ons from other sources are omitted
from the results.
- Installed add-ons are now excluded from ``search`` results.
This includes identical add-ons from sources other than the one installed.
Pass ``--no-exclude-installed`` to opt out.
- Changed the Markdown flavour used to convert changelogs
with pandoc from Markdown.pl to CommonMark to fix an issue
with list formatting.

API
~~~

- Public enum members are now capitalised.
- Exposed ``plugins.InstawowPlugin`` protocol. *instawow* plug-ins should
conform to this protocol.