rda-python-dbms 3.0.0__py3-none-any.whl → 3.0.1__py3-none-any.whl

rda_python_dbms-3.0.1.dist-info/METADATA

@@ -0,0 +1,100 @@
+Metadata-Version: 2.4
+Name: rda_python_dbms
+Version: 3.0.1
+Summary: RDA Python Package to manage PostreSQL databases
+Author-email: Zaihua Ji <zji@ucar.edu>
+Project-URL: Homepage, https://github.com/NCAR/rda-python-dbms
+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
+Dynamic: license-file
+
+# rda_python_dbms
+
+RDA Python package to manage RDA PostgreSQL databases.
+
+## Programs
+
+The package installs the following command-line utilities, all running as the
+current user:
+
+- `pgddl` — create, drop or alter tables, indexes and keys from the table
+  definitions in `<tablename>.json` files
+- `pgseq` — reset the sequences of all (or the given) tables in one or more
+  schemas
+- `pgbackup` — dump the configured `rdadb` schemas on `rda-pgdb-02` into
+  `/data/pgbackup`, replacing existing backups and emailing a summary
+- `pgdbdump` — dump a PostgreSQL database to a local directory
+- `pgdbrestore` — restore a PostgreSQL database from a local dump directory
+- `pgchksum` — re-check archived files against their RDADB records
+  (checksums, sizes and timestamps for Web and Saved files; sizes and
+  timestamps only for Quasar backup files), optionally fix the records
+  (`-x`), and email each dataset's primary owner a list of its missing
+  files (`-e`)
+- `pgcmptables` — compare the columns, indexes and data of identical tables
+  on two database servers
+- `pgschema` — copy the tables of a schema into the same schema in another
+  database on the same server
+
+Run a program without its required options to print its usage. Do not use
+`-h` for help: it is the host name option in several programs. `pgbackup`
+has no usage text and starts the backup as soon as it runs.
+
+## 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-dbms
+
+Pick whichever install mode fits your workflow.  All variants pull in the
+transitive dependency (`rda_python_common`) 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-dbms.git
+cd rda-python-dbms
+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-dbms.git
+cd rda-python-dbms
+pip install -e .
+```
+
+For a regular (non-editable) install from a checkout:
+
+```bash
+pip install /path/to/rda-python-dbms
+```
+
+For a production install on a system that uses the published distribution:
+
+```bash
+pip install rda_python_dbms
+```

{rda_python_dbms-3.0.0.dist-info → rda_python_dbms-3.0.1.dist-info}/RECORD

@@ -954,9 +954,9 @@ rda_python_dbms/tables/obsua/wind_5v2_0.json,sha256=NehMFE-GMNlD5Bh_fiacfSOmZWkr
 rda_python_dbms/tables/obsua/wind_60v2_0.json,sha256=jOyQgD5ph7YBMuQfvYz1Ln6X_-_Vdhl36HBexOHZ1dA,1067
 rda_python_dbms/tables/obsua/wind_8v2_0.json,sha256=5wtCThmFeOyiAGH_Qv3_jrXjhjo9b87ehlpI9QQY2SM,1064
 rda_python_dbms/tables/obsua/wind_9v2_0.json,sha256=7OKFUicOn15LL_WuF1VE_L8DjxsHmRP4uBnopuMIeTg,1064
-rda_python_dbms-3.0.0.dist-info/licenses/LICENSE,sha256=Uky6fiiVw7cakFVRtVpzg-mvqOQ-WcA_H8lHqhPRg58,1101
-rda_python_dbms-3.0.0.dist-info/METADATA,sha256=B9DrL7R_MmsAlJg1nRTq0jUBKjhPMFfITFGqlX5kqIE,617
-rda_python_dbms-3.0.0.dist-info/WHEEL,sha256=mOdXR9C3wMVov7cSY8PY-XCzo3SmmWCHvGQr5csJoao,91
-rda_python_dbms-3.0.0.dist-info/entry_points.txt,sha256=iti6iZS2OEeBqO5aHlWeMFcbuwN_2assidP0qeSkQ6E,346
-rda_python_dbms-3.0.0.dist-info/top_level.txt,sha256=4T1ShNUMyiqmwDIuDL7pDOm_S-6zWWW3Vy6OdAzYA4c,16
-rda_python_dbms-3.0.0.dist-info/RECORD,,
+rda_python_dbms-3.0.1.dist-info/licenses/LICENSE,sha256=Uky6fiiVw7cakFVRtVpzg-mvqOQ-WcA_H8lHqhPRg58,1101
+rda_python_dbms-3.0.1.dist-info/METADATA,sha256=iqXoJ9_l_fP-i2prZLDDLZnXx9Cvko9VL2OCEXz1kAI,3293
+rda_python_dbms-3.0.1.dist-info/WHEEL,sha256=mOdXR9C3wMVov7cSY8PY-XCzo3SmmWCHvGQr5csJoao,91
+rda_python_dbms-3.0.1.dist-info/entry_points.txt,sha256=iti6iZS2OEeBqO5aHlWeMFcbuwN_2assidP0qeSkQ6E,346
+rda_python_dbms-3.0.1.dist-info/top_level.txt,sha256=4T1ShNUMyiqmwDIuDL7pDOm_S-6zWWW3Vy6OdAzYA4c,16
+rda_python_dbms-3.0.1.dist-info/RECORD,,

rda_python_dbms-3.0.0.dist-info/METADATA

@@ -1,17 +0,0 @@
-Metadata-Version: 2.4
-Name: rda_python_dbms
-Version: 3.0.0
-Summary: RDA Python Package to manage PostreSQL databases
-Author-email: Zaihua Ji <zji@ucar.edu>
-Project-URL: Homepage, https://github.com/NCAR/rda-python-dbms
-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
-Dynamic: license-file
-
-RDA python Package to manage RDA PostgreSQL databases.