This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (pypi.python.org).
Help us improve Python packaging - Donate today!

Helper module for Frozen-Flask based websites

Project Description

elsa

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.

Basic usage

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 based deployment

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

Testing

To run the test suite, install tox and run it:

tox

Elsa uses pytest, so if you are familiar with it, feel free to run it directly.

Further notes

URLs

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.

Changes

0.1.3

  • Only treat Frozen-Flask warnings as errors, not other warnings (#34)
  • Add a --remote option for deploy to use a custom git remote
  • Be consistent on local vs Travis CI deployment, always erase the history of the gh-pages branch (actually fixes #14)

0.1.2

  • Security: Do not display the remote URL when pushing gh-pages branch. If you used Elsa 0.1 or 0.1.1 on Travis CI, revoke your GitHub token, it was probably leaked in the log. (#25)

0.1.1

  • Fix a problem with Travis CI based deployment

0.1

  • Add a test suite
  • Treat Frozen-Flask warnings as errors
  • Important: It is now recommended to run freeze in .travis.yml script section to catch problems in Pull Requests etc.
  • Important: This version of Elsa will warn if you use the deploy command without specifying --push or --no-push explicitly. In a future release, it will switch to not pushing the built pages by default.
  • Remove the dependency on sh to improve compatibility with Windows
  • Supports Linux, Mac OS X and Windows
  • The gh-branch is purged before the deploying commit (#14)
  • It is possible to shutdown the server via a special POST request (#21)

0.1.dev4

  • Set template auto_reload flag directly in serve mode (#8)

0.1.dev3

  • Set TEMPLATES_AUTO_RELOAD by default (#5)
  • Suppress a bogus warning about CNAME mime type (#7)

0.1.dev2

  • The CNAME route is now created automatically

0.1.dev1

Release History

Release History

This version
History Node

0.1.3

History Node

0.1.2

History Node

0.1.1

History Node

0.1

History Node

0.1.dev4

History Node

0.1.dev3

History Node

0.1.dev2

History Node

0.1.dev1

Download Files

Download Files

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

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting