iNarc 🌿

A CLI client to query iNaturalist taxon information with filtering based on genus, species, location, and page number. Results are printed using rich tables.

Use Examples:

1: Search Species python3 inarc.py -g <GENUS> -s <SPECIES>

python3 inarc.py -g asclepias -s tuberosa

2: Search Species by Page python3 inarc.py -g <GENUS> -s <SPECIES> -p <pgNum>

python3 inarc.py -g asclepias -s tuberosa -p 2

3: Search Species by location

iNaturalist's API did not support searching taxon by location at this time, openstreetmap bounding boxes are used to supplement this, any location supported by OSM should work. OSM location syntax is required.

python3 inarc.py -g <GENUS> -s <SPECIES> -p <pgNum> -l '<location>'

python3 inarc.py -g asclepias -s tuberosa -p 2 -l 'Austin, Texas'

Full Options 🛠️

usage: inarc.py [-h] -g GENUS -s SPECIES [-n NUMBER_TAXON] [-p PAGE] [-l LOCATION]

options:
  -h, --help            show this help message and exit
  -g GENUS, --genus GENUS
                        Selects plant Genus
  -s SPECIES, --species SPECIES
                        Selects plant Species
  -n NUMBER_TAXON, --number-taxon NUMBER_TAXON
                        Selects number of taxon results to be printed
  -p PAGE, --page PAGE  Selects page number to be printed
  -l LOCATION, --location LOCATION
                        prints taxon based on location, use format district or district, province or
                        state, country