Library of Congress script transliterator.

scossu 00172a1443 Add test sample commands to CLI. vor 8 Monaten
.github ed5877ff00 Merge test (#125) vor 9 Monaten
doc f74b1ba6d1 The list (#114) vor 11 Monaten
ext 0f81dd1a42 Merge test branch. (#124) vor 9 Monaten
legacy 875a322ecd Add MARC codes to language index. vor 10 Monaten
scriptshifter 44918381bc Add CLI and init-db command. vor 8 Monaten
tests b4bbe80522 Add opcode cache to common DB retrievals. vor 9 Monaten
.dockerignore ef159ddf98 Update Docker image to Debian. vor 1 Jahr
.gitignore 6cac2dcbd1 Use DB for transliterate function [untested]. vor 9 Monaten
.gitmodules 0f81dd1a42 Merge test branch. (#124) vor 9 Monaten
Dockerfile ed5877ff00 Merge test (#125) vor 9 Monaten
LICENSE 20cb85dad1 Initial commit vor 2 Jahren
NOTES.md 58cd0be0fd Rebrand to ScriptShifter. vor 2 Jahren
README.md 00172a1443 Add test sample commands to CLI. vor 8 Monaten
TODO.md dae54334a7 Add Arabic transliteration via 3d party. vor 2 Jahren
deps.txt ed5877ff00 Merge test (#125) vor 9 Monaten
entrypoint.sh 2d64c48b9a Link large model; fix Docker image. (#90) vor 1 Jahr
example.env 0f81dd1a42 Merge test branch. (#124) vor 9 Monaten
requirements.txt ed5877ff00 Merge test (#125) vor 9 Monaten
scriptshifter_base.Dockerfile 2dda4ee92e Split docker files and requirements. vor 1 Jahr
sscli 00172a1443 Add test sample commands to CLI. vor 8 Monaten
test.Dockerfile 2dda4ee92e Split docker files and requirements. vor 1 Jahr
uwsgi.ini acf4bf7b3d Flask and Docker boilerplate. vor 2 Jahren
wsgi.py 58cd0be0fd Rebrand to ScriptShifter. vor 2 Jahren

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.

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. If not defined, the feedback form will not be shown in the UI.

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

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.