view release on metacpan or  search on metacpan

README  view on Meta::CPAN

NAME
    Acme::CPANModules::GettingTempDir - List of ways of getting system-wide
    temporary directory in a portable way

VERSION
    This document describes version 0.002 of
    Acme::CPANModules::GettingTempDir (from Perl distribution
    Acme-CPANModules-GettingTempDir), released on 2023-10-29.

DESCRIPTION
    There's the good ol' File::Spec which has a "tmpdir" function. On Unix
    it looks at "TMPDIR" environment variable before falling back to "/tmp".
    File::Temp uses this for its "tempdir" when a template is not specified.

    Then there's File::Util::Tempdir which tries a little harder. On Unix,
    its "get_tempdir" will look at "TMPDIR", then also "TEMPDIR", "TMP",
    "TEMP". If none of those are set, it will return the first existing
    directory from the list: "/tmp", "/var/tmp". If everything fails, will
    die.

    File::Util::Tempdir also provides "get_user_tempdir" which returns a
    user-private temporary directory, which can be useful if you want to
    create temporary file with predetermined names. It will return temporary
    directory pointed by "XDG_RUNTIME_DIR" (e.g. "/run/user/1000") or, if
    unavailable, will create a subdirectory under the world-writable

lib/Acme/CPANModules/GettingTempDir.pm  view on Meta::CPAN

our $AUTHORITY = 'cpan:PERLANCAR'; # AUTHORITY
our $DATE = '2023-10-29'; # DATE
our $DIST = 'Acme-CPANModules-GettingTempDir'; # DIST
our $VERSION = '0.002'; # VERSION

our $LIST = {
    summary => 'List of ways of getting system-wide temporary directory in a portable way',
    description => <<'_',

There's the good ol' <pm:File::Spec> which has a `tmpdir` function. On Unix it
looks at `TMPDIR` environment variable before falling back to `/tmp`.
<pm:File::Temp> uses this for its `tempdir` when a template is not specified.

Then there's <pm:File::Util::Tempdir> which tries a little harder. On Unix, its
`get_tempdir` will look at `TMPDIR`, then also `TEMPDIR`, `TMP`, `TEMP`. If none
of those are set, it will return the first existing directory from the list:
`/tmp`, `/var/tmp`. If everything fails, will die.

File::Util::Tempdir also provides `get_user_tempdir` which returns a
user-private temporary directory, which can be useful if you want to create
temporary file with predetermined names. It will return temporary directory
pointed by `XDG_RUNTIME_DIR` (e.g. `/run/user/1000`) or, if unavailable, will
create a subdirectory under the world-writable temporary directory (e.g.
`/tmp/1000`).

lib/Acme/CPANModules/GettingTempDir.pm  view on Meta::CPAN

=head1 NAME

Acme::CPANModules::GettingTempDir - List of ways of getting system-wide temporary directory in a portable way

=head1 VERSION

This document describes version 0.002 of Acme::CPANModules::GettingTempDir (from Perl distribution Acme-CPANModules-GettingTempDir), released on 2023-10-29.

=head1 DESCRIPTION

There's the good ol' L<File::Spec> which has a C<tmpdir> function. On Unix it
looks at C<TMPDIR> environment variable before falling back to C</tmp>.
L<File::Temp> uses this for its C<tempdir> when a template is not specified.

Then there's L<File::Util::Tempdir> which tries a little harder. On Unix, its
C<get_tempdir> will look at C<TMPDIR>, then also C<TEMPDIR>, C<TMP>, C<TEMP>. If none
of those are set, it will return the first existing directory from the list:
C</tmp>, C</var/tmp>. If everything fails, will die.

File::Util::Tempdir also provides C<get_user_tempdir> which returns a
user-private temporary directory, which can be useful if you want to create
temporary file with predetermined names. It will return temporary directory
pointed by C<XDG_RUNTIME_DIR> (e.g. C</run/user/1000>) or, if unavailable, will
create a subdirectory under the world-writable temporary directory (e.g.
C</tmp/1000>).