1
0
mirror of https://github.com/go-micro/go-micro.git synced 2024-12-18 08:26:38 +02:00
go-micro/config/source/file
Mohamed MHAMDI 39e00f11a8
feat(config): add withFs option to file source (#2557)
Co-authored-by: Mohamed MHAMDI <mmhamdi@hubside.com>
2022-09-24 02:46:18 +02:00
..
file_test.go feat(config): add withFs option to file source (#2557) 2022-09-24 02:46:18 +02:00
file.go feat(config): add withFs option to file source (#2557) 2022-09-24 02:46:18 +02:00
format_test.go go-micro.dev/v4 (#2305) 2021-10-12 12:55:53 +01:00
format.go go-micro.dev/v4 (#2305) 2021-10-12 12:55:53 +01:00
options.go feat(config): add withFs option to file source (#2557) 2022-09-24 02:46:18 +02:00
README.md add config 2019-05-30 23:11:13 +01:00
watcher_linux.go add events package (#2341) 2021-11-08 08:52:39 +00:00
watcher.go add events package (#2341) 2021-11-08 08:52:39 +00:00

File Source

The file source reads config from a file.

It uses the File extension to determine the Format e.g config.yaml has the yaml format. It does not make use of encoders or interpet the file data. If a file extension is not present the source Format will default to the Encoder in options.

Example

A config file format in json

{
    "hosts": {
        "database": {
            "address": "10.0.0.1",
            "port": 3306
        },
        "cache": {
            "address": "10.0.0.2",
            "port": 6379
        }
    }
}

New Source

Specify file source with path to file. Path is optional and will default to config.json

fileSource := file.NewSource(
	file.WithPath("/tmp/config.json"),
)

File Format

To load different file formats e.g yaml, toml, xml simply specify them with their extension

fileSource := file.NewSource(
        file.WithPath("/tmp/config.yaml"),
)

If you want to specify a file without extension, ensure you set the encoder to the same format

e := toml.NewEncoder()

fileSource := file.NewSource(
        file.WithPath("/tmp/config"),
	source.WithEncoder(e),
)

Load Source

Load the source into config

// Create new config
conf := config.NewConfig()

// Load file source
conf.Load(fileSource)