WebSaw user guide

WebSaw is an acronym for Web Software Application Warehouse and is essentially a superfast, lightweight web application framework offering developers a fast, secure and flexible development platform from inital protyping through deployment.

Whether you are a Vue / Python /JS or HTML/CSS delveloper Websaw provides the tools to seriously improve productivity and functionality that other frameworks simply cannot.

So if you are sick and tired of copy/pasting multiple templates/fucntions/classes across multiple applications or indeed even among modules in the same application then you have definately landed in the right place.

If not then WebSaw is probably not for you.

If you need to develop Single Page Apps or Client/Server Apps or even a combination of the above securely, quickly and efficently READ ON.

So why WebSaw?

Development on traditional web frameworks generally requires a lot of code duplication whether or not it is html forms or similar fucntoin/actions used in multiple contollers. This is very time conusming and prone to errors particularly when upgrding or adding features to an application.

In addition maintenance becomes laborious with potentially multiple files needing to be changed in order to reflect a simple UI enhancement.

In order to address these shortcomings Websw allows devlopers to implement DRY coding practices in all areas of app development.

DRY or Dont Repeat Yourself application development is extremely important when developing larger and more complex applications and WebSaw gives you all the tools and more to do just that.

Simply stated, WebSaw gives you the ability to develop flexible, secure, robust applications rapidly.

Main Features

Lightweight

• usese ombott a lightweight transport layer

• small footprint

• very few dependancies

Ultrafast

• modules and acrions load only the fixtures they use

• no overhead on screen refresh or redirects

• built on top of lighweight ombott transport layer

Feature rich

• standard authorization functionality

• customizable default layout and page rendering

• customizable form templating engine

• fully functional built in grid

• customizable layout and .css libraries

Flexible

• create SPA or client server apps

• incorporate js, vue or jquery components

• connect seamlessly to multiple industry standard database engines

Contents

• Architecture Overview
  • WebSaw Fixtures:
  • The Context Layer:
  • The Application Layer:
• Getting Started
  • Requirements
  • Installation
  • Creating a Virtual Environment
  • Installing using PyPi
  • Installing from source locally
  • Installing from source globally
  • Docker Compose
  • Running Websaw
  • Websaw CLI
• Server Side Applications
  • Getting Started
    • Application Anatomy
    • Application Directory structure
    • The Controller
    • Mounting the app
  • Working with fixtures
    • Anatomy of a fixture
    • Standard Websaw fixtures
    • Creating a custom fixture
  • Application Context
    • What is meant by context?
    • Extending Context with our fixture
    • A quick recap
  • The Application Layer
    • So what is the application layer?
    • Using the Fixture
    • The Application
  • Component based Templating
    • So why UPYTL?
    • Anatomy of a component
    • The basic template
    • Adding components
  • Using mixins
    • So what is a mixin?
    • The info mixin
    • The basic app
  • Group sessions
    • So why use group sessions?
    • Group sessions in action
  • Context environment
    • Enivironment versus session
    • Environment in action
    • A quick recap
  • Working with data
    • What is a DAL?
    • Supported database engines
    • So why voodoodal?
    • Voodoodal in action
    • Model definition
    • Creating the database
    • Using multiple models
  • The simple grid
    • The BaseGrid class
    • The SimpleGrid class
    • The grid template
    • The grid in action
  • Working with CRUD
    • The CRUD sample app
    • The database model
    • The SQLGrid subclass
    • The SQLGrid
    • The crud actions fucntionality
    • The SQLForm in action
• Client Side Applications
  • SPA Getting Started
    • Understanding PyJsaw files
  • The SPA Scaffold Application
  • Next Steps
• Sample Applications
• Sample Mixins