This screencast is the third in a series of short tutorials on installing SubstanceD and using it to build a simple intranet application. It starts from where Episode 2 leaves off.

This episode demonstrates starting the WSGI server in development mode, viewing the default splash page in the browser, and logging into the the SubstanceD admin interface.

Annotated Commands

For those who'd like to read rather than listen, this is the set of commands outlined:

1. Start the server using the development configuration:

   $ ../../bin/pserve development.ini
   

2. Grep the generated, random password from the config file:

   $ cd src/myintranet
   $ grep passwword development.ini
   

3. View the default splash page at http://localhost:6543/.
4. Log into the SubstanceD management interface at: http://localhost:6543/manage.

This screencast is the second in a series of short tutorials on installing SubstanceD and using it to build a simple intranet application. It starts from where Episode 1 leaves off.

This episode demonstrates generating the initial version of the myintranet project, checking it into Git, and installing it and its added dependencies into the virtual environment.

Annotated Commands

For those who'd like to read rather than listen, this is the set of commands outlined:

1. List the templates available for generating a project:

   $ bin/pcreate --list-templates
   

2. Generate the myintranet project:

   $ cd src
   $ ../bin/pcreate --template=substanced myintranet
   $ cd myintranet
   

3. Check the initially generated code into a local Git repository:

   $ git init .
   $ cat > .gitignore
   *.pyc
   __pycache__
   *.egg-info
   *.fs*
   blobs
   tmp
   ^D
   $ git add .
   $ git commit -m "Initially-generated project."
   

4. Install the project and its extra dependencies into the environment:

   $ ../../bin/python setup.py develop
   

5. Verify that myintranet is importable from our checkout:

   $ cd ../..
   $ bin/python
   ...
   >>> import myintranet
   >>> print(myintranet.__file__)
   

This screencast is the first in a series of short tutorials on installing SubstanceD and using it to build a simple intranet application.

This episode demonstrates creating a Python virtual environment and installing the SubstanceD software into it.

Annotated Commands

For those who'd like to read rather than listen, this is the set of commands outlined:

1. Create a Python 3.3 virtual environment:

   $ /opt/Python-3.3.3/bin/pyvenv intranet
   $ cd intranet
   

2. Install and update setuptools:

   $ wget https://bitbucket.org/pypa/setuptools/downloads/ez_setup.py
   $ bin/python3 ez_setup.py
   $ bin/easy_install -U setuptools
   

3. Check out SubstanceD from Github:

   $ mkdir src
   $ cd src
   $ git clone git@github.com:Pylons/substanced
   $ cd substanced
   

4. Run SubstanceD's setup.py to install it in the environment:

   $ ../../bin/python3 setup.py develop
   

   Note that this step also installs SubstanceD's dependencies.
5. Verify that SubstanceD is importable from our checkout:

   $ cd ../..
   $ bin/python
   ...
   >>> import substanced
   >>> print(substanced.__file__)
   

We're starting a series of short (3 - 5 minute) screencasts, demonstrating the SubstanceD application development platform. The series is built around the tasks needed to set up a simple intranet site.

For an overview of SubstanceD as a development platform, start with the talk given by Chris McDonough at the RuPy 2013 confernce: "SubstanceD: Building Civilized Web Applications".