go-django

README

go-django (v2)

Django rewritten to Golang.

This is a rewrite of the Django framework in Golang.

The goal is to provide a similar experience to Django, but with the performance of Golang.

At the core this is meant to be a web framework, but it also includes sub-packages to create a CMS-like experience.

There is a caveat though; we try to touch the database as little as possible.

This means that we don't have a full ORM like Django does.

Any database logic should be implemented by the end-developer, but some sub-packages do provide backends to use with MySQL and SQLite. Postgres is not planned yet.

Latest version: v1.6.7

Installation

The package is easily installed with go get.

go get github.com/Nigel2392/go-django@v1.6.7

The CLI can optionally be installed with go install.

This will provide some useful utilities to help you get started, like creating a new project, app or Dockerfile.

go install github.com/Nigel2392/go-django/cmd/go-django@v1.6.7

Or to install the SQLC plugin to auto- generate SQL queries and go-django definitions from your SQL database.

go install github.com/Nigel2392/go-django/cmd/go-django-definitions@v1.6.7

Docs

• Using the CLI
• Configuring your server
• Creating an app
• Creating Forms (WIP)
  • Working with Fields
  • Working with Widgets
  • Passing and creating Media
• Defining your models
• Working with permissions
• Setting up Routing
• Creating Management Commands
• Working with context
• Rendering Your Templates
• Usage of Contenttypes
• Paginating your data
• Easily rendering Views (WIP)
• Setting up and calling Hooks
• Working with the Filesystem
• Serving your Staticfiles
• Cache Management
• Caching your Views
• Sending Emails
• Setting up Logging

Contrib apps

• sessions
• admin (WIP)
• auditlogs (WIP)
• auth (WIP)
• pages (WIP)
• editorjs (WIP)

Examples

• Todo App

Help Needed

• Block application:
  • Javascript for structblock
  • Javascript for listblock
  • (maybe) Javascript for fieldblock