lumina-tech / gooq

Golang Object Oriented Querying

• inspired by JOOQ - https://www.jooq.org/
• based on https://github.com/relops/sqlc
• we built this because we couldn't find a library similar to JOOQ but in Golang in August 2018.

Maintainers (in alphabetical order)

• @ppong
• @ScottyFillups

Contributors (in alphabetical order)

• @arnold-yip
• @CatastrophiClam
• @ctuong
• @daanielww
• @erikterwiel
• @JerryXie98
• @joeldomjjd
• @marceloneil
• @MingjiaNi
• @tigsss
• @zahin-mohammad

gooq's Issues

Implement window functions

gOOQ/pkg/gooq/function.go

Line 180 in 9d1335a

// Window Functions

Change of product name

Hi there.

I'm happy to see that you apparently liked jOOQ so much that you decided to create a clone in Go.

There's absolutely nothing wrong with porting a library / idea to some other platform, but I can't say I like your product being called "gOOQ". jOOQ is a registered trademark (in some countries), and your spelling, and also your spelled out name "Golang Object Oriented Querying" infringes this trademark.

The fact that you're calling your product gOOQ makes it seem as though I had anything to do with it, or even endorse it, which I don't. Think of it this way: I spent the last 11 years building this brand, and it's not OK to use this brand without my permission.

It's not too late yet. I think it would be a good idea to rename your product to something of your own creation.

Thanks,
Lukas

Set Dockerize flag to false by default

Currently running gooq generate-database-models will try to run a "dockerized" database. This behaviour is usually only desirable for testing purposes, and should not be the default.

Implement SQL binary string functions and other binary string functions in functions.go

see

gOOQ/pkg/gooq/function.go

Line 108 in 9d1335a

// Table 9.11. SQL Binary String Functions and Operators

Implement formatting functions in functions.go

see

gOOQ/pkg/gooq/function.go

Line 115 in 9d1335a

// Table 9.23. Formatting Functions

Improve example to demonstrate reference table support

extend swapi example - https://github.com/lumina-tech/gOOQ/tree/master/examples/swapi

Installing package via "go get" saves binary as cmd

Running go get github.com/lumina-tech/gooq/cmd installs the gOOQ generator binary as cmd.

The name of the binary is determined by last item in the URI path. Other projects work (such as go-ethereum) around this by having the following directory structure: repo/cmd/mycli/main.go

Fix coming soon.

Create example to demonstrate bulk insert, upsert, update

Add circleci integration

Implement UNION, INTERSECT and EXCEPT clause for SELECT

https://www.postgresql.org/docs/12/sql-select.html#SQL-UNION

Implement locking clause for SELECT statement

https://www.postgresql.org/docs/12/sql-select.html#SQL-FOR-UPDATE-SHARE

Implement WITH clause for DELETE

https://www.postgresql.org/docs/12/sql-delete.html

Improve examples to demonstrate enum support

extends swapi example - https://github.com/lumina-tech/gOOQ/tree/master/examples/swapi

Implement WITH clause for UPDATE

https://www.postgresql.org/docs/12/sql-update.html

Implement range functions and operators

gOOQ/pkg/gooq/function.go

Line 162 in 9d1335a

// Range Functions and Operators

Implement comparison functions in function.go

see:

gOOQ/pkg/gooq/function.go

Line 87 in 9d1335a

// Table 9.3. Comparison Functions

Implement SQL string functions and operators and other String Functions` in functions.go

see

gOOQ/pkg/gooq/function.go

Line 101 in 9d1335a

// Table 9.8. SQL String Functions and Operators

JSON field marshaling improvements

Currently marshaling models that have jsonb fields outputs the base64 encoding of those fields. To output json instead:

nullable.Jsonb should implement MarshalJSON/UnmarshalJSON and non-nullable jsonb columns should be generated as json.RawMessage rather than []byte.

https://github.com/lumina-tech/gOOQ/blob/e7f49a8e89eb11e7b9de65b17a23e2b7c8d28303/pkg/nullable/jsonb.go

gOOQ/pkg/generator/metadata/types.go

Line 20 in e7f49a8

DataTypeJSONB = DataType{Name: "Jsonb", Literal: "[]byte", NullableLiteral: "nullable.Jsonb"}

Implement subquery expressions

gOOQ/pkg/gooq/function.go

Line 174 in 9d1335a

// Subquery Expressions

Implement matching operators

gOOQ/pkg/gooq/operator.go

Line 36 in 9d1335a

// 9.7.1. LIKE

Implement bit string operators

gOOQ/pkg/gooq/operator.go

Line 32 in 9d1335a

// Table 9.13. Bit String Operators

Implement GROUPING SETS, CUBE, and ROLLUP for SELECT

https://www.postgresql.org/docs/12/queries-table-expressions.html#QUERIES-GROUPING-SETS

Implement aggregate functions

gOOQ/pkg/gooq/function.go

Line 168 in 9d1335a

// Aggregate Functions

Implement DISTINCT ON clause for SELECT

https://www.postgresql.org/docs/12/sql-select.html#SQL-DISTINCT

Implement mathematical, random and trigonometric functions in functions.go

see

gOOQ/pkg/gooq/function.go

Line 93 in 9d1335a

// Table 9.5. Mathematical Functions

Implement type conversion functions

gOOQ/pkg/gooq/function.go

Line 192 in 9d1335a

// Type Conversion - Functions

Implement date/time functions

see

gOOQ/pkg/gooq/function.go

Line 121 in 9d1335a

// Table 9.30. Date/Time Functions

Implement WITH clause for INSERT

https://www.postgresql.org/docs/12/sql-insert.html

Implement other data types

gOOQ/pkg/gooq/expression.go

Line 415 in 9d1335a

// [Help Wanted] TODO: implement

Implement set returning functions

gOOQ/pkg/gooq/function.go

Line 186 in 9d1335a

// Set Returning Functions

Implement WINDOW clause for SELECT

https://www.postgresql.org/docs/12/sql-select.html#SQL-WINDOW

Implement array functions and operators

gOOQ/pkg/gooq/function.go

Line 156 in 9d1335a

// Array Functions and Operators

Refactor to support multiple dialect e.g. MySQL

Support multiple VALUES in INSERT statement

INSERT INTO public.table1 (column1, column2, column3, column4) VALUES ($1, $2, $3, $4) ($5, $6, $7, $8)

From https://github.com/lumina-tech/gOOQ/blob/master/pkg/gooq/insert_test.go#L25 is supposed to be

INSERT INTO public.table1 (column1, column2, column3, column4) VALUES ($1, $2, $3, $4), ($5, $6, $7, $8)

(See https://www.postgresqltutorial.com/postgresql-insert-multiple-rows/)

I think the issue can be fixed by just changing " " to ", " here: https://github.com/lumina-tech/gOOQ/blob/master/pkg/gooq/insert.go#L256

I'll experiment and make an MR some time

Implement HAVING clause for SELECT

gOOQ's SELECT currently does not support the HAVING clause: https://github.com/lumina-tech/gOOQ/blob/master/pkg/gooq/select.go#L285

Here is a code snippet that currently panics, because HAVING is not implemented:

gooq.Select(gooq.Count(model.Person.ID)).
	GroupBy(model.Person.BirthYear).
	Having(model.Person.BirthYear.Gt(gooq.String("1995")))

Improve gOOQ/README.md

• add section on Getting Started to ensure smooth onboarding
• add section explaining how code generation work
• add section explaining benefit of having type safe SQL

Add documentation about `reference_table`

Make model package name match directory name for in `gooq.yml`

Users can specify what folder should store the generated tables and the models (i.e. modelPath and tablePath in gooq.yml).

The package names for the generated files are hardcoded to model and table; if a user sets the modelPath to, say, models, then there will be a mismatch between the directory name and the package name.

Ideally if the gooq.yml has the following key set:

modelPath: "models"

Then the files in the models/ directory should be in a package called models.

Implement remaining GREATEST and LEAST conditional expressions

gOOQ/pkg/gooq/function.go

Line 136 in 9d1335a

// [Good First Issue][Help Wanted] TODO: implement GREATEST and LEAST