ra312 / cookie-cutter

Pyramid codebase containing real world examples (CRUD, authentication, authorization, advanced patterns, and so on) that adhere to the RealWorld specification and API.

Demos

This is deployed on Heroku and is configured to automatically sleep after an hour of inactivity. If you get Application Error, refresh again in a minute or two.

• Demo (app)
• Demo (api)

This codebase was created to demonstrate a fully fledged fullstack application built with Pyramid including CRUD operations, authentication, routing, pagination, and more.

We've gone to great lengths to adhere to the Pyramid community style guides and best practices. You are encouraged to use it as a scaffold/template for your next Pyramid project.

For more information on how this works with other frontends/backends, head over to the RealWorld repo.

How it works

The application is built with Pyramid, using pyramid_openapi3 for request/response validation and pyramid_deferred_sqla for PostgreSQL integration. It is deployed to Heroku.

Pyramid serves one of the RealWorld.io frontends (Elm) on root, so it is easier to understand how things fit together. The frontend is interchangeable. You can use any RealWorld.io frontend.

Getting started

To set up your development environment, there are some dependencies you need to install on your system. You can either install them manually, or use Nix and direnv to install them automatically (except Docker which you need to install manually).

First ensure that you have Docker installed on your system. Then choose one option to install pre-requisites.

Option 1: Install pre-requisites manually

• python 3.9 (we recommend using pyenv for installing Python).
• poetry
• node & jq (to run postman tests)

Activate the virtual environment, then continue to Install RealWorld Example App.

If you have any dependency related issue, check out ./shell.nix for the specific version of dependencies.

Option 2: Install pre-requisites using Nix

• Install the Nix package manager.
• Install and configure Direnv
• Run direnv allow in the project root.

Install and Run RealWorld Example App

Docker should be running. Then you can run:

$ cd ~/projects
$ git clone https://github.com/teamniteo/pyramid-realworld-example-app.git
$ cd pyramid-realworld-example-app
$ make install
$ make start-pgsql
$ make devdb
$ make run

Now point your browser to:

• http://localhost:8080/ -> Conduit frontend app using the API
• http://localhost:8080/api -> Swagger documentation for the API

To run unit tests, mypy typing checker and flake8 linter:

$ make tests

To stop Docker and clean the container, you can run:

$ make stop-pgsql
$ make clean-pgsql