File::UserConfig

File::UserConfig is a Perl module that provides a solution for obtaining a user's existing configuration directory or copying in defaults. With the easy-to-use "Do What I Mean" function, retrieving the configuration directory is simple with the following code: $configdir = File::UserConfig->configdir.

In addition to the effortless default configuration, File::UserConfig also allows for finer control over the directory structure. The user may opt for convention-based defaults or specify different attributes such as distribution, module, directory name and shared directory as shown in the code snippet: $configdir = File::UserConfig->new(dist => 'My-Application',module => 'My::Application',dirname => '.myapp',sharedir => $defaults_here)->configdir.

Many modules and applications maintain a user-specific configuration data directory using the same implementation pattern. This directory typically establishes with a set of default files the first time the application runs, and then its files are changed as necessary. File::UserConfig offers a standard, lightweight, and subclassable default implementation approach for establishing and managing user-specific configuration directories. Thus, it "does the right thing" concerning the directory names.