RubyGems - specify_cli - Versions diffs - 0.0.5 - Mend

specify_cli 0.0.5

Files changed (106) hide show

checksums.yaml +7 -0
data/.gitignore +4 -0
data/.rspec +1 -0
data/Gemfile +17 -0
data/Gemfile.lock +117 -0
data/LICENSE.txt +21 -0
data/README.rdoc +43 -0
data/Rakefile +15 -0
data/bin/specify_cli +248 -0
data/lib/specify.rb +45 -0
data/lib/specify/branch_parser.rb +85 -0
data/lib/specify/cli.rb +11 -0
data/lib/specify/cli/database_setup.rb +46 -0
data/lib/specify/cli/stubs.rb +63 -0
data/lib/specify/cli/viewset.rb +21 -0
data/lib/specify/configuration.rb +12 -0
data/lib/specify/configuration/config.rb +120 -0
data/lib/specify/configuration/db_config.rb +162 -0
data/lib/specify/configuration/host_config.rb +37 -0
data/lib/specify/database.rb +140 -0
data/lib/specify/models.rb +43 -0
data/lib/specify/models/accession.rb +33 -0
data/lib/specify/models/agent.rb +138 -0
data/lib/specify/models/app_resource_data.rb +32 -0
data/lib/specify/models/app_resource_dir.rb +43 -0
data/lib/specify/models/auto_numbering_scheme.rb +94 -0
data/lib/specify/models/collecting_event.rb +38 -0
data/lib/specify/models/collection.rb +67 -0
data/lib/specify/models/collection_object.rb +127 -0
data/lib/specify/models/createable.rb +21 -0
data/lib/specify/models/determination.rb +63 -0
data/lib/specify/models/discipline.rb +61 -0
data/lib/specify/models/division.rb +26 -0
data/lib/specify/models/geography.rb +5 -0
data/lib/specify/models/geography/administrative_division.rb +32 -0
data/lib/specify/models/geography/geographic_name.rb +66 -0
data/lib/specify/models/geography/geography.rb +23 -0
data/lib/specify/models/institution.rb +13 -0
data/lib/specify/models/locality.rb +50 -0
data/lib/specify/models/preparation.rb +53 -0
data/lib/specify/models/preparation_type.rb +30 -0
data/lib/specify/models/record_set.rb +55 -0
data/lib/specify/models/record_set_item.rb +29 -0
data/lib/specify/models/taxonomy.rb +6 -0
data/lib/specify/models/taxonomy/common_name.rb +14 -0
data/lib/specify/models/taxonomy/rank.rb +31 -0
data/lib/specify/models/taxonomy/taxon.rb +54 -0
data/lib/specify/models/taxonomy/taxonomy.rb +21 -0
data/lib/specify/models/tree_queryable.rb +55 -0
data/lib/specify/models/updateable.rb +20 -0
data/lib/specify/models/user.rb +104 -0
data/lib/specify/models/view_set_object.rb +32 -0
data/lib/specify/number_format.rb +60 -0
data/lib/specify/services.rb +18 -0
data/lib/specify/services/service.rb +51 -0
data/lib/specify/services/stub_generator.rb +291 -0
data/lib/specify/services/view_loader.rb +177 -0
data/lib/specify/session.rb +77 -0
data/lib/specify/user_type.rb +61 -0
data/lib/specify/version.rb +19 -0
data/man/specify_cli-database.1 +60 -0
data/man/specify_cli-database.1.html +137 -0
data/man/specify_cli-database.1.ronn +53 -0
data/man/specify_cli-repository.1 +55 -0
data/man/specify_cli-repository.1.html +128 -0
data/man/specify_cli-repository.1.ronn +42 -0
data/man/specify_cli-stubs.1 +177 -0
data/man/specify_cli-stubs.1.html +239 -0
data/man/specify_cli-stubs.1.ronn +147 -0
data/man/specify_cli-viewset.1 +92 -0
data/man/specify_cli-viewset.1.html +154 -0
data/man/specify_cli-viewset.1.ronn +72 -0
data/man/specify_cli.1 +213 -0
data/man/specify_cli.1.html +252 -0
data/man/specify_cli.1.ronn +157 -0
data/spec/branch_parser_spec.rb +94 -0
data/spec/cli/stubs_spec.rb +44 -0
data/spec/configuration/config_spec.rb +269 -0
data/spec/configuration/db_config_spec.rb +299 -0
data/spec/configuration/host_config_spec.rb +64 -0
data/spec/database_spec.rb +83 -0
data/spec/examples.txt +217 -0
data/spec/helpers.rb +15 -0
data/spec/models/app_resource_data_spec.rb +38 -0
data/spec/models/app_resource_dir_spec.rb +8 -0
data/spec/models/auto_numbering_scheme_spec.rb +78 -0
data/spec/models/collection_object_spec.rb +92 -0
data/spec/models/collection_spec.rb +32 -0
data/spec/models/discipline_spec.rb +31 -0
data/spec/models/record_set_spec.rb +18 -0
data/spec/models/user_spec.rb +182 -0
data/spec/models/view_set_object_spec.rb +70 -0
data/spec/number_format_spec.rb +43 -0
data/spec/services/stub_generator_spec.rb +635 -0
data/spec/services/view_loader_spec.rb +436 -0
data/spec/session_spec.rb +105 -0
data/spec/spec_helper.rb +116 -0
data/spec/support/db.yml +12 -0
data/spec/support/stub.yaml +17 -0
data/spec/support/stub_locality.yaml +19 -0
data/spec/support/viewsets/paleo.views.xml +30 -0
data/spec/support/viewsets/paleo.xml +30 -0
data/spec/user_type_spec.rb +79 -0
data/specify_cli.gemspec +27 -0
data/specify_cli.rdoc +1 -0
metadata +246 -0

data/man/specify_cli-database.1.ronn ADDED Viewed

@@ -0,0 +1,53 @@
+specify_cli-database(1) -- A command line interface for Specify
+===============================================================================
+## SYNOPSIS
+`specify_cli` [<global options>] `database` <name>
+## DESCRIPTION
+The database configuration file (default: *~/.specify\_dbs.rc.yaml*) has a
+`hosts` section which contains settings for Specify databases by grouped by
+*hostname*.
+Use the `database` command to add information for a specific database using this command.
+Use the specify\_cli global option `--host` to provide the host information and
+pass the *name* of the database to configure as an argument.
+The command will look up the *host* and *database* in the database configuration
+file and ask for necessary information to configure either. The command will
+not overwrite existing configurations. If you need to change information, edit
+the file.
+Information required to configure a *host* is the port number.
+Information required to configure a *database* is the MySQL/MariaDB user name
+and password. The user will be the typically be the Specify *master user* (or
+any user with equivalent permissions on the database) Leave the password blank
+to be prompted when working with commands that read the file (**specify_cli-stubs(1)**, **specify_cli-viewset(1)**). Apart from the
+MySQL/MariaDB user, `specify_cli` the command will also ask for a *specify user*
+name. Every command (except the configuration commands
+**specify_cli-database(1)** and **specify_cli-repository(1)**) will start a
+session in Specify where the Specify user will be logged in to the collection.
+Any records created or modified during this session will be marked as created by
+or modified by the *specify user*.
+## OPTIONS
+None.
+## EXAMPLES
+Configure a database `Specify` on the host `specify.example.org`:
+    $ specify_cli --host=specify.example.org database Specify
+Configure a database `SpecifyTest` on localhost:
+    $ specify_cli database SpecifyTest
+## SPECIFY_CLI
+Part of the specify_cli(1) suite

data/man/specify_cli-repository.1 ADDED Viewed

@@ -0,0 +1,55 @@
+.\" generated with Ronn/v0.7.3
+.\" http://github.com/rtomayko/ronn/tree/0.7.3
+.
+.TH "SPECIFY_CLI\-REPOSITORY" "1" "August 2018" "" ""
+.
+.SH "NAME"
+\fBspecify_cli\-repository\fR \- A command line interface for Specify
+.
+.SH "SYNOPSIS"
+\fBspecify_cli\fR [\fIglobal options\fR] \fBrepository\fR \fIpath\fR \fBspecify_cli\fR [\fIglobal options\fR] \fBrepository\fR \fB\-\-c\fR
+.
+.SH "DESCRIPTION"
+The database configuration file (default: \fI~/\.specify_dbs\.rc\.yaml\fR) has a \fBdir_names\fR section which contains mappings of paths for directories containing Specify resource files to hostnames\.
+.
+.P
+The \fBspecify_cli\-viewset(1)\fR command can automatically resolve targets (host, database, collection, level) based on branch names in a Git repository\. To allow working with multiple databases on different hosts, a repository needs to be mapped to a host name\. This is done by mapping the full path name of the directory to a hostname\.
+.
+.P
+The repository command will map the directory \fIpath\fR passed as an argument to the host provided using the \fB\-H\fR or \fB\-\-host\fR global option\.
+.
+.SH "OPTIONS"
+.
+.TP
+\fB\-c\fR, \fB\-\-current\fR
+Map the path of the current working directory\.
+.
+.SH "EXAMPLES"
+Map the directory \fB~/specify_forms/invertpaleo\fR to the host \fBspecify\.example\.org\fR:
+.
+.IP "" 4
+.
+.nf
+specify_cli \-H specify\.example\.org repository\en
+    ~/specify_forms/invertpaleo
+.
+.fi
+.
+.IP "" 0
+.
+.P
+Map the current directory to localhost:
+.
+.IP "" 4
+.
+.nf
+specify_cli repository \-\-current
+.
+.fi
+.
+.IP "" 0
+.
+.SH "SPECIFY_CLI"
+Part of the specify_cli(1) suite

data/man/specify_cli-repository.1.html ADDED Viewed

@@ -0,0 +1,128 @@
+<!DOCTYPE html>
+<html>
+<head>
+  <meta http-equiv='content-type' value='text/html;charset=utf8'>
+  <meta name='generator' value='Ronn/v0.7.3 (http://github.com/rtomayko/ronn/tree/0.7.3)'>
+  <title>specify_cli-repository(1) - A command line interface for Specify</title>
+  <style type='text/css' media='all'>
+  /* style: man */
+  body#manpage {margin:0}
+  .mp {max-width:100ex;padding:0 9ex 1ex 4ex}
+  .mp p,.mp pre,.mp ul,.mp ol,.mp dl {margin:0 0 20px 0}
+  .mp h2 {margin:10px 0 0 0}
+  .mp > p,.mp > pre,.mp > ul,.mp > ol,.mp > dl {margin-left:8ex}
+  .mp h3 {margin:0 0 0 4ex}
+  .mp dt {margin:0;clear:left}
+  .mp dt.flush {float:left;width:8ex}
+  .mp dd {margin:0 0 0 9ex}
+  .mp h1,.mp h2,.mp h3,.mp h4 {clear:left}
+  .mp pre {margin-bottom:20px}
+  .mp pre+h2,.mp pre+h3 {margin-top:22px}
+  .mp h2+pre,.mp h3+pre {margin-top:5px}
+  .mp img {display:block;margin:auto}
+  .mp h1.man-title {display:none}
+  .mp,.mp code,.mp pre,.mp tt,.mp kbd,.mp samp,.mp h3,.mp h4 {font-family:monospace;font-size:14px;line-height:1.42857142857143}
+  .mp h2 {font-size:16px;line-height:1.25}
+  .mp h1 {font-size:20px;line-height:2}
+  .mp {text-align:justify;background:#fff}
+  .mp,.mp code,.mp pre,.mp pre code,.mp tt,.mp kbd,.mp samp {color:#131211}
+  .mp h1,.mp h2,.mp h3,.mp h4 {color:#030201}
+  .mp u {text-decoration:underline}
+  .mp code,.mp strong,.mp b {font-weight:bold;color:#131211}
+  .mp em,.mp var {font-style:italic;color:#232221;text-decoration:none}
+  .mp a,.mp a:link,.mp a:hover,.mp a code,.mp a pre,.mp a tt,.mp a kbd,.mp a samp {color:#0000ff}
+  .mp b.man-ref {font-weight:normal;color:#434241}
+  .mp pre {padding:0 4ex}
+  .mp pre code {font-weight:normal;color:#434241}
+  .mp h2+pre,h3+pre {padding-left:0}
+  ol.man-decor,ol.man-decor li {margin:3px 0 10px 0;padding:0;float:left;width:33%;list-style-type:none;text-transform:uppercase;color:#999;letter-spacing:1px}
+  ol.man-decor {width:100%}
+  ol.man-decor li.tl {text-align:left}
+  ol.man-decor li.tc {text-align:center;letter-spacing:4px}
+  ol.man-decor li.tr {text-align:right;float:right}
+  </style>
+</head>
+<!--
+  The following styles are deprecated and will be removed at some point:
+  div#man, div#man ol.man, div#man ol.head, div#man ol.man.
+  The .man-page, .man-decor, .man-head, .man-foot, .man-title, and
+  .man-navigation should be used instead.
+-->
+<body id='manpage'>
+  <div class='mp' id='man'>
+  <div class='man-navigation' style='display:none'>
+    <a href="#NAME">NAME</a>
+    <a href="#SYNOPSIS">SYNOPSIS</a>
+    <a href="#DESCRIPTION">DESCRIPTION</a>
+    <a href="#OPTIONS">OPTIONS</a>
+    <a href="#EXAMPLES">EXAMPLES</a>
+    <a href="#SPECIFY_CLI">SPECIFY_CLI</a>
+  </div>
+  <ol class='man-decor man-head man head'>
+    <li class='tl'>specify_cli-repository(1)</li>
+    <li class='tc'></li>
+    <li class='tr'>specify_cli-repository(1)</li>
+  </ol>
+  <h2 id="NAME">NAME</h2>
+<p class="man-name">
+  <code>specify_cli-repository</code> - <span class="man-whatis">A command line interface for Specify</span>
+</p>
+<h2 id="SYNOPSIS">SYNOPSIS</h2>
+<p><code>specify_cli</code> [<var>global options</var>] <code>repository</code> <var>path</var>
+<code>specify_cli</code> [<var>global options</var>] <code>repository</code> <code>--c</code></p>
+<h2 id="DESCRIPTION">DESCRIPTION</h2>
+<p>The database configuration file (default: <em>~/.specify_dbs.rc.yaml</em>) has a
+<code>dir_names</code> section which contains mappings of paths for directories containing
+Specify resource files to hostnames.</p>
+<p>The <strong><span class="man-ref">specify_cli-viewset<span class="s">(1)</span></span></strong> command can automatically resolve targets
+(host, database, collection, level) based on branch names in a Git repository.
+To allow working with multiple databases on different hosts, a repository needs
+to be mapped to a host name. This is done by mapping the full path name of the directory to a hostname.</p>
+<p>The repository command will map the directory <em>path</em> passed as an argument to
+the host provided using the <code>-H</code> or <code>--host</code> global option.</p>
+<h2 id="OPTIONS">OPTIONS</h2>
+<dl>
+<dt><code>-c</code>, <code>--current</code></dt><dd>  Map the path of the current working directory.</dd>
+</dl>
+<h2 id="EXAMPLES">EXAMPLES</h2>
+<p>Map the directory <code>~/specify_forms/invertpaleo</code> to the host
+<code>specify.example.org</code>:</p>
+<pre><code>specify_cli -H specify.example.org repository\n
+    ~/specify_forms/invertpaleo
+</code></pre>
+<p>Map the current directory to localhost:</p>
+<pre><code>specify_cli repository --current
+</code></pre>
+<h2 id="SPECIFY_CLI">SPECIFY_CLI</h2>
+<p>Part of the <span class="man-ref">specify_cli<span class="s">(1)</span></span> suite</p>
+  <ol class='man-decor man-foot man foot'>
+    <li class='tl'></li>
+    <li class='tc'>August 2018</li>
+    <li class='tr'>specify_cli-repository(1)</li>
+  </ol>
+  </div>
+</body>
+</html>

data/man/specify_cli-repository.1.ronn ADDED Viewed

@@ -0,0 +1,42 @@
+specify_cli-repository(1) -- A command line interface for Specify
+===============================================================================
+## SYNOPSIS
+`specify_cli` [<global options>] `repository` <path>
+`specify_cli` [<global options>] `repository` `--c`
+## DESCRIPTION
+The database configuration file (default: *~/.specify\_dbs.rc.yaml*) has a
+`dir_names` section which contains mappings of paths for directories containing
+Specify resource files to hostnames.
+The **specify_cli-viewset(1)** command can automatically resolve targets
+(host, database, collection, level) based on branch names in a Git repository.
+To allow working with multiple databases on different hosts, a repository needs
+to be mapped to a host name. This is done by mapping the full path name of the directory to a hostname.
+The repository command will map the directory *path* passed as an argument to
+the host provided using the `-H` or `--host` global option.
+## OPTIONS
+* `-c`, `--current`:
+    Map the path of the current working directory.
+## EXAMPLES
+Map the directory `~/specify_forms/invertpaleo` to the host
+`specify.example.org`:
+    specify_cli -H specify.example.org repository\n
+        ~/specify_forms/invertpaleo
+Map the current directory to localhost:
+    specify_cli repository --current
+## SPECIFY_CLI
+Part of the specify_cli(1) suite

data/man/specify_cli-stubs.1 ADDED Viewed

@@ -0,0 +1,177 @@
+.\" generated with Ronn/v0.7.3
+.\" http://github.com/rtomayko/ronn/tree/0.7.3
+.
+.TH "SPECIFY_CLI\-STUBSY" "1" "August 2018" "" ""
+.
+.SH "NAME"
+\fBspecify_cli\-stubsy\fR \- A command line interface for Specify
+.
+.SH "SYNOPSIS"
+\fBspecify_cli\fR [\fIglobal options\fR] \fBstubs\fR [\fIoptions\fR] \fIcollection\fR \fIcount\fR \fBspecify_cli\fR \fBstubs\fR \fB\-\-file\fR \fIcount\fR
+.
+.SH "DESCRIPTION"
+The stubs command creates stub records in a collection, so that catalog numbers can be printed to labels e\.g\. prior to mass digitizaton\. The command currently only works for collection objects, and will currently only work for collections using the numeric catalog numbering scheme\.
+.
+.P
+Generated catalog numbers are printed to stdout\.
+.
+.P
+The number of stub records created is specified with the \fIcount\fR argument\. The target collection is provided as the \fIcollection\fR argument\. \fIHost\fR and \fIdatabase\fR are provided using the global options \fB\-\-host\fR and \fB\-\-database\fR respectively\. The command will generate a record set with all generated collection objects\. The record set will be owned by either the \fISpecify user\fR (as provided via the global option \fB\-\-specify_user\fR or in the database configuration file), or the \fISpecify user\fR provided with the \fB\-\-cataloger\fR option\. If no dataset name is provided using the \fB\-\-dataset\fR option, the default name will be \fBstub record set <TIMESTAMP>\fR\.
+.
+.P
+Records can be created with the following basic information (provided using command options \- see below): cataloger, accession, geography/locality, taxon, preparation\.
+.
+.P
+Only existing accessions and preparation types can be assigned at present\. Unknown items will raise an error\.
+.
+.P
+If geographic information is provided, but no locality name, the default locality name will be \fBnot cataloged, see label\fR\. This can be changed using the \fB\-\-locality\fR option\. Geographic information should be passed in the format \fBGeographic Rank: Name; Geographic Subrank: Name; locality: name\fR where \fIlocality\fR is optional (if not given, the default locality name will be used)\. Only geographic names/ranks and locality names that exist in the database will can be used (unknown item will raise an error)\.
+.
+.P
+Taxon information is assigned as a determination\. Only one determination can be given to a stub records using the command\. Taxon information is provided in the format \fBTaxon Rank: Name; Taxon Subrank: Name\fR\. Only taxonomic names that exist in the database will be accepted\. Unknown items will raise an error\.
+.
+.P
+Alternatively to using the options, a YAML file with all required information can be passed with the \fB\-\-file option\fR\. In that case, the \fIdatabase\fR and \fIcollection\fR arguments can be ommitted\.
+.
+.SH "FILES"
+YAML files with stub record information provided using the \fB\-\-file\fR option should have the general structure:
+.
+.IP "" 4
+.
+.nf
+\-\-\-
+:stub_generator:
+  :host: <hostname>
+  :database: <database name>
+  :collection: <collection name>
+  :config: <database configuration file>
+dataset_name: <record set name>
+accession: <accession number>
+cataloger: <specify user name>
+collecting_data:
+  <1st rank>: <name>
+  <2nd rank>: <name>
+  <3rd rank>: <name>
+  :locality: <name>
+default_locality_name: <name>
+determination:
+  <rank>: <name>
+preparation:
+  :type: <preparation type>
+  :count: <preparation count>
+.
+.fi
+.
+.IP "" 0
+.
+.P
+Items prefixed with \fB:\fR in the YAML will be deserialized as Ruby symbols and need to be prefixed with \fB:\fR in your file\. Leave any unnecessary items out\. The first section \fB:stub_generator\fR contains connection information\. When \fB:config\fR is left out, \fIstubs\fR will use the config file provided with the global option \fB\-\-db_config\fR or the default file \fB~/\.specify_dbs\.rc\.yaml\fR if none provided\. Likewise, \fB:host\fR, and \fB:database\fR can be provided using the global options \fB\-\-host\fR and \fB\-\-database\fR respectively\.
+.
+.P
+If you provide the \fB:locality\fR under \fBcollecting data:\fR, this will have precedence over the \fBdefault_locality_name\fR, so the latter is redundant\.
+.
+.SH "OPTIONS"
+.
+.IP "\(bu" 4
+\fB\-f\fR, \fB\-\-file\fR \fIfile\fR: Load stub record information from a YAML file\.
+.
+.IP "\(bu" 4
+\fB\-c\fR, \fB\-\-cataloger\fR \fIname\fR: Specify user appearing as cataloger and owner of the record set\.
+.
+.IP "\(bu" 4
+\fB\-d\fR, \fB\-\-dataset\fR \fIname\fR: Name of the datas set (record set) generated\.
+.
+.IP "\(bu" 4
+\fB\-a\fR, \fB\-\-accession\fR \fIaccession_number\fR Accession number for the accession to which the stub records belong\.
+.
+.IP "\(bu" 4
+\fB\-g\fR, \fB\-\-geography\fR \fIgeography\fR Geographic and locality information for the stub records\. Format of \fIgeography\fR: \fB\'Rank1: Name; Rank2: Name; locality: name\'\fR
+.
+.IP "\(bu" 4
+\fB\-l\fR, \fB\-\-locality\fR \fIname\fR: Default locality name if geographic information has no locality\.
+.
+.IP "\(bu" 4
+\fB\-t\fR, \fB\-\-taxon\fR \fItaxon\fR: Taxon to which stub records are determined\. Format of \fItaxon\fR: \fB\'Rank1: Name; Rank2: Name; locality: name\'\fR
+.
+.IP "\(bu" 4
+\fB\-p\fR, \fB\-\-preptype\fR \fIname\fR: Preparation type for the stub records, if they have preparations\.
+.
+.IP "\(bu" 4
+\fB\-n\fR, \fB\-\-prepcount\fR \fInumber\fR: Number of preparation items (requires \-\-preptype to be set)\.
+.
+.IP "" 0
+.
+.SH "EXAMPLES"
+Create 10 blank stub records in the collection \fBTriloites\fR in the database \fBSpecify\fR on localhost:
+.
+.IP "" 4
+.
+.nf
+$ specify_cli \-D Specify stubs Trilobites 10
+.
+.fi
+.
+.IP "" 0
+.
+.P
+Create 10 stub records determined to \fBAsaphidae\fR in the collection \fBTriloites\fR in the database\fBSpecify\fR on localhost:
+.
+.IP "" 4
+.
+.nf
+$ specify_cli \-D Specify stubs\en
+    \-\-taxon=\'Class: Trilobita; Order: Asaphida; Family: Asaphidae\'\en
+    Trilobites 10
+.
+.fi
+.
+.IP "" 0
+.
+.P
+Create 10 stub records for herbarium sheets in the collection \fBOrchids\fR in the database \fBSpecify\fR on localhost, determined to taxon \fBOrchidaceae\fR:
+.
+.IP "" 4
+.
+.nf
+$ specify_cli \-D Specify stubs \-\-taxon=\'Family: Orchidaceae\'\en
+    \-\-preptype=Sheet \-\-perpcount=1 Orchids 10
+.
+.fi
+.
+.IP "" 0
+.
+.P
+Create 10 stub records for herbarium sheets in the collection \fBOrchids\fR in the database \fBSpecify\fR on localhost, determined to taxon \fBOrchidaceae\fR, collected in \fBDowntown Lawrence\fR:
+.
+.IP "" 4
+.
+.nf
+$ specify_cli \-D Specify stubs \-\-taxon=\'Family: Orchidaceae\'\en
+    \-\-geography=\'Country: United States, State: Kansas,\en
+    County: Douglas County; locality: Downtown Lawrence\'
+    \-\-preptype=Sheet \-\-perpcount=1 Orchids 10
+.
+.fi
+.
+.IP "" 0
+.
+.P
+Create 10 stub records from a YAML file \fBstub_details\.yaml\fR:
+.
+.IP "" 4
+.
+.nf
+$ specify_cli stubs \-\-file=stub_details\.yaml 10
+.
+.fi
+.
+.IP "" 0
+.
+.SH "SPECIFY_CLI"
+Part of the specify_cli(1) suite