1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
|
% Generated by roxygen2: do not edit by hand
% Please edit documentation in R/optparse-package.R
\docType{package}
\name{optparse-package}
\alias{optparse-package}
\alias{optparse}
\title{Command line option parser}
\description{
Goal is to create an R package of a command line parser inspired by Python's
\dQuote{optparse} library.
}
\details{
\code{optparse} is primarily intended to be used with
\dQuote{Rscript}. It facilitates writing \dQuote{#!} shebang scripts that
accept short and long flags/options. It can also be used from directly, but
is probably less useful in this context.
See package vignette for a more detailed example.
Notes on naming convention in package: 1. An option is one of the shell-split
input strings. 2. A flag is a type of option. a flag can be defined as having
no argument (defined below), a required argument, or an optional argument. 3.
An argument is a type of option, and is the value associated with a flag. 4.
A long flag is a type of flag, and begins with the string \dQuote{--}. If the
long flag has an associated argument, it may be delimited from the long flag
by either a trailing =, or may be the subsequent option. 5. A short flag is a
type of flag, and begins with the string \dQuote{-}. If a short flag has an
associated argument, it is the subsequent option. short flags may be bundled
together, sharing a single leading \dQuote{"-"}, but only the final short
flag is able to have a corresponding argument. \%\%\%
}
\examples{
example_file <- system.file("exec", "example.R", package = "optparse")
example_file_2 <- system.file("exec", "display_file.R", package = "optparse")
\dontrun{
readLines(example_file)
readLines(example_file_2)
}
}
\references{
Python's \code{optparse} library, which this package is based on,
is described here: \url{https://docs.python.org/3/library/optparse.html}
}
\seealso{
\code{\link[getopt]{getopt}}
}
\author{
Trevor L. Davis.
Some documentation and unit tests ported from Allen Day's getopt package.
The documentation for Python's optparse library, which this package is based
on, is Copyright 1990-2009, Python Software Foundation.
}
\keyword{package}
|
