search

README

Search model generator

Basic model required, which can be generated with one of the model generators

Use search sub-command to execute generator:

genna search -h

First create your database and tables in it

create table "projects"
(
    "projectId" serial not null,
    "name"      text   not null,

    primary key ("projectId")
);

create table "users"
(
    "userId"    serial      not null,
    "email"     varchar(64) not null,
    "activated" bool        not null default false,
    "name"      varchar(128),
    "countryId" integer,

    primary key ("userId")
);

create schema "geo";
create table geo."countries"
(
    "countryId" serial     not null,
    "code"      varchar(3) not null,
    "coords"    integer[],

    primary key ("countryId")
);

alter table "users"
    add constraint "fk_user_country"
        foreign key ("countryId")
            references geo."countries" ("countryId") on update restrict on delete restrict;

Run generator

genna search -c postgres://user:password@localhost:5432/yourdb -o ~/output/model.go -t public.* -f

You should get following search structs on model package:

//lint:file-ignore U1000 ignore unused code, it's generated
package model

import (
	"github.com/go-pg/pg"
	"github.com/go-pg/pg/orm"
)

// base filters

type applier func(query *orm.Query) (*orm.Query, error)

type search struct {
	custom map[string][]interface{}
}

func (s *search) apply(table string, values map[string]interface{}, query *orm.Query) *orm.Query {
	for field, value := range values {
		if value != nil {
			query.Where("?.? = ?", pg.F(table), pg.F(field), value)
		}
	}

	if s.custom != nil {
		for condition, params := range s.custom {
			query.Where(condition, params...)
		}
	}

	return query
}

func (s *search) with(condition string, params ...interface{}) {
	if s.custom == nil {
		s.custom = map[string][]interface{}{}
	}
	s.custom[condition] = params
}

// Searcher is interface for every generated filter
type Searcher interface {
	Apply(query *orm.Query) *orm.Query
	Q() applier
}

type ProjectSearch struct {
	search

	ID   *int
	Name *string
}

func (s *ProjectSearch) Apply(query *orm.Query) *orm.Query {
	return s.apply(Tables.Project.Alias, map[string]interface{}{
		Columns.Project.ID:   s.ID,
		Columns.Project.Name: s.Name,
	}, query)
}

func (s *ProjectSearch) Q() applier {
	return func(query *orm.Query) (*orm.Query, error) {
		return s.Apply(query), nil
	}
}

type UserSearch struct {
	search

	ID        *int
	Email     *string
	Activated *bool
	Name      *string
	CountryID *int
}

func (s *UserSearch) Apply(query *orm.Query) *orm.Query {
	return s.apply(Tables.User.Alias, map[string]interface{}{
		Columns.User.ID:        s.ID,
		Columns.User.Email:     s.Email,
		Columns.User.Activated: s.Activated,
		Columns.User.Name:      s.Name,
		Columns.User.CountryID: s.CountryID,
	}, query)
}

func (s *UserSearch) Q() applier {
	return func(query *orm.Query) (*orm.Query, error) {
		return s.Apply(query), nil
	}
}

type GeoCountrySearch struct {
	search

	ID   *int
	Code *string
}

func (s *GeoCountrySearch) Apply(query *orm.Query) *orm.Query {
	return s.apply(Tables.GeoCountry.Alias, map[string]interface{}{
		Columns.GeoCountry.ID:   s.ID,
		Columns.GeoCountry.Code: s.Code,
	}, query)
}

func (s *GeoCountrySearch) Q() applier {
	return func(query *orm.Query) (*orm.Query, error) {
		return s.Apply(query), nil
	}
}

Try it

package model

import (
	"fmt"
	"testing"

	"github.com/go-pg/pg"
)

func TestModel(t *testing.T) {
	// connecting to db
	options, _ := pg.ParseURL("postgres://user:password@localhost:5432/yourdb")
	db := pg.Connect(options)

	if _, err := db.Exec(`truncate table users; truncate table geo.countries cascade;`); err != nil {
		panic(err)
	}

	// objects to insert
	toInsert := []GeoCountry{
		GeoCountry{
			Code:   "us",
			Coords: []int{1, 2},
		},
		GeoCountry{
			Code:   "uk",
			Coords: nil,
		},
	}

	// inserting
	if _, err := db.Model(&toInsert).Insert(); err != nil {
		panic(err)
	}

    code := "us"
    country := GeoCountry{}
    search := GeoCountrySearch{
        Code: &code,
    }
    m = db.Model(&country).Apply(search.Q())

    if err := m.Select(); err != nil {
        panic(err)
    }

	fmt.Printf("%#v\n", country)
}

Documentation

Index

• Constants
• func CreateCommand(logger *zap.Logger) *cobra.Command
• type Options
  • func (o *Options) Def()
• type Search
  • func New(logger *zap.Logger) *Search
  • func (g *Search) AddFlags(command *cobra.Command)
  • func (g *Search) Generate() error
  • func (g *Search) Logger() *zap.Logger
  • func (g *Search) Options() *Options
  • func (g *Search) Packer() base.Packer
  • func (g *Search) ReadFlags(command *cobra.Command) error
  • func (g *Search) Repack(packer base.Packer) error
  • func (g *Search) SetOptions(options Options)
• type TemplateColumn
  • func NewTemplateColumn(_ model.Entity, column model.Column, options Options) TemplateColumn
• type TemplateEntity
  • func NewTemplateEntity(entity model.Entity, options Options) TemplateEntity
• type TemplatePackage
  • func NewTemplatePackage(entities []model.Entity, options Options) TemplatePackage

Constants

const Template = `` /* 1827-byte string literal not displayed */

Functions

func CreateCommand

func CreateCommand(logger *zap.Logger) *cobra.Command

CreateCommand creates generator command

Types

type Options

type Options struct {
	base.Options

	// Package sets package name for model
	// Works only with SchemaPackage = false
	Package string

	// Do not replace primary key name to ID
	KeepPK bool

	// Do not generate alias tag
	NoAlias bool

	// Strict types in filters
	Relaxed bool
}

Options for generator

func (*Options) Def

func (o *Options) Def()

Def fills default values of an options

type Search

type Search struct {
	// contains filtered or unexported fields
}

Search represents search generator

func New

func New(logger *zap.Logger) *Search

New creates generator

func (*Search) AddFlags

func (g *Search) AddFlags(command *cobra.Command)

AddFlags adds flags to command

func (*Search) Generate

func (g *Search) Generate() error

Generate runs whole generation process

func (*Search) Logger

func (g *Search) Logger() *zap.Logger

Logger gets logger

func (*Search) Options

func (g *Search) Options() *Options

Options gets options

func (*Search) Packer

func (g *Search) Packer() base.Packer

Packer returns packer function for compile entities into package

func (*Search) ReadFlags

func (g *Search) ReadFlags(command *cobra.Command) error

ReadFlags read flags from command

func (*Search) Repack

func (g *Search) Repack(packer base.Packer) error

Repack runs generator with custom packer

func (*Search) SetOptions

func (g *Search) SetOptions(options Options)

SetOptions sets options

type TemplateColumn

type TemplateColumn struct {
	model.Column

	Relaxed bool

	UseCustomRender bool
	CustomRender    template.HTML
}

TemplateColumn stores column info

func NewTemplateColumn

func NewTemplateColumn(_ model.Entity, column model.Column, options Options) TemplateColumn

NewTemplateColumn creates a column for template

type TemplateEntity

type TemplateEntity struct {
	model.Entity

	NoAlias bool
	Alias   string

	Columns []TemplateColumn

	Imports []string
}

TemplateEntity stores struct info

func NewTemplateEntity

func NewTemplateEntity(entity model.Entity, options Options) TemplateEntity

NewTemplateEntity creates an entity for template

type TemplatePackage

type TemplatePackage struct {
	Package string

	HasImports bool
	Imports    []string

	Entities []TemplateEntity
}

TemplatePackage stores package info

func NewTemplatePackage

func NewTemplatePackage(entities []model.Entity, options Options) TemplatePackage

NewTemplatePackage creates a package for template