rda-python-metrics 2.0.5__tar.gz → 3.0.2__tar.gz

rda_python_metrics-3.0.2/PKG-INFO

@@ -0,0 +1,185 @@
+Metadata-Version: 2.4
+Name: rda_python_metrics
+Version: 3.0.2
+Summary: RDA Python Package to gather and view data usage metrics
+Author-email: Zaihua Ji <zji@ucar.edu>
+Project-URL: Homepage, https://github.com/NCAR/rda-python-metrics
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Development Status :: 5 - Production/Stable
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: rda_python_common
+Requires-Dist: rda_python_setuid
+Requires-Dist: geoip2
+Requires-Dist: ipinfo
+Requires-Dist: httplib2
+Requires-Dist: dnspython
+Requires-Dist: unidecode
+Requires-Dist: urllib3>=2.5.0
+Requires-Dist: requests>=2.33.0
+Requires-Dist: idna>=3.10
+Dynamic: license-file
+
+# rda_python_metrics
+
+RDA Python package to gather and view data usage metrics for the
+[NSF NCAR Geoscience Data Exchange (GDEX)](https://gdex.ucar.edu).
+
+## Programs
+
+The package provides two categories of programs:
+
+**Run as gdexdata via setuid (requires setup below):**
+
+| Command | Connector script | Description |
+|---------|-----------------|-------------|
+| `logarch` | `setuid_logarch` | Archive RDA log files (web, TDS, AWS, OSDF, dssdb) to the DECSDATA area |
+
+**Run as current user (no setuid required):**
+
+| Command | Description |
+|---------|-------------|
+| `fillawsusage` | Fill AWS usage metrics into the database |
+| `fillcdgusage` | Fill CDG usage metrics into the database |
+| `fillcodusage` | Fill COD usage metrics into the database |
+| `fillcountry` | Fill country information into the database |
+| `fillendtime` | Fill end times for usage records |
+| `fillgdexusage` | Fill GDEX usage metrics into the database |
+| `fillglobususage` | Fill Globus transfer usage metrics into the database |
+| `fillipinfo` | Fill IP geolocation info into the database |
+| `filloneorder` | Fill metrics for a single order |
+| `fillosdfusage` | Fill OSDF usage metrics into the database |
+| `fillrdadb` | Fill RDA database usage metrics |
+| `filltdsusage` | Fill TDS (THREDDS) usage metrics into the database |
+| `filluser` | Fill user information into the database |
+| `fillzenodousage` | Fill Zenodo usage metrics into the database |
+| `pgperson` | Retrieve user info from the UCAR People API by field |
+| `pgusername` | Retrieve user info from the UCAR People API by username |
+| `viewallusage` | View combined usage statistics |
+| `viewawsusage` | View AWS usage statistics |
+| `viewcheckusage` | View usage check results |
+| `viewcodusage` | View COD usage statistics |
+| `viewordusage` | View order usage statistics |
+| `viewosdfusage` | View OSDF usage statistics |
+| `viewrqstusage` | View request usage statistics |
+| `viewtdsusage` | View TDS usage statistics |
+| `viewwebfile` | View web file access records |
+| `viewwebusage` | View web usage statistics |
+
+## Environment setup
+
+Create a Python environment first; package installs in the next section run
+inside whichever environment you activate here.
+
+### Option A — Python venv (DECS machines)
+
+```bash
+python3 -m venv $ENVHOME          # e.g. /glade/u/home/gdexdata/gdexmsenv
+source $ENVHOME/bin/activate
+```
+
+### Option B — Conda (DAV/Casper)
+
+```bash
+conda create --prefix $ENVHOME python=3.12   # e.g. /glade/work/gdexdata/conda-envs/pg-gdex
+conda activate $ENVHOME
+```
+
+## Installing rda-python-metrics
+
+Pick whichever install mode fits your workflow.  All four pull in the
+transitive dependencies (`rda_python_common`, `rda_python_setuid`, `geoip2`,
+`ipinfo`, `httplib2`, `dnspython`, `unidecode`, `urllib3>=2.5.0`,
+`requests>=2.33.0`, `idna>=3.10`) automatically.
+
+For local development, clone this repo alongside your project and install it
+in editable mode so that changes are picked up without re-installing:
+
+```bash
+git clone https://github.com/NCAR/rda-python-metrics.git
+cd rda-python-metrics
+pip install -e .
+```
+
+To test a specific branch (e.g. an in-progress feature or fix branch), pass
+`-b/--branch` to `git clone`:
+
+```bash
+git clone -b <branch-name> https://github.com/NCAR/rda-python-metrics.git
+cd rda-python-metrics
+pip install -e .
+```
+
+For a regular (non-editable) install from a checkout:
+
+```bash
+pip install /path/to/rda-python-metrics
+```
+
+For a production install on a system that uses the published distribution:
+
+```bash
+pip install rda_python_metrics
+```
+
+## Setuid Setup
+
+`logarch` runs as the common user `PGLOG['COMMONUSER']` (default `gdexdata`)
+via the `rda_python_setuid` mechanism, which is pulled in automatically as
+a dependency.  After `pip install` above, choose one of the wiring options
+below.
+
+> **Note:** If `rda_python_setuid` is already installed and fully set up in
+> your environment, you can skip the compile step (`-c/--compile`) and the
+> optional `pgstart` step (`-p/--pgstart`).  The `-l/--link` step is still
+> required to wire up this package's own setuid program.
+
+### Full setuid install (requires sudo access to COMMONUSER)
+
+Run these steps once per environment:
+
+```bash
+# 1. Compile the pywrapper C binary (once per environment):
+pywrapper-install -c|--compile -n|--username gdexdata
+
+# 2. Wire up logarch as a setuid entry (or use 'all' to link every setuid_* at once):
+pywrapper-install -l|--link logarch
+pywrapper-install -l|--link all
+
+# 3. Optionally, install a pgstart_<loginname> binary so <loginname> (any
+#    user in the same group as PGLOG['COMMONUSER']) can run commands as
+#    themselves.  Run either by PGLOG['ADMINUSER'] (default zji, if it has
+#    'sudo -u <loginname>'), or by <loginname> directly:
+pywrapper-install -p|--pgstart -n|--username <loginname>
+```
+
+`pywrapper-install` with no arguments displays the full user guide.
+
+### Simple install (no sudo required, runs as current user)
+
+Users who do not need the setuid mechanism can create a direct symlink instead:
+
+```bash
+pywrapper-install -l|--link logarch -s|--simple
+pywrapper-install -l|--link all -s|--simple   # or link every setuid_* at once
+```
+
+This creates `bin/logarch -> bin/setuid_logarch` and logarch runs as the
+current user with no privilege change.
+
+### Update an existing installation (no sudo required)
+
+When the package is upgraded and a new `pywrapper.c` is bundled, recompile and
+reinstall all setuid binaries using the existing `pgstart_*` binaries:
+
+```bash
+pywrapper-install -u|--update
+```
+
+### Setup guide
+
+The shared setuid setup guide is shown automatically if `setuid_logarch` is
+invoked directly before the setuid wrapper has been configured.

rda_python_metrics-3.0.2/README.md

@@ -0,0 +1,160 @@
+# rda_python_metrics
+
+RDA Python package to gather and view data usage metrics for the
+[NSF NCAR Geoscience Data Exchange (GDEX)](https://gdex.ucar.edu).
+
+## Programs
+
+The package provides two categories of programs:
+
+**Run as gdexdata via setuid (requires setup below):**
+
+| Command | Connector script | Description |
+|---------|-----------------|-------------|
+| `logarch` | `setuid_logarch` | Archive RDA log files (web, TDS, AWS, OSDF, dssdb) to the DECSDATA area |
+
+**Run as current user (no setuid required):**
+
+| Command | Description |
+|---------|-------------|
+| `fillawsusage` | Fill AWS usage metrics into the database |
+| `fillcdgusage` | Fill CDG usage metrics into the database |
+| `fillcodusage` | Fill COD usage metrics into the database |
+| `fillcountry` | Fill country information into the database |
+| `fillendtime` | Fill end times for usage records |
+| `fillgdexusage` | Fill GDEX usage metrics into the database |
+| `fillglobususage` | Fill Globus transfer usage metrics into the database |
+| `fillipinfo` | Fill IP geolocation info into the database |
+| `filloneorder` | Fill metrics for a single order |
+| `fillosdfusage` | Fill OSDF usage metrics into the database |
+| `fillrdadb` | Fill RDA database usage metrics |
+| `filltdsusage` | Fill TDS (THREDDS) usage metrics into the database |
+| `filluser` | Fill user information into the database |
+| `fillzenodousage` | Fill Zenodo usage metrics into the database |
+| `pgperson` | Retrieve user info from the UCAR People API by field |
+| `pgusername` | Retrieve user info from the UCAR People API by username |
+| `viewallusage` | View combined usage statistics |
+| `viewawsusage` | View AWS usage statistics |
+| `viewcheckusage` | View usage check results |
+| `viewcodusage` | View COD usage statistics |
+| `viewordusage` | View order usage statistics |
+| `viewosdfusage` | View OSDF usage statistics |
+| `viewrqstusage` | View request usage statistics |
+| `viewtdsusage` | View TDS usage statistics |
+| `viewwebfile` | View web file access records |
+| `viewwebusage` | View web usage statistics |
+
+## Environment setup
+
+Create a Python environment first; package installs in the next section run
+inside whichever environment you activate here.
+
+### Option A — Python venv (DECS machines)
+
+```bash
+python3 -m venv $ENVHOME          # e.g. /glade/u/home/gdexdata/gdexmsenv
+source $ENVHOME/bin/activate
+```
+
+### Option B — Conda (DAV/Casper)
+
+```bash
+conda create --prefix $ENVHOME python=3.12   # e.g. /glade/work/gdexdata/conda-envs/pg-gdex
+conda activate $ENVHOME
+```
+
+## Installing rda-python-metrics
+
+Pick whichever install mode fits your workflow.  All four pull in the
+transitive dependencies (`rda_python_common`, `rda_python_setuid`, `geoip2`,
+`ipinfo`, `httplib2`, `dnspython`, `unidecode`, `urllib3>=2.5.0`,
+`requests>=2.33.0`, `idna>=3.10`) automatically.
+
+For local development, clone this repo alongside your project and install it
+in editable mode so that changes are picked up without re-installing:
+
+```bash
+git clone https://github.com/NCAR/rda-python-metrics.git
+cd rda-python-metrics
+pip install -e .
+```
+
+To test a specific branch (e.g. an in-progress feature or fix branch), pass
+`-b/--branch` to `git clone`:
+
+```bash
+git clone -b <branch-name> https://github.com/NCAR/rda-python-metrics.git
+cd rda-python-metrics
+pip install -e .
+```
+
+For a regular (non-editable) install from a checkout:
+
+```bash
+pip install /path/to/rda-python-metrics
+```
+
+For a production install on a system that uses the published distribution:
+
+```bash
+pip install rda_python_metrics
+```
+
+## Setuid Setup
+
+`logarch` runs as the common user `PGLOG['COMMONUSER']` (default `gdexdata`)
+via the `rda_python_setuid` mechanism, which is pulled in automatically as
+a dependency.  After `pip install` above, choose one of the wiring options
+below.
+
+> **Note:** If `rda_python_setuid` is already installed and fully set up in
+> your environment, you can skip the compile step (`-c/--compile`) and the
+> optional `pgstart` step (`-p/--pgstart`).  The `-l/--link` step is still
+> required to wire up this package's own setuid program.
+
+### Full setuid install (requires sudo access to COMMONUSER)
+
+Run these steps once per environment:
+
+```bash
+# 1. Compile the pywrapper C binary (once per environment):
+pywrapper-install -c|--compile -n|--username gdexdata
+
+# 2. Wire up logarch as a setuid entry (or use 'all' to link every setuid_* at once):
+pywrapper-install -l|--link logarch
+pywrapper-install -l|--link all
+
+# 3. Optionally, install a pgstart_<loginname> binary so <loginname> (any
+#    user in the same group as PGLOG['COMMONUSER']) can run commands as
+#    themselves.  Run either by PGLOG['ADMINUSER'] (default zji, if it has
+#    'sudo -u <loginname>'), or by <loginname> directly:
+pywrapper-install -p|--pgstart -n|--username <loginname>
+```
+
+`pywrapper-install` with no arguments displays the full user guide.
+
+### Simple install (no sudo required, runs as current user)
+
+Users who do not need the setuid mechanism can create a direct symlink instead:
+
+```bash
+pywrapper-install -l|--link logarch -s|--simple
+pywrapper-install -l|--link all -s|--simple   # or link every setuid_* at once
+```
+
+This creates `bin/logarch -> bin/setuid_logarch` and logarch runs as the
+current user with no privilege change.
+
+### Update an existing installation (no sudo required)
+
+When the package is upgraded and a new `pywrapper.c` is bundled, recompile and
+reinstall all setuid binaries using the existing `pgstart_*` binaries:
+
+```bash
+pywrapper-install -u|--update
+```
+
+### Setup guide
+
+The shared setuid setup guide is shown automatically if `setuid_logarch` is
+invoked directly before the setuid wrapper has been configured.

{rda_python_metrics-2.0.5 → rda_python_metrics-3.0.2}/pyproject.toml

@@ -6,7 +6,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "rda_python_metrics"
-version = "2.0.5"
+version = "3.0.2"
 authors = [
   { name="Zaihua Ji",  email="zji@ucar.edu" },
 ]
@@ -26,7 +26,10 @@ dependencies = [
   "ipinfo",
   "httplib2",
   "dnspython",
-  "unidecode"
+  "unidecode",
+  "urllib3>=2.5.0",
+  "requests>=2.33.0",
+  "idna>=3.10",
 ]
 
 [tool.pytest.ini_options]
@@ -38,7 +41,7 @@ pythonpath = [
 "Homepage" = "https://github.com/NCAR/rda-python-metrics"
 
 [project.scripts]
-"logarch.py" = "rda_python_metrics.logarch:main"
+"setuid_logarch" = "rda_python_metrics.logarch:main"
 "fillawsusage" = "rda_python_metrics.fillawsusage:main"
 "fillcdgusage" = "rda_python_metrics.fillcdgusage:main"
 "fillcodusage" = "rda_python_metrics.fillcodusage:main"

{rda_python_metrics-2.0.5 → rda_python_metrics-3.0.2}/src/rda_python_metrics/PgView.py

@@ -6,7 +6,7 @@
 #      Date : 09/24/2020
 #             2025-03-27 transferred to package rda_python_metrics from
 #             https://github.com/NCAR/rda-database.git
-#   Purpose : python library module to help rountinely updates of new data 
+#   Purpose : python library module to help routinely updates of new data 
 #             for one or multiple datasets
 #
 #    Github : https://github.com/NCAR/rda-python-metrics.git
@@ -32,7 +32,7 @@ def simple_output(params, flds, records, totals = None):
    sep = params['L'][0] if 'L' in params else '  '
    slen = len(sep)
 
-   # get total line length, dynamically evaluating column lengthes if column 4 in %FLDS is zero
+   # get total line length, dynamically evaluating column lengths if column 4 in %FLDS is zero
    rcnt = linelen = 0
    if 'A' in params: rcnt = int(params['A'][0])
    for i in range(ccnt):
@@ -390,7 +390,7 @@ def join_query_tables(tblname, tablenames = '', joins = '', tbljoin = ''):
    return (tablenames, joins)
 
 #
-# expand reocrds via query action
+# expand records via query action
 #
 def expand_query(expid, records, params, expand, vusg = None, sns = None, flds = None):
    

rda_python_metrics-3.0.2/src/rda_python_metrics/__init__.py

@@ -0,0 +1,29 @@
+"""rda_python_metrics: RDA metrics, usage, and accounting utility package.
+
+This package exposes two parallel APIs:
+
+1. Legacy module-based API (back-compat). Import the capitalized
+   submodules and call their module-level functions, e.g.::
+
+       from rda_python_metrics import PgIPInfo, PgView
+
+2. Class-based API (preferred for new code). Import the class from the
+   lower-case module and either instantiate or subclass it, e.g.::
+
+       from rda_python_metrics.pg_ipinfo import PgIPInfo
+       from rda_python_metrics.pg_view import PgView
+
+The legacy submodules are eagerly imported below so that
+``from rda_python_metrics import PgIPInfo`` continues to return the
+module object that existing callers expect.
+"""
+
+from . import PgIPInfo, PgView
+
+__version__ = "2.0.6"
+
+__all__ = [
+   "PgIPInfo",
+   "PgView",
+   "__version__",
+]

{rda_python_metrics-2.0.5 → rda_python_metrics-3.0.2}/src/rda_python_metrics/fill_awsusage.py

@@ -10,7 +10,7 @@
 #   Purpose : python program to retrieve info from AWS logs 
 #             and fill table wusages in PgSQL database dssdb.
 # 
-#    Github : https://github.com/NCAR/rda-pythn-metrics.git
+#    Github : https://github.com/NCAR/rda-python-metrics.git
 #
 ###############################################################################
 #

{rda_python_metrics-2.0.5 → rda_python_metrics-3.0.2}/src/rda_python_metrics/fill_cdgusage.py

@@ -6,7 +6,7 @@
 #    Author : Zaihua Ji,  zji@ucar.edu
 #      Date : 2025-04-14
 #   Purpose : python program to retrieve info from GDEX Postgres database for GDS 
-#             file accesses and backup fill table tdsusage in PostgreSQL database dssdb.
+#             file accesses and backup fill table tdsusage in PostgreSQL database rdadb.
 # 
 #    Github : https://github.com/NCAR/rda-python-metrics.git
 #
@@ -173,7 +173,7 @@ def get_dataset_ids(dsnames):
    return dsids
 
 #
-# get cdgids recursivley
+# get cdgids recursively
 #
 def recursive_dataset_ids(pcdgid, cdgids):
 

{rda_python_metrics-2.0.5 → rda_python_metrics-3.0.2}/src/rda_python_metrics/fill_globususage.py

@@ -10,7 +10,7 @@
 #   Purpose : python program to retrieve info from Globus logs 
 #             and fill table wusages in PgSQL database dssdb.
 # 
-#    Github : https://github.com/NCAR/rda-pythn-metrics.git
+#    Github : https://github.com/NCAR/rda-python-metrics.git
 #
 ###############################################################################
 #

{rda_python_metrics-2.0.5 → rda_python_metrics-3.0.2}/src/rda_python_metrics/fill_osdfusage.py

@@ -8,7 +8,7 @@
 #   Purpose : python program to retrieve info from weekly OSDF logs 
 #             and fill table wusages in PgSQL database dssdb.
 # 
-#    Github : https://github.com/NCAR/rda-pythn-metrics.git
+#    Github : https://github.com/NCAR/rda-python-metrics.git
 #
 ###############################################################################
 #

{rda_python_metrics-2.0.5 → rda_python_metrics-3.0.2}/src/rda_python_metrics/fill_rdadb.py

@@ -10,7 +10,7 @@
 #   Purpose : python program to retrieve info from data logs, and fill tables
 #             in PostgreSQL database.schema rdadb.dssdb
 #
-#    Github : https://github.com/NCAR/rda-pythn-metrics.git
+#    Github : https://github.com/NCAR/rda-python-metrics.git
 #
 ###############################################################################
 #

{rda_python_metrics-2.0.5 → rda_python_metrics-3.0.2}/src/rda_python_metrics/fill_tdsusage.py

@@ -8,7 +8,7 @@
 #             2025-03-26 transferred to package rda_python_metrics from
 #             https://github.com/NCAR/rda-database.git
 #   Purpose : python program to retrieve info from TDS logs 
-#             and fill table tdsusage in PostgreSQL database dssdb.
+#             and fill table tdsusage in PostgreSQL database rdadb.
 # 
 #    Github : https://github.com/NCAR/rda-python-metrics.git
 #

{rda_python_metrics-2.0.5 → rda_python_metrics-3.0.2}/src/rda_python_metrics/fillawsusage.py

@@ -8,7 +8,7 @@
 #             2025-12-16 converted to class FillAWSUsage
 #   Purpose : python program to retrieve info from AWS logs 
 #             and fill table wusages in PgSQL database dssdb.
-#    Github : https://github.com/NCAR/rda-pythn-metrics.git
+#    Github : https://github.com/NCAR/rda-python-metrics.git
 ###############################################################################
 import sys
 import re
@@ -19,6 +19,8 @@ from .pg_ipinfo import PgIPInfo
 
 class FillAWSUsage(PgIPInfo, PgFile):
 
+   """Retrieve info from AWS logs and fill table wusage in PostgreSQL database rdadb."""
+
    def __init__(self):
       super().__init__()
       self.USAGE = {
@@ -31,8 +33,8 @@ class FillAWSUsage(PgIPInfo, PgFile):
       self.option = self.cmdstr = None
       self.params = []  # array of input values
 
-   # function to read parameters
    def read_parameters(self):
+      """Function to read parameters."""
       argv = sys.argv[1:]
       for arg in argv:
          ms = re.match(r'^-(b|d|p|N)$', arg)
@@ -55,8 +57,8 @@ class FillAWSUsage(PgIPInfo, PgFile):
       self.cmdstr = "fillawsusage {}".format(' '.join(argv))
       self.cmdlog(self.cmdstr)
 
-   # function to start actions
    def start_actions(self):
+      """Function to start actions."""
       self.change_local_directory(self.USAGE['AWSDIR'])
       filenames = self.get_log_file_names()
       if filenames:
@@ -65,8 +67,8 @@ class FillAWSUsage(PgIPInfo, PgFile):
         self.pglog("No log file found for given command: " + self.cmdstr, self.LOGWRN)
       self.pglog(None, self.LOGWRN)
 
-   # get the log file dates 
    def get_log_file_names(self):
+      """Get the log file dates."""
       filenames = {}
       if self.option == 'd':
          for dt in self.params:
@@ -93,8 +95,8 @@ class FillAWSUsage(PgIPInfo, PgFile):
             pdate = self.adddate(pdate, 0, 0, 1)
       return filenames
 
-   # Fill AWS usages into table dssdb.awsusage of DSS PgSQL database from aws access logs
    def fill_aws_usages(self, filenames):
+      """Fill AWS usages into table dssdb.awsusage of DSS PgSQL database from aws access logs."""
       year = cntall = addall = 0
       for pdate in filenames:
          fnames = filenames[pdate]
@@ -147,8 +149,8 @@ class FillAWSUsage(PgIPInfo, PgFile):
             if addall > cntadd:
                self.pglog("{} AWS usage records added for {} entries at {}".format(addall, cntall, self.current_datetime()), self.LOGWRN)
 
-   # get date and time from record
    def get_record_date_time(self, ctime):
+      """Get date and time from record."""
       ms = re.search(r'^(\d+)/(\w+)/(\d+):(\d+:\d+:\d+)$', ctime)
       if ms:
          d = int(ms.group(1))
@@ -160,8 +162,8 @@ class FillAWSUsage(PgIPInfo, PgFile):
       else:
          self.pglog(ctime + ": Invalid date/time format", self.LGEREX)
 
-   # add usage records for year
    def add_usage_records(self, records, year):
+      """Add usage records for year."""
       cnt = 0
       for key in records:
          record = records[key]
@@ -171,8 +173,8 @@ class FillAWSUsage(PgIPInfo, PgFile):
             cnt += self.pgadd(self.USAGE['PGTBL'], record, self.LOGWRN)
       return cnt
 
-   # add record to allusage tables
    def add_to_allusage(self, year, pgrec):
+      """Add record to allusage tables."""
       record = {'source' : 'A'}
       flds = ['ip', 'dsid', 'date', 'time', 'quarter', 'size', 'method',
               'org_type', 'country', 'region', 'email']
@@ -180,7 +182,7 @@ class FillAWSUsage(PgIPInfo, PgFile):
          record[fld] = pgrec[fld]
       return self.add_yearly_allusage(year, record)
 
-# main function to excecute this script
+# main function to execute this script
 def main():
    object = FillAWSUsage()
    object.read_parameters()

rda_python_metrics-3.0.2/src/rda_python_metrics/fillawsusage.usg

@@ -0,0 +1,27 @@
+
+ fillawsusage - Fill table 'awsusage' from AWS Server log files.
+
+ Reads AWS access logs from /gpfs/fs1/collections/rda/transer/AWSera5log/
+ and inserts usage records into the 'awsusage' table in PostgreSQL
+ database 'rdadb'.
+
+ USAGE:
+   fillawsusage [-b] (-d LogFileDates | -N NumberDays | -p BeginDate [EndDate])
+
+ OPTIONS (choose exactly one of -d, -N, or -p):
+
+   -d LogFileDates
+        Process log files for the given dates.
+        Date format: YYYY-MM-DD (e.g. 2024-01-15).
+
+   -N NumberDays
+        Process log files covering the most recent NumberDays days.
+
+   -p BeginDate [EndDate]
+        Process log files between BeginDate and EndDate, inclusive.
+        EndDate defaults to today if omitted.
+
+   -b   Run in background mode (log to file only, no terminal output).
+
+ EXAMPLE:
+   fillawsusage -p 2024-01-01 2024-01-31