-- coding: utf-8 --
ππ© A terrible SQLite Web UI
Not ready for general consumption, right now only browsing/viewing SQLite3 databases/tables is supported (and then barely).
Aim is a simple UI, that works on mobile for quick search. Focused on single table work, rather than fk/pk relationship display. this is mostly implemented, without write (INSERT, DELETE, UPDATE) support (and with UI/UX blemishes). Use cases, less than 100k rows, that would have previously been suitable for use with tools like Pilot-DB, MobileDB, JFile, HanDBase, Easy Database for Android, etc.
Primary aim:
- no security - did you pay attention to the name of this project? (Limit to localhost, use a reverse-proxy over https)
- Simple SQL queries (TODO determine transaction model - autocommit is the current plan)
- view/edit record, using jsonschema / jsonforms (unlike above where transaction model is unclear, autocommit on save)
- https://www.google.com/search?q=jsonform
- TODO research Python libs
- https://github.com/jsonform/jsonform/ - Bootstrap 3 (end of support as of 2019, https://blog.getbootstrap.com/2019/07/24/lts-plan/#:~:text=Starting%20today%2C%20Bootstrap%203%20will,security%20updates%2C%20and%20documentation%20updates.) https://getbootstrap.com/docs/3.3/
- https://github.com/eclipsesource/jsonforms - React, Angular and/or Vue
- quick search, with add (either on no match or no good match) using search term as initial value
- searching either a defined column, the first column, or all columns
Local
- GUI https://github.com/sqlitebrowser/sqlitebrowser?tab=readme-ov-file#what-it-is
- https://github.com/dbcli/litecli
Web
- https://github.com/coleifer/sqlite-web
- https://github.com/jeffknupp/sandman2
- https://github.com/cs91chris/flask_autocrud
- https://github.com/mathesar-foundation/mathesar (only one DBMS supported)
- https://github.com/vrana/adminer
- https://github.com/dbgate/dbgate
- https://github.com/pocketbase/pocketbase
- https://github.com/mvbasov/sqliteboy
python -m pip install -r requirements.txt
# TODO requirements_optional.txt
#python -m pip install -e .
python -m sqlshite.web.wsgi
python -m sqlshite.web.wsgi config.json
Where config.json
contains:
{
"databases": {
"memory": ":memory:",
"mydb": "mydb.sqlite3"
}
}
Then open:
That have been implemented
http://localhost/ - browse databases
http://localhost/d - browse databases
http://localhost/d/DATABASE_NAME - browse tables
http://localhost/d/DATABASE_NAME/sql - issue SQL queries
http://localhost/d/DATABASE_NAME/rescan - rescan metadata
http://localhost/d/DATABASE_NAME/TABLE_NAME?q=SEARCH_TERM - quick search the first string column with automatic (pre and post) wild card
http://localhost/d/DATABASE_NAME/TABLE_NAME/jsonform.json - schema in jsonform - format
http://localhost/d/DATABASE_NAME/TABLE_NAME/rows - view (TODO cleanup and maybe edit for desktop view) rows in table
http://localhost/d/DATABASE_NAME/TABLE_NAME/add - add TODO actually INSERT into table
http://localhost/d/DATABASE_NAME/TABLE_NAME/rowid - currently dumps schema and value
http://localhost/d/DATABASE_NAME/TABLE_NAME/view/rowid - view
http://localhost/d/DATABASE_NAME/TABLE_NAME/view/rowid/view.json - jsonform with schema and data only
http://localhost/d/DATABASE_NAME/TABLE_NAME - browse table (rows)?
TBD
http://localhost/d/DATABASE_NAME/TABLE_NAME/schema.json - schema in jsonform - format
http://localhost/d/DATABASE_NAME/TABLE_NAME?rowid=A - view? where rowid is sqlite specific rowid?
Where PRIMARY_KEY is not rowid (but it could be...)
http://localhost/d/DATABASE_NAME/TABLE_NAME/PRIMARY_KEY - edit/view?
http://localhost/d/DATABASE_NAME/TABLE_NAME/row/PRIMARY_KEY - view?
http://localhost/d/DATABASE_NAME/TABLE_NAME/view/PRIMARY_KEY - view?
http://localhost/d/DATABASE_NAME/TABLE_NAME/edit/PRIMARY_KEY - edit existing?
need to use hidden field for PK (compound pk?) in case pk is updated. Potentially use readonly (especially for view) http://localhost/d/DATABASE_NAME/TABLE_NAME/edit/PRIMARY_KEY/jsonform.json - schema+data in jsonform - format with data
- Datatype support. date/datetime
- how to handle add and edit errors, to avoid data loss:
- from database
- network?
- temp store in local storeage until get confirmation back?
SQL Python
TIMESTAMP DateTime
bool/boolean bool
varchar string
string string
int integer
real float
TODO consider Decimal support. TODO consider datetime as a mapping.