90 lines
2.9 KiB
Markdown
90 lines
2.9 KiB
Markdown
|
# ConfigDir for Go
|
||
|
|
|
||
|
|
This library provides a cross platform means of detecting the system's
|
||
|
|
configuration directories so that your Go app can store config files in a
|
||
|
|
standard location. For Linux and other Unixes (BSD, etc.) this means using the
|
||
|
|
[Freedesktop.org XDG Base Directory Specification][1] (0.8), and for Windows
|
||
|
|
and macOS it uses their standard directories.
|
||
|
|
|
||
|
|
This is a simple no-nonsense module that just gives you the path names to do
|
||
|
|
with as you please. You can either get the bare root config path, or get a
|
||
|
|
path with any number of names suffixed onto it for vendor- or
|
||
|
|
application-specific namespacing.
|
||
|
|
|
||
|
|
For the impatient, the directories this library can return tend to be like
|
||
|
|
the following:
|
||
|
|
|
||
|
|
| | **System-wide Configuration** |
|
||
|
|
|---------|-----------------------------------------------------|
|
||
|
|
| Windows | `%PROGRAMDATA%` or `C:\ProgramData` |
|
||
|
|
| Linux | `$XDG_CONFIG_DIRS` or `/etc/xdg` |
|
||
|
|
| macOS | `/Library/Application Support` |
|
||
|
|
| | **User-level Configuration** |
|
||
|
|
| Windows | `%APPDATA%` or `C:\Users\%USER%\AppData\Roaming` |
|
||
|
|
| Linux | `$XDG_CONFIG_HOME` or `$HOME/.config` |
|
||
|
|
| macOS | `$HOME/Library/Application Support` |
|
||
|
|
| | **User-level Cache Folder** |
|
||
|
|
| Windows | `%LOCALAPPDATA%` or `C:\Users\%USER%\AppData\Local` |
|
||
|
|
| Linux | `$XDG_CACHE_HOME` or `$HOME/.cache` |
|
||
|
|
| macOS | `$HOME/Library/Caches` |
|
||
|
|
|
||
|
|
## Quick Start
|
||
|
|
|
||
|
|
```go
|
||
|
|
// A common use case is to get a private config folder for your app to
|
||
|
|
// place its settings files into, that are specific to the local user.
|
||
|
|
configPath := configdir.LocalConfig("my-app")
|
||
|
|
err := configdir.MakePath(configPath) // Ensure it exists.
|
||
|
|
if err != nil {
|
||
|
|
panic(err)
|
||
|
|
}
|
||
|
|
|
||
|
|
// Deal with a JSON configuration file in that folder.
|
||
|
|
configFile := filepath.Join(configPath, "settings.json")
|
||
|
|
type AppSettings struct {
|
||
|
|
Username string `json:"username"`
|
||
|
|
Password string `json:"password"`
|
||
|
|
}
|
||
|
|
var settings AppSettings
|
||
|
|
|
||
|
|
// Does the file not exist?
|
||
|
|
if _, err = os.Stat(configFile); os.IsNotExist(err) {
|
||
|
|
// Create the new config file.
|
||
|
|
settings = AppSettings{"MyUser", "MyPassword"}
|
||
|
|
fh, err := os.Create(configFile)
|
||
|
|
if err != nil {
|
||
|
|
panic(err)
|
||
|
|
}
|
||
|
|
defer fh.Close()
|
||
|
|
|
||
|
|
encoder := json.NewEncoder(fh)
|
||
|
|
encoder.Encode(&settings)
|
||
|
|
} else {
|
||
|
|
// Load the existing file.
|
||
|
|
fh, err := os.Open(configFile)
|
||
|
|
if err != nil {
|
||
|
|
panic(err)
|
||
|
|
}
|
||
|
|
defer fh.Close()
|
||
|
|
|
||
|
|
decoder := json.NewDecoder(fh)
|
||
|
|
decoder.Decode(&settings)
|
||
|
|
}
|
||
|
|
```
|
||
|
|
|
||
|
|
## Documentation
|
||
|
|
|
||
|
|
Package documentation is available at
|
||
|
|
<https://godoc.org/github.com/kirsle/configdir>
|
||
|
|
|
||
|
|
## Author
|
||
|
|
|
||
|
|
Noah Petherbridge, [@kirsle](https://github.com/kirsle)
|
||
|
|
|
||
|
|
## License
|
||
|
|
|
||
|
|
MIT
|
||
|
|
|
||
|
|
[1]: https://specifications.freedesktop.org/basedir-spec/basedir-spec-0.8.html
|
||
|
|
[2]: https://github.com/shibukawa/configdir
|