Documentation ¶
Overview ¶
The maildir package provides an interface to mailboxes in the Maildir format.
Index ¶
- Constants
- Variables
- func Key() (string, error)
- type Delivery
- type Dir
- func (d Dir) Clean() error
- func (d Dir) Create() error
- func (d Dir) Filename(key string) (string, error)
- func (d Dir) Flags(key string) (string, error)
- func (d Dir) Header(key string) (header mail.Header, err error)
- func (d Dir) Keys() ([]string, error)
- func (d Dir) Message(key string) (*mail.Message, error)
- func (d Dir) Move(target Dir, key string) error
- func (d Dir) NewDelivery() (*Delivery, error)
- func (d Dir) Purge(key string) error
- func (d Dir) SetFlags(key string, flags string) error
- func (d Dir) SetInfo(key, info string) error
- func (d Dir) Unseen() ([]string, error)
- type FlagError
- type KeyError
Constants ¶
const CreateMode = 0700
CreateMode holds the permissions used when creating a directory.
Variables ¶
var Separator rune = ':'
The Separator separates a messages unique key from its flags in the filename. This should only be changed on operating systems where the colon isn't allowed in filenames.
Functions ¶
Types ¶
type Delivery ¶
type Delivery struct {
// contains filtered or unexported fields
}
Delivery represents an ongoing message delivery to the mailbox. It implements the WriteCloser interface. On closing the underlying file is moved/relinked to new.
type Dir ¶
type Dir string
A Dir represents a single directory in a Maildir mailbox.
func (Dir) Clean ¶
Clean removes old files from tmp and should be run periodically. This does not use access time but modification time for portability reasons.
func (Dir) Create ¶
Create creates the directory structure for a Maildir. If the main directory already exists, it tries to create the subdirectories in there. If an error occurs while creating one of the subdirectories, this function may leave a partially created directory structure.
func (Dir) Flags ¶
Flags returns the flags for a message sorted in ascending order. See the documentation of SetFlags for details.
func (Dir) NewDelivery ¶
NewDelivery creates a new Delivery.
func (Dir) SetFlags ¶
SetFlags appends an info section to the filename according to the given flags. This function removes duplicates and sorts the flags, but doesn't check whether they conform with the Maildir specification.
The following flags are listed in the specification (http://cr.yp.to/proto/maildir.html):
Flag "P" (passed): the user has resent/forwarded/bounced this message to someone else. Flag "R" (replied): the user has replied to this message. Flag "S" (seen): the user has viewed this message, though perhaps he didn't read all the way through it. Flag "T" (trashed): the user has moved this message to the trash; the trash will be emptied by a later user action. Flag "D" (draft): the user considers this message a draft; toggled at user discretion. Flag "F" (flagged): user-defined flag; toggled at user discretion.