Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/muesli/go-app-paths

Lets you retrieve platform-specific paths (like directories for app-data, cache, config, and logs)
https://github.com/muesli/go-app-paths

hacktoberfest

Last synced: about 1 month ago
JSON representation

Lets you retrieve platform-specific paths (like directories for app-data, cache, config, and logs)

Host: GitHub
URL: https://github.com/muesli/go-app-paths
Owner: muesli
License: mit
Created: 2018-01-22T00:47:20.000Z (almost 7 years ago)
Default Branch: master
Last Pushed: 2022-05-30T13:53:19.000Z (over 2 years ago)
Last Synced: 2024-10-30T05:57:52.412Z (about 1 month ago)
Topics: hacktoberfest
Language: Go
Homepage:
Size: 77.1 KB
Stars: 202
Watchers: 6
Forks: 5
Open Issues: 3
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE

Awesome Lists containing this project

go-awesome - go-app-paths - Get directory files across platforms (Open source library / Files/Storage)

README

        # go-app-paths

[![Latest Release](https://img.shields.io/github/release/muesli/go-app-paths.svg)](https://github.com/muesli/go-app-paths/releases)

[![GoDoc](https://godoc.org/github.com/golang/gddo?status.svg)](https://pkg.go.dev/github.com/muesli/go-app-paths?tab=doc)

[![Build Status](https://github.com/muesli/go-app-paths/workflows/build/badge.svg)](https://github.com/muesli/go-app-paths/actions)

[![Coverage Status](https://coveralls.io/repos/github/muesli/go-app-paths/badge.svg?branch=master)](https://coveralls.io/github/muesli/go-app-paths?branch=master)

[![Go ReportCard](https://goreportcard.com/badge/muesli/go-app-paths)](https://goreportcard.com/report/muesli/go-app-paths)

Lets you retrieve platform-specific paths (like directories for app-data, cache,

config, and logs). It is fully compliant with the [XDG Base Directory Specification](https://specifications.freedesktop.org/basedir-spec/basedir-spec-latest.html)

on Unix, but also provides implementations for macOS and Windows systems.

## Installation

Make sure you have a working Go environment (Go 1.2 or higher is required).

See the [install instructions](https://golang.org/doc/install.html).

To install go-app-paths, simply run:

    go get github.com/muesli/go-app-paths

## Usage

```go

import gap "github.com/muesli/go-app-paths"

```

### Scopes

You can initialize `gap` with either the `gap.User` or `gap.System` scope to

retrieve user- and/or system-specific base directories and paths:

```go

scope := gap.NewScope(gap.User, "app")

```

Alternatively, you can initialize `gap` with an additional vendor name:

```go

scope := gap.NewVendorScope(gap.User, "vendor", "app")

```

This will cause the `app` directory to be prefixed by a `vendor` directory in

all the following tables.

### Directories

`DataDirs` retrieves a priority-sorted list of data directories:

```go

dirs, err := scope.DataDirs()

```

| Platform | User Scope                                                       | System Scope                               |

| -------- | ---------------------------------------------------------------- | ------------------------------------------ |

| Unix     | ["~/.local/share/app", "/usr/local/share/app", "/usr/share/app"] | ["/usr/local/share/app", "/usr/share/app"] |

| macOS    | ["~/Library/Application Support/app"]                            | ["/Library/Application Support/app"]       |

| Windows  | ["%LOCALAPPDATA%/app"]                                           | ["%PROGRAMDATA%/app"]                      |

---

`ConfigDirs` retrieves a priority-sorted list of config directories:

```go

dirs, err := scope.ConfigDirs()

```

| Platform | User Scope                                    | System Scope                 |

| -------- | --------------------------------------------- | ---------------------------- |

| Unix     | ["~/.config/app", "/etc/xdg/app", "/etc/app"] | ["/etc/xdg/app", "/etc/app"] |

| macOS    | ["~/Library/Preferences/app"]                 | ["/Library/Preferences/app"] |

| Windows  | ["%LOCALAPPDATA%/app/Config"]                 | ["%PROGRAMDATA%/app/Config"] |

---

`CacheDir` retrieves the app's cache directory:

```go

dir, err := scope.CacheDir()

```

| Platform | User Scope               | System Scope            |

| -------- | ------------------------ | ----------------------- |

| Unix     | ~/.cache/app             | /var/cache/app          |

| macOS    | ~/Library/Caches/app     | /Library/Caches/app     |

| Windows  | %LOCALAPPDATA%/app/Cache | %PROGRAMDATA%/app/Cache |

### Default File Paths

`DataPath` retrieves the default path for a data file:

```go

path, err := scope.DataPath("filename")

```

| Platform | User Scope                                 | System Scope                              |

| -------- | ------------------------------------------ | ----------------------------------------- |

| Unix     | ~/.local/share/app/filename                | /usr/local/share/app/filename             |

| macOS    | ~/Library/Application Support/app/filename | /Library/Application Support/app/filename |

| Windows  | %LOCALAPPDATA%/app/filename                | %PROGRAMDATA%/app/filename                |

---

`ConfigPath` retrieves the default path for a config file:

```go

path, err := scope.ConfigPath("filename.conf")

```

| Platform | User Scope                              | System Scope                           |

| -------- | --------------------------------------- | -------------------------------------- |

| Unix     | ~/.config/app/filename.conf             | /etc/xdg/app/filename.conf             |

| macOS    | ~/Library/Preferences/app/filename.conf | /Library/Preferences/app/filename.conf |

| Windows  | %LOCALAPPDATA%/app/Config/filename.conf | %PROGRAMDATA%/app/Config/filename.conf |

---

`LogPath` retrieves the default path for a log file:

```go

path, err := scope.LogPath("filename.log")

```

| Platform | User Scope                           | System Scope                        |

| -------- | ------------------------------------ | ----------------------------------- |

| Unix     | ~/.local/share/app/filename.log      | /var/log/app/filename.log           |

| macOS    | ~/Library/Logs/app/filename.log      | /Library/Logs/app/filename.log      |

| Windows  | %LOCALAPPDATA%/app/Logs/filename.log | %PROGRAMDATA%/app/Logs/filename.log |

### Lookup Methods

`LookupData` retrieves a priority-sorted list of paths for existing data files

with the name `filename`:

```go

path, err := scope.LookupData("filename")

```

| Platform | User Scope                                                                                  | System Scope                                                 |

| -------- | ------------------------------------------------------------------------------------------- | ------------------------------------------------------------ |

| Unix     | ["~/.local/share/app/filename", "/usr/local/share/app/filename", "/usr/share/app/filename"] | ["/usr/local/share/app/filename", "/usr/share/app/filename"] |

| macOS    | ["~/Library/Application Support/app/filename"]                                              | ["/Library/Application Support/app/filename"]                |

| Windows  | ["%LOCALAPPDATA%/app/filename"]                                                             | ["%PROGRAMDATA%/app/filename"]                               |

---

`LookupConfig` retrieves a priority-sorted list of paths for existing config

files with the name `filename.conf`:

```go

path, err := scope.LookupConfig("filename.conf")

```

| Platform | User Scope                                                                              | System Scope                                             |

| -------- | --------------------------------------------------------------------------------------- | -------------------------------------------------------- |

| Unix     | ["~/.config/app/filename.conf", "/etc/xdg/app/filename.conf", "/etc/app/filename.conf"] | ["/etc/xdg/app/filename.conf", "/etc/app/filename.conf"] |

| macOS    | ["~/Library/Preferences/app/filename.conf"]                                             | ["/Library/Preferences/app/filename.conf"]               |

| Windows  | ["%LOCALAPPDATA%/app/Config/filename.conf"]                                             | ["%PROGRAMDATA%/app/Config/filename.conf"]               |