aldy505
/
bob
mirror of https://github.com/aldy505/bob.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

Merge pull request #16 from LouGel/typos 

Typos
This commit is contained in:
LouGel 2024-12-09 15:00:11 +01:00 committed by GitHub
parent 4b4430e303
commit 2bb7945721
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
1 changed files with 39 additions and 37 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

76
README.md
View File

@ -13,9 +13,9 @@ with functionality like [Knex][knex-url] (from the Node.js world). Squirrel itse
doesn't provide other types of queries for creating a table, upsert, doesn't provide other types of queries for creating a table, upsert,
and some other things. Bob is meant to fill those gaps. and some other things. Bob is meant to fill those gaps.
The different between Bob and Squirrel is that Bob is solely a query builder. The difference between Bob and Squirrel is that Bob is solely a query builder.
The users have to execute and manage the SQL connection themself. The users have to execute and manage the SQL connection themselves.
Meaning there are no ExecWith() function implemented on Bob, as you can Meaning there is no ExecWith() function implemented in Bob, as you can
find it on Squirrel. find it on Squirrel.
The purpose of an SQL query builder is to prevent any typo or mistypes The purpose of an SQL query builder is to prevent any typo or mistypes
@ -41,7 +41,7 @@ you are good to go.
Either way, I'm not 100% confident enough to say that this thing is Either way, I'm not 100% confident enough to say that this thing is
production ready. But, the way I see it, it's good enough to be used production ready. But, the way I see it, it's good enough to be used
on a production-level applications. In fact, I'm using it on one of my on a production-level application. In fact, I'm using it on one of my
current projects that's getting around 100-200 hits per day. current projects that's getting around 100-200 hits per day.
If you have any feature request or improvement ideas for the project, If you have any feature request or improvement ideas for the project,
@ -57,7 +57,7 @@ func main() {
sql, _, err := bob. sql, _, err := bob.
CreateTable("tableName"). CreateTable("tableName").
// The first parameter is the column's name. // The first parameter is the column's name.
// The second parameters and so on forth are extras. // The second parameter and so on forth are extras.
StringColumn("id", "NOT NULL", "PRIMARY KEY", "AUTOINCREMENT"). StringColumn("id", "NOT NULL", "PRIMARY KEY", "AUTOINCREMENT").
StringColumn("email", "NOT NULL", "UNIQUE"). StringColumn("email", "NOT NULL", "UNIQUE").
// See the list of available column definition types through pkg.go.dev or scroll down below. // See the list of available column definition types through pkg.go.dev or scroll down below.
@ -72,21 +72,22 @@ func main() {
``` ```
Available column definition types (please be aware that some only works on certain database): Available column definition types (please be aware that some only works on certain database):
* `StringColumn()` - Default to `VARCHAR(255)`
* `TextColumn()` - Default to `TEXT` - `StringColumn()` - Default to `VARCHAR(255)`
* `UUIDColumn()` - Defaults to `UUID` - `TextColumn()` - Default to `TEXT`
* `BooleanColumn()` - Defaults to `BOOLEAN` - `UUIDColumn()` - Defaults to `UUID`
* `IntegerColumn()` - Defaults to `INTEGER`. Postgres and SQLite only. - `BooleanColumn()` - Defaults to `BOOLEAN`
* `IntColumn()` - Defaults to `INT`. MySQL and MSSQL only. - `IntegerColumn()` - Defaults to `INTEGER`. Postgres and SQLite only.
* `RealColumn()` - Defaults to `REAL`. Postgres, MSSQL, and SQLite only. - `IntColumn()` - Defaults to `INT`. MySQL and MSSQL only.
* `FloatColumn()` - Defaults to `FLOAT`. Postgres and SQLite only. - `RealColumn()` - Defaults to `REAL`. Postgres, MSSQL, and SQLite only.
* `DateTimeColumn()` - Defaults to `DATETIME`. - `FloatColumn()` - Defaults to `FLOAT`. Postgres and SQLite only.
* `TimeStampColumn()` - Defaults to `TIMESTAMP`. - `DateTimeColumn()` - Defaults to `DATETIME`.
* `TimeColumn()` - Defaults to `TIME`. - `TimeStampColumn()` - Defaults to `TIMESTAMP`.
* `DateColumn()` - Defaults to `DATE`. - `TimeColumn()` - Defaults to `TIME`.
* `JSONColumn()` - Dafults to `JSON`. MySQL and Postgres only. - `DateColumn()` - Defaults to `DATE`.
* `JSONBColumn()` - Defaults to `JSONB`. Postgres only. - `JSONColumn()` - Defaults to `JSON`. MySQL and Postgres only.
* `BlobColumn()` - Defaults to `BLOB`. MySQL and SQLite only. - `JSONBColumn()` - Defaults to `JSONB`. Postgres only.
- `BlobColumn()` - Defaults to `BLOB`. MySQL and SQLite only.
For any other types, please use `AddColumn()`. For any other types, please use `AddColumn()`.
@ -244,10 +245,11 @@ func main() {
``` ```
Available placeholder formats: Available placeholder formats:
* `bob.Question` - `INSERT INTO "users" (name) VALUES (?)`
* `bob.Dollar` - `INSERT INTO "users" (name) VALUES ($1)` - `bob.Question` - `INSERT INTO "users" (name) VALUES (?)`
* `bob.Colon` - `INSERT INTO "users" (name) VALUES (:1)` - `bob.Dollar` - `INSERT INTO "users" (name) VALUES ($1)`
* `bob.AtP` - `INSERT INTO "users" (name) VALUES (@p1)` - `bob.Colon` - `INSERT INTO "users" (name) VALUES (:1)`
- `bob.AtP` - `INSERT INTO "users" (name) VALUES (@p1)`
### With pgx (PostgreSQL) ### With pgx (PostgreSQL)
@ -264,7 +266,7 @@ import (
func main() { func main() {
db := pgx.Connect() db := pgx.Connect()
// Check if a table is exists // Check if a table exists
sql, args, err = bob.HasTable("users").PlaceholderFormat(bob.Dollar).ToSql() sql, args, err = bob.HasTable("users").PlaceholderFormat(bob.Dollar).ToSql()
if err != nil { if err != nil {
log.Fatal(err) log.Fatal(err)
@ -320,17 +322,17 @@ func main() {
## Features ## Features
* `bob.CreateTable(tableName)` - Basic SQL create table - `bob.CreateTable(tableName)` - Basic SQL create table
* `bob.CreateTableIfNotExists(tableName)` - Create table if not exists - `bob.CreateTableIfNotExists(tableName)` - Create table if not exists
* `bob.CreateIndex(indexName)` - Basic SQL create index - `bob.CreateIndex(indexName)` - Basic SQL create index
* `bob.CreateIndexIfNotExists(tableName)` - Create index if not exists - `bob.CreateIndexIfNotExists(tableName)` - Create index if not exists
* `bob.HasTable(tableName)` - Checks if column exists (return error if false, check example above for error handling) - `bob.HasTable(tableName)` - Checks if column exists (return error if false, check example above for error handling)
* `bob.HasColumn(columnName)` - Check if a column exists on current table - `bob.HasColumn(columnName)` - Check if a column exists on current table
* `bob.DropTable(tableName)` - Drop a table (`drop table "users"`) - `bob.DropTable(tableName)` - Drop a table (`drop table "users"`)
* `bob.DropTableIfExists(tableName)` - Drop a table if exists (`drop table if exists "users"`) - `bob.DropTableIfExists(tableName)` - Drop a table if exists (`drop table if exists "users"`)
* `bob.RenameTable(currentTable, desiredName)` - Rename a table (`rename table "users" to "people"`) - `bob.RenameTable(currentTable, desiredName)` - Rename a table (`rename table "users" to "people"`)
* `bob.Truncate(tableName)` - Truncate a table (`truncate "users"`) - `bob.Truncate(tableName)` - Truncate a table (`truncate "users"`)
* `bob.Upsert(tableName, dialect)` - UPSERT function (`insert into "users" ("name", "email") values (?, ?) on duplicate key update email = ?`) - `bob.Upsert(tableName, dialect)` - UPSERT function (`insert into "users" ("name", "email") values (?, ?) on duplicate key update email = ?`)
## Contributing ## Contributing
@ -353,6 +355,6 @@ Bob is licensed under [MIT license](./LICENSE)
[codecov-badge]: https://codecov.io/gh/aldy505/bob/branch/master/graph/badge.svg?token=Noeexg5xEJ [codecov-badge]: https://codecov.io/gh/aldy505/bob/branch/master/graph/badge.svg?token=Noeexg5xEJ
[codecov-link]: https://codecov.io/gh/aldy505/bob [codecov-link]: https://codecov.io/gh/aldy505/bob
[codacy-badge]: https://app.codacy.com/project/badge/Grade/9b78970127c74c1a923533e05f65848d [codacy-badge]: https://app.codacy.com/project/badge/Grade/9b78970127c74c1a923533e05f65848d
[codacy-link]: https://www.codacy.com/gh/aldy505/bob/dashboard?utm_source=github.com&utm_medium=referral&utm_content=aldy505/bob&utm_campaign=Badge_Grade [codacy-link]: https://www.codacy.com/gh/aldy505/bob/dashboard?utm_source=github.com&utm_medium=referral&utm_content=aldy505/bob&utm_campaign=Badge_Grade
[actions-badge]: https://github.com/aldy505/bob/actions/workflows/coverage.yml/badge.svg [actions-badge]: https://github.com/aldy505/bob/actions/workflows/coverage.yml/badge.svg
[actions-link]: https://github.com/aldy505/bob/actions/workflows/coverage.yml [actions-link]: https://github.com/aldy505/bob/actions/workflows/coverage.yml