specutil

package
v0.0.0-...-3fa874a Latest Latest
Warning

This package is not in the latest version of its module.

 Go to latest Published: Apr 5, 2024 License: Apache-2.0 Imports: 11 Imported by: 0

Documentation

Index

Constants

This section is empty.

Variables

View Source 
var ReferenceVars = []string{
	Var(string(schema.NoAction)),
	Var(string(schema.Restrict)),
	Var(string(schema.Cascade)),
	Var(string(schema.SetNull)),
	Var(string(schema.SetDefault)),
}

ReferenceVars holds the HCL variables for foreign keys' referential-actions.

Functions

func Check 

func Check(spec *sqlspec.Check) (*schema.Check, error)

Check converts a sqlspec.Check to a schema.Check.

func Column 

func Column(spec *sqlspec.Column, conv ConvertTypeFunc) (*schema.Column, error)

Column converts a sqlspec.Column into a schema.Column.

func ColumnByRef 

func ColumnByRef[T *schema.View | *schema.Table](tv T, ref *schemahcl.Ref) (*schema.Column, error)

ColumnByRef returns a column from the table by its reference.

func ColumnDefault 

func ColumnDefault(c *schema.Column) (cty.Value, error)

ColumnDefault converts the column default into cty.Value.

func ColumnRef 

func ColumnRef(cName string) *schemahcl.Ref

ColumnRef returns the reference of a column by its name.

func ColumnRefFinder 

func ColumnRefFinder(specs []*sqlspec.Table) func(s, t, c string) (*schemahcl.Ref, error)

ColumnRefFinder returns a function that finds a column reference by its table and its schema.

func ConvertGenExpr 

func ConvertGenExpr(r *schemahcl.Resource, c *schema.Column, t func(string) string) error

ConvertGenExpr converts the "as" attribute or the block under the given resource.

func Default 

func Default(d cty.Value) (schema.Expr, error)

Default converts a cty.Value (as defined in the spec) into a schema.Expr.

func ExternalColumnRef 

func ExternalColumnRef(cName string, tName string) *schemahcl.Ref

ExternalColumnRef returns the reference of a column by its name and table name.

func FromCheck 

func FromCheck(s *schema.Check) *sqlspec.Check

FromCheck converts schema.Check to sqlspec.Check.

func FromColumn 

func FromColumn(c *schema.Column, columnTypeSpec ColumnTypeSpecFunc) (*sqlspec.Column, error)

FromColumn converts a *schema.Column into a *sqlspec.Column using the ColumnTypeSpecFunc.

func FromForeignKey 

func FromForeignKey(s *schema.ForeignKey) (*sqlspec.ForeignKey, error)

FromForeignKey converts schema.ForeignKey to sqlspec.ForeignKey.

func FromGenExpr 

func FromGenExpr(x schema.GeneratedExpr, t func(string) string) *schemahcl.Resource

FromGenExpr returns the spec for a generated expression.

func FromIndex 

func FromIndex(idx *schema.Index, partFns ...func(*schema.Index, *schema.IndexPart, *sqlspec.IndexPart) error) (*sqlspec.Index, error)

FromIndex converts schema.Index to sqlspec.Index.

func FromPrimaryKey 

func FromPrimaryKey(s *schema.Index) (*sqlspec.PrimaryKey, error)

FromPrimaryKey converts schema.Index to a sqlspec.PrimaryKey.

func FromTable 

func FromTable(t *schema.Table, colFn TableColumnSpecFunc, pkFn PrimaryKeySpecFunc, idxFn IndexSpecFunc,
	fkFn ForeignKeySpecFunc, ckFn CheckSpecFunc) (*sqlspec.Table, error)

FromTable converts a schema.Table to a sqlspec.Table.

func FromVar 

func FromVar(s string) string

FromVar is the inverse function of Var.

func FromView 

func FromView(v *schema.View, colFn ViewColumnSpecFunc, idxFn IndexSpecFunc) (*sqlspec.View, error)

FromView converts a schema.View to a sqlspec.View.

func HCLBytesFunc 

func HCLBytesFunc(ev schemahcl.Evaluator) func(b []byte, v any, inp map[string]cty.Value) error

HCLBytesFunc returns a helper that evaluates an HCL document from a byte slice instead of from an hclparse.Parser instance.

func Index 

func Index(spec *sqlspec.Index, parent *schema.Table, partFns ...func(*sqlspec.IndexPart, *schema.IndexPart) error) (*schema.Index, error)

Index converts a sqlspec.Index to a schema.Index. The optional arguments allow passing functions for mutating the created index-part (e.g. add attributes).

func Marshal 

func Marshal(v any, marshaler schemahcl.Marshaler, funcs RealmFuncs) ([]byte, error)

Marshal marshals v into an Atlas DDL document using a schemahcl.Marshaler. Marshal uses the given schemaSpec function to convert a *schema.Schema into *sqlspec.Schema, []*sqlspec.Table and []*sqlspec.View.

func ObjectRef 

func ObjectRef(s *schema.Schema, o SpecTypeNamer) *schemahcl.Ref

ObjectRef returns a reference to the object. In case there is more than one object of this type with the same name, the reference will be qualified with the schema name.

func PrimaryKey 

func PrimaryKey(spec *sqlspec.PrimaryKey, parent *schema.Table) (*schema.Index, error)

PrimaryKey converts a sqlspec.PrimaryKey to a schema.Index.

func QualifiedExternalColRef 

func QualifiedExternalColRef(cName, tName, sName string) *schemahcl.Ref

QualifiedExternalColRef returns the reference of a column by its name and qualified table name.

func QualifyObjects 

func QualifyObjects[T SchemaObject](specs []T) error

QualifyObjects sets the Qualifier field equal to the schema name in any objects with duplicate names in the provided specs.

func QualifyReferences 

func QualifyReferences(tableSpecs []*sqlspec.Table, realm *schema.Realm) error

QualifyReferences qualifies any reference with qualifier.

func RefName 

func RefName(ref *schemahcl.Ref, typeName string) (qualifier, name string, err error)

RefName returns the qualifier and name from a reference.

func Scan 

func Scan(r *schema.Realm, doc *ScanDoc, funcs *ScanFuncs) error

Scan populates the Realm from the schemas and table specs.

func SchemaName 

func SchemaName(ref *schemahcl.Ref) (string, error)

SchemaName returns the name from a ref to a schema.

func SchemaRef 

func SchemaRef(name string) *schemahcl.Ref

SchemaRef returns the schemahcl.Ref to the schema with the given name.

func Table 

func Table(spec *sqlspec.Table, parent *schema.Schema, convertColumn ConvertTableColumnFunc,
	convertPK ConvertPrimaryKeyFunc, convertIndex ConvertIndexFunc, convertCheck ConvertCheckFunc) (*schema.Table, error)

Table converts a sqlspec.Table to a schema.Table. Table conversion is done without converting ForeignKeySpecs into ForeignKeys, as the target tables do not necessarily exist in the schema at this point. Instead, the linking is done by the Schema function.

func TableName 

func TableName(ref *schemahcl.Ref) (string, string, error)

TableName returns the qualifier and name from a reference to a table.

func TypeAttr 

func TypeAttr(k string, t *schemahcl.Type) *schemahcl.Attr

TypeAttr is a helper method for constructing *schemahcl.Attr instances that contain a type reference.

func Var 

func Var(s string) string

Var formats a string as variable to make it HCL compatible. The result is simple, replace each space with underscore.

func VarAttr 

func VarAttr(k, v string) *schemahcl.Attr

VarAttr is a helper method for constructing *schemahcl.Attr instances that contain a variable reference.

func View 

func View(spec *sqlspec.View, parent *schema.Schema, convertC ConvertViewColumnFunc, convertI ConvertViewIndexFunc) (*schema.View, error)

View converts a sqlspec.View to a schema.View.

Types

type Attrer 

type Attrer interface {
	Attr(string) (*schemahcl.Attr, bool)
}

Attrer is the interface that wraps the Attr method.

type CheckSpecFunc 

type CheckSpecFunc func(*schema.Check) *sqlspec.Check

List of convert function types.

type ColumnTypeSpecFunc 

type ColumnTypeSpecFunc func(schema.Type) (*sqlspec.Column, error)

List of convert function types.

type ConvertCheckFunc 

type ConvertCheckFunc func(*sqlspec.Check) (*schema.Check, error)

List of convert function types.

type ConvertIndexFunc 

type ConvertIndexFunc func(*sqlspec.Index, *schema.Table) (*schema.Index, error)

List of convert function types.

type ConvertPrimaryKeyFunc 

type ConvertPrimaryKeyFunc func(*sqlspec.PrimaryKey, *schema.Table) (*schema.Index, error)

List of convert function types.

type ConvertTableColumnFunc 

type ConvertTableColumnFunc func(*sqlspec.Column, *schema.Table) (*schema.Column, error)

List of convert function types.

type ConvertTableFunc 

type ConvertTableFunc func(*sqlspec.Table, *schema.Schema) (*schema.Table, error)

List of convert function types.

type ConvertTypeFunc 

type ConvertTypeFunc func(*sqlspec.Column) (schema.Type, error)

List of convert function types.

type ConvertViewColumnFunc 

type ConvertViewColumnFunc func(*sqlspec.Column, *schema.View) (*schema.Column, error)

List of convert function types.

type ConvertViewFunc 

type ConvertViewFunc func(*sqlspec.View, *schema.Schema) (*schema.View, error)

List of convert function types.

type ConvertViewIndexFunc 

type ConvertViewIndexFunc func(*sqlspec.Index, *schema.View) (*schema.Index, error)

List of convert function types.

type Doc 

type Doc struct {
	Tables       []*sqlspec.Table   `spec:"table"`
	Views        []*sqlspec.View    `spec:"view"`
	Materialized []*sqlspec.View    `spec:"materialized"`
	Funcs        []*sqlspec.Func    `spec:"function"`
	Procs        []*sqlspec.Func    `spec:"procedure"`
	Triggers     []*sqlspec.Trigger `spec:"trigger"`
	Schemas      []*sqlspec.Schema  `spec:"schema"`
}

Doc represents the common HCL spec document.

type ForeignKeySpecFunc 

type ForeignKeySpecFunc func(*schema.ForeignKey) (*sqlspec.ForeignKey, error)

List of convert function types.

type IndexSpecFunc 

type IndexSpecFunc func(*schema.Index) (*sqlspec.Index, error)

List of convert function types.

type PrimaryKeySpecFunc 

type PrimaryKeySpecFunc func(*schema.Index) (*sqlspec.PrimaryKey, error)

List of convert function types.

type RealmFuncs 

type RealmFuncs struct {
	Schema   func(*schema.Schema) (*SchemaSpec, error)
	Triggers func([]*schema.Trigger, *Doc) ([]*sqlspec.Trigger, error)
}

RealmFuncs represents the functions that used to convert the schema.Realm into HCL spec document.

type RefNamer 

type RefNamer interface {
	// Ref returns the reference to the object.
	Ref() *schemahcl.Ref
}

RefNamer is an interface for objects that can return their reference.

type ScanDoc 

type ScanDoc struct {
	Schemas      []*sqlspec.Schema
	Tables       []*sqlspec.Table
	Views        []*sqlspec.View
	Materialized []*sqlspec.View
	Funcs        []*sqlspec.Func
	Procs        []*sqlspec.Func
	Triggers     []*sqlspec.Trigger
}

ScanDoc represents a scanned HCL document.

type ScanFuncs 

type ScanFuncs struct {
	Table ConvertTableFunc
	View  ConvertViewFunc
	Func  func(*sqlspec.Func) (*schema.Func, error)
	Proc  func(*sqlspec.Func) (*schema.Proc, error)
	// Triggers add themselves to the relevant tables/views.
	Triggers func(*schema.Realm, []*sqlspec.Trigger) error
	// Objects add themselves to the realm.
	Objects func(*schema.Realm) error
}

ScanFuncs represents a set of scan functions used to convert the HCL document to the Realm.

type SchemaFuncs 

type SchemaFuncs struct {
	Table TableSpecFunc
	View  ViewSpecFunc
	Func  func(*schema.Func) (*sqlspec.Func, error)
	Proc  func(*schema.Proc) (*sqlspec.Func, error)
}

SchemaFuncs represents a set of spec functions used to convert the Schema object to an HCL document.

type SchemaObject 

type SchemaObject interface {
	Label() string
	QualifierLabel() string
	SetQualifier(string)
	SchemaRef() *schemahcl.Ref
}

SchemaObject describes a top-level schema object that might be qualified, e.g. a table or a view.

type SchemaSpec 

type SchemaSpec struct {
	Schema       *sqlspec.Schema
	Tables       []*sqlspec.Table
	Views        []*sqlspec.View
	Funcs        []*sqlspec.Func
	Procs        []*sqlspec.Func
	Materialized []*sqlspec.View
	// Collected triggers to convert into spec.
	Triggers []*schema.Trigger
}

SchemaSpec is returned by driver convert functions to marshal a *schema.Schema into top-level spec objects.

func FromSchema 

func FromSchema(s *schema.Schema, funcs *SchemaFuncs) (*SchemaSpec, error)

FromSchema converts a schema.Schema into sqlspec.Schema and []sqlspec.Table.

type SpecTypeNamer 

type SpecTypeNamer interface {
	// SpecType returns the spec type of the object.
	SpecType() string
	// SpecName returns the spec name of the object.
	SpecName() string
}

SpecTypeNamer is an interface for objects that can return their spec type and name.

type TableColumnSpecFunc 

type TableColumnSpecFunc func(*schema.Column, *schema.Table) (*sqlspec.Column, error)

List of convert function types.

type TableSpecFunc 

type TableSpecFunc func(*schema.Table) (*sqlspec.Table, error)

List of convert function types.

type ViewColumnSpecFunc 

type ViewColumnSpecFunc func(*schema.Column, *schema.View) (*sqlspec.Column, error)

List of convert function types.

type ViewSpecFunc 

type ViewSpecFunc func(*schema.View) (*sqlspec.View, error)

List of convert function types.

Source Files

View all Source files

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.