https://github.com/rkoesters/xdg

FreeDesktop.org (xdg) Specs implemented in Go
https://github.com/rkoesters/xdg

go golang xdg xdg-basedir xdg-compliance xdg-open xdg-specs

Last synced: 3 months ago
JSON representation

FreeDesktop.org (xdg) Specs implemented in Go

• Host: GitHub
• URL: https://github.com/rkoesters/xdg
• Owner: rkoesters
• License: bsd-3-clause
• Created: 2013-12-15T09:51:51.000Z (about 11 years ago)
• Default Branch: master
• Last Pushed: 2024-05-07T00:24:31.000Z (9 months ago)
• Last Synced: 2024-07-31T20:52:32.726Z (6 months ago)
• Topics: go, golang, xdg, xdg-basedir, xdg-compliance, xdg-open, xdg-specs
• Language: Go
• Homepage:
• Size: 160 KB
• Stars: 41
• Watchers: 2
• Forks: 9
• Open Issues: 2
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

• awesome-go - xdg - FreeDesktop.org (xdg) Specs implemented in Go. (Miscellaneous / Uncategorized)
• zero-alloc-awesome-go - xdg - FreeDesktop.org (xdg) Specs implemented in Go. (Miscellaneous / Uncategorized)
• awesome-go-extra - xdg - 12-15T09:51:51Z|2022-04-26T02:05:26Z| (Microsoft Office / Uncategorized)

README

        
xdg

===

Package xdg provides access to the FreeDesktop.org (XDG) specs.

[![GoDoc](https://godoc.org/github.com/rkoesters/xdg?status.svg)](https://godoc.org/github.com/rkoesters/xdg)

[![Build Status](https://travis-ci.org/rkoesters/xdg.svg?branch=master)](https://travis-ci.org/rkoesters/xdg)

[![Go Report Card](https://goreportcard.com/badge/github.com/rkoesters/xdg)](https://goreportcard.com/report/github.com/rkoesters/xdg)

Documentation

-------------

Documentation is available via godoc. Here are direct links to the

documentation pages for each package:

* [xdg](https://godoc.org/github.com/rkoesters/xdg) - Provides xdg.Open

  function to call `xdg-open` command.

* [xdg/basedir](https://godoc.org/github.com/rkoesters/xdg/basedir) -

  Provides access to the xdg basedir spec.

* [xdg/desktop](https://godoc.org/github.com/rkoesters/xdg/desktop) -

  Read desktop files (w/ localization support).

* [xdg/keyfile](https://godoc.org/github.com/rkoesters/xdg/keyfile) -

  Provides access to xdg key file format (w/ localization support).

* [xdg/trash](https://godoc.org/github.com/rkoesters/xdg/trash) -

  Provides access to xdg trash spec.

* [xdg/userdirs](https://godoc.org/github.com/rkoesters/xdg/userdirs) -

  Provides access to common user directories.

Testing

-------

Tests can be run with `go test`.

The tests for the [xdg/trash](trash) package expect the trash to exist

(`$XDG_DATA_HOME/Trash/files` (or `$HOME/.local/share/Trash/files` if

`$XDG_DATA_HOME` is undefined)).

The tests for the [xdg/userdirs](userdirs) package require the

`xdg-user-dir` command.

TODO

----

- autostart

- desktop.Launch (in progress on desktop-launch branch)

- trash.New (requires checking for a "sticky bit" on the filesystem of

  the drive on which the trash exists; in addition to other (easier)

  checks)

License

-------

See [LICENSE](LICENSE).