This is a short guide that will show you the basics of creating a Web
application based on
Install Python 3.3+¶
First, install Python 3.3. Older versions of Python 3 will not work. Mainly, this is because of the use of built-in namespace package support that was added in Python 3.3.
brew install python3
Python 2.x is not supported, and there are no plans to support it.
Next, set up an isolated virtual environment. Since we’re using Python 3, this is built in. The command for creating a virtual env looks like this:
python3 -m venv helloworld.venv
Change into the
helloworld.venv directory and download the following file
Then run the following command:
A couple of Tangled dependencies need to be installed so that the
tangled scaffold command and
basic scaffold are available:
./bin/pip install tangled.web==VERSION
Replace VERSION with the version you want to install. The current version is 1.0a13.dev0.
If you want to use the latest code, you can do this instead (requires git to be installed):
./bin/pip install -e git+git://github.com/TangledWeb/tangled#egg=tangled ./bin/pip install -e git+git://github.com/TangledWeb/tangled.web#egg=tangled.web
Create a Basic Tangled Web App¶
Now that the virtual environment is set up and the Tangled dependencies have
been installed, a project can be created. Run the following commands in the
./bin/tangled scaffold basic helloworld ./bin/pip install -e helloworld
Serve it Up¶
Now that everything’s installed, it’s time to run the app:
./bin/tangled serve -f helloworld/development.ini
Take a look at the app configuration in
Hello resource in
The Application API documentation currently has the most comprehensive info on creating and configuring Tangled Web apps.
This is all still very much a work in progress. Please feel free to make suggestions or report issues on GitHub.