---
name: "Test::Dir"
section: "3pm"
platform: "linux"
package: "libtest-dir-perl"
version: "1.16-3"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/Test::Dir"
---

# Test::Dir(3pm)

test directory attributes

## NAME

Test::Dir - test directory attributes

## SYNOPSIS

```
  use Test::More ...;
  use Test::Dir;
```

## DESCRIPTION

This modules provides a collection of test utilities for directory attributes. Use it in combination with Test::More in your test programs.

## FUNCTIONS

### dir\_exists\_ok(DIRNAME \[, TESTNAME\] )

Ok if the directory exists, and not ok otherwise.

### dir\_not\_exists\_ok(DIRNAME \[, TESTNAME\] )

Ok if the directory does not exist, and not ok otherwise.

### dir\_empty\_ok(DIRNAME \[, TESTNAME\] )

Ok if the directory is empty (contains no files or subdirectories), and not ok otherwise.

### dir\_not\_empty\_ok(DIRNAME \[, TESTNAME\] )

Ok if the directory is not empty, and not ok otherwise.

### dir\_readable\_ok(DIRNAME \[, TESTNAME\] )

Ok if the directory is readable, and not ok otherwise.

### dir\_not\_readable\_ok(DIRNAME \[, TESTNAME\] )

Ok if the directory is not readable, and not ok otherwise.

### dir\_writable\_ok(DIRNAME \[, TESTNAME\] )

Ok if the directory is writable, and not ok otherwise.

### dir\_not\_writable\_ok(DIRNAME \[, TESTNAME\] )

Ok if the directory is not writable, and not ok otherwise.

### dir\_executable\_ok(DIRNAME \[, TESTNAME\] )

Ok if the directory is executable, and not ok otherwise.

### dir\_not\_executable\_ok(DIRNAME \[, TESTNAME\] )

Ok if the directory is not executable, and not ok otherwise.

## TO DO

I know there are a lot more directory attributes that can be tested. If you need them, please ask (or better yet, contribute code!).

## AUTHOR

Martin 'Kingpin' Thurn, `"mthurn at cpan.org"`, \<http://tinyurl.com/nn67z\>.

## BUGS

Please report any bugs or feature requests to `"bug-test-dir at` `rt.cpan.org"`, or through the web interface at \<http://rt.cpan.org/NoAuth/ReportBug.html?Queue=Test-Dir\>.  I will be notified, and then you'll automatically be notified of progress on your bug as I make changes.

## SUPPORT

You can find documentation for this module with the perldoc command.

```
  perldoc Test::Dir
```

You can also look for information at:

- •

  RT: CPAN's request tracker

  \<http://rt.cpan.org/NoAuth/Bugs.html?Dist=Test-Dir\>

- •

  AnnoCPAN: Annotated CPAN documentation

  \<http://annocpan.org/dist/Test-Dir\>

- •

  CPAN Ratings

  \<http://cpanratings.perl.org/d/Test-Dir\>

- •

  Search CPAN

  \<http://search.cpan.org/dist/Test-Dir\>

## ACKNOWLEDGEMENTS

## COPYRIGHT & LICENSE

Copyright (C) 2007-2008 Martin 'Kingpin' Thurn

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