rasant

README

Rasant

Rasant is a web application framework written in the Go language.

Documentation

Index

• type Database
• type Encryption
  • func (e *Encryption) Decrypt(cryptoText string) (string, error)
  • func (e *Encryption) Encrypt(text string) (string, error)
• type Rasant
  • func (ras *Rasant) BuildDSN() string
  • func (ras *Rasant) CreateDirIfNotExist(path string) error
  • func (ras *Rasant) CreateFileIfNotExist(path string) error
  • func (ras *Rasant) DownloadFile(w http.ResponseWriter, r *http.Request, pathToFile, fileName string) error
  • func (ras *Rasant) Error404(w http.ResponseWriter, r *http.Request)
  • func (ras *Rasant) Error500(w http.ResponseWriter, r *http.Request)
  • func (ras *Rasant) ErrorForbidden(w http.ResponseWriter, r *http.Request)
  • func (ras *Rasant) ErrorStatus(w http.ResponseWriter, status int)
  • func (ras *Rasant) ErrorUnauthorized(w http.ResponseWriter, r *http.Request)
  • func (ras *Rasant) Init(p initPaths) error
  • func (ras *Rasant) ListenAndServe()
  • func (ras *Rasant) LoadTime(start time.Time)
  • func (ras *Rasant) MigrateDownAll(dsn string) error
  • func (ras *Rasant) MigrateForce(dsn string) error
  • func (ras *Rasant) MigrateUp(dsn string) error
  • func (ras *Rasant) New(rootPath string) error
  • func (ras *Rasant) NoSurf(next http.Handler) http.Handler
  • func (res *Rasant) OpenDB(dbType, dsn string) (*sql.DB, error)
  • func (ras *Rasant) RandomString(n int) string
  • func (ras *Rasant) ReadJSON(w http.ResponseWriter, r *http.Request, data interface{}) error
  • func (ras *Rasant) SessionLoad(next http.Handler) http.Handler
  • func (ras *Rasant) Steps(n int, dsn string) error
  • func (ras *Rasant) Validator(data url.Values) *Validation
  • func (ras *Rasant) WriteJSON(w http.ResponseWriter, status int, data interface{}, headers ...http.Header) error
  • func (ras *Rasant) WriteXML(w http.ResponseWriter, status int, data interface{}, headers ...http.Header) error
• type Server
• type Validation
  • func (v *Validation) AddError(key, message string)
  • func (v *Validation) Check(ok bool, key, message string)
  • func (v *Validation) Has(field string, r *http.Request) bool
  • func (v *Validation) IsDateISO(field, value string)
  • func (v *Validation) IsEmail(field, value string)
  • func (v *Validation) IsFloat(field, value string)
  • func (v *Validation) IsInt(field, value string)
  • func (v *Validation) NoSpaces(field, value string)
  • func (v *Validation) Required(r *http.Request, fields ...string)
  • func (v *Validation) Valid() bool

Types

type Database

type Database struct {
	DataType string
	Pool     *sql.DB
}

type Encryption

type Encryption struct {
	Key []byte
}

func (*Encryption) Decrypt

func (e *Encryption) Decrypt(cryptoText string) (string, error)

func (*Encryption) Encrypt

func (e *Encryption) Encrypt(text string) (string, error)

type Rasant

type Rasant struct {
	AppName  string
	Debug    bool
	Version  string
	ErrorLog *log.Logger
	InfoLog  *log.Logger
	RootPath string
	Routes   *chi.Mux
	Render   *render.Render
	Session  *scs.SessionManager
	DB       Database
	JetViews *jet.Set

	EncryptionKey string
	Cache         cache.Cache
	Scheduler     *cron.Cron
	Mail          mailer.Mail
	Server        Server
	FileSystems   map[string]interface{}
	// contains filtered or unexported fields
}

Rasant is the overall type for the Rasant package. Members that are exported in this type are available to any application that uses it.

func (*Rasant) BuildDSN

func (ras *Rasant) BuildDSN() string

func (*Rasant) CreateDirIfNotExist

func (ras *Rasant) CreateDirIfNotExist(path string) error

func (*Rasant) CreateFileIfNotExist

func (ras *Rasant) CreateFileIfNotExist(path string) error

func (*Rasant) DownloadFile

func (ras *Rasant) DownloadFile(w http.ResponseWriter, r *http.Request, pathToFile, fileName string) error

func (*Rasant) Error404

func (ras *Rasant) Error404(w http.ResponseWriter, r *http.Request)

func (*Rasant) Error500

func (ras *Rasant) Error500(w http.ResponseWriter, r *http.Request)

func (*Rasant) ErrorForbidden

func (ras *Rasant) ErrorForbidden(w http.ResponseWriter, r *http.Request)

func (*Rasant) ErrorStatus

func (ras *Rasant) ErrorStatus(w http.ResponseWriter, status int)

func (*Rasant) ErrorUnauthorized

func (ras *Rasant) ErrorUnauthorized(w http.ResponseWriter, r *http.Request)

func (*Rasant) Init

func (ras *Rasant) Init(p initPaths) error

Init creates necessary folders for our Rasant application

func (*Rasant) ListenAndServe

func (ras *Rasant) ListenAndServe()

ListenAndServe starts the web server

func (*Rasant) LoadTime

func (ras *Rasant) LoadTime(start time.Time)

func (*Rasant) MigrateDownAll

func (ras *Rasant) MigrateDownAll(dsn string) error

func (*Rasant) MigrateForce

func (ras *Rasant) MigrateForce(dsn string) error

func (*Rasant) MigrateUp

func (ras *Rasant) MigrateUp(dsn string) error

func (*Rasant) New

func (ras *Rasant) New(rootPath string) error

New reads the .env file, creates our application config, populates the Rasant type with settings based on .env values, and creates necessary folders and files if they don't exist

func (*Rasant) NoSurf

func (ras *Rasant) NoSurf(next http.Handler) http.Handler

func (*Rasant) OpenDB

func (res *Rasant) OpenDB(dbType, dsn string) (*sql.DB, error)

func (*Rasant) RandomString

func (ras *Rasant) RandomString(n int) string

RandomString generates a random string length n from values in the const randomString

func (*Rasant) ReadJSON

func (ras *Rasant) ReadJSON(w http.ResponseWriter, r *http.Request, data interface{}) error

func (*Rasant) SessionLoad

func (ras *Rasant) SessionLoad(next http.Handler) http.Handler

func (*Rasant) Steps

func (ras *Rasant) Steps(n int, dsn string) error

func (*Rasant) Validator

func (ras *Rasant) Validator(data url.Values) *Validation

func (*Rasant) WriteJSON

func (ras *Rasant) WriteJSON(w http.ResponseWriter, status int, data interface{}, headers ...http.Header) error

func (*Rasant) WriteXML

func (ras *Rasant) WriteXML(w http.ResponseWriter, status int, data interface{}, headers ...http.Header) error

type Server

type Server struct {
	ServerName string
	Port       string
	Secure     bool
	URL        string
}

type Validation

type Validation struct {
	Data   url.Values
	Errors map[string]string
}

func (*Validation) AddError

func (v *Validation) AddError(key, message string)

func (*Validation) Check

func (v *Validation) Check(ok bool, key, message string)

func (*Validation) Has

func (v *Validation) Has(field string, r *http.Request) bool

func (*Validation) IsDateISO

func (v *Validation) IsDateISO(field, value string)

func (*Validation) IsEmail

func (v *Validation) IsEmail(field, value string)

func (*Validation) IsFloat

func (v *Validation) IsFloat(field, value string)

func (*Validation) IsInt

func (v *Validation) IsInt(field, value string)

func (*Validation) NoSpaces

func (v *Validation) NoSpaces(field, value string)

func (*Validation) Required

func (v *Validation) Required(r *http.Request, fields ...string)

func (*Validation) Valid

func (v *Validation) Valid() bool