summaryrefslogtreecommitdiffstats
path: root/scripts/README.rst
diff options
context:
space:
mode:
authorDaniel Baumann <daniel.baumann@progress-linux.org>2024-05-18 05:31:44 +0000
committerDaniel Baumann <daniel.baumann@progress-linux.org>2024-05-18 05:31:44 +0000
commitf77392695c09f9fef9386c112aef0e2b2f6fcd1a (patch)
tree04c428a7cfc9b7c6dbea73b5697f8c201d9106ff /scripts/README.rst
parentInitial commit. (diff)
downloadpython-pgspecial-f77392695c09f9fef9386c112aef0e2b2f6fcd1a.tar.xz
python-pgspecial-f77392695c09f9fef9386c112aef0e2b2f6fcd1a.zip
Adding upstream version 2.1.2.upstream/2.1.2upstream
Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>
Diffstat (limited to 'scripts/README.rst')
-rw-r--r--scripts/README.rst21
1 files changed, 21 insertions, 0 deletions
diff --git a/scripts/README.rst b/scripts/README.rst
new file mode 100644
index 0000000..6d96afd
--- /dev/null
+++ b/scripts/README.rst
@@ -0,0 +1,21 @@
+Scripts
+--------------------------
+
+**docparser.py**
+
+Parses SGML files containing Postgres command information and converts them
+into a JSON data structure, this is the converted into a python dictionary
+and saved to `pgspecial/help/commands.py`
+
+This should me manually ran and the results committed after each new release
+of the main Postgres project.
+
+SGML files can be found: https://github.com/postgres/postgres/tree/master/doc/src/sgml/ref
+Grab a copy of this directory on your local system.
+
+**Usage**
+
+::
+ pip install beautifulsoup4
+ # From root of project
+ echo -n "helpcommands = " > pgspecial/help/commands.py; python scripts/docparser.py ref/ | python -mjson.tool | sed 's/"\: null/": None/g' >> pgspecial/help/commands.py