Dev tools for aiohttp
Project description
Dev tools for aiohttp.
(Note: aiohttp-devtools>=0.3 only supports aiohttp>=2.0, if you’re using older aiohttp, please use aiohtt-devtools==0.21, see History.rst for details.)
aiohttp-devtools provides a number of tools useful when developing applications with aiohttp and associated libraries.
Installation
Requires python 3.5 or python 3.6.
pip install aiohttp-devtoolsUsage
The aiohttp-devtools CLI (and it’s shorter alias adev) consist of three sub-commands: runserver, serve and start.
runserver
Provides a simple local server for running your application while you’re developing.
Usage is simply
adev runserver <app-path>app-path can be a path to either a directory containing a recognized default file (app.py or main.py) or to a specific file. The --app-factory option can be used to define which method is called from the app path file, if not supplied some default method names are tried.
All runserver arguments can be set via environment variables, the start command creates a script suitable for setting up your environment such that you can run the dev server with just adev runserver.
runserver has a few of useful features:
livereload will reload resources in the browser as your code changes without having to hit refresh, see livereload for more details.
static files are served separately from your main app (generally on 8001 while your app is on 8000) so you don’t have to contaminate your application to serve static files you only need locally
a debug toolbar is automatically enabled using aiohttp debugtoolbar.
For more options see adev runserver --help.
serve
Similar to runserver except just serves static files.
Usage is simply
adev serve <path-to-directory-to-serve>Like runserver you get nice live reloading and access logs. For more options see adev serve --help.
start
Creates a new bare bones aiohttp app similar to django’s “startproject”.
Usage is simply
adev start <path-to-directory-to-create-project-in>You’re then asked a bunch of questions about the the application you’re about to create, you get to choose:
Template Engine, options are
jinja views are rendered using Jinja2 templates via aiohttp_jinja2.
none views are rendered directly.
Session, options are
secure will implemented encrypted cookie sessions using aiohttp_session.
none - session are not implemented
Database, options are:
pg-sqlalchemy will use postgresql via aiopg and the SqlAlchemy ORM.
none will use no database, persistence in examples is achieved by simply writing to file. This is a quick way to get started but is obviously not suitable for production use!
Example, the newly created app can include some basic functionality
message board: which demonstrates a little of aiohttp’s usage. Messages can be added via posting to a form, are stored in the database and then displayed in a list, if available the session is used to pre-populate the user’s name.
none: no example, just a single simple view is created.
For more options see adev start --help, or just run adev start foobar and follow instructions.
Tutorial
To demonstrate what adev can do, let’s walk through creating a new application:
First let’s create a clean python environment to work in and install aiohttp-devtools.
(it is assumed you’ve already got python 3.5, pip and virtualenv installed)
mkdir my_new_app && cd my_new_app
virtualenv -p `which python3.5` env
. env/bin/activate
pip install aiohttp-devtoolsWe’re now ready to build our new application with start, using the current directory . will put files where we want them and will prompt adev to name the project my_new_app after the current directory.
We’re going to explicitly choose no database here to make, this tutorial easier but you can remove that option and choose to use a proper database if you like.
You can just hit return to choose the default for all the options.
adev start . --database noneThat’s it, your app is now created. You might want to have a look through the local directory’s file tree.
Before you can run your app you’ll need to install the other requirements, luckily they’ve already been listed in ./requirements.txt by start, to install simply run
pip install -r requirements.txt(If you went off-piste and choose to use a database you’ll need to edit activate.settings.sh to configure connection settings, then run make reset-database to create a database.)
You can then run your app with just:
source activate.settings.sh
adev runserverrunserver uses the environment variables set in activate.settings.sh to decide how to serve your app.
With that:
your app should be being served at localhost:8000 (you can go and play with it in a browser).
Your static files are being served at localhost:8001, adev has configured your app to know that so it should be rendering properly.
any changes to your app’s code (.py files) should cause the server to reload, changes to any files (.py as well as .jinja, .js, .css etc.) will cause livereload to prompt your browser to reload the required pages.
That’s it, go develop.
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
File details
Details for the file aiohttp-devtools-0.4.1.tar.gz.
File metadata
- Download URL: aiohttp-devtools-0.4.1.tar.gz
- Upload date:
- Size: 35.4 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 6cba0097bf988315c5a132b62fb3208d84508a7aea5bc9dea3f0943318f19421 |
|
| MD5 | 5864240e6d5f9dc242e3a5c7b111e914 |
|
| BLAKE2b-256 | b7c481377dbc1e352368501d0c03b202bbf157c18ab9b284cfd44f206414b50d |
Provenance
File details
Details for the file aiohttp_devtools-0.4.1-py35.py36-none-any.whl.
File metadata
- Download URL: aiohttp_devtools-0.4.1-py35.py36-none-any.whl
- Upload date:
- Size: 49.3 kB
- Tags: Python 3.5, Python 3.6
- Uploaded using Trusted Publishing? No
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | b24822ff58ec74664ab3c9ccec921c320c238607d4f54cab33ae9715cf5087c4 |
|
| MD5 | 3d8e5c56059ca96d343cad0f5186519d |
|
| BLAKE2b-256 | 4f857665aef130106ddab22d698038c58c1602560f13283f619a7245b60b7f8c |
