the cookiecutter utility uses pre-defined project templates to auto-generate the project and package structure. for complex projects, it saves a lot of manual effort in properly organizing various project components.

however, a pyramid project can be built manually without having to use cookiecutter. in this section, we shall see how a pyramid project named hello is built in following easy steps.

setup.py

create a project directory within pyramid virtual environment.

md hello
cd hello

and save the following script as setup.py

from setuptools import setup

requires = [
   'pyramid',
   'waitress',
]
setup(
   name='hello',
   install_requires=requires,
   entry_points={
      'paste.app_factory': [
         'main = hello:main'
      ],
   },
)

as mentioned earlier, this is a setuptools setup file that defines requirements for installing dependencies for your package.

run the following command to install the project and generate the 'egg' in the name hello.egg-info.

pip3 install -e.

development.ini

pyramid uses pastedeploy configuration file mainly to specify the main application object, and the server configuration. we are going to use the application object in the egg info of hello package, and the waitress server, listening on port 5643 of the localhost. hence, save the following snippet as development.ini file.

[app:main]
use = egg:hello

[server:main]
use = egg:waitress#main
listen = localhost:6543

init.py

finally, the application code resides in this file which is also essential for the hello folder to be recognised as a package.

the code is a basic hello world pyramid application code having hello_world() view. the main() function registers this view with hello route having '/' url pattern, and returns the application object given by make_wsgi_app() method of configurator.

from pyramid.config import configurator
from pyramid.response import response
def hello_world(request):
   return response('<body><h1>hello world!</h1></body>')
def main(global_config, **settings):
   config = configurator(settings=settings)
   config.add_route('hello', '/')
   config.add_view(hello_world, route_name='hello')
   return config.make_wsgi_app()

finally, serve the application with the help of pserve command.

pserve development.ini --reload

setup.py

development.ini

__init__.py

init.py

Save or share this article