changelog

Documentation

Index

• type AssetSpec
• type Changelog
• type Config
  • func (c *Config) Sanitize(configFile string) error
  • func (c Config) SaveIndexToDisk(changelogs []Spec) error
  • func (c Config) SaveToDisk(changelogs []Spec) error
• type ConfigFormat
  • func (c *ConfigFormat) Sanitize() error
• type IndexData
• type ReleaseData
• type Spec

Types

type AssetSpec

type AssetSpec struct {
	CreatedAt   time.Time `json:",omitempty"`
	ContentType string    `json:",omitempty"`
	DownloadURL string    `json:",omitempty"`
	Name        string    `json:",omitempty"`
	UpdatedAt   string    `json:",omitempty"`
	Size        int       `json:",omitempty"`
}

ReleaseAssetspec contains information about release assets

type Changelog

type Changelog struct {
	Config Config
}

type Config

type Config struct {
	/*
		Name specifies the name of the changelog to retrieve. It is only used for identification purposes.
	*/
	Name string
	/*
		dir specifies the directory where changelog files will be repost.
	*/
	Dir string
	/*
		kind specifies the kind of changelog to retrieve.

		accepted values:
			* github
	*/
	Kind string
	/*
		format specifies the format of the changelog to generate.
	*/
	Formats []ConfigFormat
	/*
		spec specifies the configuration input for a specific kind of changelog.
	*/
	Spec interface{}
}

Config contains various information used to configure the way changelogs are retrieved

func (*Config) Sanitize

func (c *Config) Sanitize(configFile string) error

Sanitize ensures that the configuration is valid and that all required fields are set.

func (Config) SaveIndexToDisk

func (c Config) SaveIndexToDisk(changelogs []Spec) error

SaveIndexToDisk saves an index file per format to disk

func (Config) SaveToDisk

func (c Config) SaveToDisk(changelogs []Spec) error

SaveToDisk saves one changelog per file per format to disk

type ConfigFormat

type ConfigFormat struct {
	/*
		Extension is the file extension used for the changelog file.
		accepted values:
			* markdown
			* json

		default:
			* markdown
	*/
	Extension string
	/*
		indexFileName is the name of the index file name without the extension.

		default:
			* _index
	*/
	IndexFileName string
	/*
		indexFrontMatters is the front matters using yaml syntax to add to the index file.
	*/
	IndexFrontMatters string
	/*
		frontmatters is the front matters using yaml syntax to add to the changelog file.
	*/
	FrontMatters string
}

func (*ConfigFormat) Sanitize

func (c *ConfigFormat) Sanitize() error

type IndexData

type IndexData struct {
	Latest       Spec
	Changelogs   []Spec
	FrontMatters string
}

type ReleaseData

type ReleaseData struct {
	Changelog    Spec
	FrontMatters string
}

type Spec

type Spec struct {
	Assets          []AssetSpec `json:",omitempty"`
	Author          string      `json:",omitempty"`
	Title           string      `json:",omitempty"`
	Description     string      `json:",omitempty"`
	DescriptionHTML string      `json:",omitempty"`
	URL             string      `json:",omitempty"`
	PublishedAt     string      `json:",omitempty"`
	UpdatedAt       string      `json:",omitempty"`
	Tag             string      `json:",omitempty"`
	Name            string      `json:",omitempty"`
	/*
		Path is the path to the file containing the changelog.
	*/
	Path string `json:",omitempty"`
}

Spec contains various information used to describe target changes