v2.0.0

* When scanning a struct or slice of structs, the struct(s) will be parsed for the column names to select. #9 - @TechnotronicOz

HISTORY.md

@@ -1,4 +1,4 @@
-## v1.0.1
+## v2.0.0
 
 * When scanning a struct or slice of structs, the struct(s) will be parsed for the column names to select. [#9](https://github.com/doug-martin/goqu/pull/9) - [@technotronicoz](https://github.com/TechnotronicOz)
 

README.md

@@ -358,34 +358,61 @@ goqu also has basic query support through the use of either the Database or the
 ### Dataset
 
 * [`ScanStructs`](http://godoc.org/github.com/doug-martin/goqu#Dataset.ScanStructs) - scans rows into a slice of structs
+
+**NOTE** [`ScanStructs`](http://godoc.org/github.com/doug-martin/goqu#Dataset.ScanStructs) will only select the columns that can be scanned in to the structs unless you have explicitly selected certain columns.
+
 ```go
+type User struct{
+    FirstName string `db:"first_name"`
+    LastName  string `db:"last_name"`
+}
+
 var users []User
-if err := db.From("user").ScanStructs(&users){
+//SELECT "first_name", "last_name" FROM "user";
+if err := db.From("user").ScanStructs(&users); err != nil{
+    fmt.Println(err.Error())
+    return
+}
+fmt.Printf("\n%+v", users)
+
+var users []User
+//SELECT "first_name" FROM "user";
+if err := db.From("user").Select("first_name").ScanStructs(&users); err != nil{
     fmt.Println(err.Error())
     return
 }
 fmt.Printf("\n%+v", users)
 ```
 
 * [`ScanStruct`](http://godoc.org/github.com/doug-martin/goqu#Dataset.ScanStruct) - scans a row into a slice a struct, returns false if a row wasnt found
+
+**NOTE** [`ScanStruct`](http://godoc.org/github.com/doug-martin/goqu#Dataset.ScanStruct) will only select the columns that can be scanned in to the struct unless you have explicitly selected certain columns.
+
 ```go
+
+type User struct{
+    FirstName string `db:"first_name"`
+    LastName  string `db:"last_name"`
+}
+
 var user User
+//SELECT "first_name", "last_name" FROM "user" LIMIT 1;
 found, err := db.From("user").ScanStruct(&user)
 if err != nil{
     fmt.Println(err.Error())
     return
 }
-if !found{
+if !found {
     fmt.Println("No user found")
-}else{
+} else {
     fmt.Printf("\nFound user: %+v", user)
 }
 ```
 
 * [`ScanVals`](http://godoc.org/github.com/doug-martin/goqu#Dataset.ScanVals) - scans a rows of 1 column into a slice of primitive values
 ```go
 var ids []int64
-if err := db.From("user").Select("id").ScanVals(&ids){
+if err := db.From("user").Select("id").ScanVals(&ids); err != nil{
     fmt.Println(err.Error())
     return
 }

adapters/mysql/dataset_adapter_test.go

@@ -1,13 +1,12 @@
-// +build mysql
 package mysql
 
 import (
 	"regexp"
 	"testing"
 
 	"github.com/doug-martin/goqu"
-	"github.com/technotronicoz/testify/assert"
 	"github.com/stretchr/testify/suite"
+	"github.com/technotronicoz/testify/assert"
 )
 
 type datasetAdapterTest struct {

adapters/mysql/mysql_test.go

@@ -1,4 +1,3 @@
-// +build mysql
 package mysql
 
 import (
@@ -73,13 +72,11 @@ func (me logger) Printf(sql string, args ...interface{}) {
 }
 
 func (me *mysqlTest) SetupSuite() {
-	fmt.Println(db_uri)
 	db, err := sql.Open("mysql", db_uri)
 	if err != nil {
 		panic(err.Error())
 	}
 	me.db = goqu.New("mysql", db)
-	//	me.db.Logger(logger{})
 }
 
 func (me *mysqlTest) SetupTest() {

adapters/postgres/dataset_adapter_test.go

@@ -1,4 +1,3 @@
-// +build postgres
 package postgres
 
 import (

adapters/postgres/postgres_test.go

@@ -1,4 +1,3 @@
-// +build postgres
 package postgres
 
 import (
@@ -72,7 +71,6 @@ func (me *postgresTest) SetupSuite() {
 		panic(err)
 	}
 	me.db = goqu.New("postgres", db)
-	//	me.db.Logger(logger{})
 }
 
 func (me *postgresTest) SetupTest() {

adapters/sqlite3/dataset_adapter_test.go

@@ -1,4 +1,3 @@
-// +build sqlite3
 package sqlite3
 
 import (

adapters/sqlite3/sqlite3_test.go

@@ -1,4 +1,3 @@
-// +build sqlite3
 package sqlite3
 
 import (
@@ -67,7 +66,6 @@ func (me *sqlite3Test) SetupSuite() {
 		panic(err.Error())
 	}
 	me.db = goqu.New("sqlite3", db)
-	//		me.db.Logger(logger{})
 }
 
 func (me *sqlite3Test) SetupTest() {

dataset_actions.go

@@ -1,8 +1,8 @@
 package goqu
 
 //Generates the SELECT sql for this dataset and uses Exec#ScanStructs to scan the results into a slice of structs.
-// When using this method, ScanStructs will only select the columns that can be scanned in to the struct unless you
-// have explicitly selected certain columns. See examples.
+//
+//ScanStructs will only select the columns that can be scanned in to the struct unless you have explicitly selected certain columns. See examples.
 //
 //i: A pointer to a slice of structs
 func (me *Dataset) ScanStructs(i interface{}) error {
@@ -16,6 +16,8 @@ func (me *Dataset) ScanStructs(i interface{}) error {
 
 //Generates the SELECT sql for this dataset and uses Exec#ScanStruct to scan the result into a slice of structs
 //
+//ScanStruct will only select the columns that can be scanned in to the struct unless you have explicitly selected certain columns. See examples.
+//
 //i: A pointer to a structs
 func (me *Dataset) ScanStruct(i interface{}) (bool, error) {
 	ds := me.Limit(1)