1.7.3rc1

This is the first release candidate for the 1.7.3 stable release of ara.

1.7.3 is a maintenance release which adds a few new features.

Changes since 1.7.2:

Server
------

- Added tzdata to django server requirements

UI
--

- Added an auto refresh arrow at the top right, allowing automatic refreshes of the pages at the selected duration

Callback
--------

- Added support for specifying 'all' to ARA_IGNORED_FACTS to prevent ara from recording any host facts

New action plugin: ara_label
----------------------------

This new module provides the ability to manipulate ara's labels on playbooks.
Excerpt from the documentation:
```

- name: Add a static label to this playbook (the one that is running)
  # Note: By default Ansible will run this task on every host.
  # Consider the use case and declare 'run_once: true' when there is no need to
  # run this task more than once.
  # This might sound obvious but it avoids updating the same labels 100 times
  # if there are 100 hosts, incurring a performance penalty needlessly.
  run_once: true
  ara_label:
    state: present
    labels:
      - state:running

- name: Add dynamically templated labels to this playbook
  ara_label:
    state: present
    labels:
      - "git:{{ lookup('git -C {{ playbook_dir }} rev-parse HEAD') }}"
      - "os:{{ ansible_distribution }}-{{ ansible_distribution_version }}"

- name: Add labels to a specific playbook
  ara_label:
    state: present
    playbook_id: 1
    labels:
      - state:deployed

- name: Remove labels from the running playbook (if they exist)
  ara_label:
    state: absent
    labels:
      - state:running
```

Maintenance
-----------

- Bumped CI and container images to Fedora 41
- Bumped CI to the latest versions of ansible (11) and ansible-core (2.18)
- Docs: Stop using deprecated usage of get_html_theme_path

Upgrade Notes
-------------

- There are no migrations, deprecations or backwards-incompatible changes in this release.

Notes
-----

- With the new release of Django 5.2 LTS, the next release of ara (1.8.0) is expected
  to bump the django requirement from `>=3.2,<4.3` to `>=4.2,<5.3`.
  The python requirement will remain `>=3.8`.

- ara 1.7.3 will be the last release made from https://github.com/ansible-community/ara.
  The project is moving to Codeberg: https://codeberg.io/ansible-community/ara.
  This does not change the availability of releases on PyPi, Docker Hub or Quay.io.

1.7.2

This is the 1.7.2 stable release of ara.

1.7.2 is a maintenance and bugfix release that includes a few new features.

Changes since 1.7.1:

UI
--

- When recording diffs, properly format and display the "prepared" key
  for the modules that use it (apt, git, cli_config and others)
- Sorting task results by duration when browsing playbook results works once again
- Updated bootstrap css from 5.3.0 to 5.3.3

Callback plugin
---------------

- Catch SIGINT and SIGTERM signals resulting in the interruption of playbooks to
  set the status of the playbook to "expired" instead of keeping it running forever
  unless expired with `ara playbook expire` from the CLI.

API Client
----------

- Add support for UTF-8 encoded usernames and passwords

Docs
----

- Add .readthedocs.yaml to fix broken documentation builds
- Formally include ara as a dependency in order to include --help commands in the docs
- Added an introduction page

Maintenance and packaging
-------------------------

- Made dependency on ruamel.yaml explicit rather than implicit
- Update usage of logging.warn to logging.warning for
  python 3.13
- Updated versions of Ansible tested in CI to Ansible 10 and ansible-core 2.17

Upgrade notes
-------------

There are no API changes or SQL migrations in this release.

1.7.2rc2

This is the second release candidate for the 1.7.2 stable release of ara.

1.7.2 is a maintenance and bugfix release that includes a few new features.

Changes since 1.7.1:

UI
--

- When recording diffs, properly format and display the "prepared" key
  for the modules that use it (apt, git, cli_config and others)
- Sorting task results by duration when browsing playbook results works once again
- Updated bootstrap css from 5.3.0 to 5.3.3

Callback plugin
---------------

- Catch SIGINT and SIGTERM signals resulting in the interruption of playbooks to
  set the status of the playbook to "expired" instead of keeping it running forever
  unless expired with `ara playbook expire` from the CLI.

API Client
----------

- Add support for UTF-8 encoded usernames and passwords

Docs
----

- Add .readthedocs.yaml to fix broken documentation builds
- Formally include ara as a dependency in order to include --help commands in the docs
- Added an introduction page

Maintenance and packaging
-------------------------

- Made dependency on ruamel.yaml explicit rather than implicit
- Update usage of logging.warn to logging.warning for
  python 3.13
- Updated versions of Ansible tested in CI to Ansible 10 and ansible-core 2.17

Upgrade notes
-------------

There are no API changes or SQL migrations in this release.

1.7.2rc1

This is the first release candidate for the 1.7.2 stable release of ara.

1.7.2 is a maintenance and bugfix release that includes a few new features.

Changes since 1.7.1:

UI
--

- When recording diffs, properly format and display the "prepared" key
  for the modules that use it (apt, git, cli_config and others)
- Sorting task results by duration when browsing playbook results works once again
- Updated bootstrap css from 5.3.0 to 5.3.3

Callback plugin
---------------

- Catch SIGINT and SIGTERM signals resulting in the interruption of playbooks to
  set the status of the playbook to "expired" instead of keeping it running forever
  unless expired with `ara playbook expire` from the CLI.

Docs
----

- Add .readthedocs.yaml to fix broken documentation builds
- Formally include ara as a dependency in order to include --help commands in the docs
- Added an introduction page

Maintenance and packaging
-------------------------

- Made dependency on ruamel.yaml explicit rather than implicit
- Update usage of logging.warn to logging.warning for
  python 3.13
- Updated versions of Ansible tested in CI to Ansible 10 and ansible-core 2.17

Upgrade notes
-------------

There are no API changes or SQL migrations in this release.

1.7.1

This is the 1.7.1 stable release of ara.

1.7.1 is a maintenance release that features minor bug fixes.

Changes since 1.7.0:

- Address deprecation of yaml.dump in ruamel.yaml when generating
  the default server settings.yaml file (#524)
- Don't use setuptools/pkg_resources to retrieve the version of ara
  since it is not always installed by default.
- Bumped the version of ansible, ansible-core and fedora used in Zuul
  CI jobs.

1.7.1rc1

This is the first release candidate for the 1.7.1 stable release of ara.

1.7.1 is a maintenance release that features minor bug fixes.

Changes since 1.7.0:

- Address deprecation of yaml.dump in ruamel.yaml when generating
  the default server settings.yaml file (#524)
- Don't use setuptools/pkg_resources to retrieve the version of ara
  since it is not always installed by default.
- Bumped the version of ansible, ansible-core and fedora used in Zuul
  CI jobs.

1.7.0

This is the 1.7.0 stable release of ara.

It features a refresh of the built-in web interface with the upgrade
from bootstrap 4.6.0 to 5.3.0.

It lifts the supported version of django up to the latest LTS, 4.2, and
raises the minimum version of python to >=3.8 as a result.

There's also bug fixes and new features.

Changes since 1.6.1:

UI
--
Boostrap and CSS:

- Update bootstrap CSS from 4.6.0 to 5.3.0 and fix broken layout and
  components as a result of the update
- Removed separate light/dark themes via bootstrap-darkly and
  bootstrap-flatly: bootstrap 5.3 features a new built-in dark theme
- Re-worked the dark/light theme selection to match the new bootstrap
  built-in dark theme including pygments highlighting for pretty-printed
  output
- Removed jquery, it is no longer required with bootstrap
- Re-worked implementation of file line highlighting since it relied on
  jquery
- Fixed tooltip implementation (i.e, for task tags) since the
  implementation in bootstrap had changed

Site-wide minor cleanups and improvements:

- Headers and font size made generally larger and more consistent
- Improved the about and CLI argument modals
- Improved display for the report and CLI argument buttons
- Improved the playbook report header card
- Adjusted search accordions to match new bootstrap theme
- Improvements to responsiveness of layout at smaller (e.g, mobile)
  resolutions
- Truncate excessively long controller hostnames such that they do not
  needlessly take up all the table's available width
- Added support for colored diff when viewing task results
- Fixed the API link when viewing tasks to properly direct to
  /api/v1/tasks

Django templating:

- Large chunks of templating were moved out to partials/tables and
  partials/search in order to improve readability.
- Round of template cleanups and fixes as reported by djlint
- Will continue to be a work in progress to simplify and standardize
  templates.

API Server
----------

- Raised the requirement on django from >=3.2,<3.3 to >=3.2,<4.3 to
  allow installation with the latest LTS release of django.
- Raised the requirement on python from >=3.6 to >=3.8 to accomodate
  django 4.2.
- Ignored Django warning about the lack of a STATIC_ROOT directory.
  ara uses whitenoise for serving static files which makes the warning
  superfluous. (#492)

Ansible callback plugin
-----------------------

- Added ARA_RECORD_CONTROLLER_NAME and ARA_RECORD_USER_NAME settings to
  override the automatic detection of the controller hostname and user
  name for the specified values.
- Added ARA_RECORD_TASK_CONTENT which defaults to true but can be set to
  false to prevent ara from recording the task content for use cases
  where it is not important or to avoid leaking sensitive information.

Maintenance
-----------

Update versions, CI test jobs and container images:

- containers: updated fedora base image from 36 to 38
- containers: updated centos-pypi image from stream8 to stream9
- zuul: Update fedora base image from 36 to 38
- zuul: Update ansible version tested from 6.4.0 to 8.3.0
- zuul: Update versions of ansible-core tested (2.14, 2.15)
- Dropped testing for Ansible 2.9 which has been EOL for over a year.

Upgrade notes
-------------

There are no API changes or SQL migrations in this release.

1.7.0rc3

This is the third release candidate for the version 1.7.0 stable release of ara.

It features a refresh of the built-in web interface with the upgrade
from bootstrap 4.6.0 to 5.3.0.

It lifts the supported version of django up to the latest LTS, 4.2, and
raises the minimum version of python to >=3.8 as a result.

There's also bug fixes and new features.

Changes since 1.6.1:

UI
--
Boostrap and CSS:

- Update bootstrap CSS from 4.6.0 to 5.3.0 and fix broken layout and
  components as a result of the update
- Removed separate light/dark themes via bootstrap-darkly and
  bootstrap-flatly: bootstrap 5.3 features a new built-in dark theme
- Re-worked the dark/light theme selection to match the new bootstrap
  built-in dark theme including pygments highlighting for pretty-printed
  output
- Removed jquery, it is no longer required with bootstrap
- Re-worked implementation of file line highlighting since it relied on
  jquery
- Fixed tooltip implementation (i.e, for task tags) since the
  implementation in bootstrap had changed

Site-wide minor cleanups and improvements:

- Headers and font size made generally larger and more consistent
- Improved the about and CLI argument modals
- Improved display for the report and CLI argument buttons
- Improved the playbook report header card
- Adjusted search accordions to match new bootstrap theme
- Improvements to responsiveness of layout at smaller (e.g, mobile)
  resolutions
- Truncate excessively long controller hostnames such that they do not
  needlessly take up all the table's available width
- Added support for colored diff when viewing task results
- Fixed the API link when viewing tasks to properly direct to
  /api/v1/tasks

Django templating:

- Large chunks of templating were moved out to partials/tables and
  partials/search in order to improve readability.
- Round of template cleanups and fixes as reported by djlint
- Will continue to be a work in progress to simplify and standardize
  templates.

API Server
----------

- Raised the requirement on django from >=3.2,<3.3 to >=3.2,<4.3 to
  allow installation with the latest LTS release of django.
- Raised the requirement on python from >=3.6 to >=3.8 to accomodate
  django 4.2.
- Ignored Django warning about the lack of a STATIC_ROOT directory.
  ara uses whitenoise for serving static files which makes the warning
  superfluous. (#492)

Ansible callback plugin
-----------------------

- Added ARA_RECORD_CONTROLLER_NAME and ARA_RECORD_USER_NAME settings to
  override the automatic detection of the controller hostname and user
  name for the specified values.
- Added ARA_RECORD_TASK_CONTENT which defaults to true but can be set to
  false to prevent ara from recording the task content for use cases
  where it is not important or to avoid leaking sensitive information.

Maintenance
-----------

Update versions, CI test jobs and container images:

- containers: updated fedora base image from 36 to 38
- containers: updated centos-pypi image from stream8 to stream9
- zuul: Update fedora base image from 36 to 38
- zuul: Update ansible version tested from 6.4.0 to 8.3.0
- zuul: Update versions of ansible-core tested (2.14, 2.15)
- Dropped testing for Ansible 2.9 which has been EOL for over a year.

Upgrade notes
-------------

There are no API changes or SQL migrations in this release.

1.7.0rc2

This is the second release candidate for the version 1.7.0 stable release of ara.

It features a refresh of the built-in web interface with the upgrade
from bootstrap 4.6.0 to 5.3.0.

It lifts the supported version of django up to the latest LTS, 4.2, and
raises the minimum version of python to >=3.8 as a result.

There's also bug fixes and new features.

Changes since 1.6.1:

UI
--
Boostrap and CSS:

- Update bootstrap CSS from 4.6.0 to 5.3.0 and fix broken layout and
  components as a result of the update
- Removed separate light/dark themes via bootstrap-darkly and
  bootstrap-flatly: bootstrap 5.3 features a new built-in dark theme
- Re-worked the dark/light theme selection to match the new bootstrap
  built-in dark theme including pygments highlighting for pretty-printed
  output
- Removed jquery, it is no longer required with bootstrap
- Re-worked implementation of file line highlighting since it relied on
  jquery
- Fixed tooltip implementation (i.e, for task tags) since the
  implementation in bootstrap had changed

Site-wide minor cleanups and improvements:

- Headers and font size made generally larger and more consistent
- Improved the about and CLI argument modals
- Improved display for the report and CLI argument buttons
- Improved the playbook report header card
- Adjusted search accordions to match new bootstrap theme
- Improvements to responsiveness of layout at smaller (e.g, mobile)
  resolutions
- Truncate excessively long controller hostnames such that they do not
  needlessly take up all the table's available width
- Added support for colored diff when viewing task results

Django templating:

- Large chunks of templating were moved out to partials/tables and
  partials/search in order to improve readability.
- Round of template cleanups and fixes as reported by djlint
- Will continue to be a work in progress to simplify and standardize
  templates.

API Server
----------

- Raised the requirement on django from >=3.2,<3.3 to >=3.2,<4.3 to
  allow installation with the latest LTS release of django.
- Raised the requirement on python from >=3.6 to >=3.8 to accomodate
  django 4.2.
- Ignored Django warning about the lack of a STATIC_ROOT directory.
  ara uses whitenoise for serving static files which makes the warning
  superfluous. (#492)

Ansible callback plugin
-----------------------

- Added ARA_RECORD_CONTROLLER_NAME and ARA_RECORD_USER_NAME settings to
  override the automatic detection of the controller hostname and user
  name for the specified values.
- Added ARA_RECORD_TASK_CONTENT which defaults to true but can be set to
  false to prevent ara from recording the task content for use cases
  where it is not important or to avoid leaking sensitive information.

Maintenance
-----------

Update versions, CI test jobs and container images:

- containers: updated fedora base image from 36 to 38
- containers: updated centos-pypi image from stream8 to stream9
- zuul: Update fedora base image from 36 to 38
- zuul: Update ansible version tested from 6.4.0 to 8.3.0
- zuul: Update versions of ansible-core tested (2.14, 2.15)
- Dropped testing for Ansible 2.9 which has been EOL for over a year.

1.7.0rc1

This is the first release candidate for the version 1.7.0 stable release of ara.

It features a refresh of the built-in web interface with the upgrade
from bootstrap 4.6.0 to 5.3.0.

It lifts the supported version of django up to the latest LTS, 4.2, and
raises the minimum version of python to >=3.8 as a result.

There's also bug fixes and new features.

Changes since 1.6.1:

UI
--
Boostrap and CSS:

- Update bootstrap CSS from 4.6.0 to 5.3.0 and fix broken layout and
  components as a result of the update
- Removed separate light/dark themes via bootstrap-darkly and
  bootstrap-flatly: bootstrap 5.3 features a new built-in dark theme
- Re-worked the dark/light theme selection to match the new bootstrap
  built-in dark theme including pygments highlighting for pretty-printed
  output
- Removed jquery, it is no longer required with bootstrap
- Re-worked implementation of file line highlighting since it relied on
  jquery
- Fixed tooltip implementation (i.e, for task tags) since the
  implementation in bootstrap had changed

Site-wide minor cleanups and improvements:

- Headers and font size made generally larger and more consistent
- Improved the about and CLI argument modals
- Improved display for the report and CLI argument buttons
- Improved the playbook report header card
- Adjusted search accordions to match new bootstrap theme
- Improvements to responsiveness of layout at smaller (e.g, mobile)
  resolutions
- Truncate excessively long controller hostnames such that they do not
  needlessly take up all the table's available width
- Added support for colored diff when viewing task results

Django templating:

- Large chunks of templating were moved out to partials/tables and
  partials/search in order to improve readability.
- Round of template cleanups and fixes as reported by djlint
- Will continue to be a work in progress to simplify and standardize
  templates.

Server
------

- Ignored Django warning about the lack of a STATIC_ROOT directory.
  ara uses whitenoise for serving static files which makes the warning
  superfluous. (#492)

Callback
--------

- Added ARA_RECORD_CONTROLLER_NAME and ARA_RECORD_USER_NAME settings to
  override the automatic detection of the controller hostname and user
  name for the specified values.
- Added ARA_RECORD_TASK_CONTENT which defaults to true but can be set to
  false to prevent ara from recording the task content for use cases
  where it is not important or to avoid leaking sensitive information.

Maintenance
-----------

Update versions, CI test jobs and container images:

- containers: updated fedora base image from 36 to 38
- containers: updated centos-pypi image from stream8 to stream9
- zuul: Update fedora base image from 36 to 38
- zuul: Update ansible version tested from 6.4.0 to 8.3.0
- zuul: Update versions of ansible-core tested (2.14, 2.15)
- Dropped testing for Ansible 2.9 which has been EOL for over a year.