Test::File::ShareDir::Object::Dist(3) User Contributed Perl Documentation Test::File::ShareDir::Object::Dist(3)

# [NAME](#NAME)

Test::File::ShareDir::Object::Dist - Object Oriented ShareDir creation for distributions

# [VERSION](#VERSION)

version 1.001002

# [SYNOPSIS](#SYNOPSIS)

```
    use Test::File::ShareDir::Object::Dist;
    my $dir = Test::File::ShareDir::Object::Dist->new(
        root    => "some/path",
        dists => {
            "Hello-Nurse" => "share/HN"
        },
    );
    $dir->install_all_dists;
    $dir->add_to_inc;
```

# [METHODS](#METHODS)

## ["dist\_names"](#_dist_names_)

```
    my @names = $instance->dist_names();
```

Returns the names of all distributions listed in the "dists" set.

## ["dist\_share\_target\_dir"](#_dist_share_target_dir_)

```
    my $dir = $instance->dist_share_target_dir("Dist-Name");
```

Returns the path where the "ShareDir" will be created for "Dist-Name"

## ["dist\_share\_source\_dir"](#_dist_share_source_dir_)

```
    my $dir = $instance->dist_share_source_dir("Dist-Name");
```

Returns the path where the "ShareDir" will be **COPIED** *FROM* for "Dist-Name"

## ["install\_dist"](#_install_dist_)

```
    $instance->install_dist("Dist-Name");
```

Installs "Dist-Name"'s "ShareDir"

## ["install\_all\_dists"](#_install_all_dists_)

```
    $instance->install_all_dists();
```

Installs all "dist\_names"

## ["add\_to\_inc"](#_add_to_inc_)

**DEPRECATED:** Use "register" instead.

## ["register"](#_register_)

```
    $instance->register();
```

Adds the "Tempdir" "ShareDir" ( "inc" ) to the global @INC

*Since 1.001000*

## ["clear"](#_clear_)

```
    $instance->clear();
```

Removes the "Tempdir" "ShareDir" ( "inc" ) from the global @INC

*Since 1.001000*

# [ATTRIBUTES](#ATTRIBUTES)

## ["inc"](#_inc_)

A "Test::File::ShareDir::Object::Inc" object.

## ["dists"](#_dists_)

A hash of :

```
    Dist-Name => "relative/path"
```

## ["root"](#_root_)

The origin all paths's are relative to.

( Defaults to "cwd" )

# [AUTHOR](#AUTHOR)

Kent Fredric <kentnl@cpan.org>

# [COPYRIGHT AND LICENSE](#COPYRIGHT_AND_LICENSE)

This software is copyright (c) 2017 by Kent Fredric <kentnl@cpan.org>.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.

2026-04-22 perl v5.42.2

---

Document: Test::File::ShareDir::Object::Dist(3pm) from perl-test-file-sharedir 1.001002-r1 (Chainguard OS)
Source: https://github.com/kentnl/Test-File-ShareDir