Package: pacup
PacupWhat is this?Pacup (PacscriptUpdater) is a maintainer helper tool to help
maintainers update their pacscripts. It semi-automates the tedious task of
updating pacscripts, and aims to make it a fun process for the maintainer!InstallationTo install the latest release run:$pacstall-Ipacup-bin# or pip install pacupTo install the latest development build run:$pipinstallgit+https://github.com/pacstall/pacupUsageUsage: pacup [OPTIONS] PACSCRIPTS...Updates specified pacscripts.If ship flag is passed, the pacscript will be prepared for shipping to upstream.After the pacscript is prepared, it will be committed and pushed to the origin remote.This requires you to be present in your cloned fork.╭─ Arguments ──────────────────────────────────────────────────────────────────────────────────────────╮│ *    pacscripts      PACSCRIPTS...  The pacscripts to update. [default: None] [required]             │╰──────────────────────────────────────────────────────────────────────────────────────────────────────╯╭─ Options ────────────────────────────────────────────────────────────────────────────────────────────╮│ --show-repology       -r                                       Show the parsed repology data and     ││                                                                exit.                                 ││ --debug               -d                                       Turn on debugging mode.               ││ --version             -v                                       Show the version and exit.            ││ --ship                -s                                       Prepare the pacscript for shipping to ││                                                                upstream.                             ││ --install-completion          [bash|zsh|fish|powershell|pwsh]  Install completion for the specified  ││                                                                shell.                                ││                                                                [default: None]                       ││ --show-completion             [bash|zsh|fish|powershell|pwsh]  Show completion for the specified     ││                                                                shell, to copy it or customize the    ││                                                                installation.                         ││                                                                [default: None]                       ││ --help                                                         Show this message and exit.           │╰──────────────────────────────────────────────────────────────────────────────────────────────────────╯You can get this help text by runningpacup --help.You should visit ourwiki, for
more information on how to use therepologykey.How does it work?Supposefoo.pacscriptis outdated.On runningpacup foo.pacscriptPacup will parse the pacscript's variables,
then it compiles a list of filters specified in therepologyvariable in the
pacscript. Then it queries theRepology APIto get
all the repositories which have packaged that package. After which it applies
the filter to the response, and from the filtrate it considers the most common
version to be the latest.Then it replaces all occurrences of the previousversion's value in theurlwith the latest one placeholder's value with the latest version, and downloads
the new package, and generates it's hash.Then writes the edited pacscript and installs it withPacstall, after installation it asks
the user to confirm that the installed package works. On approval the pacscript
is considered successfully upgraded and the program ends.CaveatsDoes not work with-gitpacscripts as those pacscripts are auto updating.Doesn't work if a pacscript doesn't have an equivalentRepologypackage.StatsLicense____             __  __
   / __ \____ ______/ / / /___
  / /_/ / __ `/ ___/ / / / __ \
 / ____/ /_/ / /__/ /_/ / /_/ /
/_/    \__,_/\___/\____/ .___/
                      /_/

Copyright (C) 2022-present

This file is part of PacUp

PacUp 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.

PacUp 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 PacUp.  If not, see <https://www.gnu.org/licenses/>.