config
Read and/or write to the git config files.
| param | type [= default] | description |
|---|---|---|
| core | string = 'default' | The plugin core identifier to use for plugin injection |
| fs [deprecated] | FileSystem | The filesystem containing the git repo. Overrides the fs provided by the plugin system. |
| dir | string | The working tree directory path |
| gitdir | string = join(dir,'.git') | The git directory path |
| path | string | The key of the git config entry |
| value | string | (Optional) A value to store at that path |
| all | boolean = false | If the config file contains multiple values, return them all as an array. |
| append | boolean = false | If true, will append rather than replace when setting (use with multi-valued config options). |
| return | Promise<any> | Resolves with the config value |
Caveats:
- Currently only the local
$GIT_DIR/configfile can be read or written. However support for the global~/.gitconfigand system$(prefix)/etc/gitconfigwill be added in the future. - The current parser does not support the more exotic features of the git-config file format such as
[include]and[includeIf].
Example Code:
// Write config value
await git.config({
dir: '$input((/))',
path: '$input((user.name))',
value: '$input((Mr. Test))'
})
// Read config value
let value = await git.config({
dir: '$input((/))',
path: '$input((user.name))'
})
console.log(value)