Skip to content

command

0.3.0Package record

Process Command Line Arguments

0packages depend
3.1Kdownloads / year
99.9%test coverage
13/13flavors OK

Overview

About

Process command line arguments. Processing includes checking, naming, and coercing to numeric, date, or logical. By capturing assumptions about inputs and outputs, the 'command' package can provide scripts with well defined interfaces, leading to safer, more modular data analysis pipelines.

Changes in 0.3.0

Variable-length file arguments

  • Added cmd_assign_collect() and cmd_assign_collect_quiet(), which assign every unnamed command-line argument to the one argument that was not passed by name.
  • extract_make(), extract_shell(), makefile(), and shell_script() read calls to cmd_assign_collect(). A character vector of paths becomes one file name per element, and in a Makefile the last element is the target.
  • extract_make(), extract_shell(), makefile(), and shell_script() now recognize cmd_assign_quiet(), cmd_assign_collect_quiet(), and a call written with a command:: or command::: prefix.
Show all changes in 0.3.0Hide the rest of the changes in 0.3.0
  • The dot-name convention for file arguments has been documented in the help for cmd_assign() and cmd_assign_collect().
  • shell_script() orders commands by matching output paths with input paths.
  • cmd_assign() and cmd_assign_collect() reject a named command-line argument that is passed more than once.
  • makefile(), shell_script(), extract_make(), and extract_shell() read literal values from calls. A name or a function call such as file.path() or paste() is an error.

Command-line values

  • A named argument is split on the first =, so the value may itself contain =. An argument with an empty name, such as --=value, is an error.

Shell commands

  • extract_shell() and shell_script() leave a plain length-1 vector unchanged, and quote a path or value only when it contains a space or a character that is special to the shell. NULL is written as --name=NULL.
  • shell_script() rejects a quiet value that is not TRUE or FALSE.

Bug fixes

  • The message for a missing directory now says that the directory does not exist.

Documentation

  • Revised the package description and the help pages.

From NEWS.md in the release

Install

Health

CRAN checks
13OK
Slowest check: 1.3 min · r-oldrel-windows-x86_64
Status changes
  • OK13 OK2026-08-05
  • NOTE12 OK, 1 NOTE2026-08-01
  • OK12 OK2026-04-25
  • NOTE13 OK, 1 NOTE2026-03-10
Advisories

none known

Documentation

In release 0.3.0
READMEYes · 70 wordsVignettesNoNEWSYes · 100% structured · mentions 0.3.0Citation fileNoWebsiteYes · pkgdown

The repository also keeps web-only articles.

Help pages
8includes a package overview page
Examples that run
100%7 run in a plain check (2 of them under a condition)
Exported functions with examples
100%
Documented parameters
100%
Return-value docs
100%
Help pages citing references
63%

Downloads

3.1K
CRAN downloads in the past year
Rank #8,796 · ~8/day · ~257/mo
Daily download trend is not available in this view yet.
35730 days
1.1K90 days
3.1K1 year
Compare downloads with other packages →
Also on102 r2u15 autocran

Repository

1Stars
0Forks
0Open issues
0Open PRs
0Releases
134Commits
1Commit identities
134 commits · Last activity 2026-10-17
Responsiveness
How these are sampled
PRs merged (all time)
not measured
Median days to close, 50 most recently updated closed issues
11
Median days to close, 50 most recently updated closed PRs
not measured

Stars over time

2025-09-12 · 12026-07-07 · 1
PracticesBeta

10 development-tooling and community-health practices detected across 5 families in the upstream repository

Checks run against github.com/bayesiandemography/command on 2026-10-18.

Continuous integration (2)
GitHub ActionsR CMD check workflow

The R CMD check workflow runs on Linux, macOS and Windows, and on R-devel

Docs source (4)
README.Rmdpkgdown

GitHub Pages site last deployed 2026-10-17 · The repository has a site deploy workflow

pkgdown site last built 2026-10-17

Coverage (1)
Coverage reporting (Codecov)
CRAN release process (2)
cran-comments.mdCRAN-SUBMISSION
Show all practicesHide 1 practice
Lint, format, editor (1)
RStudio project
How this is detected·Detection ruleset v3 (2026-09-26)
AI coding toolsBeta

This repository shows signs of AI coding tools.

  • Cursorfirst seen on or before 2026-07-21
    Commits: at least 31 crediting it in the message
Counts are commits, not lines of code. Commits by a tool's accounts count once across all of its accounts. Commits crediting it are the largest count among its credit lines, a minimum.How this is detected·Detection ruleset v4 (updated 2026-09-27)

Dependencies

Declared dependencies
12 external dependencies (excludes base and recommended)

Installing command adds 1 package (1 with compiled code, 629 KB of source tarballs). Heaviest: cli 629 KB.

Depends (1)
R >= 3.5.0
Imports (3)
climethodstools
LinkingTo (0)
none
Enhances (0)
none
Reverse dependencies
0direct
0indirect

Nothing depends on this yet.

Datasets

People & History

People (2)
Author, Maintainer since 0.1.2 (2025)
Releases (4)

Pick two releases to compare their code metrics.

  • 0.3.0Latest
    record
    2026-10-17 · current release · diff ↗ ·
    added 2 exports
    cmd_assign_collect, cmd_assign_collect_quiet
  • 0.2.0
    record
    2026-07-23 · diff ↗ ·
    added 1 export
    use_renv
  • R
    R 4.6.0 released · 2026-04-24
  • 0.1.3
    record
    2025-11-22 · diff ↗
  • 0.1.2
    record
    2025-10-16
  • R
    R 4.5.0 released · 2025-04-11

Package metadata

First published
2025-10-16
Total releases
4 / 1 yrs
License
MIT + file LICENSE OSI
Minimum R
≥ 3.5.0
Download size
801 KB

Cite

Cite this package

Run in R for the authors' preferred citation:

citation("command")
Bryant, J., & Bayesian Demography Limited. (2026). command: Process Command Line Arguments (Version 0.3.0) [Computer software]. https://doi.org/10.32614/CRAN.package.command

This package has no citation file, so citation() returns this entry built from DESCRIPTION.

Cite the R Observatory

For a number measured here: a download total, a coverage figure, an archival date.

APA

Balamuta, J. J. (2026). R Observatory: Metrics for command version 0.3.0 [Data set]. HJJB, LLC. Data release v2026-10-21. https://doi.org/10.5281/zenodo.21843040

From data release v2026-10-21, which the citation names so these numbers can be found later. More on citing and the projects behind them.

Report a problem with this page →

Privacy choices

These apply to this browser and are stored on this device only. Nothing about your choice is sent to us.

Read the privacy policy