args/6.4.6+2

A simple header-only C++ argument parser library

Usage

Make sure to add the stable section of the cppget.org repository to your project's repositories.manifest to be able to fetch the package.

:
role: prerequisite
location: https://pkg.cppget.org/1/stable
# trust: ...

Add the respective dependency in your project's manifest file to make the package available for import.

depends: args ^ 6.4.6

The single header-only C++ library to use args as command-line argument parser can be imported by the following declaration in a buildfile.

import args = args%lib{args}

... More

version	6.4.6+2
license	MIT
repository	https://pkg.cppget.org/1/stable
download	args-6.4.6+2.tar.gz
sha256	beeba3583dd43e2693f6316c4b3d505f321277d5eb5978794f7b1d3c4c995e4c

project	args
url	github.com/Taywee/args
doc-url	taywee.github.io/args/
package-url	github.com/build2-packaging/args/
email	taywee@gmx.com
package-email	packaging@build2.org

Tests

	args-tests == 6.4.6

Reviews

fail	0
pass	1

Builds

toolchain	public-0.17.0
target	x86_64-apple-darwin23.5.0
tgt config	macos_14-gcc_14_homebrew-O3
timestamp	2024-10-15 05:33:13 UTC (01:56:12 hours ago)
result	success \| log \| rebuild

toolchain	public-0.17.0
target	x86_64-apple-darwin23.5.0
tgt config	macos_14-gcc_14_homebrew
timestamp	2024-10-15 05:25:19 UTC (02:04:06 hours ago)
result	success \| log \| rebuild

toolchain	public-0.17.0
target	aarch64-linux-gnu
tgt config	linux_debian_12-clang_18_libc++-static_O3
timestamp	2024-10-15 01:02:22 UTC (06:27:02 hours ago)
result	success \| log \| rebuild

toolchain	public-0.17.0
target	aarch64-linux-gnu
tgt config	linux_debian_12-clang_18_libc++-O3
timestamp	2024-10-15 01:00:37 UTC (06:28:48 hours ago)
result	success \| log \| rebuild

toolchain	public-0.17.0
target	aarch64-linux-gnu
tgt config	linux_debian_12-clang_18_libc++
timestamp	2024-10-15 00:59:28 UTC (06:29:56 hours ago)
result	success \| log \| rebuild

toolchain	public-0.17.0
target	aarch64-linux-gnu
tgt config	linux_debian_12-clang_18-static_O3
timestamp	2024-10-15 00:58:56 UTC (06:30:29 hours ago)
result	success \| log \| rebuild

toolchain	public-0.17.0
target	aarch64-linux-gnu
tgt config	linux_debian_12-clang_18-O3
timestamp	2024-10-15 00:58:06 UTC (06:31:18 hours ago)
result	success \| log \| rebuild

toolchain	public-0.17.0
target	aarch64-linux-gnu
tgt config	linux_debian_12-clang_18
timestamp	2024-10-15 00:57:39 UTC (06:31:46 hours ago)
result	success \| log \| rebuild

toolchain	public-0.17.0
target	x86_64-linux-gnu
tgt config	linux_debian_12-clang_18_libc++-static_O3
timestamp	2024-10-14 23:02:34 UTC (08:26:51 hours ago)
result	success \| log \| rebuild

toolchain	public-0.17.0
target	x86_64-linux-gnu
tgt config	linux_debian_12-clang_18_libc++-O3
timestamp	2024-10-14 23:01:00 UTC (08:28:25 hours ago)
result	success \| log \| rebuild

toolchain	public-0.17.0
target	x86_64-linux-gnu
tgt config	linux_debian_12-clang_18-O3
timestamp	2024-10-14 23:00:27 UTC (08:28:58 hours ago)
result	success \| log \| rebuild

toolchain	public-0.17.0
target	x86_64-linux-gnu
tgt config	linux_debian_12-clang_18-static_O3
timestamp	2024-10-14 22:59:19 UTC (08:30:06 hours ago)
result	success \| log \| rebuild

toolchain	public-0.17.0
target	x86_64-linux-gnu
tgt config	linux_debian_12-clang_18_libc++
timestamp	2024-10-14 22:57:26 UTC (08:31:59 hours ago)
result	success \| log \| rebuild

toolchain	public-0.17.0
target	x86_64-linux-gnu
tgt config	linux_debian_12-clang_18
timestamp	2024-10-14 22:56:06 UTC (08:33:19 hours ago)
result	success \| log \| rebuild

toolchain	public-0.17.0
target	aarch64-linux-gnu
tgt config	linux_debian_12-gcc_14-static_O3
timestamp	2024-10-14 21:34:55 UTC (09:54:29 hours ago)
result	success \| log \| rebuild

toolchain	public-0.17.0
target	aarch64-linux-gnu
tgt config	linux_debian_12-gcc_14-ndebug_O3
timestamp	2024-10-14 21:29:08 UTC (10:00:17 hours ago)
result	success \| log \| rebuild

toolchain	public-0.17.0
target	aarch64-linux-gnu
tgt config	linux_debian_12-gcc_14-O3
timestamp	2024-10-14 21:28:44 UTC (10:00:41 hours ago)
result	success \| log \| rebuild

toolchain	public-0.17.0
target	aarch64-linux-gnu
tgt config	linux_debian_12-gcc_14
timestamp	2024-10-14 21:25:58 UTC (10:03:27 hours ago)
result	success \| log \| rebuild

toolchain	public-0.17.0
target	x86_64-microsoft-win32-msvc14.3
tgt config	windows_10-clang_18_llvm_msvc_17.10-static_O2
timestamp	2024-10-14 19:39:49 UTC (11:49:36 hours ago)
result	success \| log \| rebuild

toolchain	public-0.17.0
target	x86_64-microsoft-win32-msvc14.3
tgt config	windows_10-clang_18_llvm_msvc_17.10-O2
timestamp	2024-10-14 19:39:37 UTC (11:49:48 hours ago)
result	success \| log \| rebuild

toolchain	public-0.17.0
target	x86_64-microsoft-win32-msvc14.3
tgt config	windows_10-clang_18_llvm_msvc_17.10
timestamp	2024-10-14 19:38:16 UTC (11:51:08 hours ago)
result	success \| log \| rebuild

toolchain	public-0.17.0
target	x86_64-w64-mingw32
tgt config	windows_10-gcc_13.2_mingw_w64-O2
timestamp	2024-10-14 19:34:43 UTC (11:54:42 hours ago)
result	success \| log \| rebuild

toolchain	public-0.17.0
target	x86_64-microsoft-win32-msvc14.3
tgt config	windows_10-msvc_17.8-static_O2
timestamp	2024-10-14 19:33:43 UTC (11:55:42 hours ago)
result	success \| log \| rebuild

toolchain	public-0.17.0
target	x86_64-linux-gnu
tgt config	linux_debian_12-gcc_14-static_O3
timestamp	2024-10-14 19:33:20 UTC (11:56:05 hours ago)
result	success \| log \| rebuild

toolchain	public-0.17.0
target	x86_64-microsoft-win32-msvc14.3
tgt config	windows_10-msvc_17.10-static_O2
timestamp	2024-10-14 19:33:07 UTC (11:56:17 hours ago)
result	success \| log \| rebuild

toolchain	public-0.17.0
target	x86_64-linux-gnu
tgt config	linux_debian_12-gcc_14-ndebug_O3
timestamp	2024-10-14 19:32:43 UTC (11:56:41 hours ago)
result	success \| log \| rebuild

toolchain	public-0.17.0
target	x86_64-microsoft-win32-msvc14.3
tgt config	windows_10-msvc_17.8-O2
timestamp	2024-10-14 19:32:21 UTC (11:57:03 hours ago)
result	success \| log \| rebuild

toolchain	public-0.17.0
target	x86_64-microsoft-win32-msvc14.3
tgt config	windows_10-msvc_17.10-O2
timestamp	2024-10-14 19:32:14 UTC (11:57:11 hours ago)
result	success \| log \| rebuild

toolchain	public-0.17.0
target	x86_64-microsoft-win32-msvc14.3
tgt config	windows_10-msvc_17.10
timestamp	2024-10-14 19:31:44 UTC (11:57:41 hours ago)
result	success \| log \| rebuild

toolchain	public-0.17.0
target	x86_64-microsoft-win32-msvc14.3
tgt config	windows_10-msvc_17.8
timestamp	2024-10-14 19:31:37 UTC (11:57:47 hours ago)
result	success \| log \| rebuild

toolchain	public-0.17.0
target	x86_64-apple-darwin22.5.0
tgt config	macos_13-clang_15.0
timestamp	2024-10-14 19:31:17 UTC (11:58:08 hours ago)
result	success \| log \| rebuild

toolchain	public-0.17.0
target	x86_64-linux-gnu
tgt config	linux_debian_12-gcc_14-O3
timestamp	2024-10-14 19:12:09 UTC (12:17:15 hours ago)
result	success \| log \| rebuild

toolchain	public-0.17.0
target	x86_64-w64-mingw32
tgt config	windows_10-gcc_13.2_mingw_w64-static_O2
timestamp	2024-10-14 19:12:06 UTC (12:17:19 hours ago)
result	success \| log \| rebuild

toolchain	public-0.17.0
target	x86_64-microsoft-win32-msvc14.3
tgt config	windows_10-clang_17_msvc_msvc_17.10
timestamp	2024-10-14 19:10:40 UTC (12:18:44 hours ago)
result	success \| log \| rebuild

toolchain	public-0.17.0
target	x86_64-linux-gnu
tgt config	linux_debian_12-gcc_12-bindist
timestamp	2024-10-14 19:10:29 UTC (12:18:56 hours ago)
result	success \| log \| rebuild

toolchain	public-0.17.0
target	x86_64-linux-gnu
tgt config	linux_ubuntu_24.04-gcc_13-bindist
timestamp	2024-10-14 19:10:05 UTC (12:19:19 hours ago)
result	success \| log \| rebuild

toolchain	public-0.17.0
target	x86_64-linux-gnu
tgt config	linux_fedora_39-gcc_13-bindist
timestamp	2024-10-14 19:10:02 UTC (12:19:22 hours ago)
result	success \| log \| rebuild

toolchain	public-0.17.0
target	x86_64-freebsd14.1
tgt config	freebsd_14-clang_18-static_O3
timestamp	2024-10-14 19:09:45 UTC (12:19:40 hours ago)
result	success \| log \| rebuild

toolchain	public-0.17.0
target	x86_64-linux-gnu
tgt config	linux_debian_12-gcc_14
timestamp	2024-10-14 19:09:07 UTC (12:20:18 hours ago)
result	success \| log \| rebuild

toolchain	public-0.17.0
target	x86_64-freebsd14.1
tgt config	freebsd_14-clang_18-O3
timestamp	2024-10-14 19:08:42 UTC (12:20:43 hours ago)
result	success \| log \| rebuild

toolchain	public-0.17.0
target	x86_64-freebsd13.3
tgt config	freebsd_13-clang_17
timestamp	2024-10-14 19:08:30 UTC (12:20:55 hours ago)
result	success \| log \| rebuild

toolchain	public-0.17.0
target	x86_64-linux-gnu
tgt config	linux_debian_12-clang_17_libc++
timestamp	2024-10-14 19:06:26 UTC (12:22:58 hours ago)
result	success \| log \| rebuild

toolchain	public-0.17.0
target	x86_64-linux-gnu
tgt config	linux_debian_12-gcc_13.1
timestamp	2024-10-14 19:05:28 UTC (12:23:57 hours ago)
result	success \| log \| rebuild

toolchain	public-0.17.0
target	x86_64-freebsd14.1
tgt config	freebsd_14-clang_18
timestamp	2024-10-14 19:04:54 UTC (12:24:30 hours ago)
result	success \| log \| rebuild

toolchain	public-0.17.0
target	x86_64-linux-gnu
tgt config	linux_debian_12-clang_17
timestamp	2024-10-14 19:04:07 UTC (12:25:18 hours ago)
result	success \| log \| rebuild

toolchain	public-0.17.0
target	aarch64-linux-gnu
tgt config	linux_debian_12-gcc_13
timestamp	2024-10-14 16:00:16 UTC (15:29:09 hours ago)
result	success \| log \| rebuild

toolchain	public-0.17.0
target	aarch64-linux-gnu
tgt config	linux_debian_12-clang_17_libc++
timestamp	2024-10-14 15:42:42 UTC (15:46:43 hours ago)
result	success \| log \| rebuild

toolchain	public-0.17.0
target	aarch64-linux-gnu
tgt config	linux_debian_12-clang_17
timestamp	2024-10-14 15:42:10 UTC (15:47:15 hours ago)
result	success \| log \| rebuild

toolchain	public-0.17.0
target	x86_64-linux-gnu
tgt config	linux_fedora_40-gcc_14-bindist
timestamp	2024-10-14 13:00:32 UTC (18:28:53 hours ago)
result	error (test) \| log \| rebuild

toolchain	public-0.17.0
target	x86_64-apple-darwin23.5.0
tgt config	macos_14-gcc_14_homebrew-static_O3
timestamp	2024-10-13 21:51:12 UTC (01 09:38:13 days ago)
result	success \| log \| rebuild

toolchain	public-0.17.0
target	x86_64-apple-darwin23.5.0
tgt config	macos_14-clang_15.0
result	unbuilt

toolchain	public-0.17.0
target	x86_64-apple-darwin23.5.0
tgt config	macos_14-clang_15.0-O3
result	unbuilt

toolchain	public-0.17.0
target	x86_64-apple-darwin23.5.0
tgt config	macos_14-clang_15.0-static_O3
result	unbuilt

target	x86_64-w64-mingw32
tgt config	windows_10-gcc_13.2_mingw_w64
result	excluded (unoptimized compilation with MinGW on Windows gets stuck)

Changes

* 6.0.0
Change Reader to functor type, breaking change.
Change Reader functor to allow any return type, but specifically need bool-testable return for NOEXCEPT use.
Change List and Map templates into template templates to enforce proper type use and to clean up user template invocations (i.e. `args::ValueFlagList<std::string, std::unordered_set<std::string>>` becomes `args::ValueFlagList<std::string, std::unordered_set>`, also breaking change.

* 5.0.0
Implemented proper subparsers.
Added better C++11 style.
Improved documentation.

* 4.0.0
Changed all wording:

ArgFlag -> ValueFlag
Counter -> CounterFlag
PosArg -> Positional

Argument now solely refers to command line arguments.
Value refers to the argument that flags or positionals can take and store.
Positional is a positional option, which contains a value.
Option refers to flags and positionals, which can contain values.