CPAN::Meta::YAML(3p)

CPAN::Meta::YAML3p

Read and write a subset of yaml for cpan meta files

Usage

    use CPAN::Meta::YAML;
    # reading a META file
    open $fh, "<:utf8", "META.yml";
    $yaml_text = do { local $/; <$fh> };
    $yaml = CPAN::Meta::YAML->read_string($yaml_text)
      or die CPAN::Meta::YAML->errstr;
    # finding the metadata
    $meta = $yaml->[0];
    # writing a META file
    $yaml_text = $yaml->write_string
      or die CPAN::Meta::YAML->errstr;
    open $fh, ">:utf8", "META.yml";
    print $fh $yaml_text;

Version

version 0.020

Overview

This module implements a subset of the YAML specification for use in reading and writing CPAN metadata files like META.yml and MYMETA.yml. It should not be used for any other general YAML parsing or generation task.

NOTE: META.yml (and MYMETA.yml) files should be UTF-8 encoded. Users are responsible for proper encoding and decoding. In particular, the "read" and "write" methods do not support UTF-8 and should not be used.

Support

This module is currently derived from YAML::Tiny by Adam Kennedy. If there are bugs in how it parses a particular META.yml file, please file a bug report in the YAML::Tiny bugtracker: <https://github.com/Perl-Toolchain-Gang/YAML-Tiny/issues>

Contributor

Karen Etheridge <[email protected]>

Releases

28 releases since OpenBSD 5.4; the text changed 19 times.

  1. 5.4–5.5
  2. 5.6
  3. 5.7
  4. 5.8–5.9
  5. 6.0
  6. 6.1
  7. 6.2
  8. 6.3–6.4
  9. 6.5
  10. 6.6
  11. 6.7
  12. 6.8
  13. 6.9–7.2
  14. 7.3
  15. 7.4
  16. 7.5
  17. 7.6
  18. 7.7–7.8
  19. 7.9
  20. 8.0

Authors

•

Adam Kennedy <[email protected]>
•

David Golden <[email protected]>

From man 8.0-current-20261101 in OpenBSD 8.0-current (2026-11-01). Parsed by carta from the page's man source.