Help language development. Donate to The Perl Foundation

XDG::BaseDirectory zef:jonathanstowe last updated on 2023-01-09

717b6abeca68df72179eb7b0ca2453de0ba3fbf2/

XDG::BaseDirectory

Raku access to path information provided by the xdg base directory specfication http://www.freedesktop.org/wiki/Specifications/basedir-spec/

Synopsis

use XDG::BaseDirectory;

my $bd = XDG::BaseDirectory.new

for $bd.load-config-paths('mydomain.org', 'MyProg', 'Options') -> $d {
    say $d;
}

# Directories can be made available as terms as well
use XDG::BaseDirectory :terms;

say config-home;

Description

This is loosely based on the interface of python module pyxdg. But due to the differences between Python and Raku it may do some things differently.

It provides a set of facilities for discovering the location of the configuration and data of applications.

I split this out from the XDG module as it has more general usefulness and no external dependencies.

Installation

Assuming you have a working Rakudo installation with zef installed you can install from a copy of the source directory:

 zef install .

or remotely:

 zef install XDG::BaseDirectory

Support

Suggestions/patches are welcomed via github at:

https://github.com/jonathanstowe/XDG-BaseDirectory/issues

I'm not able to test on a wide variety of platforms so any help there would be appreciated.

Licence

This module is Free Software please see the LICENCE file in the distribution for the exact terms.