From 3327884f2167bff2c8efb3383a3671b0a9deb666 Mon Sep 17 00:00:00 2001 From: Alan Orth Date: Tue, 25 Sep 2018 00:55:35 +0300 Subject: [PATCH] Update docs to remove SQLite stuff I've decided to use PostgreSQL instead of SQLite because the UPSERT support is available in versions of PostgreSQL we're alread running, whereas SQLite needs a VERY new (3.24.0) version that is not avail- able on any recent long-term support Ubuntu releases. --- .gitignore | 1 - CHANGELOG.md | 4 ++++ README.md | 4 ++-- indexer.py | 2 +- 4 files changed, 7 insertions(+), 4 deletions(-) diff --git a/.gitignore b/.gitignore index 0cb8f26..82adb58 100644 --- a/.gitignore +++ b/.gitignore @@ -1,3 +1,2 @@ __pycache__ venv -*.db diff --git a/CHANGELOG.md b/CHANGELOG.md index e61d5c7..3e6ef75 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -4,6 +4,10 @@ All notable changes to this project will be documented in this file. The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/), and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html). +## [0.2.0] - 2018-09-24 +### Changed +- Use PostgreSQL instead of SQLite because UPSERT support needs a very new libsqlite3 whereas it's already in PostgreSQL 9.5+ + ## [0.1.0] - 2018-09-24 ### Changed - Rename project to "DSpace Statistics API" diff --git a/README.md b/README.md index 13a26cc..948c987 100644 --- a/README.md +++ b/README.md @@ -1,14 +1,14 @@ # DSpace Statistics API A quick and dirty REST API to expose Solr view and download statistics for items in a DSpace repository. -Written and tested in Python 3.6. SolrClient (0.2.1) does not currently run in Python 3.7.0. Requires SQLite version 3.24.0 or greater for [`UPSERT` support](https://www.sqlite.org/lang_UPSERT.html). +Written and tested in Python 3.6. SolrClient (0.2.1) does not currently run in Python 3.7.0. Requires PostgreSQL version 9.5 or greater for [`UPSERT` support](https://wiki.postgresql.org/wiki/UPSERT). ## Installation Create a virtual environment and run it: $ virtualenv -p /usr/bin/python3.6 venv $ . venv/bin/activate - $ pip install falcon gunicorn SolrClient + $ pip install falcon gunicorn SolrClient psycopg2-binary $ gunicorn app:api ## Todo diff --git a/indexer.py b/indexer.py index 6e62481..8b2cd1e 100755 --- a/indexer.py +++ b/indexer.py @@ -20,7 +20,7 @@ # --- # # Connects to a DSpace Solr statistics core and ingests item views and downloads -# into a SQLite database for use with other applications (an API, for example). +# into a Postgres database for use with other applications (an API, for example). # # This script is written for Python 3 and requires several modules that you can # install with pip (I recommend setting up a Python virtual environment first):