xdg
A Go package for reading config and data files according to the XDG Base Directory specification.
by BurntSushiGo
Meet the team
See all 2 on GitHub →
Commit activity
Last 12 weeks · 0 commits
Community health
2 of 6 standards met
42
✓README✓License○Contributing○Code of Conduct○Issue Template○PR Template
Recent PRs & issues
Quiet · 1 discussion · Last activity 12y ago
See all on GitHub →
From the [0.8 spec][1]: A specification that refers to or should define what the behaviour must be when a file is located under multiple base directories. It could, for example, define that only the file under the most important base directory should be used or, as another example, it could define rules for merging the information from the different files. I'm interested in this so I can have my application look for a particular setting in the user-specific config, and fall back through the system config(s) if the user config doesn't have that setting. That allows users to extend the system configs without copy/pasting them into the user-specific config. The current API provided by this package does not support that though. I'm happy to write up a PR for: (with a similar ) if there's interest in supporting that usecase in this package. I'm also interested in hearing thoughts about different APIs that would support this usecase. [1]: https://specifications.freedesktop.org/basedir-spec/basedir-spec-0.8.html#referencing
Recent fixes
The documentation says: So how would one use these functions when trying to _create_ a configuration or data file, if they always return + error in that case?
Hello there! I hoped a library like this existed out there, so I was very excited when I found yours. If you would be so kind as to add a LICENSE/COPYING file (might I suggest the ISC license?), others might then use your library with clear conscience. Thank you! Example license file: Copyright (c) 2013, Andrew Gallant Permission to use, copy, modify, and/or distribute this software for any purpose with or without fee is hereby granted, provided that the above copyright notice and this permission notice appear in all copies. THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
Structured data for AI agents
Repository: BurntSushi/xdg. Description: A Go package for reading config and data files according to the XDG Base Directory specification. Stars: 36, Forks: 3. Primary language: Go. Languages: Go (100%). Open PRs: 0, open issues: 1. Last activity: 12y ago. Community health: 42%. Top contributors: BurntSushi.