MAR-218: Switch to using task imports instead of includes:

- Should result in somewhat faster run, except the includes happen
during planning phase. None of the changed includes will have
problem with this.
- Solves the issue of (included) imported tasks not being tagged
properly, particularly in relation to the mechanism for explicitly
running all handlers.

MAR-218: Document the passlib Python package requirement:

- The library is used for hashing the operating system user passwords
during account creation.

MAR-218: Undo removal of explicitly specifying Python interpreter:

- Ansible will produce warnings if the interpreter path is not
specified explicitly.

MAR-218: Update the usage tasks and instructions for Ansible 10.3:

- Update the module names to include the namespace.
- Drop references to Python 3, and bump up the installed package
versions.

MAR-218: Drop documentation references to only Python 3 being supported:

- The project is at this point only supporting Python 3, and all
modern distros support only Python 3 nowadays. No need to be
explicit anymore.

MAR-218: Enable case-sensitive column name handling for database privileges:

- This will become a new default in the next major release of the
community.mysql collection.
- Gets rid of the Ansible mysql_user module warning.

MAR-218: Upgrade test site for Ansible 10.x and fix linting errors:

- Disable name checks when importing playbooks into top-level playbook
to avoid naming duplication.

MAR-218: Fix the custom m_ldap_permissions module to work correctly with ansible-lint:

- In order for things to behave correctly, module should not invoke
the main part of code automatically during import, but only if run
via CLI.
- Without this the ansible-lint kept erroring out with:

"missing required arguments: filter, rules"

MAR-218: Improve mail server role test reliability:

- Introduce sleep after sending out mails in order to ensure that
Postfix has had enough time to process the messages.
- Relevant only for tests that take care of parsing the mail log.
- Solves the false negatives caused by timing issues.
- It might be a good idea down the line to implement some kind of
retry/backoff mechanism instead.

MAR-218: Fix test instance preparation for php_website testing:

- Some of the tasks can only be run without errors on the spun up PHP
website instance due to (un)availability of ansible_eth0 variable.

MAR-218: Fix/improve reliability of mail_server tests:

- The common role has rather conservative rate limit values that
easily get triggered when running connectivity tests in quick
succesions.

MAR-218: Force handler execution during testing for consistency:

- Otherwise it can easily happen that some handlers never run, leaving
the machine in inconsistent state until they are run by hand.

MAR-218: Fix execution of the LDAP database permissions module:

- Python interpreter path must be specified explicitly (without the
env wrapper).

MAR-218: Drop the workaround for running connectivity tests:

- Relevant PR has been long merged into testinfra, and no longer poses
an issue.

MAR-218: Add back flake8 requirement for running tests:

- Requirements was dropped by accident.

MAR-218: Switch to using ldap_attrs module:

- Update invocations and syntax.
- Drop the workaround for configuring TLS on the LDAP server (should
be possible to set all relevant attributes at the same time at this
point).
- Group some invocations where it makes sense.

MAR-218: Switch to using fully-qualified collection names for all tasks:

- Ensures there is no ambiguity when invoking a module.

MAR-218: Quote all octal values in YAML files:

- Fixes linting errors, and ensures there is no ambiguity in case of
YAML specification changes.

MAR-218: Disable Ansible lints for prefixed role variable names:

- At this point in time, it does not make much sense to introduce
prefixing and breaking every single role invocation.
- Might be worth revisting down the line, although it would require
understanding a bit more clearly if prefixing has any kind of
special logic handling or it's pure guidelines.

MAR-218: Fix linting errors related to commands doing unconditional changes:

- Tasks run during the prepare stage of test runs do not matter.
- Some of the role tasks are already effectively running only when
change _will_ happen (when it is detected via variable registered by
a previous task).

MAR-218: Update noqa directives for ansible-lint to use text tags:

- Numeric tagging is deprecated.

MAR-218: Fix linting errors for unnamed plays:

- All plays should be named at this point.
- Improve naming of some plays.
- Group some of the common tasks together to speed-up the prepare
step.
- Minor refactoring to make the prepare playbooks more consistent
across the roles.

MAR-218: Drop deprecated argument for command invocation:

- This might require fixing down the line in some other way (to avoid
warnings being spit out).

MAR-218: Fix include invocations:

- The old include keyword/task has been deprecated in favour of more
explicit include_tasks one.

MAR-218: Update metadata information for all roles:

- Bump minimum Ansible version.
- Add missing metadata.
- Use named release for platform (Debian) version.

MAR-218: Drop linting definitions from Molecule configuratin files:

- Molecule no longer natively supports running linters.
- Disable the Ansible Galaxy dependency installation (none of the
roles utilise this).

MAR-218: Update the name of playbook when setting up Molecule instances:

- Fixes Molecule deprecation warnings.

MAR-218: Document the workaround needed to make Molecule instance logins work:

- It should be possible to drop this workaround once the upstream has
taken care of merging the necessary fixes.

MAR-218: Updated project requirements for Python virtual environment:

- Switch to using Python 3.11 as the basis.
- Pin Ansible and test framework to latest available/supported
versions.
- Drop the workarounds used for older package versions.
- Group the requirements according to their use within the project.

MAR-239: Dropped support for Debian 11 Bullseye from the ldap_server role:

- Debian 12 Bookworm and upwards no longer install/configure rsyslog
by default, drop the related tests, tasks, and configuration files.

MAR-239: Dropped support for Debian 11 Bullseye from the backup_client role:

- Switch to using Paramiko instead of pexpect backend (therefore
avoiding using the external SSH client binary).

Noticket: Added workaround to development process for outdated Molecule version:

- Unfortunately, the Molecule version used for running tests does not
generate valid Ruby 3.x code. For now just work around the way Hash
is unpacked in function calls to optional arguments (until the test
stack gets a revamp).

Noticket: Increase allocated memory for testing the mail server role:

- ClamAV and related processes/applications have tendency to be rather
memory-hungry.

MAR-234: Use the pipreqcheck user when checking the Python version and prompt:

- Using the root account can result in incorrect permissions being set
on the Python cache (__pycache__) directories, which can further
cause permission issues for the pirpeqcheck user itself.
- The prompt also makes more sense to check in context of the virtual
environment user (since that's the one that will normally get used
with the virtual environment itself).

MAR-234: Use the pipreqcheck user when checking the Python version and prompt:

- Using the root account can result in incorrect permissions being set
on the Python cache (__pycache__) directories, which can further
cause permission issues for the pirpeqcheck user itself.
- The prompt also makes more sense to check in context of the virtual
environment user (since that's the one that will normally get used
with the virtual environment itself).

Noticket: Fix version for 8.0.0 release notes:

- The x.y.z was left unchanged by mistake.

Noticket: Fix version for 8.0.0 release notes:

- The x.y.z was left unchanged by mistake.

MAR-201: Preparing for release 8.0.0:

- Update the release procedure to cater for Sphinx documentation
builder upgrade.

MAR-232: Switch to using IP addreses in firewall rules for mail_forwarder role:

- Perform lookups on managed machine for the passed-in SMTP relay
host, and use those values when populating the firewall rules.

MAR-226: Harmonise the HTTP header override parameter between the PHP and WSGI website roles:

- Use the new naming/syntax introduced in the php_website role since
it implies less dependence on the backend application (more generic
name for it), and is a little bit saner in terms of not having to
provide quotes as part of the value.

MAR-192: Update deployment instructions and configuration for Django Wiki in usage instructions:

- Bring the package and its dependencies to latest possible (LTS)
version.

MAR-192: Fix missing dnspython library as requiremnts for running the roles:

- Turns out there is still one usage left in the mail_forwarder role.
- It might be a good idea to try to get rid of that single usage to
make the firewall coming up more reliable during boot time.

MAR-192: Updated controller and base server installation instructions to use Debian 12 Bookworm:

- Reword some senteces.
- Some reformatting changes.
- Update list of packages getting installed in the Python virtual
environment.

MAR-192: Get rid of the dnspython requirement, and document netaddr requirement:

- This is the result of previous deprecation of using resolvable names
for setting-up the list of allowed incoming connections when in
maintenance mode.

MAR-192: Updated test site instructions/deployment for Debian 12 Bookworm:

- Default to recommending Debian 12 Bookworm.
- Update the demo WSGI application for Python 3 use.

MAR-192: Drop rsyslog/logrotate configuration for ldap_server role under Debian 12 Bookworm:

- Default installations of Debian 12 Bookworm no longer come with
rsyslog pre-installed (and it is considered to be deprecated as
default system logger under Debian 12 Bookworm).

MAR-192: Upgrade documentation build requirements:

- Current requiremetns no longer seem to work with Python 3.9. Time to
bump up the Sphinx version.

MAR-192: Fix incorrect prompt for pipreqcheck virtual environment:

- Ensure that the virtualenv indicator string ends with a
whitespace.
- The virtualenv prompt parameter behaves slightly different between
the versions of Debian 11 Bullseye and Debian 12 Bookworm - the former
being a bit more user-friendly.
- Recreate virtual environment if the prompt does not match-up.

MAR-192: Fix incorrect prompt for wsgi_website virtual environments:

- Ensure that the virtualenv indicator string ends with a whitespace.
- The virtualenv prompt parameter behaves slightly different between
the versions of Debian 11 Bullseye and Debian 12 Bookworm - the
former being a bit more user-friendly.
- Recreate virtual environment if the prompt does not match-up.

MAR-192: Fix/improve backup tests for XMPP server:

- Don't send message to self because go-sendxmpp will retrieve them,
and they won't end-up the offline messages file.
- Generate a random UUID in order to test for the content in the
backed-up files. Makes the test more reliable.

MAR-192: Switch to using go-sendxmpp where possible for testing XMPP server role:

- The sendxmpp in Debian 12 Bookworm is quite broken at this point,
and go-sendxmpp is somewhat close in terms of interface etc.
- Fix a number of tests related to sending messages.

MAR-192: Added support for Debian 12 Bookworm to xmpp_server role:

- Some of the tests are still failing, namely the ones centered around
the sendxmpp tool (which seems completely broken at this point in
Debian 12 Bookworm)

MAR-192: Align IP ranges used for testing VMs in the xmpp_sever role:

- Use two consecutive ranges for Debian 11 Bullseye like in
mail_server.

MAR-192: Allocate a bit more memory to LDAP server helper for mail_server tests:

- Debian 12 Bookworm is a bit more memory-hungry.

MAR-192: Added support for Debian 12 Bookworm to mail_server role:

- Allow use of older versions of TLS on Bookworm for testing of
related optional parameters.
- Install the IMAP CLI testing tool under its own virtual environment
in order to avoid warnings and errors when trying to install it
globally under Debian 12 Bookworm.
- Update the lists of expected TLS protocols and ciphers.

MAR-192: Update compatibility-related entries for Postfix main configuration file:

- Default value for append_dot_mydomain has been "no" for a while now,
no need to set it explicitly.
- Prefer the whitelist/blacklist instead of allowlist/denylist
keywords in logs.

MAR-192: Reformatted mail_forwader Postfix configuration file:

- Improve commenting, and align it with the mail_server role
configuration file in terms of layout.
- Set the compatibility level.

MAR-192: Reformat the Postfix main configuration file for mail_server:

- Improve the comments and split up the config with section titles.
- Drop the deprecated/unnecessary option smtpd_use_tls (already
covered with smtpd_tls_security_level).

MAR-192: Added support for Debian 12 Bookworm to wsgi_website role:

- Update list of Python packages that are installed for running the
tests.
- Paramterise Python version testing (depends on distribution
release). Use similar construct like for the php_website role.