moving to struct as param, readme updates

This commit is contained in:
2025-09-26 16:46:40 -04:00
parent b9a8c5cd47
commit 4573594c85
2 changed files with 36 additions and 18 deletions

View File

@@ -9,10 +9,12 @@ This function expects the SQL query, the example response object, and an optiona
<b>Example Object</b> The example object argument <u>must</u> be a struct and requires "db" tags. The db tags are then parsed and used to calculate the psuedo-random rows and values
<b>Primary Key</b> The optional primary key argument is used to hardcode a primary key field in the returned mocks, the primary key field in the example struct <u>must</u> have a test tag with the value "key"
<b>Primary Key</b> The optional primary key argument is used to hardcode a primary key field in the returned mocks, the primary key field in the example struct <u>must</u> have a lazy tag with the value "key"
<b>Row Count</b> Row count sets the amount of mock rows to generate, if set to 0 then one row will be generated. If primary keys are provided you must provide one per row.
```go
type Mock struct {
Field1 string `db:"field1" test:"key"`
Field1 string `db:"field1" lazy:"key"`
}
```
@@ -22,17 +24,17 @@ func Test() {
testArg := 123
query := `SELECT ...`
type results struct {
Field1 string `db:"field1" test:"key"`
Field1 string `db:"field1" lazy:"key"`
Field2 int `db:"field2"`
}
rando, err := GenerateRandomResults(query, results{}, testArg)
rando, err := GenerateRandomResults(query, results{}, []any{testArg}, 1)
if err != nil {
panic(err)
}
//the rando object will now have psuedo random values in all fields except for the field containing the test tag set to "key" that field will be hardcoded with the testArg to allow for unit tests to ensure the requested ID flows through
rows := sqlmock.NewRows(rando.Columns).AddRow(rando.Rows...)
rows := sqlmock.NewRows(rando.Columns).AddRows(rando.Rows...)
mock.ExpectQuery(rando.Query).WithArgs(testArg).WillReturnRows(rows)
...