refine package logging

fix: force dry run build on task initialization for VCS packages
Previously if package is VCS and version in PKGBUILD doesn't match to AUR one, then makepkg will update pkgbuild ignoring all previous pkgrel patches With this change during task init dry ryn process is always run for vcs packages
2025-07-16 15:29:56 +00:00 · 2025-02-06 12:31:05 +02:00 · 2025-01-27 15:46:41 +02:00 · 2025-01-13 14:32:40 +02:00 · 2025-01-09 17:18:50 +02:00 · 2025-01-06 01:14:28 +02:00
385 changed files with 4354 additions and 2989 deletions
--- a/.github/workflows/setup.sh
+++ b/.github/workflows/setup.sh
@ -18,7 +18,7 @@ if [[ -z $MINIMAL_INSTALL ]]; then
    # web server
    pacman -S --noconfirm python-aioauth-client python-aiohttp python-aiohttp-apispec-git python-aiohttp-cors python-aiohttp-jinja2 python-aiohttp-security python-aiohttp-session python-cryptography python-jinja
    # additional features
-    pacman -S --noconfirm gnupg python-boto3 python-cerberus python-matplotlib rsync
+    pacman -S --noconfirm gnupg ipython python-boto3 python-cerberus python-matplotlib rsync
 fi
 # FIXME since 1.0.4 devtools requires dbus to be run, which doesn't work now in container
 cp "docker/systemd-nspawn.sh" "/usr/local/bin/systemd-nspawn"
--- a/.pylintrc
+++ b/.pylintrc
@ -305,7 +305,7 @@ max-branches=12
 max-locals=15

 # Maximum number of parents for a class (see R0901).
-max-parents=7
+max-parents=15

 # Maximum number of public methods for a class (see R0904).
 max-public-methods=20
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@ -175,11 +175,10 @@ Again, the most checks can be performed by `tox` command, though some additional
 * Web API methods must be documented by using `aiohttp_apispec` library. The schema testing mostly should be implemented in related view class tests. Recommended example for documentation (excluding comments):

    ```python
-    import aiohttp_apispec
-
    from marshmallow import Schema, fields  
-
-    from ahriman.web.schemas import AuthSchema, ErrorSchema, PackageNameSchema, PaginationSchema
+    
+    from ahriman.web.apispec.decorators import apidocs
+    from ahriman.web.schemas import PackageNameSchema, PaginationSchema
    from ahriman.web.views.base import BaseView


@ -198,25 +197,17 @@ Again, the most checks can be performed by `tox` command, though some additional
        POST_PERMISSION = ...
        ROUTES = ...

-        @aiohttp_apispec.docs(
+        @apidocs(
            tags=["Tag"],
            summary="Do foo",
            description="Extended description of the method which does foo",
-            responses={
-                200: {"description": "Success response", "schema": ResponseSchema},
-                204: {"description": "Success response"},  # example without json schema response
-                400: {"description": "Bad data is supplied", "schema": ErrorSchema},  # exception raised by this method
-                401: {"description": "Authorization required", "schema": ErrorSchema},  # should be always presented
-                403: {"description": "Access is forbidden", "schema": ErrorSchema},  # should be always presented
-                404: {"description": "Repository is unknown", "schema": ErrorSchema},  # include if BaseView.service() method is called
-                500: {"description": "Internal server error", "schema": ErrorSchema},  # should be always presented
-            },
-            security=[{"token": [POST_PERMISSION]}],
+            error_400_enabled=True,  # exception raised by this method
+            error_404_description="Repository is unknown",
+            schema=ResponseSchema,  # leave empty if no responses here
+            match_schema=PackageNameSchema,
+            query_schema=PaginationSchema,
+            body_schema=RequestSchema(many=True),
        )
-        @aiohttp_apispec.cookies_schema(AuthSchema)  # should be always presented
-        @aiohttp_apispec.match_info_schema(PackageNameSchema)
-        @aiohttp_apispec.querystring_schema(PaginationSchema)
-        @aiohttp_apispec.json_schema(RequestSchema(many=True))
        async def post(self) -> None: ...
    ```

--- a/docker/Dockerfile
+++ b/docker/Dockerfile
@ -108,9 +108,7 @@ RUN cp "/etc/pacman.d/mirrorlist" "/etc/pacman.d/mirrorlist.orig" && \
    sed -i "s/SigLevel *=.*/SigLevel = Optional/g" "/etc/pacman.conf" && \
    pacman -Sy
 ## install package and its optional dependencies
-RUN pacman -S --noconfirm \
-        --assume-installed python-aiohttp-apispec=3.0.0 \
-        ahriman
+RUN pacman -S --noconfirm ahriman
 RUN pacman -S --noconfirm --asdeps \
        python-aioauth-client \
        python-aiohttp-apispec-git \
--- a/docs/_static/architecture.dot
+++ b/docs/_static/architecture.dot
--- a/docs/ahriman.application.rst
+++ b/docs/ahriman.application.rst
@ -29,6 +29,14 @@ ahriman.application.help\_formatter module
   :no-undoc-members:
   :show-inheritance:

+ahriman.application.interactive\_shell module
+---------------------------------------------
+
+.. automodule:: ahriman.application.interactive_shell
+   :members:
+   :no-undoc-members:
+   :show-inheritance:
+
 ahriman.application.lock module
 -------------------------------

--- a/docs/ahriman.core.formatters.rst
+++ b/docs/ahriman.core.formatters.rst
@ -92,6 +92,14 @@ ahriman.core.formatters.repository\_printer module
   :no-undoc-members:
   :show-inheritance:

+ahriman.core.formatters.repository\_stats\_printer module
+---------------------------------------------------------
+
+.. automodule:: ahriman.core.formatters.repository_stats_printer
+   :members:
+   :no-undoc-members:
+   :show-inheritance:
+
 ahriman.core.formatters.status\_printer module
 ----------------------------------------------

--- a/docs/ahriman.models.rst
+++ b/docs/ahriman.models.rst
@ -236,6 +236,14 @@ ahriman.models.repository\_paths module
   :no-undoc-members:
   :show-inheritance:

+ahriman.models.repository\_stats module
+---------------------------------------
+
+.. automodule:: ahriman.models.repository_stats
+   :members:
+   :no-undoc-members:
+   :show-inheritance:
+
 ahriman.models.result module
 ----------------------------

@ -252,6 +260,14 @@ ahriman.models.scan\_paths module
   :no-undoc-members:
   :show-inheritance:

+ahriman.models.series\_statistics module
+----------------------------------------
+
+.. automodule:: ahriman.models.series_statistics
+   :members:
+   :no-undoc-members:
+   :show-inheritance:
+
 ahriman.models.sign\_settings module
 ------------------------------------

--- a/docs/ahriman.web.apispec.rst
+++ b/docs/ahriman.web.apispec.rst
@ -0,0 +1,29 @@
+ahriman.web.apispec package
+===========================
+
+Submodules
+----------
+
+ahriman.web.apispec.decorators module
+-------------------------------------
+
+.. automodule:: ahriman.web.apispec.decorators
+   :members:
+   :no-undoc-members:
+   :show-inheritance:
+
+ahriman.web.apispec.info module
+-------------------------------
+
+.. automodule:: ahriman.web.apispec.info
+   :members:
+   :no-undoc-members:
+   :show-inheritance:
+
+Module contents
+---------------
+
+.. automodule:: ahriman.web.apispec
+   :members:
+   :no-undoc-members:
+   :show-inheritance:
--- a/docs/ahriman.web.rst
+++ b/docs/ahriman.web.rst
@ -7,6 +7,7 @@ Subpackages
 .. toctree::
   :maxdepth: 4

+   ahriman.web.apispec
   ahriman.web.middlewares
   ahriman.web.schemas
   ahriman.web.views
@ -14,14 +15,6 @@ Subpackages
 Submodules
 ----------

-ahriman.web.apispec module
--------------------------
-
-.. automodule:: ahriman.web.apispec
-   :members:
-   :no-undoc-members:
-   :show-inheritance:
-
 ahriman.web.cors module
 -----------------------

--- a/docs/ahriman.web.schemas.rst
+++ b/docs/ahriman.web.schemas.rst
@ -260,6 +260,14 @@ ahriman.web.schemas.repository\_id\_schema module
   :no-undoc-members:
   :show-inheritance:

+ahriman.web.schemas.repository\_stats\_schema module
+----------------------------------------------------
+
+.. automodule:: ahriman.web.schemas.repository_stats_schema
+   :members:
+   :no-undoc-members:
+   :show-inheritance:
+
 ahriman.web.schemas.search\_schema module
 -----------------------------------------

--- a/package/archlinux/PKGBUILD
+++ b/package/archlinux/PKGBUILD
@ -2,7 +2,7 @@

 pkgbase='ahriman'
 pkgname=('ahriman' 'ahriman-core' 'ahriman-triggers' 'ahriman-web')
-pkgver=2.16.0
+pkgver=2.17.1
 pkgrel=1
 pkgdesc="ArcH linux ReposItory MANager"
 arch=('any')
@ -30,6 +30,7 @@ package_ahriman-core() {
    pkgname='ahriman-core'
    optdepends=('ahriman-triggers: additional extensions for the application'
                'ahriman-web: web server'
+                'ipython: an enhanced shell interpreter'
                'python-boto3: sync to s3'
                'python-cerberus: configuration validator'
                'python-matplotlib: usage statistics chart'
@ -71,8 +72,9 @@ package_ahriman-triggers() {
 package_ahriman-web() {
    pkgname='ahriman-web'
    pkgdesc="ArcH linux ReposItory MANager, web server"
-    depends=("$pkgbase-core=$pkgver" 'python-aiohttp-apispec>=3.0.0' 'python-aiohttp-cors' 'python-aiohttp-jinja2')
+    depends=("$pkgbase-core=$pkgver" 'python-aiohttp-cors' 'python-aiohttp-jinja2')
    optdepends=('python-aioauth-client: OAuth2 authorization support'
+                'python-aiohttp-apispec>=3.0.0: autogenerated API documentation'
                'python-aiohttp-security: authorization support'
                'python-aiohttp-session: authorization support'
                'python-cryptography: authorization support')
--- a/package/share/ahriman/settings/ahriman.ini
+++ b/package/share/ahriman/settings/ahriman.ini
@ -7,6 +7,8 @@ logging = ahriman.ini.d/logging.ini
 ;apply_migrations = yes
 ; Path to the application SQLite database.
 database = ${repository:root}/ahriman.db
+; Keep last build logs for each package
+keep_last_logs = 5

 [alpm]
 ; Path to pacman system database cache.
--- a/package/share/ahriman/templates/build-status.jinja2
+++ b/package/share/ahriman/templates/build-status.jinja2
@ -15,7 +15,7 @@

        <div class="container">
            <nav class="navbar navbar-expand-lg">
-                <div class="navbar-brand"><img src="/static/logo.svg" width="30" height="30" alt=""></div>
+                <div class="navbar-brand"><a href="https://github.com/arcan1s/ahriman" title="logo"><img src="/static/logo.svg" width="30" height="30" alt=""></a></div>
                <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#repositories-navbar-supported-content" aria-controls="repositories-navbar-supported-content" aria-expanded="false" aria-label="Toggle navigation">
                    <span class="navbar-toggler-icon"></span>
                </button>
@ -36,7 +36,9 @@

        <div class="container">
            <div id="toolbar" class="dropdown">
-                <a id="badge-status" tabindex="0" role="button" class="btn btn-outline-secondary" data-bs-toggle="popover" data-bs-trigger="focus" data-bs-content="no run data"><i class="bi bi-info-circle"></i></a>
+                <button id="dashboard-button" type="button" class="btn btn-outline-secondary" data-bs-toggle="modal" data-bs-target="#dashboard-modal">
+                    <i class="bi bi-info-circle"></i>
+                </button>

                {% if not auth.enabled or auth.username is not none %}
                    <button type="button" class="btn btn-primary dropdown-toggle" data-bs-toggle="dropdown" aria-expanded="false">
@ -119,7 +121,9 @@
                    <li><a id="badge-version" class="nav-link" href="https://github.com/arcan1s/ahriman" title="sources"><i class="bi bi-github"></i> ahriman</a></li>
                    <li><a class="nav-link" href="https://github.com/arcan1s/ahriman/releases" title="releases list">releases</a></li>
                    <li><a class="nav-link" href="https://github.com/arcan1s/ahriman/issues" title="issues tracker">report a bug</a></li>
-                    <li><a class="nav-link" href="/api-docs" title="API documentation">api</a></li>
+                    {% if docs_enabled %}
+                        <li><a class="nav-link" href="/api-docs" title="API documentation">api</a></li>
+                    {% endif %}
                </ul>

                {% if index_url is not none %}
@ -150,6 +154,7 @@

        {% include "build-status/alerts.jinja2" %}

+        {% include "build-status/dashboard.jinja2" %}
        {% include "build-status/package-add-modal.jinja2" %}
        {% include "build-status/package-rebuild-modal.jinja2" %}
        {% include "build-status/key-import-modal.jinja2" %}
--- a/package/share/ahriman/templates/build-status/dashboard.jinja2
+++ b/package/share/ahriman/templates/build-status/dashboard.jinja2
@ -0,0 +1,76 @@
+<div id="dashboard-modal" tabindex="-1" role="dialog" class="modal fade">
+    <div class="modal-dialog modal-xl" role="document">
+        <div class="modal-content">
+             <div id="dashboard-modal-header" class="modal-header">
+                <h4 class="modal-title">System health</h4>
+                <button type="button" class="btn-close" data-bs-dismiss="modal" aria-label="close"></button>
+            </div>
+            <div class="modal-body">
+                <div class="form-group row mt-2">
+                    <div class="col-4 col-lg-2" style="text-align: right">Repository name</div>
+                    <div id="dashboard-name" class="col-8 col-lg-3"></div>
+                    <div class="col-4 col-lg-2" style="text-align: right">Repository architecture</div>
+                    <div id="dashboard-architecture" class="col-8 col-lg-3"></div>
+                </div>
+
+                <div class="form-group row mt-2">
+                    <div class="col-4 col-lg-2" style="text-align: right">Current status</div>
+                    <div id="dashboard-status" class="col-8 col-lg-3"></div>
+                    <div class="col-4 col-lg-2" style="text-align: right">Updated at</div>
+                    <div id="dashboard-status-timestamp" class="col-8 col-lg-3"></div>
+                </div>
+
+                <div id="dashboard-canvas" class="form-group row mt-2">
+                    <div class="col-8 col-lg-6">
+                        <canvas id="dashboard-packages-count-chart"></canvas>
+                    </div>
+                    <div class="col-8 col-lg-6">
+                        <canvas id="dashboard-packages-statuses-chart"></canvas>
+                    </div>
+                </div>
+            </div>
+            <div class="modal-footer">
+                <button type="button" class="btn btn-primary" data-bs-dismiss="modal"><i class="bi bi-x"></i><span class="d-none d-sm-inline"> close</span></button>
+            </div>
+        </div>
+    </div>
+</div>
+
+<script>
+    const dashboardModal = document.getElementById("dashboard-modal");
+    const dashboardModalHeader = document.getElementById("dashboard-modal-header");
+
+    const dashboardName = document.getElementById("dashboard-name");
+    const dashboardArchitecture = document.getElementById("dashboard-architecture");
+    const dashboardStatus = document.getElementById("dashboard-status");
+    const dashboardStatusTimestamp = document.getElementById("dashboard-status-timestamp");
+
+    const dashboardCanvas = document.getElementById("dashboard-canvas");
+    const dashboardPackagesStatusesChartCanvas = document.getElementById("dashboard-packages-statuses-chart");
+    let dashboardPackagesStatusesChart = null;
+    const dashboardPackagesCountChartCanvas = document.getElementById("dashboard-packages-count-chart");
+    let dashboardPackagesCountChart = null;
+
+    ready(_ => {
+        dashboardPackagesStatusesChart = new Chart(dashboardPackagesStatusesChartCanvas, {
+            type: "pie",
+            data: {},
+            options: {
+                responsive: true,
+            },
+        });
+        dashboardPackagesCountChart = new Chart(dashboardPackagesCountChartCanvas, {
+            type: "bar",
+            data: {},
+            options: {
+                maintainAspectRatio: false,
+                responsive: true,
+                scales: {
+                    x: {
+                        stacked: true,
+                    },
+                },
+            },
+        });
+    });
+</script>
--- a/package/share/ahriman/templates/build-status/package-info-modal.jinja2
+++ b/package/share/ahriman/templates/build-status/package-info-modal.jinja2
@ -296,14 +296,6 @@
    }

    function loadPackage(packageBase, onFailure) {
-        const headerClass = status => {
-            if (status === "pending") return ["bg-warning"];
-            if (status === "building") return ["bg-warning"];
-            if (status === "failed") return ["bg-danger", "text-white"];
-            if (status === "success") return ["bg-success", "text-white"];
-            return ["bg-secondary", "text-white"];
-        };
-
        makeRequest(
            `/api/v1/packages/${packageBase}`,
            {
--- a/package/share/ahriman/templates/build-status/table.jinja2
+++ b/package/share/ahriman/templates/build-status/table.jinja2
@ -7,7 +7,7 @@
    // so far bootstrap-table only operates with jquery elements
    const table = $(document.getElementById("packages"));

-    const statusBadge = document.getElementById("badge-status");
+    const dashboardButton = document.getElementById("dashboard-button");
    const versionBadge = document.getElementById("badge-version");

    function doPackageAction(uri, packages, repository, successText, failureText, data) {
@ -141,14 +141,62 @@
            data => {
                versionBadge.innerHTML = `<i class="bi bi-github"></i> ahriman ${safe(data.version)}`;

-                statusBadge.classList.remove(...statusBadge.classList);
-                statusBadge.classList.add("btn");
-                statusBadge.classList.add(badgeClass(data.status.status));
+                dashboardButton.classList.remove(...dashboardButton.classList);
+                dashboardButton.classList.add("btn");
+                dashboardButton.classList.add(badgeClass(data.status.status));

-                const popover = bootstrap.Popover.getOrCreateInstance(statusBadge);
-                popover.dispose();
-                statusBadge.dataset.bsContent = `${data.status.status} at ${new Date(1000 * data.status.timestamp).toISOStringShort()}`;
-                bootstrap.Popover.getOrCreateInstance(statusBadge);
+                dashboardModalHeader.classList.remove(...dashboardModalHeader.classList);
+                dashboardModalHeader.classList.add("modal-header");
+                headerClass(data.status.status).forEach(clz => dashboardModalHeader.classList.add(clz));
+
+                dashboardName.textContent = data.repository;
+                dashboardArchitecture.textContent = data.architecture;
+                dashboardStatus.textContent = data.status.status;
+                dashboardStatusTimestamp.textContent = new Date(1000 * data.status.timestamp).toISOStringShort();
+
+                if (dashboardPackagesStatusesChart) {
+                    const labels = [
+                        "unknown",
+                        "pending",
+                        "building",
+                        "failed",
+                        "success",
+                    ];
+                    dashboardPackagesStatusesChart.config.data = {
+                        labels: labels,
+                        datasets: [{
+                            label: "packages in status",
+                            data: labels.map(label => data.packages[label]),
+                            backgroundColor: [
+                                "rgb(55, 58, 60)",
+                                "rgb(255, 117, 24)",
+                                "rgb(255, 117, 24)",
+                                "rgb(255, 0, 57)",
+                                "rgb(63, 182, 24)",  // copy-paste from current style
+                            ],
+                        }],
+                    };
+                    dashboardPackagesStatusesChart.update();
+                }
+
+                if (dashboardPackagesCountChart) {
+                    dashboardPackagesCountChart.config.data = {
+                        labels: ["packages"],
+                        datasets: [
+                            {
+                                label: "archives",
+                                data: [data.stats.packages],
+                            },
+                            {
+                                label: "bases",
+                                data: [data.stats.bases],
+                            },
+                        ],
+                    };
+                    dashboardPackagesCountChart.update();
+                }
+
+                dashboardCanvas.hidden = data.status.total > 0;
            },
        );
    }
@ -227,7 +275,6 @@
            });
        });

-        bootstrap.Popover.getOrCreateInstance(statusBadge);
        selectRepository();
    });
 </script>
--- a/package/share/ahriman/templates/utils/bootstrap-scripts.jinja2
+++ b/package/share/ahriman/templates/utils/bootstrap-scripts.jinja2
@ -58,6 +58,14 @@
        return value.includes(dataList[index].toLowerCase());
    }

+    function headerClass(status) {
+        if (status === "pending") return ["bg-warning"];
+        if (status === "building") return ["bg-warning"];
+        if (status === "failed") return ["bg-danger", "text-white"];
+        if (status === "success") return ["bg-success", "text-white"];
+        return ["bg-secondary", "text-white"];
+    }
+
    function listToTable(data) {
        return Array.from(new Set(data))
            .sort()
--- a/package/share/bash-completion/completions/_ahriman
+++ b/package/share/bash-completion/completions/_ahriman
@ -64,10 +64,10 @@ _shtab_ahriman_service_key_import_option_strings=('-h' '--help' '--key-server')
 _shtab_ahriman_service_repositories_option_strings=('-h' '--help' '--id-only' '--no-id-only')
 _shtab_ahriman_service_run_option_strings=('-h' '--help')
 _shtab_ahriman_service_setup_option_strings=('-h' '--help' '--build-as-user' '--from-configuration' '--generate-salt' '--no-generate-salt' '--makeflags-jobs' '--no-makeflags-jobs' '--mirror' '--multilib' '--no-multilib' '--packager' '--server' '--sign-key' '--sign-target' '--web-port' '--web-unix-socket')
-_shtab_ahriman_service_shell_option_strings=('-h' '--help')
+_shtab_ahriman_service_shell_option_strings=('-h' '--help' '-o' '--output')
 _shtab_ahriman_service_tree_migrate_option_strings=('-h' '--help')
 _shtab_ahriman_setup_option_strings=('-h' '--help' '--build-as-user' '--from-configuration' '--generate-salt' '--no-generate-salt' '--makeflags-jobs' '--no-makeflags-jobs' '--mirror' '--multilib' '--no-multilib' '--packager' '--server' '--sign-key' '--sign-target' '--web-port' '--web-unix-socket')
-_shtab_ahriman_shell_option_strings=('-h' '--help')
+_shtab_ahriman_shell_option_strings=('-h' '--help' '-o' '--output')
 _shtab_ahriman_sign_option_strings=('-h' '--help')
 _shtab_ahriman_status_option_strings=('-h' '--help' '--ahriman' '-e' '--exit-code' '--info' '--no-info' '-s' '--status')
 _shtab_ahriman_status_update_option_strings=('-h' '--help' '-s' '--status')
--- a/package/share/man/man1/ahriman.1
+++ b/package/share/man/man1/ahriman.1
@ -1,4 +1,4 @@
-.TH AHRIMAN "1" "2024\-12\-01" "ahriman" "Generated Python Manual"
+.TH AHRIMAN "1" "2025\-01\-05" "ahriman" "Generated Python Manual"
 .SH NAME
 ahriman
 .SH SYNOPSIS
@ -940,7 +940,7 @@ port of the web service
 path to unix socket used for interprocess communications

 .SH COMMAND \fI\,'ahriman service\-shell'\/\fR
-usage: ahriman service\-shell [\-h] [code]
+usage: ahriman service\-shell [\-h] [\-o OUTPUT] [code]

 drop into python shell

@ -948,6 +948,11 @@ drop into python shell
 \fBcode\fR
 instead of dropping into shell, just execute the specified code

+.SH OPTIONS \fI\,'ahriman service\-shell'\/\fR
+.TP
+\fB\-o\fR \fI\,OUTPUT\/\fR, \fB\-\-output\fR \fI\,OUTPUT\/\fR
+output commands and result to the file
+
 .SH COMMAND \fI\,'ahriman service\-tree\-migrate'\/\fR
 usage: ahriman service\-tree\-migrate [\-h]

--- a/package/share/zsh/site-functions/_ahriman
+++ b/package/share/zsh/site-functions/_ahriman
@ -583,6 +583,7 @@ _shtab_ahriman_service_setup_options=(

 _shtab_ahriman_service_shell_options=(
  "(- : *)"{-h,--help}"[show this help message and exit]"
+  {-o,--output}"[output commands and result to the file (default\: None)]:output:"
  ":instead of dropping into shell, just execute the specified code (default\: None):"
 )

@ -608,6 +609,7 @@ _shtab_ahriman_setup_options=(

 _shtab_ahriman_shell_options=(
  "(- : *)"{-h,--help}"[show this help message and exit]"
+  {-o,--output}"[output commands and result to the file (default\: None)]:output:"
  ":instead of dropping into shell, just execute the specified code (default\: None):"
 )

--- a/pyproject.toml
+++ b/pyproject.toml
@ -60,6 +60,9 @@ pacman = [
 s3 = [
    "boto3",
 ]
+shell = [
+    "IPython"
+]
 stats = [
    "matplotlib",
 ]
--- a/src/ahriman/init.py
+++ b/src/ahriman/init.py
@ -1,5 +1,5 @@
 #
-# Copyright (c) 2021-2024 ahriman team.
+# Copyright (c) 2021-2025 ahriman team.
 #
 # This file is part of ahriman
 # (see https://github.com/arcan1s/ahriman).
@ -17,4 +17,4 @@
 # You should have received a copy of the GNU General Public License
 # along with this program. If not, see <http://www.gnu.org/licenses/>.
 #
-__version__ = "2.16.0"
+__version__ = "2.17.1"
--- a/src/ahriman/application/init.py
+++ b/src/ahriman/application/init.py
@ -1,5 +1,5 @@
 #
-# Copyright (c) 2021-2024 ahriman team.
+# Copyright (c) 2021-2025 ahriman team.
 #
 # This file is part of ahriman
 # (see https://github.com/arcan1s/ahriman).
--- a/src/ahriman/application/ahriman.py
+++ b/src/ahriman/application/ahriman.py
@ -1,5 +1,5 @@
 #
-# Copyright (c) 2021-2024 ahriman team.
+# Copyright (c) 2021-2025 ahriman team.
 #
 # This file is part of ahriman
 # (see https://github.com/arcan1s/ahriman).
--- a/src/ahriman/application/application/init.py
+++ b/src/ahriman/application/application/init.py
@ -1,5 +1,5 @@
 #
-# Copyright (c) 2021-2024 ahriman team.
+# Copyright (c) 2021-2025 ahriman team.
 #
 # This file is part of ahriman
 # (see https://github.com/arcan1s/ahriman).
--- a/src/ahriman/application/application/application.py
+++ b/src/ahriman/application/application/application.py
@ -1,5 +1,5 @@
 #
-# Copyright (c) 2021-2024 ahriman team.
+# Copyright (c) 2021-2025 ahriman team.
 #
 # This file is part of ahriman
 # (see https://github.com/arcan1s/ahriman).
--- a/src/ahriman/application/application/application_packages.py
+++ b/src/ahriman/application/application/application_packages.py
@ -1,5 +1,5 @@
 #
-# Copyright (c) 2021-2024 ahriman team.
+# Copyright (c) 2021-2025 ahriman team.
 #
 # This file is part of ahriman
 # (see https://github.com/arcan1s/ahriman).
--- a/src/ahriman/application/application/application_properties.py
+++ b/src/ahriman/application/application/application_properties.py
@ -1,5 +1,5 @@
 #
-# Copyright (c) 2021-2024 ahriman team.
+# Copyright (c) 2021-2025 ahriman team.
 #
 # This file is part of ahriman
 # (see https://github.com/arcan1s/ahriman).
--- a/src/ahriman/application/application/application_repository.py
+++ b/src/ahriman/application/application/application_repository.py
@ -1,5 +1,5 @@
 #
-# Copyright (c) 2021-2024 ahriman team.
+# Copyright (c) 2021-2025 ahriman team.
 #
 # This file is part of ahriman
 # (see https://github.com/arcan1s/ahriman).
--- a/src/ahriman/application/application/updates_iterator.py
+++ b/src/ahriman/application/application/updates_iterator.py
@ -1,5 +1,5 @@
 #
-# Copyright (c) 2021-2024 ahriman team.
+# Copyright (c) 2021-2025 ahriman team.
 #
 # This file is part of ahriman
 # (see https://github.com/arcan1s/ahriman).
--- a/src/ahriman/application/application/workers/init.py
+++ b/src/ahriman/application/application/workers/init.py
@ -1,5 +1,5 @@
 #
-# Copyright (c) 2021-2024 ahriman team.
+# Copyright (c) 2021-2025 ahriman team.
 #
 # This file is part of ahriman
 # (see https://github.com/arcan1s/ahriman).
--- a/src/ahriman/application/application/workers/local_updater.py
+++ b/src/ahriman/application/application/workers/local_updater.py
@ -1,5 +1,5 @@
 #
-# Copyright (c) 2021-2024 ahriman team.
+# Copyright (c) 2021-2025 ahriman team.
 #
 # This file is part of ahriman
 # (see https://github.com/arcan1s/ahriman).
--- a/src/ahriman/application/application/workers/remote_updater.py
+++ b/src/ahriman/application/application/workers/remote_updater.py
@ -1,5 +1,5 @@
 #
-# Copyright (c) 2021-2024 ahriman team.
+# Copyright (c) 2021-2025 ahriman team.
 #
 # This file is part of ahriman
 # (see https://github.com/arcan1s/ahriman).
--- a/src/ahriman/application/application/workers/updater.py
+++ b/src/ahriman/application/application/workers/updater.py
@ -1,5 +1,5 @@
 #
-# Copyright (c) 2021-2024 ahriman team.
+# Copyright (c) 2021-2025 ahriman team.
 #
 # This file is part of ahriman
 # (see https://github.com/arcan1s/ahriman).
--- a/src/ahriman/application/handlers/init.py
+++ b/src/ahriman/application/handlers/init.py
@ -1,5 +1,5 @@
 #
-# Copyright (c) 2021-2024 ahriman team.
+# Copyright (c) 2021-2025 ahriman team.
 #
 # This file is part of ahriman
 # (see https://github.com/arcan1s/ahriman).
--- a/src/ahriman/application/handlers/add.py
+++ b/src/ahriman/application/handlers/add.py
@ -1,5 +1,5 @@
 #
-# Copyright (c) 2021-2024 ahriman team.
+# Copyright (c) 2021-2025 ahriman team.
 #
 # This file is part of ahriman
 # (see https://github.com/arcan1s/ahriman).
--- a/src/ahriman/application/handlers/backup.py
+++ b/src/ahriman/application/handlers/backup.py
@ -1,5 +1,5 @@
 #
-# Copyright (c) 2021-2024 ahriman team.
+# Copyright (c) 2021-2025 ahriman team.
 #
 # This file is part of ahriman
 # (see https://github.com/arcan1s/ahriman).
--- a/src/ahriman/application/handlers/change.py
+++ b/src/ahriman/application/handlers/change.py
@ -1,5 +1,5 @@
 #
-# Copyright (c) 2021-2024 ahriman team.
+# Copyright (c) 2021-2025 ahriman team.
 #
 # This file is part of ahriman
 # (see https://github.com/arcan1s/ahriman).
--- a/src/ahriman/application/handlers/clean.py
+++ b/src/ahriman/application/handlers/clean.py
@ -1,5 +1,5 @@
 #
-# Copyright (c) 2021-2024 ahriman team.
+# Copyright (c) 2021-2025 ahriman team.
 #
 # This file is part of ahriman
 # (see https://github.com/arcan1s/ahriman).
--- a/src/ahriman/application/handlers/copy.py
+++ b/src/ahriman/application/handlers/copy.py
@ -1,5 +1,5 @@
 #
-# Copyright (c) 2021-2024 ahriman team.
+# Copyright (c) 2021-2025 ahriman team.
 #
 # This file is part of ahriman
 # (see https://github.com/arcan1s/ahriman).
--- a/src/ahriman/application/handlers/daemon.py
+++ b/src/ahriman/application/handlers/daemon.py
@ -1,5 +1,5 @@
 #
-# Copyright (c) 2021-2024 ahriman team.
+# Copyright (c) 2021-2025 ahriman team.
 #
 # This file is part of ahriman
 # (see https://github.com/arcan1s/ahriman).
--- a/src/ahriman/application/handlers/dump.py
+++ b/src/ahriman/application/handlers/dump.py
@ -1,5 +1,5 @@
 #
-# Copyright (c) 2021-2024 ahriman team.
+# Copyright (c) 2021-2025 ahriman team.
 #
 # This file is part of ahriman
 # (see https://github.com/arcan1s/ahriman).
--- a/src/ahriman/application/handlers/handler.py
+++ b/src/ahriman/application/handlers/handler.py
@ -1,5 +1,5 @@
 #
-# Copyright (c) 2021-2024 ahriman team.
+# Copyright (c) 2021-2025 ahriman team.
 #
 # This file is part of ahriman
 # (see https://github.com/arcan1s/ahriman).
--- a/src/ahriman/application/handlers/help.py
+++ b/src/ahriman/application/handlers/help.py
@ -1,5 +1,5 @@
 #
-# Copyright (c) 2021-2024 ahriman team.
+# Copyright (c) 2021-2025 ahriman team.
 #
 # This file is part of ahriman
 # (see https://github.com/arcan1s/ahriman).
--- a/src/ahriman/application/handlers/key_import.py
+++ b/src/ahriman/application/handlers/key_import.py
@ -1,5 +1,5 @@
 #
-# Copyright (c) 2021-2024 ahriman team.
+# Copyright (c) 2021-2025 ahriman team.
 #
 # This file is part of ahriman
 # (see https://github.com/arcan1s/ahriman).
--- a/src/ahriman/application/handlers/patch.py
+++ b/src/ahriman/application/handlers/patch.py
@ -1,5 +1,5 @@
 #
-# Copyright (c) 2021-2024 ahriman team.
+# Copyright (c) 2021-2025 ahriman team.
 #
 # This file is part of ahriman
 # (see https://github.com/arcan1s/ahriman).
--- a/src/ahriman/application/handlers/rebuild.py
+++ b/src/ahriman/application/handlers/rebuild.py
@ -1,5 +1,5 @@
 #
-# Copyright (c) 2021-2024 ahriman team.
+# Copyright (c) 2021-2025 ahriman team.
 #
 # This file is part of ahriman
 # (see https://github.com/arcan1s/ahriman).
--- a/src/ahriman/application/handlers/remove.py
+++ b/src/ahriman/application/handlers/remove.py
@ -1,5 +1,5 @@
 #
-# Copyright (c) 2021-2024 ahriman team.
+# Copyright (c) 2021-2025 ahriman team.
 #
 # This file is part of ahriman
 # (see https://github.com/arcan1s/ahriman).
--- a/src/ahriman/application/handlers/remove_unknown.py
+++ b/src/ahriman/application/handlers/remove_unknown.py
@ -1,5 +1,5 @@
 #
-# Copyright (c) 2021-2024 ahriman team.
+# Copyright (c) 2021-2025 ahriman team.
 #
 # This file is part of ahriman
 # (see https://github.com/arcan1s/ahriman).
--- a/src/ahriman/application/handlers/repositories.py
+++ b/src/ahriman/application/handlers/repositories.py
@ -1,5 +1,5 @@
 #
-# Copyright (c) 2021-2024 ahriman team.
+# Copyright (c) 2021-2025 ahriman team.
 #
 # This file is part of ahriman
 # (see https://github.com/arcan1s/ahriman).
--- a/src/ahriman/application/handlers/restore.py
+++ b/src/ahriman/application/handlers/restore.py
@ -1,5 +1,5 @@
 #
-# Copyright (c) 2021-2024 ahriman team.
+# Copyright (c) 2021-2025 ahriman team.
 #
 # This file is part of ahriman
 # (see https://github.com/arcan1s/ahriman).
--- a/src/ahriman/application/handlers/run.py
+++ b/src/ahriman/application/handlers/run.py
@ -1,5 +1,5 @@
 #
-# Copyright (c) 2021-2024 ahriman team.
+# Copyright (c) 2021-2025 ahriman team.
 #
 # This file is part of ahriman
 # (see https://github.com/arcan1s/ahriman).
--- a/src/ahriman/application/handlers/search.py
+++ b/src/ahriman/application/handlers/search.py
@ -1,5 +1,5 @@
 #
-# Copyright (c) 2021-2024 ahriman team.
+# Copyright (c) 2021-2025 ahriman team.
 #
 # This file is part of ahriman
 # (see https://github.com/arcan1s/ahriman).
--- a/src/ahriman/application/handlers/service_updates.py
+++ b/src/ahriman/application/handlers/service_updates.py
@ -1,5 +1,5 @@
 #
-# Copyright (c) 2021-2024 ahriman team.
+# Copyright (c) 2021-2025 ahriman team.
 #
 # This file is part of ahriman
 # (see https://github.com/arcan1s/ahriman).
--- a/src/ahriman/application/handlers/setup.py
+++ b/src/ahriman/application/handlers/setup.py
@ -1,5 +1,5 @@
 #
-# Copyright (c) 2021-2024 ahriman team.
+# Copyright (c) 2021-2025 ahriman team.
 #
 # This file is part of ahriman
 # (see https://github.com/arcan1s/ahriman).
--- a/src/ahriman/application/handlers/shell.py
+++ b/src/ahriman/application/handlers/shell.py
@ -1,5 +1,5 @@
 #
-# Copyright (c) 2021-2024 ahriman team.
+# Copyright (c) 2021-2025 ahriman team.
 #
 # This file is part of ahriman
 # (see https://github.com/arcan1s/ahriman).
@ -18,12 +18,12 @@
 # along with this program. If not, see <http://www.gnu.org/licenses/>.
 #
 import argparse
-import code
 import sys

 from pathlib import Path

 from ahriman.application.handlers.handler import Handler, SubParserAction
+from ahriman.application.interactive_shell import InteractiveShell
 from ahriman.core.configuration import Configuration
 from ahriman.core.formatters import StringPrinter
 from ahriman.models.repository_id import RepositoryId
@ -58,11 +58,13 @@ class Shell(Handler):
            "configuration": configuration,
            "repository_id": repository_id,
        }
+        console = InteractiveShell(locals=local_variables)

-        if args.code is None:
-            code.interact(local=local_variables)
-        else:
-            code.InteractiveConsole(locals=local_variables).runcode(args.code)
+        match args.code:
+            case None:
+                console.interact()
+            case snippet:
+                console.runcode(snippet)

    @staticmethod
    def _set_service_shell_parser(root: SubParserAction) -> argparse.ArgumentParser:
@ -79,6 +81,7 @@ class Shell(Handler):
                                 description="drop into python shell")
        parser.add_argument("code", help="instead of dropping into shell, just execute the specified code", nargs="?")
        parser.add_argument("-v", "--verbose", help=argparse.SUPPRESS, action="store_true")
+        parser.add_argument("-o", "--output", help="output commands and result to the file", type=Path)
        parser.set_defaults(lock=None, report=False)
        return parser

--- a/src/ahriman/application/handlers/sign.py
+++ b/src/ahriman/application/handlers/sign.py
@ -1,5 +1,5 @@
 #
-# Copyright (c) 2021-2024 ahriman team.
+# Copyright (c) 2021-2025 ahriman team.
 #
 # This file is part of ahriman
 # (see https://github.com/arcan1s/ahriman).
--- a/src/ahriman/application/handlers/statistics.py
+++ b/src/ahriman/application/handlers/statistics.py
@ -1,5 +1,5 @@
 #
-# Copyright (c) 2021-2024 ahriman team.
+# Copyright (c) 2021-2025 ahriman team.
 #
 # This file is part of ahriman
 # (see https://github.com/arcan1s/ahriman).
@ -27,7 +27,7 @@ from pathlib import Path
 from ahriman.application.application import Application
 from ahriman.application.handlers.handler import Handler, SubParserAction
 from ahriman.core.configuration import Configuration
-from ahriman.core.formatters import EventStatsPrinter, PackageStatsPrinter
+from ahriman.core.formatters import EventStatsPrinter, PackageStatsPrinter, RepositoryStatsPrinter
 from ahriman.core.utils import enum_values, pretty_datetime
 from ahriman.models.event import Event, EventType
 from ahriman.models.repository_id import RepositoryId
@ -64,6 +64,7 @@ class Statistics(Handler):

        match args.package:
            case None:
+                RepositoryStatsPrinter(repository_id, application.reporter.statistics())(verbose=True)
                Statistics.stats_per_package(args.event, events, args.chart)
            case _:
                Statistics.stats_for_package(args.event, events, args.chart)
--- a/src/ahriman/application/handlers/status.py
+++ b/src/ahriman/application/handlers/status.py
@ -1,5 +1,5 @@
 #
-# Copyright (c) 2021-2024 ahriman team.
+# Copyright (c) 2021-2025 ahriman team.
 #
 # This file is part of ahriman
 # (see https://github.com/arcan1s/ahriman).
--- a/src/ahriman/application/handlers/status_update.py
+++ b/src/ahriman/application/handlers/status_update.py
@ -1,5 +1,5 @@
 #
-# Copyright (c) 2021-2024 ahriman team.
+# Copyright (c) 2021-2025 ahriman team.
 #
 # This file is part of ahriman
 # (see https://github.com/arcan1s/ahriman).
--- a/src/ahriman/application/handlers/structure.py
+++ b/src/ahriman/application/handlers/structure.py
@ -1,5 +1,5 @@
 #
-# Copyright (c) 2021-2024 ahriman team.
+# Copyright (c) 2021-2025 ahriman team.
 #
 # This file is part of ahriman
 # (see https://github.com/arcan1s/ahriman).
--- a/src/ahriman/application/handlers/tree_migrate.py
+++ b/src/ahriman/application/handlers/tree_migrate.py
@ -1,5 +1,5 @@
 #
-# Copyright (c) 2021-2024 ahriman team.
+# Copyright (c) 2021-2025 ahriman team.
 #
 # This file is part of ahriman
 # (see https://github.com/arcan1s/ahriman).
--- a/src/ahriman/application/handlers/triggers.py
+++ b/src/ahriman/application/handlers/triggers.py
@ -1,5 +1,5 @@
 #
-# Copyright (c) 2021-2024 ahriman team.
+# Copyright (c) 2021-2025 ahriman team.
 #
 # This file is part of ahriman
 # (see https://github.com/arcan1s/ahriman).
--- a/src/ahriman/application/handlers/triggers_support.py
+++ b/src/ahriman/application/handlers/triggers_support.py
@ -1,5 +1,5 @@
 #
-# Copyright (c) 2021-2024 ahriman team.
+# Copyright (c) 2021-2025 ahriman team.
 #
 # This file is part of ahriman
 # (see https://github.com/arcan1s/ahriman).
--- a/src/ahriman/application/handlers/unsafe_commands.py
+++ b/src/ahriman/application/handlers/unsafe_commands.py
@ -1,5 +1,5 @@
 #
-# Copyright (c) 2021-2024 ahriman team.
+# Copyright (c) 2021-2025 ahriman team.
 #
 # This file is part of ahriman
 # (see https://github.com/arcan1s/ahriman).
--- a/src/ahriman/application/handlers/update.py
+++ b/src/ahriman/application/handlers/update.py
@ -1,5 +1,5 @@
 #
-# Copyright (c) 2021-2024 ahriman team.
+# Copyright (c) 2021-2025 ahriman team.
 #
 # This file is part of ahriman
 # (see https://github.com/arcan1s/ahriman).
--- a/src/ahriman/application/handlers/users.py
+++ b/src/ahriman/application/handlers/users.py
@ -1,5 +1,5 @@
 #
-# Copyright (c) 2021-2024 ahriman team.
+# Copyright (c) 2021-2025 ahriman team.
 #
 # This file is part of ahriman
 # (see https://github.com/arcan1s/ahriman).
--- a/src/ahriman/application/handlers/validate.py
+++ b/src/ahriman/application/handlers/validate.py
@ -1,5 +1,5 @@
 #
-# Copyright (c) 2021-2024 ahriman team.
+# Copyright (c) 2021-2025 ahriman team.
 #
 # This file is part of ahriman
 # (see https://github.com/arcan1s/ahriman).
--- a/src/ahriman/application/handlers/versions.py
+++ b/src/ahriman/application/handlers/versions.py
@ -1,5 +1,5 @@
 #
-# Copyright (c) 2021-2024 ahriman team.
+# Copyright (c) 2021-2025 ahriman team.
 #
 # This file is part of ahriman
 # (see https://github.com/arcan1s/ahriman).
--- a/src/ahriman/application/handlers/web.py
+++ b/src/ahriman/application/handlers/web.py
@ -1,5 +1,5 @@
 #
-# Copyright (c) 2021-2024 ahriman team.
+# Copyright (c) 2021-2025 ahriman team.
 #
 # This file is part of ahriman
 # (see https://github.com/arcan1s/ahriman).
--- a/src/ahriman/application/help_formatter.py
+++ b/src/ahriman/application/help_formatter.py
@ -1,5 +1,5 @@
 #
-# Copyright (c) 2021-2024 ahriman team.
+# Copyright (c) 2021-2025 ahriman team.
 #
 # This file is part of ahriman
 # (see https://github.com/arcan1s/ahriman).
--- a/src/ahriman/application/interactive_shell.py
+++ b/src/ahriman/application/interactive_shell.py
@ -0,0 +1,60 @@
+#
+# Copyright (c) 2021-2025 ahriman team.
+#
+# This file is part of ahriman
+# (see https://github.com/arcan1s/ahriman).
+#
+# This program is free software: you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with this program. If not, see <http://www.gnu.org/licenses/>.
+#
+from code import InteractiveConsole
+from importlib.util import find_spec
+from typing import Any
+
+
+class InteractiveShell(InteractiveConsole):
+    """
+    wrapper around :class:`code.InteractiveConsole` to pass :func:`interact()` to IPython shell
+    """
+
+    @staticmethod
+    def has_ipython() -> bool:
+        """
+        check if IPython shell is available
+
+        Returns:
+            bool: ``True`` if IPython shell is available, ``False`` otherwise
+        """
+        try:
+            return find_spec("IPython.terminal.embed") is not None
+        except ModuleNotFoundError:
+            return False
+
+    def interact(self, *args: Any, **kwargs: Any) -> None:
+        """
+        pass controller to IPython shell
+
+        Args:
+            *args(Any): positional arguments
+            **kwargs(Any): keyword arguments
+        """
+        if self.has_ipython():
+            from IPython.terminal.embed import InteractiveShellEmbed
+
+            shell = InteractiveShellEmbed(user_ns=self.locals)  # type: ignore[no-untyped-call]
+            shell.show_banner()  # type: ignore[no-untyped-call]
+            shell.interact()  # type: ignore[no-untyped-call]
+        else:
+            # fallback to default
+            import readline  # pylint: disable=unused-import
+            InteractiveConsole.interact(self, *args, **kwargs)
--- a/src/ahriman/application/lock.py
+++ b/src/ahriman/application/lock.py
@ -1,5 +1,5 @@
 #
-# Copyright (c) 2021-2024 ahriman team.
+# Copyright (c) 2021-2025 ahriman team.
 #
 # This file is part of ahriman
 # (see https://github.com/arcan1s/ahriman).
--- a/src/ahriman/core/init.py
+++ b/src/ahriman/core/init.py
@ -1,5 +1,5 @@
 #
-# Copyright (c) 2021-2024 ahriman team.
+# Copyright (c) 2021-2025 ahriman team.
 #
 # This file is part of ahriman
 # (see https://github.com/arcan1s/ahriman).
--- a/src/ahriman/core/alpm/init.py
+++ b/src/ahriman/core/alpm/init.py
@ -1,5 +1,5 @@
 #
-# Copyright (c) 2021-2024 ahriman team.
+# Copyright (c) 2021-2025 ahriman team.
 #
 # This file is part of ahriman
 # (see https://github.com/arcan1s/ahriman).
--- a/src/ahriman/core/alpm/pacman.py
+++ b/src/ahriman/core/alpm/pacman.py
@ -1,5 +1,5 @@
 #
-# Copyright (c) 2021-2024 ahriman team.
+# Copyright (c) 2021-2025 ahriman team.
 #
 # This file is part of ahriman
 # (see https://github.com/arcan1s/ahriman).
--- a/src/ahriman/core/alpm/pacman_database.py
+++ b/src/ahriman/core/alpm/pacman_database.py
@ -1,5 +1,5 @@
 #
-# Copyright (c) 2021-2024 ahriman team.
+# Copyright (c) 2021-2025 ahriman team.
 #
 # This file is part of ahriman
 # (see https://github.com/arcan1s/ahriman).
--- a/src/ahriman/core/alpm/pkgbuild_parser.py
+++ b/src/ahriman/core/alpm/pkgbuild_parser.py
@ -1,5 +1,5 @@
 #
-# Copyright (c) 2021-2024 ahriman team.
+# Copyright (c) 2021-2025 ahriman team.
 #
 # This file is part of ahriman
 # (see https://github.com/arcan1s/ahriman).
@ -41,6 +41,7 @@ class PkgbuildToken(StrEnum):
        FunctionDeclaration(PkgbuildToken): (class attribute) function declaration token
        FunctionEnds(PkgbuildToken): (class attribute) function ends token
        FunctionStarts(PkgbuildToken): (class attribute) function starts token
+        NewLine(PkgbuildToken): (class attribute) new line token
    """

    ArrayStarts = "("
@ -54,6 +55,8 @@ class PkgbuildToken(StrEnum):
    FunctionStarts = "{"
    FunctionEnds = "}"

+    NewLine = "\n"
+

 class PkgbuildParser(shlex.shlex):
    """
@ -174,31 +177,18 @@ class PkgbuildParser(shlex.shlex):
        Returns:
            bool: ``True`` if the previous element of the stream is a quote or escaped and ``False`` otherwise
        """
-        # wrapper around reading utf symbols from random position of the stream
-        def read_last() -> tuple[int, str]:
-            while (position := self._io.tell()) > 0:
-                try:
-                    return position, self._io.read(1)
-                except UnicodeDecodeError:
-                    self._io.seek(position - 1)
-
-            raise PkgbuildParserError("reached starting position, no valid symbols found")
-
        current_position = self._io.tell()

        last_char = penultimate_char = None
        index = current_position - 1
        while index > 0:
-            self._io.seek(index)
-
-            index, last_char = read_last()
+            index, last_char = self._read_last(index)
            if last_char.isspace():
                index -= 1
                continue

            if index > 1:
-                self._io.seek(index - 1)
-                _, penultimate_char = read_last()
+                _, penultimate_char = self._read_last(index - 1)

            break

@ -227,7 +217,7 @@ class PkgbuildParser(shlex.shlex):
                    case PkgbuildToken.ArrayEnds:
                        break
                    case comment if comment.startswith(PkgbuildToken.Comment):
-                        self.instream.readline()
+                        self._read_comment()
                        continue

                yield token
@ -268,7 +258,7 @@ class PkgbuildParser(shlex.shlex):
                    if counter == 0:
                        break
                case comment if comment.startswith(PkgbuildToken.Comment):
-                    self.instream.readline()
+                    self._read_comment()

        if not 0 < start_position < end_position:
            raise PkgbuildParserError("function body wasn't found")
@ -304,7 +294,7 @@ class PkgbuildParser(shlex.shlex):
            return

        if token.startswith(PkgbuildToken.Comment):
-            self.instream.readline()
+            self._read_comment()
            return

        match self.get_token():
@ -332,6 +322,44 @@ class PkgbuildParser(shlex.shlex):
            case other if other is not None:
                yield from self._parse_token(other)

+    def _read_comment(self) -> None:
+        """
+        read comment from the current position. This method doesn't check comment itself, just read the stream
+        until the comment line ends
+        """
+        _, last_symbol = self._read_last()
+        if last_symbol != PkgbuildToken.NewLine:
+            self.instream.readline()
+
+    def _read_last(self, initial_index: int | None = None) -> tuple[int, str]:
+        """
+        wrapper around read to read the last symbol from the input stream. This method is designed to process UTF-8
+        symbols correctly. This method does not reset current stream position
+
+        Args:
+            initial_index(int | None, optional): initial index to start reading from. If none set, the previous position
+                will be used (Default value = None)
+
+        Returns:
+            tuple[int, str]: last symbol and its position in the stream
+
+        Raises:
+            PkgbuildParserError: in case if stream reached starting position, but no valid symbols were found
+        """
+        if initial_index is None:
+            initial_index = self._io.tell() - 1
+        if initial_index < 0:
+            raise PkgbuildParserError("stream is on starting position")
+        self._io.seek(initial_index)
+
+        while (position := self._io.tell()) > 0:
+            try:
+                return position, self._io.read(1)
+            except UnicodeDecodeError:
+                self._io.seek(position - 1)
+
+        raise PkgbuildParserError("reached starting position, no valid symbols found")
+
    def parse(self) -> Generator[PkgbuildPatch, None, None]:
        """
        parse source stream and yield parsed entries
--- a/src/ahriman/core/alpm/remote/init.py
+++ b/src/ahriman/core/alpm/remote/init.py
@ -1,5 +1,5 @@
 #
-# Copyright (c) 2021-2024 ahriman team.
+# Copyright (c) 2021-2025 ahriman team.
 #
 # This file is part of ahriman
 # (see https://github.com/arcan1s/ahriman).
--- a/src/ahriman/core/alpm/remote/aur.py
+++ b/src/ahriman/core/alpm/remote/aur.py
@ -1,5 +1,5 @@
 #
-# Copyright (c) 2021-2024 ahriman team.
+# Copyright (c) 2021-2025 ahriman team.
 #
 # This file is part of ahriman
 # (see https://github.com/arcan1s/ahriman).
--- a/src/ahriman/core/alpm/remote/official.py
+++ b/src/ahriman/core/alpm/remote/official.py
@ -1,5 +1,5 @@
 #
-# Copyright (c) 2021-2024 ahriman team.
+# Copyright (c) 2021-2025 ahriman team.
 #
 # This file is part of ahriman
 # (see https://github.com/arcan1s/ahriman).
--- a/src/ahriman/core/alpm/remote/official_syncdb.py
+++ b/src/ahriman/core/alpm/remote/official_syncdb.py
@ -1,5 +1,5 @@
 #
-# Copyright (c) 2021-2024 ahriman team.
+# Copyright (c) 2021-2025 ahriman team.
 #
 # This file is part of ahriman
 # (see https://github.com/arcan1s/ahriman).
--- a/src/ahriman/core/alpm/remote/remote.py
+++ b/src/ahriman/core/alpm/remote/remote.py
@ -1,5 +1,5 @@
 #
-# Copyright (c) 2021-2024 ahriman team.
+# Copyright (c) 2021-2025 ahriman team.
 #
 # This file is part of ahriman
 # (see https://github.com/arcan1s/ahriman).
--- a/src/ahriman/core/alpm/repo.py
+++ b/src/ahriman/core/alpm/repo.py
@ -1,5 +1,5 @@
 #
-# Copyright (c) 2021-2024 ahriman team.
+# Copyright (c) 2021-2025 ahriman team.
 #
 # This file is part of ahriman
 # (see https://github.com/arcan1s/ahriman).
--- a/src/ahriman/core/auth/init.py
+++ b/src/ahriman/core/auth/init.py
@ -1,5 +1,5 @@
 #
-# Copyright (c) 2021-2024 ahriman team.
+# Copyright (c) 2021-2025 ahriman team.
 #
 # This file is part of ahriman
 # (see https://github.com/arcan1s/ahriman).
--- a/src/ahriman/core/auth/auth.py
+++ b/src/ahriman/core/auth/auth.py
@ -1,5 +1,5 @@
 #
-# Copyright (c) 2021-2024 ahriman team.
+# Copyright (c) 2021-2025 ahriman team.
 #
 # This file is part of ahriman
 # (see https://github.com/arcan1s/ahriman).
--- a/src/ahriman/core/auth/helpers.py
+++ b/src/ahriman/core/auth/helpers.py
@ -1,5 +1,5 @@
 #
-# Copyright (c) 2021-2024 ahriman team.
+# Copyright (c) 2021-2025 ahriman team.
 #
 # This file is part of ahriman
 # (see https://github.com/arcan1s/ahriman).
@ -19,9 +19,8 @@
 #
 try:
    import aiohttp_security
-    _has_aiohttp_security = True
 except ImportError:
-    _has_aiohttp_security = False
+    aiohttp_security = None  # type: ignore[assignment]

 from typing import Any

@ -40,7 +39,7 @@ async def authorized_userid(*args: Any, **kwargs: Any) -> Any:
    Returns:
        Any: ``None`` in case if no aiohttp_security module found and function call otherwise
    """
-    if _has_aiohttp_security:
+    if aiohttp_security is not None:
        return await aiohttp_security.authorized_userid(*args, **kwargs)  # pylint: disable=no-value-for-parameter
    return None

@ -56,7 +55,7 @@ async def check_authorized(*args: Any, **kwargs: Any) -> Any:
    Returns:
        Any: ``None`` in case if no aiohttp_security module found and function call otherwise
    """
-    if _has_aiohttp_security:
+    if aiohttp_security is not None:
        return await aiohttp_security.check_authorized(*args, **kwargs)  # pylint: disable=no-value-for-parameter
    return None

@ -72,7 +71,7 @@ async def forget(*args: Any, **kwargs: Any) -> Any:
    Returns:
        Any: ``None`` in case if no aiohttp_security module found and function call otherwise
    """
-    if _has_aiohttp_security:
+    if aiohttp_security is not None:
        return await aiohttp_security.forget(*args, **kwargs)  # pylint: disable=no-value-for-parameter
    return None

@ -88,6 +87,6 @@ async def remember(*args: Any, **kwargs: Any) -> Any:
    Returns:
        Any: ``None`` in case if no aiohttp_security module found and function call otherwise
    """
-    if _has_aiohttp_security:
+    if aiohttp_security is not None:
        return await aiohttp_security.remember(*args, **kwargs)  # pylint: disable=no-value-for-parameter
    return None
--- a/src/ahriman/core/auth/mapping.py
+++ b/src/ahriman/core/auth/mapping.py
@ -1,5 +1,5 @@
 #
-# Copyright (c) 2021-2024 ahriman team.
+# Copyright (c) 2021-2025 ahriman team.
 #
 # This file is part of ahriman
 # (see https://github.com/arcan1s/ahriman).
--- a/src/ahriman/core/auth/oauth.py
+++ b/src/ahriman/core/auth/oauth.py
@ -1,5 +1,5 @@
 #
-# Copyright (c) 2021-2024 ahriman team.
+# Copyright (c) 2021-2025 ahriman team.
 #
 # This file is part of ahriman
 # (see https://github.com/arcan1s/ahriman).
--- a/src/ahriman/core/auth/pam.py
+++ b/src/ahriman/core/auth/pam.py
@ -1,5 +1,5 @@
 #
-# Copyright (c) 2021-2024 ahriman team.
+# Copyright (c) 2021-2025 ahriman team.
 #
 # This file is part of ahriman
 # (see https://github.com/arcan1s/ahriman).
--- a/src/ahriman/core/build_tools/init.py
+++ b/src/ahriman/core/build_tools/init.py
@ -1,5 +1,5 @@
 #
-# Copyright (c) 2021-2024 ahriman team.
+# Copyright (c) 2021-2025 ahriman team.
 #
 # This file is part of ahriman
 # (see https://github.com/arcan1s/ahriman).
--- a/src/ahriman/core/build_tools/package_archive.py
+++ b/src/ahriman/core/build_tools/package_archive.py
@ -1,5 +1,5 @@
 #
-# Copyright (c) 2021-2024 ahriman team.
+# Copyright (c) 2021-2025 ahriman team.
 #
 # This file is part of ahriman
 # (see https://github.com/arcan1s/ahriman).
@ -136,7 +136,7 @@ class PackageArchive:
        dependencies, roots = self.depends_on_paths()
        installed_packages = self.installed_packages()
        # build list of packages, which contains both the package itself and (possible) debug packages
-        packages = list(self.package.packages) + [f"{package}-debug" for package in self.package.packages]
+        packages = list(self.package.packages) + [f"{self.package.base}-debug"]

        # build initial map of file path -> packages containing this path
        # in fact, keys will contain all libraries the package linked to and all directories it contains
--- a/src/ahriman/core/build_tools/sources.py
+++ b/src/ahriman/core/build_tools/sources.py
@ -1,5 +1,5 @@
 #
-# Copyright (c) 2021-2024 ahriman team.
+# Copyright (c) 2021-2025 ahriman team.
 #
 # This file is part of ahriman
 # (see https://github.com/arcan1s/ahriman).
--- a/src/ahriman/core/build_tools/task.py
+++ b/src/ahriman/core/build_tools/task.py
@ -1,5 +1,5 @@
 #
-# Copyright (c) 2021-2024 ahriman team.
+# Copyright (c) 2021-2025 ahriman team.
 #
 # This file is part of ahriman
 # (see https://github.com/arcan1s/ahriman).
@ -149,8 +149,11 @@ class Task(LazyLogging):
            str | None: current commit sha if available
        """
        last_commit_sha = Sources.load(sources_dir, self.package, patches, self.paths)
-        if local_version is None:
-            return last_commit_sha  # there is no local package or pkgrel increment is disabled
+        if self.package.is_vcs:  # if package is VCS, then make sure to update PKGBUILD to the latest version
+            self.build(sources_dir, dry_run=True)
+
+        if local_version is None:  # there is no local package or pkgrel increment is disabled
+            return last_commit_sha

        # load fresh package
        loaded_package = Package.from_build(sources_dir, self.architecture, None)
--- a/src/ahriman/core/configuration/init.py
+++ b/src/ahriman/core/configuration/init.py
@ -1,5 +1,5 @@
 #
-# Copyright (c) 2021-2024 ahriman team.
+# Copyright (c) 2021-2025 ahriman team.
 #
 # This file is part of ahriman
 # (see https://github.com/arcan1s/ahriman).
--- a/src/ahriman/core/configuration/configuration.py
+++ b/src/ahriman/core/configuration/configuration.py
@ -1,5 +1,5 @@
 #
-# Copyright (c) 2021-2024 ahriman team.
+# Copyright (c) 2021-2025 ahriman team.
 #
 # This file is part of ahriman
 # (see https://github.com/arcan1s/ahriman).
@ -21,7 +21,6 @@ import configparser
 import shlex
 import sys

-from collections.abc import Callable
 from pathlib import Path
 from typing import Any, Self

@ -68,7 +67,6 @@ class Configuration(configparser.RawConfigParser):
    _LEGACY_ARCHITECTURE_SPECIFIC_SECTIONS = ["web"]
    ARCHITECTURE_SPECIFIC_SECTIONS = ["alpm", "build", "sign"]
    SYSTEM_CONFIGURATION_PATH = Path(sys.prefix) / "share" / "ahriman" / "settings" / "ahriman.ini"
-    converters: dict[str, Callable[[str], Any]]  # typing guard

    def __init__(self, allow_no_value: bool = False, allow_multi_key: bool = True) -> None:
        """
--- a/src/ahriman/core/configuration/configuration_multi_dict.py
+++ b/src/ahriman/core/configuration/configuration_multi_dict.py
@ -1,5 +1,5 @@
 #
-# Copyright (c) 2021-2024 ahriman team.
+# Copyright (c) 2021-2025 ahriman team.
 #
 # This file is part of ahriman
 # (see https://github.com/arcan1s/ahriman).
--- a/src/ahriman/core/configuration/schema.py
+++ b/src/ahriman/core/configuration/schema.py
@ -1,5 +1,5 @@
 #
-# Copyright (c) 2021-2024 ahriman team.
+# Copyright (c) 2021-2025 ahriman team.
 #
 # This file is part of ahriman
 # (see https://github.com/arcan1s/ahriman).
@ -45,6 +45,11 @@ CONFIGURATION_SCHEMA: ConfigurationSchema = {
                "path_exists": True,
                "path_type": "dir",
            },
+            "keep_last_logs": {
+                "type": "integer",
+                "coerce": "integer",
+                "min": 0,
+            },
            "logging": {
                "type": "path",
                "coerce": "absolute_path",
--- a/src/ahriman/core/configuration/shell_interpolator.py
+++ b/src/ahriman/core/configuration/shell_interpolator.py
@ -1,5 +1,5 @@
 #
-# Copyright (c) 2021-2024 ahriman team.
+# Copyright (c) 2021-2025 ahriman team.
 #
 # This file is part of ahriman
 # (see https://github.com/arcan1s/ahriman).
--- a/Show More
+++ b/Show More
Author	SHA1	Message	Date
Evgenii Alekseev	6b993cca3b	refine package logging	2025-02-06 12:31:05 +02:00
Evgenii Alekseev	c6cb4a4abd	fix: force dry run build on task initialization for VCS packages Previously if package is VCS and version in PKGBUILD doesn't match to AUR one, then makepkg will update pkgbuild ignoring all previous pkgrel patches With this change during task init dry ryn process is always run for vcs packages	2025-01-27 15:46:41 +02:00
Evgenii Alekseev	22ac5e8b43	feat: add dashboard (#139 )	2025-01-13 14:32:40 +02:00
Evgenii Alekseev	15ca143b70	feat: add counters to repository stats overview	2025-01-09 17:18:50 +02:00
Evgenii Alekseev	a07b20bf50	Release 2.17.1	2025-01-06 01:14:28 +02:00
Evgenii Alekseev	ed70897c39	fix: suppress traceback in shell if no ipython installed Old implementation was showing import error, new implementation instead hides it behind separated call and if-else check	2025-01-06 01:07:13 +02:00
Evgenii Alekseev	0423c3e67c	Release 2.17.0	2024-12-29 18:07:23 +02:00
Evgenii Alekseev	571f62327f	build: remove unused line from dockerfile	2024-12-24 16:49:30 +02:00
Evgenii Alekseev	286ff4bcef	fix: update packages properties after rebuild This case leads to issue when it is impossible to update list of implicit dependencies correctly in case of multi-packages	2024-12-24 15:13:18 +02:00
Evgenii Alekseev	0660c33de3	chore: copyright update	2024-12-23 16:03:26 +02:00
Evgenii Alekseev	c8421e97ee	fix: fix pkgbuild parsing in case if comment mark is followed by token without whitespaces In this case, the next line was ignored	2024-12-23 15:55:07 +02:00
Evgenii Alekseev	bc2288afc1	fix: suppress codefactor warning	2024-12-23 01:52:23 +02:00
Evgenii Alekseev	503c8b0355	feat: make apispec dependency optional (#138 )	2024-12-22 20:33:31 +02:00
Evgenii Alekseev	6738f9206d	type: remove unused typeguard	2024-12-21 17:02:09 +02:00
Evgenii Alekseev	f865e998b0	feat: add link to logo	2024-12-19 12:47:17 +02:00
Evgenii Alekseev	4880ca4fee	feat: use IPython shell if available	2024-12-18 15:41:36 +02:00