Helper module for Frozen-Flask based websites
Elsa will help you build your Frozen-Flask based website and deploy it to GitHub pages. It’s based on scripts from PyLadies.cz repo and is distributed under the terms of the MIT license, see LICENSE (does not apply for the image below). It requires Python 3.
Image linked from cartoonbros.com, not stored in the repo, so the repo remains free.
Create you Flask app and give it to elsa.cli():
from flask import Flask app = Flask(...) # do stuff with app if __name__ == '__main__': from elsa import cli cli(app, base_url='https://example.com')
This will add command line interface to the script, enabling you to use it like this:
python foo.py serve # serves the site, no freezing, so you can check it quickly python foo.py freeze # freezes the site, i.e. makes a HTML snapshot python foo.py deploy # deploys the frozen site to GitHub pages
See more options with --help.
Follow the quickstart tutorial for more information.
Travis CI is (in this context) a tool, that allows you to deploy the site automatically to GitHub pages after every push. All you have to do is tell Travis to run Elsa and provide a GitHub token. Elsa on Travis will freeze the site and deploy it frozen to GitHub pages. Elsa knows it’s being run on Travis and will use the provided GitHub token to gain push permissions. Elsa will push force to gh-pages branch in a single commit rewriting the history and all manual changes of that branch.
Here is an example .travis.yml file for automatic deployment. It assumes elsa and other requirements are in requirements.txt and that you are familiar with Travis CI (so it’s not very verbose):
language: python python: - '3.6' script: - 'python foo.py freeze' env: global: - secure: "blahblah" # gem install travis; travis encrypt GITHUB_TOKEN=xyz --add deploy: provider: script skip_cleanup: true script: 'python foo.py deploy --no-freeze --push' on: branch: master repo: only/yours
To run the test suite, install tox and run it:
Elsa uses pytest, so if you are familiar with it, feel free to run it directly.
When you use URLs without trailing slash (e.g. https://example.com/foobar), GitHub pages would serve the pages with bad Content-Type header (application/octet-stream instead of text/html) and the browser would attempt to download it. That’s why Elsa will not allow such thing and will treat MimetypeMismatchWarning from Frozen-Flask as error. Make sure to use URLs with trailing slash (e.g. https://example.com/foobar/) instead, so Frozen-Flask will create index.html in a folder and GitHub pages will use proper content type.
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
|File Name & Checksum SHA256 Checksum Help||Version||File Type||Upload Date|
|elsa-0.1.3-py3-none-any.whl (10.6 kB) Copy SHA256 Checksum SHA256||py3||Wheel||Apr 4, 2017|
|elsa-0.1.3.tar.gz (15.0 kB) Copy SHA256 Checksum SHA256||–||Source||Apr 4, 2017|