Library of Congress script transliterator.

scossu ad30f6d345 Move JS Oriya transliteration table to legacy. 8 months ago
.github ed5877ff00 Merge test (#125) 9 months ago
doc f74b1ba6d1 The list (#114) 11 months ago
ext ad30f6d345 Move JS Oriya transliteration table to legacy. 8 months ago
legacy ad30f6d345 Move JS Oriya transliteration table to legacy. 8 months ago
scriptshifter 6a5e0f1be3 Merge pull request #138 from lcnetdev/casei 8 months ago
tests 9f3ba34c49 Force lower case on R2S for case insensitive scripts. 8 months ago
.dockerignore ef159ddf98 Update Docker image to Debian. 1 year ago
.gitignore 6cac2dcbd1 Use DB for transliterate function [untested]. 9 months ago
.gitmodules 0f81dd1a42 Merge test branch. (#124) 9 months ago
Dockerfile 7bee998651 Add test dir to Docker file. 8 months ago
LICENSE 20cb85dad1 Initial commit 2 years ago
NOTES.md 58cd0be0fd Rebrand to ScriptShifter. 2 years ago
README.md 8684b3f2f2 Write feedback message to file if SMTP is not set. 8 months ago
TODO.md dae54334a7 Add Arabic transliteration via 3d party. 2 years ago
deps.txt ed5877ff00 Merge test (#125) 9 months ago
entrypoint.sh f0377ae91d Fix init-db call and circular dep. 8 months ago
example.env 0f81dd1a42 Merge test branch. (#124) 9 months ago
requirements.txt ed5877ff00 Merge test (#125) 9 months ago
scriptshifter_base.Dockerfile fa5b48dba6 Test (#101) 1 year ago
sscli d6b7303c0e Fix looping error in trans. 8 months ago
test.Dockerfile fa5b48dba6 Test (#101) 1 year ago
uwsgi.ini acf4bf7b3d Flask and Docker boilerplate. 2 years ago
wsgi.py 58cd0be0fd Rebrand to ScriptShifter. 2 years ago

README.md

ScriptShifter

REST API service to convert non-Latin scripts to Latin, and vice versa.

View supported scripts.

Environment variables

The provided example.env can be renamed to .env in your deployment and/or moved to a location that is not under version control, and adjusted to fit the environment. The file will be parsed directly by the application if present, or it can be pre-loaded in a Docker environment.

Currently, the following environment variables are defined:

  • TXL_LOGLEVEL: Application log level. Defaults to WARN.
  • TXL_FLASK_SECRET: Flask secret key.
  • TXL_DICTA_EP: Endpoint for the Dicta Hebrew transliteration service. This is mandatory for using the Hebrew module.

Initial setup

In order to run Scriptshifter, a local SQLite database must be created. The simplest way to do that is via command-line:

./sscli admin init-db

This step is already included in the entrypoint.sh script that gets executed by Docker, so no additional action is necessary.

Note that the DB must be recreated every time any of the configuration tables in scriptshifter/tables/data changes.

Local development server

For local development, it is easiest to run Flask without the WSGI wrapper, possibly in a virtual environment:

# python -m venv /path/to/venv
# source /path/to/venv/bin/activate
# pip install -r requirements.txt
# flask run

It is advised to set FLASK_DEBUG=true to reload the web app on code changes and print detailed stack traces when exceptions are raised. Note that changes to any .yml file do NOT trigger a reload of Flask.

Alternatively, the transliteration interface can be accessed directly from Python:

from scriptshifter.trans import transliterate

transliterate("some text", "some language")

Run on Docker

Build container in current dir:

docker build -t scriptshifter:latest .

Start container:

docker run --env-file .env -p 8000:8000 scriptshifter:latest

For running in development mode, add -e FLASK_ENV=development to the options.

Environment variables

The following environment variables are available for modification:

TXL_EMAIL_FROM: Email address sending the feedback form on behalf of users.

TXL_EMAIL_TO: Recipients of the feedback form.

TXL_FLASK_SECRET: Seed for web server security. Set to a random-generated string in a production environment.

TXL_LOGLEVEL: Logging level. Use Python notation. The default is WARN.

TXL_SMTP_HOST: SMTP host to send feedback messages through.

TXL_SMTP_PORT: Port of the SMTP server. Defaults to 1025.

TXL_FEEDBACK_PATH: if a SMTP server is not available, the feedback message may be written to a file under this given path for further processing. The file will have a random name and a .txt suffix. This option is only available if TXL_SMTP_HOST is not defined. If neither TXL_SMTP_HOST nor TXL_FEEDBACK_PATH is defined, the feedback form will not be shown in the UI and a POST request to the /feedback REST endpoint will result in a 501 Not Implemented error.

Web UI

/ renders a simple HTML form to test the transliteration service.

Adding a language as a value of the lang URL parameter, the UI will start with that language selected. E.g. /?lang=chinese will select Chinese from the drop-down automatically. The value must be one of the keys found in /languages.

Command-line interface

Various Scriptshifter commands can be accessed via the shell command sscli. At the moment only a few essential admin and testing tools are available. More commands can be made avaliable on an as-needed basis.

Help menu:

/path/to/sscli --help

Section help:

/path/to/sscli admin --help

Contributing

See the contributing guide.

Further documentation

See the doc folder for additional documentation.