users

Documentation

Overview

Package users implements operations for user data manipulation.

Index

• Variables
• func Equals(a, b models.User) bool
• func Filter(users []models.User, filters ...FilterFunc) []models.User
• func Online(u models.User) bool
• func Private(u models.User) bool
• func PublicSlice(u []models.User) []models.UserPublicData
• func StrictEquals(a, b models.User) bool
• func Update(old models.User, c *Changes) models.User
• func VerifyNickname(n string) bool
• func VerifyPassword(p string) bool
• func VerifyRegisterData(nickname, password string) error
• type Changes
• type FilterFunc
  • func DefaultFilters() []FilterFunc
  • func Not(f FilterFunc) FilterFunc

Variables

var (
	// ErrInvalidNickname error is used for various verifies to
	// signal that user verification failed because of
	// invalid username. Raw message of error is safe to output
	// to client.
	ErrInvalidNickname = errors.New(invalidNicknameMsg)

	// ErrInvaliPassword error is used for various verifies to
	// signal that user verification failed because of
	// invalid password. Raw message of error is safe to output
	// to client.
	ErrInvaliPassword = errors.New(invalidPasswordMsg)
)

Functions

func Equals

func Equals(a, b models.User) bool

Equals returns true if both users have same nickname, password and mac address.

func Filter

func Filter(users []models.User, filters ...FilterFunc) []models.User

Filter returns slice of users that passed all given FilterFunc tests. If no filters given, returns exactly same slice of users that has been passed to function.

func Online

func Online(u models.User) bool

Online returns true if given user is currently online.

func Private

func Private(u models.User) bool

Private returns true if given user has private flag set to true.

func PublicSlice

func PublicSlice(u []models.User) []models.UserPublicData

PublicSlice returns new slice with only public user data, created from given slice containing full user data.

func StrictEquals

func StrictEquals(a, b models.User) bool

StrictEquals returns true if both users have same values assigned to every field.

func Update

func Update(old models.User, c *Changes) models.User

Update applies given changes to given user model and returns new user model.

func VerifyNickname

func VerifyNickname(n string) bool

VerifyNickname verifies if given nickname string is proper nickname for long-season application.

func VerifyPassword

func VerifyPassword(p string) bool

VerifyPassword verifies if given password string is proper password for long-season application.

func VerifyRegisterData

func VerifyRegisterData(nickname, password string) error

VerifyRegisterData verifies if given data required for user registration is valid. Returned error messages are safe to output to client.

Types

type Changes

type Changes struct {
	Nickname string
	Password []byte
	Online   *bool
}

Changes represents possible changes that can be applied to models.User

type FilterFunc

type FilterFunc func(models.User) bool

FilterFunc accepts User model and returns true or false.

func DefaultFilters

func DefaultFilters() []FilterFunc

DefaultFilters returns slice with convenient collection of default filters that can be used for outputting user data.

For example: default filters contains Not(Private) filter for hiding private users.

func Not

func Not(f FilterFunc) FilterFunc

Not returns opposite of given FilterFunc result.