conventional-changelog

constructor

constructor(cwdOrGitClient?: any);

method commits

commits: (params: GetCommitsParams, parserOptions?: ParserStreamOptions) => this;

• Set params to get commits

  Parameter params

  Params to get commits since last release

  Parameter parserOptions

  Parser options

  Returns

  this

method config

config: (config: Preset | Promise<Preset>) => this;

• Set the config directly

  Parameter config

  Config object

  Returns

  this

method context

context: (context: Context) => this;

• Set writer context data

  Parameter context

  Writer context data

  Returns

  this

method loadPreset

loadPreset: <
    PresetCreatorParams extends UnknownPresetCreatorParams = UnknownPresetCreatorParams
>(
    preset: PresetParams<PresetCreatorParams>,
    loader?: PresetModuleLoader
) => this;

• Load configs from a preset

  Parameter preset

  Parameter loader

  Preset module loader, if not provided, will use default loader

  Returns

  this

method options

options: (options: Options) => this;

• Set conventional-changelog options

  Parameter options

  Generator options

  Returns

  this

method package

package: (pkg: Record<string, unknown>) => this;

• Set package.json data

  Parameter pkg

  Package.json data

  Returns

  this

method readPackage

readPackage: {
    (transform?: PackageTransform): this;
    (path?: string, transform?: PackageTransform): this;
};

• Find package.json and read it

  Parameter transform

  Optional transform function

  Returns

  this

• Read package.json from a specified path

  Parameter path

  Path to package.json

  Parameter transform

  Optional transform function

  Returns

  this

method readRepository

readRepository: () => this;

• Read repository info from the current git repository

  Returns

  this

method repository

repository: (infoOrGitUrl: string | Partial<HostedGitInfo>) => this;

• Set repository info

  Parameter infoOrGitUrl

  Hosted git info or git url

  Returns

  this

method tags

tags: (params: GetSemverTagsParams) => this;

• Set params to get semver tags

  Parameter params

  Params to get the last semver tag

  Returns

  this

method write

write: {
    (includeDetails?: false): AsyncGenerator<string, void>;
    (includeDetails: true): AsyncGenerator<Details<Commit>, void, unknown>;
    (includeDetails?: boolean): AsyncGenerator<any, void, unknown>;
};

• Generate changelog

  Parameter includeDetails

  Generate data objects instead of strings

  Returns

  Changelog generator

• Generate changelog data objects

  Parameter includeDetails

  Generate data objects instead of strings

method writer

writer: (params: WriterOptions) => this;

• Set writer options

  Parameter params

  Writer options

  Returns

  this

method writeStream

writeStream: (includeDetails?: boolean) => Readable;

• Generate changelog to stream

  Parameter includeDetails

  Generate data objects instead of strings

  Returns

  Changelog stream

property currentTag

currentTag?: string | null;

property linkCompare

linkCompare?: boolean;

property previousTag

previousTag?: string | null;

property append

append?: boolean;

property config

config?: string;

property context

context?: string;

property firstRelease

firstRelease?: boolean;

property infile

infile?: string;

property lernaPackage

lernaPackage?: string;

property outfile

outfile?: string;

property outputUnreleased

outputUnreleased?: boolean;

property pkg

pkg?: string;

property preset

preset?: string;

property releaseCount

releaseCount?: number;

property skipUnstable

skipUnstable?: boolean;

property stdout

stdout?: boolean;

property tagPrefix

tagPrefix?: string;

property verbose

verbose?: boolean;

property commit

commit: string;

property issue

issue: string;

property issuePrefixes

issuePrefixes: string[];

property referenceActions

referenceActions: string[];

property append

append?: boolean;

• Should the log be appended to existing data. false

property debug

debug?: Logger;

• Logger for debug messages.

property outputUnreleased

outputUnreleased?: boolean;

• If this value is true and context.version equals last release then context.version will be changed to 'Unreleased'.

property releaseCount

releaseCount?: number;

• How many releases of changelog you want to generate. It counts from the upcoming release. Useful when you forgot to generate any previous changelog. Set to 0 to regenerate all. 1

property reset

reset?: boolean;

• Whether to reset the changelog or not. false

property transformCommit

transformCommit?: CommitTransformFunction;

• A transform function that applies after the parser and before the writer.

property warn

warn?: Logger;

• Logger for warnings.

method formatDate

formatDate: (date: string | Date) => string;

• A function to format date.

  Parameter date

  Date string or Date object.

  Returns

  Final date string.

property commits

commits: GetCommitsParams;

property context

context?: Context;

property options

options: Options;

property package

package?: Package;

property repository

repository?: Partial<HostedGitInfo> | null;

property commits

commits?: GetCommitsParams;

property parser

parser?: ParserStreamOptions;

property tags

tags?: GetSemverTagsParams;

property writer

writer?: WriterOptions;