mandarvaze / pyramid-realworld-example-app

Pyramid and OpenAPI3 based RealWorld implementation.

Pyramid codebase containing real world examples (CRUD, auth, advanced patterns, etc) that adheres to the RealWorld spec and API.

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 styleguides & 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

Pyramid using pyramid_openapi3 for request/response validation and pyramid_deferred_sqla for PostgreSQL integration. 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 setup 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).

So, first ensure that you have Docker installed on your system. Then,

Option 1: Install manually

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

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

Option 2: Install using Nix

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

Docker should be running. Then you can run:

$ cd ~/projects
$ git clone https://github.com/niteoweb/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 container, you can run:

$ make stop-pgsql
$ make clean-pgsql