Documentation
¶
Index ¶
Constants ¶
const ( // ErrNotFound is returned when a resource cannot be found // in the database. ErrNotFound modelError = "models: resource not found" // ErrPasswordIncorrect is returned when an invalid password // is used when attempting to authenticate a user. ErrPasswordIncorrect modelError = "models: incorrect password provided" // ErrEmailRequired is returned when an email address is // not provided when creating a user ErrEmailRequired modelError = "models: email address is required" // ErrEmailInvalid is returned when an email address provided // does not match any of our requirements ErrEmailInvalid modelError = "models: email address is not valid" // ErrEmailTaken is returned when an update or create is attempted // with an email address that is already in use. ErrEmailTaken modelError = "models: email address is already taken" // ErrPasswordRequired is returned when a create is attempted // without a user password provided. ErrPasswordRequired modelError = "models: password is required" // ErrPasswordTooShort is returned when an update or create is // attempted with a user password that is less than 8 characters. ErrPasswordTooShort modelError = "models: password must be at least 8 characters long" ErrTitleRequired modelError = "models: title is required" // ErrIDInvalid is returned when an invalid ID is provided // to a method like Delete. ErrIDInvalid privateError = "models: ID provided was invalid" // ErrRememberRequired is returned when a create or update // is attempted without a user remember token hash ErrRememberRequired privateError = "models: remember token is required" // ErrRememberTooShort is returned when a remember token is // not at least 32 bytes ErrRememberTooShort privateError = "models: remember token must be at least 32 bytes" ErrUserIDRequired privateError = "models: user ID is required" )
Variables ¶
This section is empty.
Functions ¶
This section is empty.
Types ¶
type Gallery ¶
type Gallery struct { gorm.Model UserID uint `gorm:"not_null;index"` Title string `gorm:"not_null"` Images []Image `gorm:"-"` }
Gallery is our image container resources that visitors view
func (*Gallery) ImagesSplitN ¶
type GalleryService ¶
type GalleryService interface { GalleryDB }
func NewGalleryService ¶
func NewGalleryService(db *gorm.DB) GalleryService
type ImageService ¶
type ImageService interface { Create(galleryID uint, r io.Reader, filename string) error ByGalleryID(galleryID uint) ([]Image, error) Delete(i *Image) error }
func NewImageService ¶
func NewImageService() ImageService
type Services ¶
type Services struct { Gallery GalleryService User UserService Image ImageService // contains filtered or unexported fields }
func NewServices ¶
func NewServices(cfgs ...ServicesConfig) (*Services, error)
func (*Services) AutoMigrate ¶
AutoMigrate will attempt to automatically migrate all tables
func (*Services) DestructiveReset ¶
DestructiveReset drops all tables and rebuilds them
type ServicesConfig ¶
func WithGallery ¶
func WithGallery() ServicesConfig
func WithGorm ¶
func WithGorm(dialect, connectionInfo string) ServicesConfig
func WithImage ¶
func WithImage() ServicesConfig
func WithLogMode ¶
func WithLogMode(mode bool) ServicesConfig
func WithUser ¶
func WithUser(pepper, hmacKey string) ServicesConfig
type User ¶
type User struct { gorm.Model Name string Email string `gorm:"not null;unique_index"` Password string `gorm:"-"` PasswordHash string `gorm:"not null"` Remember string `gorm:"-"` RememberHash string `gorm:"not null;unique_index"` }
User represents the user model stored in our database This is used for user accounts, storing both an email address and a password so users can log in and gain access to their content.
type UserDB ¶
type UserDB interface { // Methods for querying for single users ByID(id uint) (*User, error) ByEmail(email string) (*User, error) ByRemember(token string) (*User, error) // Methods for altering users Create(user *User) error Update(user *User) error Delete(id uint) error }
UserDB is used to interact with the users database.
For pretty much all single user queries: If the user is found, we will return a nil error If the user is not found, we will return ErrNotFound If there is another error, we will return an error with more information about what went wrong. This may not be an error generated by the models package.
For single user queries, any error but ErrNotFound should probably result in a 500 error.
type UserService ¶
type UserService interface { // Authenticate will verify the provided email address and // password are correct. If they are correct, the user // corresponding to that email will be returned. Otherwise // You will receive either: // ErrNotFound, ErrPasswordIncorrect, or another error if // something goes wrong. Authenticate(email, password string) (*User, error) UserDB }
UserService is a set of methods used to manipulate and work with the user model
func NewUserService ¶
func NewUserService(db *gorm.DB, pepper, hmacKey string) UserService