Find your home and other directories on any platform
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
examples
lib/File
t
.gitignore Ignore .precomp generated directories Apr 15, 2016
.travis.yml
LICENSE
META6.json Use SPDX identifier in license field of META6.json Apr 28, 2017
README.md
appveyor.yml

README.md

File::HomeDir

Build Status Build status

This is a Perl 6 port of File::HomeDir. File::HomeDir is a module for locating the directories that are "owned" by a user (typicaly your user) and to solve the various issues that arise trying to find them consistently across a wide variety of platforms.

The end result is a single API that can find your resources on any platform, making it relatively trivial to create Perl software that works elegantly and correctly no matter where you run it.

Example

use v6;

use File::HomeDir;

say File::HomeDir.my-home;
say File::HomeDir.my-desktop;
say File::HomeDir.my-documents;
say File::HomeDir.my-pictures;
say File::HomeDir.my-videos;

Installation

To install it using zef (a module management tool bundled with Rakudo Star):

zef install File::HomeDir

Testing

  • To run tests:
$ prove -ve "perl6 -Ilib"
  • To run all tests including author tests (Please make sure Test::Meta is installed):
$ zef install Test::META
$ AUTHOR_TESTING=1 prove -ve "perl6 -Ilib"

Author

Perl 6 version:

Perl 5 version:

  • Adam Kennedy (2005 - 2012)
  • Chris Nandor (2006)
  • Stephen Steneker (2006)
  • Jérôme Quelin (2009-2011)
  • Sean M. Burke (2000)

License

MIT License