update readme
authorShane Jaroch <nutratracker@protonmail.com>
Sat, 8 Aug 2020 14:12:12 +0000 (10:12 -0400)
committerShane Jaroch <nutratracker@protonmail.com>
Sat, 8 Aug 2020 21:11:55 +0000 (17:11 -0400)
README.rst
data/setup.sh
sql/import.sql

index b2aaef47146220bc889976ee460fac20af7d29d3..6287385022d51032dae5630d31dd242d50ec1b81 100644 (file)
@@ -1,6 +1,6 @@
-************
- nt-sqlite3
-************
+***********
+ nt-sqlite
+***********
 
 Python, SQL and CSV files for setting up portable SQL database.
 
@@ -8,10 +8,15 @@ See CLI:    https://github.com/nutratech/cli
 
 Pypi page:  https://pypi.org/project/nutra
 
+
 Building the database
 #########################
 
-1. Install ``access2csv`` dependency, :code:`git submodule update --init`
+1. Install ``access2csv`` dependency,
+
+.. code-block:: bash
+
+    git submodule update --init
 
 
 2. Download database and process into CSV files,
@@ -22,7 +27,7 @@ Building the database
     bash setup.sh
     python3 process.py
 
-3. If you are committing changes, add a line to :code:`nt_ver.csv``, e.g. :code:`id=3` is new
+3. If you are committing database changes, add a line to :code:`nt_ver.csv` (e.g. :code:`id=3` is new),
 
 +-----+----------+-----------------------------------+
 | id  | version  | created                           |
@@ -41,7 +46,7 @@ Building the database
     cd ../sql
     sqlite3 nutra.db
 
-NOTE: FOLLOW STEP 5 FROM INSIDE THE SQL SHELL
+NOTE: FOLLOW STEPS 5 and 6 FROM INSIDE THE SQL SHELL
 
 5. Create the tables, import the data, and save:
 
@@ -51,7 +56,7 @@ NOTE: FOLLOW STEP 5 FROM INSIDE THE SQL SHELL
     .read import.sql
     .exit
 
-6. Verify the tables, again inside :code:`sqlite nutra.db`,
+6. Verify the tables (again inside the SQL shell :code:`sqlite nutra.db`),
 
 .. code-block:: sql
 
@@ -63,10 +68,11 @@ NOTE: FOLLOW STEP 5 FROM INSIDE THE SQL SHELL
 
 7. If everything looks good, compress into :code:`nutra-X.X.X.db.tar.xz` and upload to binary host.
 
+
 Tables (Relational Design)
 ##########################
 
-See :code:`data/tables.sql` for details.
+See :code:`sql/tables.sql` for details.
 
 This is frequently updated, see :code:`docs/` for more info.
 
index c91cea01acb2f07589ea2692f0af939855c7a110..233d3b2a2d694f6bee66c7c630f0ec1c31658d90 100755 (executable)
@@ -38,8 +38,8 @@ curl -L "https://www.ars.usda.gov/ARSUserFiles/80400525/Data/PA/PA02.accdb" -o P
 # -----------------
 # Run access2csv
 # -----------------
+# git submodule update --init
 # git clone git@github.com:AccelerationNet/access2csv.git
-
 # cd access2csv
 # mvn clean install -Dmaven.test.skip=true  # the install is handled by command
 cd ../access2csv
index f7e52b933f3bc865b57285045a3332a018d40b37..df5e14979a228a413e8796b19888ad04a51c2145 100644 (file)
@@ -1,3 +1,19 @@
+-- nt-sqlite, an sqlite3 database for nutratracker clients
+-- Copyright (C) 2020  Shane Jaroch <nutratracker@gmail.com>
+--
+-- This program is free software: you can redistribute it and/or modify
+-- it under the terms of the GNU General Public License as published by
+-- the Free Software Foundation, either version 3 of the License, or
+-- (at your option) any later version.
+--
+-- This program is distributed in the hope that it will be useful,
+-- but WITHOUT ANY WARRANTY; without even the implied warranty of
+-- MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+-- GNU General Public License for more details.
+--
+-- You should have received a copy of the GNU General Public License
+-- along with this program.  If not, see <https://www.gnu.org/licenses/>.
+
 .mode csv
 
 .import '| tail -n +2 nt_ver.csv' nt_ver