NAME

gr-batch-watch-standalone - batch check a pkgset for remote git update

SYNOPSIS

gr-batch-watch-standalone [-q] [--quiet] [-v] [--verbose] [--help] [-j num] [--jobs num] [--tmpdir dir] [--workdir dir] [--bad-urls-file file] [--keep-tree] [--no-keep-tree] [--log-notags] [--no-log-notags] [--log-ahead] [--no-log-ahead] [--warn-ahead] [--no-warn-ahead] [--input3] [--input4] input file]

DESCRIPTION

gr-batch-watch-standalone is used to batch check a set of packages for remote git update. The set of packages is defined in STDIN or input file. It output a list of packages that have an update.

gr-batch-watch-standalone (standalone mode) by default also creates and keeps its own WORKDIR in current directory for user to check for different warnings and failures later.

repocop-watch-batch-git-plugin (watch plugin mode) is a symlink of gr-batch-watch-standalone with another set of defaults intended for automatic execution at watch.altlinux.org. It has different output format and removes its WORKDIR after run.

INPUT

There are two input modes: default 4-part mode and 3-part mode.

 The 3-part mode input consists of 3 columns:
 <name><tab><version><tab><vcs url>
 The 4-part mode input consists of 4 columns:
 <name><tab><version><tab><web url><tab><vcs url>

vcs url is assumed to be content of the VCS: tag, an URL that can be used in git clone or git ls-remote command. web url is assumed to be content of the URL: tag, an URL that is intended for human use, but sometimes coincidently can be used as web url too. vcs url takes priority over web url.

Packages are filtered and only those who has urls that was recognized as possible git repository urls are processed, other are silently rejected. Use gr-batch-watch-filter-rejected(1) to view rejected packages and their urls.

Use gr-batch-check-url(1) to check a specific url.

OUTPUT

gr-batch-watch-standalone (standalone mode) by default use 4 column format
<name><tab><old version><tab><new version><tab><message>

repocop-watch-batch-git-plugin (watch plugin mode) by default use 3 columns
<name><tab><new version><tab><message>

message here is a message that contains the new version tag and remote git url or some warning.

WORKDIR

 WORKDIR/out

Logs packages with update found.

 WORKDIR/fail

Logs packages whose urls failed to connect.

 WORKDIR/notags

Logs packages whose remote git repositories do not have git version tags. Those repositories either have no tags at all or have no tags in format ([vV]\.?)?\d([\.\d]*)(-rel|-release)?, for example, They can have tag FOO_1_3_2, but not tag v1.3.2 or 1.3.2 recognized by this system.

 WORKDIR/ahead

Logs packages whose version is ahead of discoverd in remote repository.

OPTIONS

-j num, --jobs num

Number of parallel jobs. Default is 32.

--tmpdir dir

TMPDIR location. For watch plugin mode only

--workdir dir

WORKDIR name and location. See WORKDIR

--bad-urls-file file

File to cache bad urls information. Bad urls will not be quered each time but only if package change its urls or until the expiration time (30+ days). expiration time is slightly randomized to prevent DoS.

--keep-tree, --no-keep-tree

Whether to keep WORKDIR after run.

--log-notags, --no-log-notags

Whether to log to WORKDIR/notags.

--log-ahead, --no-log-ahead

Whether to log to WORKDIR/ahead.

--warn-ahead, --no-warn-ahead

Whether to warn about ahead versions in output.

--input3, --input4

Set 3 column / 4 column input. See INPUT

-v|--verbose

Verbose. Prints extra information.

-q|--quiet

Quiet. Print no warnings.

-h|--help

Display this help and exit.

AUTHOR

Written by Igor Vlasenko <viy@altlinux.org>.

COPYING

Copyright (c) 2021 Igor Vlasenko, ALT Linux Team.

This 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 2 of the License, or (at your option) any later version.