Wutta Tutorial

This is a tutorial for building an app using Wutta Framework.

It splits things into 2 main parts:

First is the “Basic Setup” which is meant to be useful for any new project.

Second is the “Custom App” - which shows how to go about building with the framework. For now that is a simple gas mileage tracker app; hopefully in the future more examples will be added.

Note

All examples here use Poser as the project name.

It is literally a placeholder - you should use a different name!

To help differentiate things somewhat, here are all the names used:

• Poser - human-friendly project name

• poser - Python package name (and the source folder name)

• poserdb - name of the app database

• poserenv - root folder name of the Python virtual environment

Also, examples show the virtual environment at ~/poserenv and the project source at ~/src/poser - you should adjust both paths according to your preference.

Basic Setup:

• Create the Project
  • Project Naming
  • Virtual Environment
  • Cookie Cutter
  • Generate Code
  • Commit Code
  • Install Package
• Create the Database
  • PostgreSQL
  • MariaDB/MySQL
• Run the App Installer
  • Command Line
  • End Result
• Run the Web App
  • Command Line
  • First Admin Account
• Get Acquainted
  • Admin Users Can “Become Root”
  • Users + Roles + Permissions
  • Site Admin Role

Mileage App:

• Mileage Tracker App
  • Create the first App Table (vehicle)
  • Create the Master View (/vehicles/)
  • Create another App Table (mileage_entry)
  • Create another Master View (/mileage-entries/)
  • Customize the Master Views
  • Add a custom “Charts” page