---
name: "Catmandu::Importer::Modules"
section: "3pm"
platform: "linux"
package: "libcatmandu-perl"
version: "1.2024-1"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/Catmandu::Importer::Modules"
---

# Catmandu::Importer::Modules(3pm)

list installed perl modules in a given namespace

## NAME

Catmandu::Importer::Modules - list installed perl modules in a given namespace

## DESCRIPTION

This Catmandu::Importer list perl modules from all perl library paths with their `"name"`, `"version"`, absolute `"file"`, library `"path"`, and short description (`"about"`).

## CONFIGURATION

- file

  Read input from a local file given by its path. Alternatively a scalar reference can be passed to read from a string.

- fh

  Read input from an IO::Handle. If not specified, Catmandu::Util::io is used to create the input stream from the `"file"` argument or by using STDIN.

- encoding

  Binmode of the input stream `"fh"`. Set to `":utf8"` by default.

- fix

  An ARRAY of one or more fixes or file scripts to be applied to imported items.

- namespace

  Namespace(s) for the modules to list, given as array or comma-separated list

- inc

  List of library paths (defaults to `@INC`)

- max\_depth

  Maximum depth to recurse into the namespace e.g. if the namespace is Catmandu::Fix then Catmandu::Fix::add\_field has a depth of 1 and Catmandu::Fix::Condition::exists a depth of 2

- pattern

  Filter modules by the given regex pattern

- primary

  Filter modules to the first module of each name

- about

  Include short description as given in the NAME section of each module's documentation.  Enabled by default.

## METHODS

Every Catmandu::Importer is a Catmandu::Iterable all its methods are inherited.

## SEE ALSO

Catmandu::Importer::CPAN, Catmandu::Cmd::info