Why Go
- Case Studies
  
  Common problems companies solve with Go
- Use Cases
  
  Stories about how and why companies use Go
- Security
  
  How Go can help keep you secure by default
Learn
Docs
- Effective Go
  
  Tips for writing clear, performant, and idiomatic Go code
- Go User Manual
  
  A complete introduction to building software with Go
- Standard library
  
  Reference documentation for Go's standard library
- Release Notes
  
  Learn what's new in each Go release
Packages
Community
- Recorded Talks
  
  Videos from prior events
- Meetups
  
  Meet other local Go developers
- Conferences
  
  Learn and network with Go developers from around the world
- Go blog
  
  The Go project's official blog.
- Go project
  
  Get help and stay informed from Go
- Get connected

sessions

package module

Go to main page

Versions in this module

v0

v0.3.0

May 5, 2025

v0.2.0

Jan 10, 2025

Changes in this version

type CookieOptions

+ Name string

+ type Flash struct

+ func (f *Flash) Add(key, message string)

+ func (f *Flash) BinaryMarshal() ([]byte, error)

+ func (f *Flash) BinaryUnmarshal(data []byte) error

+ func (f *Flash) Clear()

+ func (f *Flash) Get(key string) string

+ func (f *Flash) GobDecode(data []byte) error

+ func (f *Flash) GobEncode() ([]byte, error)

+ func (f *Flash) Keep(key, message string)

+ func (f *Flash) MarshalJSON() ([]byte, error)

+ func (f *Flash) Now(key, message string)

+ func (f *Flash) Remove(key string)

+ func (f *Flash) UnmarshalJSON(data []byte) error

v0.1.0

Nov 1, 2024

Changes in this version

+ var DefaultDomain = ""

+ var DefaultHashFn = sha256.New

+ var DefaultHttpOnly = true

+ var DefaultMaxAge = 86400 * 30

+ var DefaultMaxLength = 4096

+ var DefaultPartitioned = false

+ var DefaultPath = "/"

+ var DefaultSameSite = http.SameSiteLaxMode

+ var DefaultSecure = false

+ var ErrCreatingBlockCipher = errors.ErrInternalServerError.Msg("failed to create block cipher")

+ var ErrDecryptionFailed = errors.ErrInternalServerError.Msg("the value cannot be decrypted")

+ var ErrDeserializeFailed = errors.ErrInternalServerError.Msg("the value cannot be deserialized")

+ var ErrEncodedLengthTooLong = errors.ErrOutOfRange.Msg("the encoded value is too long")

+ var ErrGeneratingIV = errors.ErrInternalServerError.Msg("error generating the random iv")

+ var ErrHMACIsInvalid = errors.ErrBadRequest.Msg("the value cannot be validated")

+ var ErrHashKeyNotSet = errors.ErrInternalServerError.Msg("the hash key is not set for the codec")

+ var ErrInvalidSessionType = errors.ErrBadRequest.Msg("the session type is incorrect")

+ var ErrNoCodecs = errors.ErrInternalServerError.Msg("no codecs were provided")

+ var ErrNoResponseWriter = errors.ErrInternalServerError.Msg("no response writer was provided")

+ var ErrSerializeFailed = errors.ErrInternalServerError.Msg("the value cannot be serialized")

+ var ErrTimestampIsExpired = errors.ErrOutOfRange.Msg("the timestamp has expired")

+ var ErrTimestampIsInvalid = errors.ErrBadRequest.Msg("the timestamp is invalid")

+ var ErrTimestampIsTooNew = errors.ErrOutOfRange.Msg("the timestamp is too new")

+ func Save(w http.ResponseWriter, r *http.Request) error

+ type Block struct

+ type BlockKey []byte

+ type Codec interface

+ Decode func(name string, src []byte, dst any) error

+ Encode func(name string, src any) ([]byte, error)

+ func NewCodec(hashKey []byte, options ...CodecOption) Codec

+ type CodecOption interface

+ func WithBlock(block cipher.Block) CodecOption

+ func WithBlockKey(key []byte) CodecOption

+ func WithHashFn(fn func() hash.Hash) CodecOption

+ func WithMaxAge(age int64) CodecOption

+ func WithMaxLength(length int) CodecOption

+ func WithMinAge(age int64) CodecOption

+ func WithSerializer(s Serializer) CodecOption

+ type CookieOptions struct

+ Domain string

+ HttpOnly bool

+ MaxAge int

+ Partitioned bool

+ Path string

+ SameSite http.SameSite

+ Secure bool

+ func NewCookieOptions() CookieOptions

+ type CookieStore struct

+ func NewCookieStore() *CookieStore

+ func (cs CookieStore) Get(_ context.Context, proxy *SessionProxy, cookieValue string) error

+ func (cs CookieStore) New(_ context.Context, _ *SessionProxy) error

+ func (cs CookieStore) Save(_ context.Context, proxy *SessionProxy) error

+ type FileSystemStore struct

+ func NewFileSystemStore(root string, maxFileSize int) *FileSystemStore

+ func (fs FileSystemStore) Get(_ context.Context, proxy *SessionProxy, cookieValue string) error

+ func (fs FileSystemStore) New(_ context.Context, _ *SessionProxy) error

+ func (fs FileSystemStore) Save(_ context.Context, proxy *SessionProxy) error

+ type GobSerializer struct

+ func (s GobSerializer) Deserialize(src []byte, dst any) error

+ func (s GobSerializer) Serialize(src any) ([]byte, error)

+ type HashFn func() hash.Hash

+ type JsonSerializer struct

+ func (s JsonSerializer) Deserialize(src []byte, dst any) error

+ func (s JsonSerializer) Serialize(src any) ([]byte, error)

+ type MaxAge int64

+ type MaxLength int

+ type MinAge int64

+ type Registry struct

+ type Serializer interface

+ Deserialize func([]byte, any) error

+ Serialize func(any) ([]byte, error)

+ var DefaultSerializer Serializer = JsonSerializer{}

+ type SerializerOption struct

+ type Session struct

+ IsNew bool

+ Values T

+ func (s *Session[T]) Delete(w http.ResponseWriter, r *http.Request) error

+ func (s *Session[T]) DoNotPersist()

+ func (s *Session[T]) Expire()

+ func (s *Session[T]) Persist(maxAge int)

+ func (s *Session[T]) Save(w http.ResponseWriter, r *http.Request) error

+ type SessionManager interface

+ Get func(r *http.Request, cookieName string) (*Session[T], error)

+ Save func(w http.ResponseWriter, r *http.Request, session *Session[T]) error

+ func NewSessionManager[T any](options CookieOptions, store Store, codecs ...Codec) SessionManager[T]

+ type SessionProxy struct

+ ID string

+ IsNew bool

+ Values any

+ func (sp *SessionProxy) Decode(data []byte, dst any) error

+ func (sp *SessionProxy) Delete() error

+ func (sp *SessionProxy) Encode(src any) ([]byte, error)

+ func (sp *SessionProxy) IsExpired() bool

+ func (sp *SessionProxy) MaxAge() int

+ func (sp *SessionProxy) Save(value string) error

+ type Store interface

+ Get func(ctx context.Context, proxy *SessionProxy, cookieValue string) error

+ New func(ctx context.Context, proxy *SessionProxy) error

+ Save func(ctx context.Context, proxy *SessionProxy) error