What words is a simple Tornado application that can count words occurrences in passed URL and display them as a nice tag cloud. It also has a simple, password protected word list view with all-time word count.
Made to finally play around with Tornado and Google App Engine.
Last seen at what-words.appspot.com
What words uses environment variables to manage configuration variables. To
run it locally you need at least SECRET_KEY
set (either explicitly or in
.env
file). It exposes a WSGI server for running it in production but
locally you can just run app.py
:
$ export SECRET_KEY='...'
$ pip3 install -r requirements.txt
$ python what_words/app.py
One time operation of creating database tables (what_words.db.create_tables
)
is also required.
Whole application was made with Google App Engine in mind so deploying
it there should be as easy as running gcloud app deploy app.yaml
.
What words uses python-decouple
to manage configuration variables. You can
have a look at the settings file to see what values are configurable, but for
reference here are the ones that I use locally:
$ cat .env
DEBUG=True
DATABASE_URL=mysql://pawelad@localhost/what_words
ADMIN_PASSWORD=...
SECRET_KEY=..
SALT=...
Package source code is available at GitHub.
Feel free to use, ask, fork, star, report bugs, fix them, suggest enhancements, add functionality and point out any mistakes. Thanks!
Developed and maintained by Paweł Adamczak.
Released under MIT License.