GetoptLong

1.1.1

Parsing Command-Line Arguments

6packages depend

1.2Mdownloads / year

61.4%test coverage

13/13checks pass

Overview

About

Maintained by Zuguang GuFirst published 2013-11-2825 releasesCRAN page ↗GitHub ↗

This is a command-line argument parser which wraps the powerful Perl module Getopt::Long and with some adaptations for easier use in R.

Install

R (CRAN)pak (dev)Ubuntu (r2u)Fedora (COPR)openSUSE (OBS)

install.packages("GetoptLong", repos = "https://cloud.r-project.org/")

Installs the current CRAN release. Prebuilt binaries on Windows and macOS.

if (!requireNamespace("pak", quietly = TRUE))
  install.packages("pak", repos = "https://cloud.r-project.org/")
pak::pak("jokergoo/GetoptLong")

Development version from jokergoo/GetoptLong. Installs pak first if it is not already available.

Release

# enable cranapt (r2u) if it is not already set up, then install
grep -rqs r2u.stat.illinois.edu /etc/apt/sources.list /etc/apt/sources.list.d/ \
  || curl -fsSL https://raw.githubusercontent.com/eddelbuettel/r2u/master/inst/scripts/add_cranapt_noble.sh | sudo bash
sudo apt install -y r-cran-getoptlong

Fast Ubuntu binaries via r2u (no compilation). The cranapt setup runs once and is skipped when it is already enabled.

bspm (used by r2u) also needs make: sudo apt install make

# enable the iucar/cran COPR if it is not already present, then install
ls /etc/yum.repos.d/*iucar*cran*.repo >/dev/null 2>&1 \
  || sudo dnf copr enable -y iucar/cran
sudo dnf install -y R-CRAN-GetoptLong

RPMs from the iucar/cran COPR, rebuilt from CRAN.

For install.packages() integration in R, also: sudo dnf install R-CoprManager

# add the autoCRAN OBS repo (Tumbleweed) if it is missing, then install
zypper -q lr | grep -qi autoCRAN \
  || sudo zypper addrepo https://download.opensuse.org/repositories/devel:/languages:/R:/autoCRAN/openSUSE_Tumbleweed/devel:languages:R:autoCRAN.repo
sudo zypper install -y R-GetoptLong

RPMs auto-built from CRAN on openSUSE OBS (Tumbleweed).

Health

CRAN checks

13OK

Slowest check: 3.1 min · r-oldrel-windows-x86_64

Code health

Yes

Tests · ratio 0.25

61.4%

Coverage · measured lines

100%

Documentation · exports

Dependencies · direct

Check history

OK2026-03-10
14 OK · 0 NOTE · 0 WARNING · 0 ERROR · 0 FAILURE

Documentation

READMENoVignettesYes · dynamicpkgdown siteNoNEWSYes · 100% structuredCode of conductNoContributing guideNo

Examples that run: 100%
Documented parameters: 100%
Return-value docs: 20%
References docs: 0%

Downloads

1.2M

CRAN downloads in the past year

Rank #536 · ~3.4K/day · ~102.7K/mo

Releases R versions

Daily download trend is not available in this view yet.

45.1K30 days

142.6K90 days

1.2M1 year

Compare downloads with other packages →

Also on3.9K r2u33 autocran43.6K conda_forge322 bioconda18 c2d4u

Repository

GitHub ↗ jokergoo/getoptlong

17Stars

3Forks

5Open issues

0Open PRs

0Releases

229Commits

1Contributors

229 commits · Last activity 2026-02-06

Stars over time

2024-10-03 · 172026-07-07 · 17

Repository practices

Upstream repositoryBeta

1 development-tooling and community-health practice detected across 1 family in the upstream repository

Checks run against github.com/jokergoo/getoptlong on 2026-07-19.

Continuous integration (1)

GitHub Actions

How this is detected·Detection ruleset v1 (2026-07-18)

Dependencies

Declared dependencies

7 external dependencies (excludes base and recommended)

Depends (1)

R >= 4.0.0

Imports (4)

rjson GlobalOptionsmethodscrayon

LinkingTo (0)

none

Suggests (4)

testthat knitr markdown rmarkdown

Enhances (0)

none

Dependency license breakdown →

Reverse dependencies

6direct

1indirect

bsub pkgndep reproducer spiralize GlobalOptions ProjectTemplate

Code & Tests

Code Composition

R 2,626 (56%)Other 928 (20%)Vignettes 577 (12%)Rd 384 (8%)CSS 167 (4%)

Code characteristics

Object systems

RC1

Cyclomatic complexity: 3.5 median / 53 max
Test cases: 32 / 0.25 per code line
System requirements: 2 external

Test coverage

Line coverage

61%

Expression

59.7%

Tests / Examples

61.4% / 7% ex

Functions

34 10 exported

Complexity

7.8 avg / 53 max

Call network

34 nodes / 57 edges

Call graph

Open call graph →

Loading call graph…

Lowest coverage

34 functions

Function	Cyclo	Coverage
GetOptions exp	1	0%
get_scriptdir exp	2	0%
source_script exp	1	0%
subCommands exp	38	0%
print_help_msg_sub_commands	18	0%
source	1	0%

People & History

People (1)

Maintainer (1)

Zuguang Gu

Author, Maintainer

Authors (1)

Zuguang Gu

Author, Maintainer

Package Timeline

25 releases. Pick two to compare their code metrics. R releases are shown for context.

R
R 4.6.0 released · 2026-04-24
1.1.1Latest
2026-04-08 · current release · diff ↗
1.1.0
2025-11-28 · diff ↗
R
R 4.5.0 released · 2025-04-11
R
R 4.4.0 released · 2024-04-24
R
R 4.3.0 released · 2023-04-21
R
R 4.2.0 released · 2022-04-22
R
R 4.1.0 released · 2021-05-18
1.0.5
2020-12-15 · diff ↗
1.0.4
2020-10-19 · diff ↗
1.0.3
2020-10-01 · diff ↗
1.0.2
2020-07-06 · diff ↗
1.0.1
2020-07-05 · diff ↗
1.0.0
2020-06-10 · diff ↗
R
R 4.0.0 released · 2020-04-24
0.1.8
2020-01-09 · diff ↗

Show 23 earlier events

R
R 3.6.0 released · 2019-04-26
0.1.7
2018-06-10 · diff ↗
R
R 3.5.0 released · 2018-04-23
R
R 3.4.0 released · 2017-04-21
0.1.6
2017-03-07 · diff ↗
0.1.5
2016-09-26 · diff ↗
0.1.4
2016-08-14 · diff ↗
R
R 3.3.0 released · 2016-05-03
0.1.3
2016-04-23 · diff ↗
0.1.2
2016-03-25 · diff ↗
0.1.1
2015-12-04 · diff ↗
R
R 3.2.0 released · 2015-04-16
0.1.0
2015-03-09 · diff ↗
0.0.9
2015-01-29 · diff ↗
0.0.8
2014-11-06 · diff ↗
0.0.7
2014-10-11 · diff ↗
0.0.6
2014-08-19 · diff ↗
0.0.5
2014-07-30 · diff ↗
0.0.4
2014-06-17 · diff ↗
R
R 3.1.0 released · 2014-04-10
0.0.3
2013-12-10 · diff ↗
0.0.2
2013-11-28
R
R 3.0.0 released · 2013-04-03

Package metadata

First published: 2013-11-28
Total releases: 25 / 13 yrs
License: MIT + file LICENSE OSI
Minimum R: ≥ 4.0.0
Download size: 1.0 MB
Installed size: not tracked yet
With dependencies: not tracked yet

Report a problem with this page →