{"id":19640372,"url":"https://github.com/kentnl/dist-zilla-plugin-metaprovides-package","last_synced_at":"2025-04-28T11:31:14.283Z","repository":{"id":56833606,"uuid":"794974","full_name":"kentnl/Dist-Zilla-Plugin-MetaProvides-Package","owner":"kentnl","description":"Extract namespaces/version from traditional packages for provides","archived":false,"fork":false,"pushed_at":"2017-03-01T12:53:53.000Z","size":797,"stargazers_count":2,"open_issues_count":0,"forks_count":2,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-04-05T08:34:31.394Z","etag":null,"topics":["dist-zilla","perl"],"latest_commit_sha":null,"homepage":"","language":"Perl","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/kentnl.png","metadata":{"files":{"readme":"README.mkdn","changelog":"Changes","contributing":"CONTRIBUTING.pod","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2010-07-24T11:41:55.000Z","updated_at":"2017-03-01T12:49:30.000Z","dependencies_parsed_at":"2022-09-08T07:41:57.631Z","dependency_job_id":null,"html_url":"https://github.com/kentnl/Dist-Zilla-Plugin-MetaProvides-Package","commit_stats":null,"previous_names":[],"tags_count":66,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kentnl%2FDist-Zilla-Plugin-MetaProvides-Package","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kentnl%2FDist-Zilla-Plugin-MetaProvides-Package/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kentnl%2FDist-Zilla-Plugin-MetaProvides-Package/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kentnl%2FDist-Zilla-Plugin-MetaProvides-Package/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/kentnl","download_url":"https://codeload.github.com/kentnl/Dist-Zilla-Plugin-MetaProvides-Package/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":251304853,"owners_count":21567951,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["dist-zilla","perl"],"created_at":"2024-11-11T14:05:36.388Z","updated_at":"2025-04-28T11:31:10.916Z","avatar_url":"https://github.com/kentnl.png","language":"Perl","funding_links":[],"categories":[],"sub_categories":[],"readme":"# NAME\n\nDist::Zilla::Plugin::MetaProvides::Package - Extract namespaces/version from traditional packages for provides\n\n# VERSION\n\nversion 2.004004\n\n# SYNOPSIS\n\nIn your `dist.ini`:\n\n    [MetaProvides::Package]\n\n    ; This is the (optional) default: This forces any package versions\n    ; added in the \"provides\" metadata to use the 'version'\n    ; specified by dzil.\n    ;\n    ; Set it to 0 to force packages own versions to be respected. ( You probably don't want this )\n    inherit_version = 1\n\n    ; This is also the (optional) default: This forces any package without\n    ; a version declaration to use the 'version' specified by default.\n    ;\n    ; Set it to 0 to allow packages to have no versions\n    inherit_missing = 1\n\n    ; This is the (optional) default: This being true discovers any [MetaNoIndex]\n    ; plugins to also further exclude packages from the provides map.\n    ;\n    ; Set it to 0 if for some weird reason you don't want this.\n    meta_noindex    = 1\n\n    ; This is the (optional) default: Packages named _Foo::Bar or Foo::_Bar are not indexed.\n    ; Set this to 1 to enable indexing of similarly named packages.\n    include_underscores = 0\n\n# DESCRIPTION\n\nThis is a [`Dist::Zilla`](https://metacpan.org/pod/Dist::Zilla) Plugin that populates the `provides`\nproperty of `META.json` and `META.yml` by absorbing it from your shipped modules,\nin a manner similar to how `PAUSE` itself does it.\n\nThis allows you to easily create an authoritative index of what module provides what\nversion in advance of `PAUSE` indexing it, which `PAUSE` in turn will take verbatim.\n\n# CONSUMED ROLES\n\n## [Dist::Zilla::Role::MetaProvider::Provider](https://metacpan.org/pod/Dist::Zilla::Role::MetaProvider::Provider)\n\n# ROLE SATISFYING METHODS\n\n## `provides`\n\nA conformant function to the [Dist::Zilla::Role::MetaProvider::Provider](https://metacpan.org/pod/Dist::Zilla::Role::MetaProvider::Provider) Role.\n\n### signature: $plugin-\u003eprovides()\n\n### returns: Array of [Dist::Zilla::MetaProvides::ProvideRecord](https://metacpan.org/pod/Dist::Zilla::MetaProvides::ProvideRecord)\n\n# ATTRIBUTES\n\n## `include_underscores`\n\nThis attribute controls automatic skipping of packages.\n\nBy default, `MetaProvides::Package` skips packages matching the following regular expression:\n\n    qr/(\\A|::)_/\n\nSetting this attribute to a `true` value will avoid skipping these packages.\n\nThis feature was added in `2.004001-TRIAL`\n\n## `finder`\n\nThis attribute, if specified will\n\n- Override the `FileFinder` used to find files containing packages\n- Inhibit autovivification of the `.pm` file finder\n\nThis parameter may be specified multiple times to aggregate a list of finders\n\n# OPTIONS INHERITED FROM [Dist::Zilla::Role::MetaProvider::Provider](https://metacpan.org/pod/Dist::Zilla::Role::MetaProvider::Provider)\n\n## [`inherit_version`](https://metacpan.org/pod/Dist::Zilla::Role::MetaProvider::Provider#inherit_version)\n\nHow do you want existing versions ( Versions hard-coded into files before running this plug-in )to be processed?\n\n- DEFAULT: inherit\\_version = 1\n\n    Ignore anything you find in a file, and just probe `DZIL-\u003eversion()` for a value. This is a sane default and most will want this.\n\n- inherit\\_version = 0\n\n    Use this option if you actually want to use hard-coded values in your files and use the versions parsed out of them.\n\n## [`inherit_missing`](https://metacpan.org/pod/Dist::Zilla::Role::MetaProvider::Provider#inherit_missing)\n\nIn the event you are using the aforementioned `[\"inherit_version\"](#inherit_version) = 0`, this determines how to behave when encountering a\nmodule with no version defined.\n\n- DEFAULT: inherit\\_missing = 1\n\n    When a module has no version, probe `DZIL-\u003eversion()` for an answer. This is what you want if you want to have some\n    files with fixed versions, and others to just automatically be maintained by Dist::Zilla.\n\n- inherit\\_missing = 0\n\n    When a module has no version, emit a versionless record in the final metadata.\n\n## [`meta_noindex`](https://metacpan.org/pod/Dist::Zilla::Role::MetaProvider::Provider#meta_noindex)\n\nThis is a utility for people who are also using [`MetaNoIndex`](https://metacpan.org/pod/Dist::Zilla::Plugin::MetaNoIndex),\nso that its settings can be used to eliminate items from the 'provides' list.\n\n- meta\\_noindex = 0\n\n    With this set, any `MetaNoIndex` plugins are ignored.\n\n- DEFAULT: meta\\_noindex = 1\n\n    When a module meets the criteria provided to [`MetaNoIndex`](https://metacpan.org/pod/Dist::Zilla::Plugin::MetaNoIndex),\n    eliminate it from the metadata shipped to [Dist::Zilla](https://metacpan.org/pod/Dist::Zilla).\n\n# SEE ALSO\n\n- [Dist::Zilla::Plugin::MetaProvides](https://metacpan.org/pod/Dist::Zilla::Plugin::MetaProvides)\n\n# AUTHOR\n\nKent Fredric \u003ckentnl@cpan.org\u003e\n\n# COPYRIGHT AND LICENSE\n\nThis software is copyright (c) 2017 by Kent Fredric \u003ckentfredric@gmail.com\u003e.\n\nThis is free software; you can redistribute it and/or modify it under\nthe same terms as the Perl 5 programming language system itself.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkentnl%2Fdist-zilla-plugin-metaprovides-package","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkentnl%2Fdist-zilla-plugin-metaprovides-package","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkentnl%2Fdist-zilla-plugin-metaprovides-package/lists"}