{"id":15062326,"url":"https://github.com/kentnl/dist-zilla-pluginbundle-author-kentnl","last_synced_at":"2026-01-03T06:07:24.717Z","repository":{"id":917733,"uuid":"680357","full_name":"kentnl/Dist-Zilla-PluginBundle-Author-KENTNL","owner":"kentnl","description":"Belike::KENTNL when you make your dists","archived":false,"fork":false,"pushed_at":"2017-03-04T03:22:39.000Z","size":3697,"stargazers_count":2,"open_issues_count":1,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-03-16T04:28:11.378Z","etag":null,"topics":["dist-zilla","perl"],"latest_commit_sha":null,"homepage":"http://search.cpan.org/dist/Dist-Zilla-PluginBundle-Author-KENTNL","language":"Perl","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":"Unmaintained","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-05-22T09:13:58.000Z","updated_at":"2017-02-28T02:26:45.000Z","dependencies_parsed_at":"2022-08-16T11:25:26.842Z","dependency_job_id":null,"html_url":"https://github.com/kentnl/Dist-Zilla-PluginBundle-Author-KENTNL","commit_stats":null,"previous_names":[],"tags_count":290,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kentnl%2FDist-Zilla-PluginBundle-Author-KENTNL","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kentnl%2FDist-Zilla-PluginBundle-Author-KENTNL/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kentnl%2FDist-Zilla-PluginBundle-Author-KENTNL/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kentnl%2FDist-Zilla-PluginBundle-Author-KENTNL/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/kentnl","download_url":"https://codeload.github.com/kentnl/Dist-Zilla-PluginBundle-Author-KENTNL/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243826826,"owners_count":20354220,"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-09-24T23:34:28.560Z","updated_at":"2026-01-03T06:07:24.711Z","avatar_url":"https://github.com/kentnl.png","language":"Perl","funding_links":[],"categories":[],"sub_categories":[],"readme":"# NAME\n\nDist::Zilla::PluginBundle::Author::KENTNL - BeLike::KENTNL when you build your distributions.\n\n# VERSION\n\nversion 2.025022\n\n# SYNOPSIS\n\n    [@Author::KENTNL]\n    normal_form  = numify ; Mandatory for this bundle indicating normal form.\n                          ; see DZP::Git::NextVersion::Sanitized\n\n    mantissa     = 6      ; Mandatory for this bundle if normal_form is numify.\n                          ; see DZP::Git::NextVersion::Sanitized\n\n    authority    = cpan:KENTNL ; Optional, defaults to cpan:KENTNL\n\n    auto_prereqs_skip   = Some::Module  ; Hide these from autoprereqs\n    auto_prereqs_skip   = Other::Module\n\n    toolkit     = mb   ; Which toolkit to use. Either eumm or mb\n                         ; mb is default.\n\n    toolkit_hardness = hard ; Whether to upgrade *require* deps to the latest\n                            ; or wether to make them merely recomendations.\n                            ; Either 'soft' ( recommend ) or 'hard' ( require )\n                            ; default is 'hard'\n\n    twitter_extra_hash_tags = #foo #bar ; non-default hashtags to append to the tweet\n\n# DESCRIPTION\n\nThis is the plug-in bundle that KENTNL uses. It exists mostly because he is very lazy\nand wants others to be using what he's using if they want to be doing work on his modules.\n\n# NAMING SCHEME\n\nAs I blogged about on [`blog.fox.geek.nz` : Making a Minting Profile as a CPANized Dist ](http://bit.ly/hAwl4S),\nthis bundle advocates a new naming system for people who are absolutely convinced they want their `Author-Centric` distribution\nuploaded to CPAN.\n\nAs we have seen with Dist::Zilla there have been a slew of PluginBundles with CPANID's in their name, to the point that there is\na copious amount of name-space pollution in the PluginBundle name-space, and more Author bundles than task-bundles, which was\nreally what the name-space was designed for, and I'm petitioning you to help reduce this annoyance in future modules.\n\nFrom a CPAN testers perspective, the annoyance of lots of CPANID-dists is similar to the annoyance of the whole DPCHRIST::\nsubspace, and that if this pattern continues, it will mean for the testers who do not wish to test everyones personal modules,\nthat they will have to work hard to avoid this. If DPCHRIST:: had used something like Author::DPCHRIST:: instead, I doubt so many\npeople would be horrified by it, because you can just have a policy/rule that excludes ^Author::, and everyone else who goes that\nway can be quietly ignored.\n\nThen we could probably rationally add that same restriction to the irc announce bots, the \"recent modules\" list and so-forth, and\npossibly even apply special indexing restrictions or something so people wouldn't even have to know those modules exist on cpan!\n\nSo, for the sake of cleanliness, semantics, and general global sanity, I ask you to join me with my Author:: naming policy to\nvoluntarily segregate modules that are most likely of only personal use from those that have more general application.\n\n    Dist::Zilla::Plugin::Foo                    # [Foo]                 dist-zilla plugins for general use\n    Dist::Zilla::Plugin::Author::KENTNL::Foo    # [Author::KENTNL::Foo] foo that only KENTNL will probably have use for\n    Dist::Zilla::PluginBundle::Classic          # [@Classic]            A bundle that can have practical use by many\n    Dist::Zilla::PluginBundle::Author::KENTNL   # [@Author::KENTNL]     KENTNL's primary plugin bundle\n    Dist::Zilla::MintingProfile::Default        # A minting profile that is used by all\n    Dist::Zilla::MintingProfile::Author::KENTNL # A minting profile that only KENTNL will find of use.\n\n## Current Proponents\n\nI wish to give proper respect to the people out there already implementing this scheme:\n\n- [`@Author::DOHERTY` ](https://metacpan.org/pod/Dist::Zilla::PluginBundle::Author::DOHERTY) - Mike Doherty's, Author Bundle.\n- [`@Author::OLIVER` ](https://metacpan.org/pod/Dist::Zilla::PluginBundle::Author::OLIVER) - Oliver Gorwits', Author Bundle.\n- [`Dist::Zilla::PluginBundle::Author::` namespace ](http://bit.ly/dIovQI) - Oliver Gorwit's blog on the subject.\n- [`@Author::LESPEA` ](https://metacpan.org/pod/Dist::Zilla::PluginBundle::Author::LESPEA) - Adam Lesperance's, Author Bundle.\n- [`@Author::ALEXBIO` ](https://metacpan.org/pod/Dist::Zilla::PluginBundle::Author::ALEXBIO) - Alessandro Ghedini's, Author Bundle.\n- [`@Author::RWSTAUNER` ](https://metacpan.org/pod/Dist::Zilla::PluginBundle::Author::RWSTAUNER) - Randy Stauner's, Author Bundle.\n- [`@Author::WOLVERIAN` ](https://metacpan.org/pod/Dist::Zilla::PluginBundle::Author::WOLVERIAN) - Ilmari Vacklin's, Author Bundle.\n- [`@Author::YANICK` ](https://metacpan.org/pod/Dist::Zilla::PluginBundle::Author::YANICK) - Yanick Champoux's, Author Bundle.\n- [`@Author::RUSSOZ` ](https://metacpan.org/pod/Dist::Zilla::PluginBundle::Author::RUSSOZ) - Alexei Znamensky's, Author Bundle.\n\n# METHODS\n\n## `bundle_config`\n\nSee [the `PluginBundle` role](https://metacpan.org/pod/Dist::Zilla::Role::PluginBundle) for what this is for, it is a method to satisfy that role.\n\n## `add_plugin`\n\n    $bundle_object-\u003eadd_plugin(\"Basename\" =\u003e { config_hash } );\n\n## `add_named_plugin`\n\n    $bundle_object-\u003eadd_named_plugin(\"alias\" =\u003e \"Basename\" =\u003e { config_hash } );\n\n## `configure`\n\nCalled by in `bundle_config` after `new`\n\n# ATTRIBUTES\n\n## `plugins`\n\n**INTERNAL**.\n\n    ArrayRef, ro, default = [], no init arg.\n\nPopulated during `$self-\u003econfigure` and returned from `-\u003ebundle_config`\n\n## `normal_form`\n\n    Str, ro, lazy\n\nA `normal_form` to pass to [`[Git::NextVersion::Sanitized]`](https://metacpan.org/pod/Dist::Zilla::Plugin::Git::NextVersion::Sanitized).\n\nDefaults to `numify`\n\nSee [`[::Role::Version::Sanitize]`](https://metacpan.org/pod/Dist::Zilla::Role::Version::Sanitize)\n\n## `mantissa`\n\n    Int, ro, defaults to 6.\n\nDefines the length of the mantissa when normal form is `numify`.\n\nSee [`[Git::NextVersion::Sanitized]`](https://metacpan.org/pod/Dist::Zilla::Plugin::Git::NextVersion::Sanitized) and [`[::Role::Version::Sanitize]`](https://metacpan.org/pod/Dist::Zilla::Role::Version::Sanitize)\n\n## `git_versions`\n\n    Any, unused.\n\n- **UNUSED**\n\nSince `2.020`, this field is no longer required, and is unused, simply supported for legacy reasons.\n\nThings may not work if code has not been portaged to be `Git::NextVersion` safe, but that's better than going \"bang\".\n\nBut code will be assumed to be using `Git::NextVersion`.\n\n## `authority`\n\n    Str, ro, default = cpan:KENTNL\n\nAn authority string to use for `[Authority]`.\n\n## `auto_prereqs_skip`\n\n    ArrayRef, ro, multivalue, default = []\n\nA list of prerequisites to pass to `[AutoPrereqs].skips`\n\n## `twitter_extra_hash_tags`\n\n    Str, ro, default = \"\"\n\nAdditional hash tags to append to twitter\n\n## `twitter_hash_tags`\n\n    Str, ro, default = '#perl #cpan' . extras()\n\nPopulates `extras` from `twitter_extra_hash_tags`\n\n## `tweet_url`\n\n    Str, ro, default =  q[https://metacpan.org/release/{{$AUTHOR_UC}}/{{$DIST}}-{{$VERSION}}{{$TRIAL}}#whatsnew]\n\nThe `URI` to tweet to `@kentnlrelease`\n\n## `toolkit_hardness`\n\n    enum( hard, soft ), ro, default = hard\n\n- `hard`\n\n    Copy the versions of important toolkit components the author was using as `required` dependencies,\n    forcing consumers to update aggressively on those parts.\n\n- `soft`\n\n    Copy the versions of important toolkit components the author was using as `recommended` dependencies,\n    so that only consumers who are installing with `--with-recommended` get given the forced upgrade path.\n\n## `toolkit`\n\n    enum( mb, mbtiny, eumm ), ro, default = mb\n\nDetermines which tooling to generate the distribution with\n\n- `mb` : [`Module::Build`](https://metacpan.org/pod/Module::Build)\n- `mbtiny` : [`Module::Build::Tiny`](https://metacpan.org/pod/Module::Build::Tiny)\n- `eumm` : [`ExtUtils::MakeMaker`](https://metacpan.org/pod/ExtUtils::MakeMaker)\n\n## `bump_versions`\n\n    bump_versions = 1\n\nIf true, use `[BumpVersionAfterRelease]`  and `[RewriteVersions::Sanitized]` instead of `[PkgVersion]` and\n`[Git::NextVersion::Sanitized]`\n\n## `copy_files`\n\nAn array of files generated by `Dist::Zilla` build to copy from the built dist back to the source dist\n\nIf not specified, the default contents are as follows:\n\n    copy_files = LICENSE\n    copy_files = Makefile.PL\n\nThese defaults can be wiped with:\n\n    copy_files = none\n\n## `src_readme`\n\n    src_readme = pod  ; # generate README.pod on the source side\n    src_readme = mkdn ; # generate README.mkdn on the source side\n    src_readme = none ; # don't generate README on the source side\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-pluginbundle-author-kentnl","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkentnl%2Fdist-zilla-pluginbundle-author-kentnl","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkentnl%2Fdist-zilla-pluginbundle-author-kentnl/lists"}