https://github.com/jonathanstowe/xdg-basedirectory

The BaseDirectory part of the freedesktop XDG specifications
https://github.com/jonathanstowe/xdg-basedirectory

config raku xdg

Last synced: 18 days ago
JSON representation

The BaseDirectory part of the freedesktop XDG specifications

• Host: GitHub
• URL: https://github.com/jonathanstowe/xdg-basedirectory
• Owner: jonathanstowe
• License: artistic-2.0
• Created: 2015-09-02T09:32:02.000Z (over 9 years ago)
• Default Branch: master
• Last Pushed: 2023-01-09T23:00:39.000Z (almost 2 years ago)
• Last Synced: 2023-04-22T17:07:00.419Z (over 1 year ago)
• Topics: config, raku, xdg
• Language: Raku
• Homepage:
• Size: 331 KB
• Stars: 1
• Watchers: 1
• Forks: 5
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • Changelog: Changes

Awesome Lists containing this project

README

        
# XDG::BaseDirectory

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

![Build Status](https://github.com/jonathanstowe/XDG-BaseDirectory/workflows/CI/badge.svg)

## Synopsis

```raku

    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](LICENCE) file in the distribution for the exact terms.

© Jonathan Stowe 2015-2021