This project builds and defines the build2 package for the cxxopts library.

The packaging code is licensed under the MIT License, the upstream artifacts are licensed under the terms and conditions of cxxopts.

Usage

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

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

If this is not an option then, instead, add this Git repository itself as a prerequisite.

:
role: prerequisite
location: https://github.com/build2-packaging/cxxopts.git

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

depends: libcxxopts ^ 3.1.1

Import the library in your buildfile by using the following line.

import cxxopts = libcxxopts%lib{cxxopts}

Configuration

Unicode Support

config [bool] config.libcxxopts.use_unicode ?= false

Unicode functionality in cxxopts is based on the ICU library. It will be added as interface dependency to the header-only library if this config variable is set to true.

Issues

Currently, there are no known issues.

Contributing

Thanks in advance for your help and contribution to keep this package up-to-date. For now, please, file an issue on GitHub for everything that is not described below.

Recommend Updating Version

Please, file an issue on GitHub with the new recommended version.

Update Version by Pull Request

1. Fork the repository on GitHub and clone it to your local machine.
2. Run git submodule init and git submodule update to get the current upstream directory.
3. Inside the upstream directory, checkout the new library version X.Y.Z by calling git checkout vX.Y.Z that you want to be packaged.
4. If needed, change source files, buildfiles, and symbolic links accordingly to create a working build2 package. Make sure not to directly depend on the upstream directory inside the build system but use symbolic links instead.
5. Update library version in manifest file if it has changed or add package update by using +n for the n-th update.
6. Make an appropriate commit message by using imperative mood and a capital letter at the start and push the new commit to the master branch.
7. Run bdep ci and test for errors.
8. If everything works fine, make a pull request on GitHub and write down the bdep ci link to your CI tests.
9. After a successful pull request, we will run the appropriate commands to publish a new package version.

Update Version Directly if You Have Permissions

1. Inside the upstream directory, checkout the new library version X.Y.Z by calling git checkout vX.Y.Z that you want to be packaged.
2. If needed, change source files, buildfiles, and symbolic links accordingly to create a working build2 package. Make sure not to directly depend on the upstream directory inside the build system but use symbolic links instead.
3. Update library version in manifest file if it has changed or add package update by using +n for the n-th update.
4. Make an appropriate commit message by using imperative mood and a capital letter at the start and push the new commit to the master branch.
5. Run bdep ci and test for errors and warnings.
6. When successful, run bdep release --tag --push to push new tag version to repository.
7. Run bdep publish to publish the package to cppget.org.

Changelog

This is the changelog for cxxopts, a C++11 library for parsing command line options. The project adheres to semantic versioning.

3.1.1

Bug Fixes

• Fixed version number in header.

3.1

Added

• Support for multiple long names for the same option (= multiple long aliases)
• Add a program() function to retrieve the program name.
• Added a .clang-format file.
• Added iterator and printing for a ParseResult.

Changed

• Cleanup exception code, add cxxopts::exceptions namespace.

Bug Fixes

• Fix arguments() having no key for options that only have a short name.

3.0

Changed

• Only search for a C++ compiler in CMakeLists.txt.
• Allow for exceptions to be disabled.
• Fix duplicate default options when there is a short and long option.
• Add CXXOPTS_NO_EXCEPTIONS to disable exceptions.
• Fix char parsing for space and check for length.
• Change argument type in Options::parse from char** to const char**.
• Refactor parser to not change its arguments.
• ParseResult doesn't depend on a reference to the parser.
• Fixed several warnings and code quality issues.
• Improved formatting for help descriptions.
• Improve integer parsing.

Added

• A list of unmatched arguments is available in ParseResult.
• Support single letter options with argument attached.
• Use if it is present.

Bug Fixes

• Fix missing option name in exception.

2.2

Changed

• Allow integers to have leading zeroes.
• Build the tests by default.
• Don't check for container when showing positional help.

Added

• Iterator inputs to parse_positional.
• Throw an exception if the option in parse_positional doesn't exist.
• Parse a delimited list in a single argument for vector options.
• Add an option to disable implicit value on booleans.

Bug Fixes

• Fix a warning about possible loss of data.
• Fix version numbering in CMakeLists.txt
• Remove unused declaration of the undefined ParseResult::get_option.
• Throw on invalid option syntax when beginning with a -.
• Throw in as when option wasn't present.
• Fix catching exceptions by reference.
• Fix out of bounds errors parsing integers.

2.1.1

Bug Fixes

• Revert the change adding const type for argv, because most users expect to pass a non-const argv from main.

2.1

Changed

• Options with implicit arguments now require the --option=value form if they are to be specified with an option. This is to remove the ambiguity when a positional argument could follow an option with an implicit value. For example, --foo value, where foo has an implicit value, will be parsed as --foo=implicit and a positional argument value.
• Boolean values are no longer special, but are just an option with a default and implicit value.

Added

• Added support for std::optional as a storage type.
• Allow the help string to be customised.
• Use const for the type in the argv parameter, since the contents of the arguments is never modified.

Bug Fixes

• Building against GCC 4.9 was broken due to overly strict shadow warnings.
• Fixed an ambiguous overload in the parse_positional function when an initializer_list was directly passed.
• Fixed precedence in the Boolean value regex.

2.0

Changed

• Options::parse returns a ParseResult rather than storing the parse result internally.
• Options with default values now get counted as appearing once if they were not specified by the user.

Added

• A new ParseResult object that is the immutable result of parsing. It responds to the same count and operator[] as Options of 1.x did.
• The function ParseResult::arguments returns a vector of the parsed arguments to iterate through in the order they were provided.
• The symbol cxxopts::version for the version of the library.
• Booleans can be specified with various strings and explicitly set false.

1.x

The 1.x series was the first major version of the library, with release numbers starting to follow semantic versioning, after 0.x being unstable. It never had a changelog maintained for it. Releases mostly contained bug fixes, with the occasional feature added.