optparse
‹1.8.2
- 1.8.217 Apr 2026, current
- 1.7.516 Apr 2024
- 1.7.416 Jan 2024
- 1.7.320 Jul 2022
- 1.7.18 Oct 2021
- 1.6.616 Apr 2020
- 1.6.416 Sep 2019
- 1.6.23 Apr 2019
- 1.6.115 Jan 2019
- 1.6.017 Jun 2018
- 1.4.419 Jul 2017
- 1.3.23 Oct 2015
- 1.3.011 Dec 2014
- 1.2.04 Apr 2014
- 1.0.226 Aug 2013
- 1.0.130 Jan 2013
- 1.0.021 Nov 2012
- 0.9.516 Feb 2012
- 0.9.41 Oct 2011
- 0.9.14 Oct 2010
- 0.9.06 Aug 2010
- 0.83 Nov 2009
Command Line Option Parser
- CRAN checks, method
Method
Checks and health
CRAN runs every current package through
R CMD checkon a set of machines and publishes a result for each one. The health shown on a package page comes from these results alone.- Problems
- Notes alone never count against a package, but a warning, an error or a failure on any platform is a problem. Open CRAN deadlines are a fact of their own, shown as a clock after the mark, so the mark always says what the checks found.
- Checks only
- Health reflects CRAN's check results and nothing else. Even a package with no tests, no coverage or no recent release can have every platform OK.
- Once a day
- Results are collected once a day from files CRAN publishes. Each platform is one machine set-up, named by its R version, operating system, architecture and compiler, such as r-devel-linux-x86_64-fedora-clang.
- Platforms counted
- The 13 in 3 of 13 is the number of platform rows CRAN published for that package on the day of collection. The set of machines changes over time, so the number is not fixed, and a package missing from a platform counts as neither passing nor failing there.
- All OK13 platforms
- CRAN 30-day downloads, method
- 18,930−1.8% down on the 30 days before, the worse direction
- Dependent packages, method
Method
Reverse dependencies
Dependent packages are other packages that list this one under
Depends,ImportsorLinkingToin theirDESCRIPTIONfile. Those fields list the packages a package needs to install, so dependents break if this one is archived or broken.- As declared
- The counts follow the declarations as written, not whether a package uses the other one when it runs.
- Suggests apart
- Packages that list this one only under
Suggestsinstall and run without it, and use it for tests, examples or an optional feature. They are counted as Suggested by, never among the dependents, and a package that also lists it under one of the three fields is a dependent and is not counted again. - Zero
- Zero dependents means no current CRAN package declares a need for this one, though some may suggest it. On 28 Oct 2026, 19,572 of the 25,583 current CRAN packages had no dependent package.
- 510 more suggest it
- Test coverage, method
Method
Test coverage
Test coverage is measured by downloading each CRAN package's current source file, installing its dependencies, building it and running its tests under covr.
- Almost half of CRAN has no tests to run
- Only CRAN packages are measured. Many have no percentage, most often because the package has no tests, and that blank is a recorded outcome, not missing data.
- NOT_CRAN
- Tests run with NOT_CRAN=true, so tests that skip themselves on CRAN run here, and the figure can differ from what CRAN's own checks see.
- Current version only
- Only the current version is measured, and a new version on CRAN is measured again. Older rows are kept but never filled in later. This is one package's run.
- Never 0%
- On a package page three states stay apart: measured, no tests, and not measured. Neither of the last two is ever shown as 0%.
- 98%of lines run by tests
- Advisories, method
Method
Security advisories
Advisories come from the R Consortium advisory database, a community record of security problems in R packages, as OSV publishes it.
- The copy
- The record is read once a day. The data is published under the Apache License 2.0 and is credited on the advisories list.
- Box under the name
- Under the package's name, a box names any advisory that affects the current release, with its fix or that there is none.
- Ranges
- Advisories state ranges, such as from 0.9.12 up to but not including 1.8.8. Each range is checked against every version CRAN has published, using the version rules R itself uses, so a release that came out after the advisory was written is still caught by its range.
- Not the package
- The rating is for the library flaw itself, not for how exposed the R package is, and it is never added up into a figure for the package.
- None known
About
Method, About Method Licence figures come from the Licences
License field of each package's DESCRIPTION file, read the way R itself reads it. No licence file is opened.tools::analyze_license() and R's own licence database, as CRAN's checks read it.| is read, so one string can offer two families.
A command line parser inspired by Python's 'optparse' library to be used with Rscript to write "#!" shebang scripts that accept short and long flag/options.
- Maintainer
- Trevor L. Davis
- Licence
- GPL (>= 2)
- Latest release
- 17 Apr 2026
- First release
- 3 Nov 2009
More details
- Releases
- 22
- Needs compilation
- No
- Needs R
- >= 3.6.0
- Config/testthat/edition
- 3
- RoxygenNote
- 7.3.3
Subjects (1) Method, SubjectsMethod
Subjects and collections
Subjects are the site's own grouping of CRAN packages, found by clustering. Collections are sets of packages that communities declare, such as the tidyverse.
- Subjects
- Subjects are found by clustering the words of current CRAN packages and the packages they use. No one edits them by hand.
- Collections
- Collections are sets that communities declare, through a package that installs the set or an organization on GitHub. The site finds them by rules.
- Who made each
- Subjects are marked Site and collections Community. Subjects, collections and task views are never mixed in one list.
- The day of the data
- Subjects and collections were last worked out on 22 Oct 2026.
Cite
Package
Run in R for the authors' preferred citation:
citation("optparse")Davis, T. L., Python Software Foundation, Choi, G. J., Day, A., FitzJohn, R., Humburg, P., Lianoglou, S., Müller, K., & Nikelski, J. (2026). optparse: Command Line Option Parser (Version 1.8.2) [Computer software]. https://doi.org/10.32614/CRAN.package.optparse
About
This package has no citation file, so citation() returns this entry built from DESCRIPTION.
R Observatory
For a number measured here: a download total, a coverage figure, an archival date.
Balamuta, J. J. (2026). R Observatory: Metrics for optparse version 1.8.2 [Data set]. HJJB, LLC. Data release v2026-10-28. https://doi.org/10.5281/zenodo.21843040
About
From data release v2026-10-28, which the citation names so these numbers can be found later.
Health
All 13 check platforms pass.
r-devel-linux-x86_64-debian-clangThe unreleased R on Linux, x86_64, debian-clang
OK
- Version checked
- 1.8.2
- Time taken
- 44 s
r-devel-linux-x86_64-debian-gccThe unreleased R on Linux, x86_64, debian-gcc
OK
- Version checked
- 1.8.2
- Time taken
- 34 s
r-devel-linux-x86_64-fedora-clangThe unreleased R on Linux, x86_64, fedora-clang
OK
- Version checked
- 1.8.2
- Time taken
- 42 s
r-devel-linux-x86_64-fedora-gccThe unreleased R on Linux, x86_64, fedora-gcc
OK
- Version checked
- 1.8.2
- Time taken
- 35 s
r-devel-windows-x86_64The unreleased R on Windows, x86_64
OK
- Version checked
- 1.8.2
- Options
- --no-vignettes
- Time taken
- 79 s
r-oldrel-macos-arm64The previous release of R on macOS, arm64
OK
- Version checked
- 1.8.2
- Time taken
- 17 s
r-oldrel-macos-x86_64The previous release of R on macOS, x86_64
OK
- Version checked
- 1.8.2
- Time taken
- 96 s
r-oldrel-windows-x86_64The previous release of R on Windows, x86_64
OK
- Version checked
- 1.8.2
- Options
- --no-vignettes
- Time taken
- 62 s
r-patched-linux-x86_64The patched release of R on Linux, x86_64
OK
- Version checked
- 1.8.2
- Time taken
- 38 s
r-release-linux-x86_64The current release of R on Linux, x86_64
OK
- Version checked
- 1.8.2
- Time taken
- 38 s
r-release-macos-arm64The current release of R on macOS, arm64
OK
- Version checked
- 1.8.2
- Time taken
- 18 s
r-release-macos-x86_64The current release of R on macOS, x86_64
OK
- Version checked
- 1.8.2
- Time taken
- 61 s
r-release-windows-x86_64The current release of R on Windows, x86_64
OK
- Version checked
- 1.8.2
- Options
- --no-vignettes
- Time taken
- 56 s
- 13 OK
Over time
No change since 5 Aug 2026
As a list (3)
| Changed | Worst status | OK | Notes | Warnings | Errors |
|---|---|---|---|---|---|
| 5 Aug 2026 | OK | 13 | 0 | 0 | 0 |
| 1 Aug 2026 | Note | 12 | 1 | 0 | 0 |
| 10 Mar 2026 | OK | 14 | 0 | 0 | 0 |
Since March 2026
Downloads
Method, Downloads Method Download figures count requests logged by each distribution channel. They are not counts of installs or of users, because each channel publishes its own totals and this site reads them.Downloads
- Total downloads in the last 30 days
- 58,819+26.7% up on the 30 days before, the better directionIt is the sum of 6 channels: CRAN, r2u, autoCRAN, conda-forge, Bioconda and c2d4u.
CRAN rank
813 of 26,530
CRAN
18,930 downloads in the last 30 days
- Rank
- 813 of 26,530
- Change
- −1.8% down on the 30 days before, the worse direction
It is in the total. Take it out
r2u
2,284 downloads in the last 30 days
- Rank
- 574 of 30,526
- Change
- +217% up on the 30 days before, the better direction
It is in the total. Take it out
autoCRAN
3 downloads in the last 30 days
- Rank
- 17,776 of 29,212
- Change
- −66.7% down on the 30 days before, the worse direction
It is in the total. Take it out
conda-forge
37,500 downloads in the last 30 days
- Rank
- 210 of 3,828
- Change
- +42.7% up on the 30 days before, the better direction
It is in the total. Take it out
Bioconda
42 downloads in the last 30 days
- Rank
- 3,467 of 4,976
- Change
- −20.8% down on the 30 days before, the worse direction
It is in the total. Take it out
c2d4u, no longer updated
60 downloads in the last 30 days
- Rank
- 431 of 7,575
- Change
- −21.1% down on the 30 days before, the worse direction
It is in the total. Take it out
The total is 58,819 downloads in the last 30 days. It is the sum of 6 channels: CRAN, r2u, autoCRAN, conda-forge, Bioconda and c2d4u.
Over time
Dependencies
- Needs
- 1
- Dependent packages
- 5
- Suggested by
- 10
Needs (1)
- methods
- Installing it adds
- 0 packages, 0 KB of source
- Of those, need compilation
- 0
Dependent packages (5)
| Package | Title | Downloads in 30 days |
|---|---|---|
| numbat | Haplotype-Aware CNV Analysis from scRNA-Seq | 506 |
| plinkQC | Genotype Quality Control with 'PLINK' | 454 |
| fmriqa | Functional MRI Quality Assurance Routines | 265 |
| RIbench | Benchmark Suite for Indirect Methods for RI Estimation | 237 |
| dynafluxr | Retrieve Reaction Rate Dynamics from Metabolite Concentration Time Courses | 190 |
Code
Method, Code Method Code metrics come from reading the released source of each package version. The package is never installed, loaded or run.Code metrics
README, vignettes, a NEWS file and the shares read from its help pages. Files kept only in the repository, such as a pkgdown configuration or CI files, are read by the repository scan instead.
- Functions
- 47
- Public exports
- 9
- Lines of R code
- 1,315
- Median complexity
- 2
Functions (47)
Size and composition
Lines by kind (3,074)
| Kind | Lines | Share |
|---|---|---|
| R code | 1,315 | 43% |
| Tests | 1,088 | 35% |
| Documentation | 529 | 17% |
| Guides | 142 | 5% |
Lines by language
| Language | Lines | Share |
|---|---|---|
| R | 2,127 | 69% |
| Rd | 529 | 17% |
| Markdown | 246 | 8% |
| Vignettes | 142 | 5% |
| Other | 30 | 1% |
Languages are counted from file extensions.
- Files
- 34
- R functions
- 47
- Object systems
- S4: 2 classes, S4: 1 generics, S4: 1 methods
Complexity
- Median
- 2
- Mean
- 3.62
- Highest
- 23
- Median lines per function
- 13
About complexity
Cyclomatic complexity counts the independent paths through a function: 1 is a straight line, higher is harder to test. R functions only.
Call graph figures
- R functions
- 47
- Calls
- 53
- Unconnected
- 5
- Groups
- 1
Growth (22 releases)
Release changes
Tests
The tests ran and coverage was measured.
- Lines run by tests
- 98.3%
- Expressions run by tests
- 97.7%
- Test cases
- 35
- Exports named in tests
- 77.8%
Coverage by file (2)
Coverage run
- Lines counted
- 661
- Lines the tests ran
- 650
- Tests passed
- Yes
- Measured with
- covr 3.6.5 on R 4.6.1
Test suite
- Has tests
- Yes
- Test frameworks
- testthat
- Test cases
- 35
- Snapshot tests
- 31
- Lines of tests
- 1,088
- Test lines per line of code
- 0.83
Documentation
- Exports documented
- 100%
- Arguments documented
- 93.3%
- Return value documented
- 83.3%
- Help pages with examples
- 50%
- Examples run in checks
- 100%
Guides (1)
Other documentation
- README
- Yes, 560 words
- Release notes file
- Yes
- Help pages
- 8
- Lines of documentation
- 529
People
Method, People Method People on the site are the names packages give them in their Author and maintainer identity
DESCRIPTION files: authors from the author list, and the maintainer from the Maintainer field. Spellings of one name become one person only where the rules below allow it, and when in doubt the rules keep people apart.
Maintainer since 0.8 (2009), author
Python Software Foundation, an organisation
Contributor
Contributor
Author
Contributor
Contributor
Contributor
Contributor
Contributor
Earlier names (11)
- Jim Nikelski.
- Kirill Müller.
- Peter Humburg.
- Rich FitzJohn.
- some documentation
- the Python Software Foundation.
- the Python Software Foundation. Contributions from Steve Lianoglou
- Trevor Davis. "getopt" function
- Trevor Davis. Some documentation
- Trevor L Davis
- Trevor L Davis. Some documentation
Repository
Method, figures by host Method Repository signals are the figures read from the source repository a package links to: stars, forks, issues, commits, releases and the time issues take to close. They are read from GitHub, GitLab, Codeberg and Bitbucket.Repository signals
URL and BugReports fields of its DESCRIPTION file. Read-only mirrors, the cran and bioc accounts on GitHub and git.bioconductor.org, are left out.
trevorld / r-optparse on github.com
- Stars
- 159no change on 30 days ago
- Forks
- 10
- Open issues
- 1
- Last commit
- 9 May 2026
Activity
- Commits
- 178
- Open pull requests
- 0
- Tagged releases
- 10
- Latest tagged release
- v1.8.2, 17 Apr 2026
- Issues closed in
- 2 days (median)
- Pull requests closed in
- 1 day (median)
- Pull requests merged
- 84%
- Created
- 4 May 2013
- Licence file reads as
- GPL-2.0
Development practices (14)
| Kind | Found |
|---|---|
| Continuous integration | GitHub Actions, R CMD check workflow The R CMD check workflow runs on Linux, macOS and Windows, and on R-devel |
| Governance and community | Contributing guide, Funding Funding links: GitHub Sponsors The repository owner accepts GitHub Sponsors |
| Docs source | pkgdown |
| Coverage | Coverage reporting |
| Reproducibility and dev environment | data-raw/ |
| CRAN release process | cran-comments.md |
| Automation and maintenance | pre-commit |
| Lint, format, editor | lintr, Lint workflow, Air, EditorConfig |
Method, repository practices Method Beta Each week a scan of the public source repository a package links to looks for the tools a maintainer has set up, and the Repository section lists the findings. Repositories on GitHub and GitLab are scanned.Repository practices
R CMD build reads .Rbuildignore and leaves out files used only in development, such as .github/, .lintr, renv/, a Dockerfile and cran-comments.md, so the released source file holds almost none of them. The repository is the one place these files stay visible.
AI tools
Method, AI tools Method Beta What is found in a repository is not a measure of the code.AI tool findings
Tools
| Tool | First seen | Found | Commits crediting it |
|---|---|---|---|
| Claude Code | 17 Mar 2026 | Named in .Rbuildignore.claudeNamed in .gitignore.claude | 13 at least |
- Named in .Rbuildignore
- Named in .gitignore
Models
| Model | Commits | First commit | Last commit | Credit lines of |
|---|---|---|---|---|
| Claude Sonnet 4.6 | 13 | 21 Mar 2026 | 27 Mar 2026 | Claude Code |
History
Method, History Method Archived is built from CRAN's archive records, its list of check deadlines and Bioconductor's package records. Every figure is counted to 28 Oct 2026, the day the data was read.Packages leaving
| Version | Released | R |
|---|---|---|
| 1.8.2 current | 17 Apr 2026 | 4.5.3 |
| 1.7.5 | 16 Apr 2024 | 4.3.3 |
| 1.7.4 | 16 Jan 2024 | 4.3.2 |
| 1.7.3 | 20 Jul 2022 | 4.2.1 |
| 1.7.1 | 8 Oct 2021 | 4.1.1 |
| 1.6.6 | 16 Apr 2020 | 3.6.3 |
| 1.6.4 | 16 Sep 2019 | 3.6.1 |
| 1.6.2 | 3 Apr 2019 | 3.5.3 |
Earlier versions (14)
| Version | Released | R |
|---|---|---|
| 1.6.1 | 15 Jan 2019 | 3.5.2 |
| 1.6.0 | 17 Jun 2018 | 3.5.0 |
| 1.4.4 | 19 Jul 2017 | 3.4.1 |
| 1.3.2 | 3 Oct 2015 | 3.2.2 |
| 1.3.0 | 11 Dec 2014 | 3.1.2 |
| 1.2.0 | 4 Apr 2014 | 3.0.3 |
| 1.0.2 | 26 Aug 2013 | 3.0.1 |
| 1.0.1 | 30 Jan 2013 | 2.15.2 |
| 1.0.0 | 21 Nov 2012 | 2.15.2 |
| 0.9.5 | 16 Feb 2012 | 2.14.1 |
| 0.9.4 | 1 Oct 2011 | 2.13.2 |
| 0.9.1 | 4 Oct 2010 | 2.11.1 |
| 0.9.0 | 6 Aug 2010 | 2.11.1 |
| 0.8 | 3 Nov 2009 | 2.10.0 |
Release notes (1.8.2)
New features
------------
add_option()(andmake_option()) now support the following new actions (#22):action = "append"which appends each occurrence's value todefault.action = "append_const"which appendsconsttodefaulteach time the flag is seen.action = "count", which counts the number of times a flag is seen and adds it todefault(treated as0Lif not supplied). ReturnsNULLif the flag is never seen and nodefaultwas supplied.action = "store_const"which storesconstwhen the flag is seen.add_option()(andmake_option()) now support aconstparameter (intended for new actions"append_const"and"store_const").- Several new classed errors are now thrown, mirroring Python's
optparseexception hierarchy: optparse_option_error: invalid option definition inmake_option()oradd_option().optparse_option_conflict_error: duplicate flag inOptionParser()oradd_option().optparse_parse_error: existing base class for all parse-time errors fromparse_args().optparse_bad_option_error: unrecognized, misused, or argument-requiring option.optparse_ambiguous_option_error: ambiguous abbreviated long flag.optparse_bad_positional_arguments_error: wrong number of positional arguments supplied.optparse_missing_required_error: a required option was not supplied.add_option()(andmake_option()) now allow non-letter characters in short flags (e.g.,-1) and at the beginning of long flags (e.g.,--1flag), following Python'soptparseconvention. However long and short flags may not contain=or whitespace (or begin with hyphens).add_option()(andmake_option()) now support arequiredargument. IfTRUE,parse_args()will throw an error if the option is not provided on the command line (#17).
Bug fixes and minor improvements
--------------------------------
parse_args()(andparse_args2()) now correctly handle a bare--separator: all arguments after--are treated as positional arguments rather than options.parse_args()(andparse_args2()) now support abbreviated long flags (e.g.--verbmatching--verbose) whenpositional_argumentsis notFALSE. Previously abbreviations were only supported whenpositional_arguments = FALSE.make_option()now throws a classedoptparse_option_errorfor invalidactionortypearguments instead of a confusing error later at parse time.OptionParser()now also checks theLITTLER_SCRIPT_PATHenvironment variable for the script name when performing%progon theusageargument so it works when called fromlittler.