https://github.com/boostorg/program_options

Boost.org program_options module
https://github.com/boostorg/program_options

Last synced: 3 months ago
JSON representation

Boost.org program_options module

• Host: GitHub
• URL: https://github.com/boostorg/program_options
• Owner: boostorg
• Created: 2013-01-13T15:59:20.000Z (about 13 years ago)
• Default Branch: develop
• Last Pushed: 2025-09-27T10:54:36.000Z (4 months ago)
• Last Synced: 2025-09-27T12:27:44.534Z (4 months ago)
• Language: C++
• Homepage: http://boost.org/libs/program_options
• Size: 1.91 MB
• Stars: 123
• Watchers: 9
• Forks: 114
• Open Issues: 73
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

• fucking-awesome-cpp - Boost.Program_options - A library to obtain program options via conventional methods such as command line and config file. [Boost] 🌎 [website](boost.org/libs/program_options) (CLI)
• awesome-cpp - Boost.Program_options - A library to obtain program options via conventional methods such as command line and config file. [Boost] [website](https://boost.org/libs/program_options) (CLI)

README

          
Program Options, part of the collection of [Boost C++ Libraries](http://github.com/boostorg), allows for definition and acquisition of (name, value) pairs from the user via conventional methods such as command line and config file.  It is roughly analogous to getopt_long, but for use with C++.

### License

Distributed under the [Boost Software License, Version 1.0](http://www.boost.org/LICENSE_1_0.txt).

### Properties

* C++03

* Requires Linking

### Build Status

(in progress...)

|Branch          | Travis | Appveyor | codecov.io | Deps | Docs | Tests |

|:-------------: | ------ | -------- | ---------- | ---- | ---- | ----- |

|[`master`](https://github.com/boostorg/program_options/tree/master) | [![Build Status](https://travis-ci.org/boostorg/program_options.svg?branch=master)](https://travis-ci.org/boostorg/program_options) | [![Build status](https://ci.appveyor.com/api/projects/status/e0quisadwh1v7ok5/branch/master?svg=true)](https://ci.appveyor.com/project/vprus/program-options/branch/master) | [![codecov](https://codecov.io/gh/boostorg/program_options/branch/master/graph/badge.svg)](https://codecov.io/gh/boostorg/program_options/branch/master) | [![Deps](https://img.shields.io/badge/deps-master-brightgreen.svg)](https://pdimov.github.io/boostdep-report/master/program_options.html) | [![Documentation](https://img.shields.io/badge/docs-master-brightgreen.svg)](http://www.boost.org/doc/libs/master/doc/html/program_options.html) | [![Enter the Matrix](https://img.shields.io/badge/matrix-master-brightgreen.svg)](https://regression.boost.io/master/developer/program_options.html) 

|[`develop`](https://github.com/boostorg/program_options/tree/develop) | [![Build Status](https://travis-ci.org/boostorg/program_options.svg?branch=develop)](https://travis-ci.org/boostorg/program_options) | [![Build status](https://ci.appveyor.com/api/projects/status/e0quisadwh1v7ok5/branch/develop?svg=true)](https://ci.appveyor.com/project/vprus/program-options/branch/develop) | [![codecov](https://codecov.io/gh/boostorg/program_options/branch/develop/graph/badge.svg)](https://codecov.io/gh/boostorg/program_options/branch/develop) | [![Deps](https://img.shields.io/badge/deps-develop-brightgreen.svg)](https://pdimov.github.io/boostdep-report/develop/program_options.html) | [![Documentation](https://img.shields.io/badge/docs-develop-brightgreen.svg)](http://www.boost.org/doc/libs/develop/doc/html/program_options.html) | [![Enter the Matrix](https://img.shields.io/badge/matrix-develop-brightgreen.svg)](https://regression.boost.io/develop/developer/program_options.html)

 

### Directories

| Name      | Purpose                        |

| --------- | ------------------------------ |

| `build`   | build script for link library  |

| `ci`      | continuous integration scripts |

| `doc`     | documentation                  |

| `example` | use case examples              |

| `include` | headers                        |

| `src`     | source code for link library   |

| `test`    | unit tests                     |

### More information

* [Ask questions](http://stackoverflow.com/questions/ask?tags=c%2B%2B,boost,boost-program_options): Be sure to read the documentation first to see if it answers your question.

* [Report bugs](https://github.com/boostorg/program_options/issues): Be sure to mention Boost version, platform and compiler you're using. A small compilable code sample to reproduce the problem is always good as well.

* [Submit Pull Requests](https://github.com/boostorg/program_options/pulls) against the **develop** branch. Note that by submitting patches you agree to license your modifications under the [Boost Software License, Version 1.0](http://www.boost.org/LICENSE_1_0.txt).  Be sure to include tests proving your changes work properly.

* Discussions about the library are held on the [Boost developers mailing list](http://www.boost.org/community/groups.html#main). Be sure to read the [discussion policy](http://www.boost.org/community/policy.html) before posting and add the `[program_options]` tag at the beginning of the subject line.