{"id":15018740,"url":"https://github.com/jonasbn/pcplrsb","last_synced_at":"2026-02-16T08:33:11.418Z","repository":{"id":12319040,"uuid":"14954880","full_name":"jonasbn/pcplrsb","owner":"jonasbn","description":"Perl::Critic::Policy::logicLAB::RequireSheBang - simple policy for keeping your shebang line uniform","archived":false,"fork":false,"pushed_at":"2021-05-18T04:53:15.000Z","size":1683,"stargazers_count":0,"open_issues_count":3,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-10-21T03:56:05.164Z","etag":null,"topics":["hacktoberfest","perl","perl-critic","perl5","policy"],"latest_commit_sha":null,"homepage":"","language":"Perl","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/jonasbn.png","metadata":{"files":{"readme":"README.mkdn","changelog":"Changes","contributing":"CONTRIBUTING.md","funding":null,"license":null,"code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2013-12-05T13:57:00.000Z","updated_at":"2022-10-01T06:57:36.000Z","dependencies_parsed_at":"2022-09-08T07:41:44.200Z","dependency_job_id":null,"html_url":"https://github.com/jonasbn/pcplrsb","commit_stats":null,"previous_names":[],"tags_count":7,"template":false,"template_full_name":null,"purl":"pkg:github/jonasbn/pcplrsb","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jonasbn%2Fpcplrsb","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jonasbn%2Fpcplrsb/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jonasbn%2Fpcplrsb/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jonasbn%2Fpcplrsb/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jonasbn","download_url":"https://codeload.github.com/jonasbn/pcplrsb/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jonasbn%2Fpcplrsb/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29503809,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-16T08:14:25.707Z","status":"ssl_error","status_checked_at":"2026-02-16T08:14:25.334Z","response_time":115,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":["hacktoberfest","perl","perl-critic","perl5","policy"],"created_at":"2024-09-24T19:52:23.723Z","updated_at":"2026-02-16T08:33:11.390Z","avatar_url":"https://github.com/jonasbn.png","language":"Perl","funding_links":[],"categories":[],"sub_categories":[],"readme":"[![CPAN version](https://badge.fury.io/pl/Perl-Critic-Policy-logicLAB-RequireSheBang.svg)](http://badge.fury.io/pl/Perl-Critic-Policy-logicLAB-RequireSheBang)\n[![Build Status](https://travis-ci.org/jonasbn/pcplrsb.svg?branch=master)](https://travis-ci.org/jonasbn/pcplrsb)\n[![Coverage Status](https://coveralls.io/repos/jonasbn/pcplrsb/badge.png)](https://coveralls.io/r/jonasbn/pcplrsb)\n\n# NAME\n\nPerl::Critic::Policy::logicLAB::RequireSheBang - simple policy for keeping your shebang line uniform\n\n# AFFILIATION\n\nThis policy is a policy in the Perl::Critic::logicLAB distribution. The policy\nis themed: logiclab.\n\n# VERSION\n\nThis documentation describes version 0.07.\n\n# DESCRIPTION\n\nThis policy is intended in guarding your use of the shebang line. It assists\nin making sure that your shebang line adheres to certain formats.\n\nThe default format is\n\n    #!/usr/local/bin/perl\n\nYou can however specify another or define your own in the configuration of the\npolicy.\n\n**NB** this policy does currently not warn about missing shebang lines, it only\nchecks shebang lines encountered.\n\n# CONFIGURATION AND ENVIRONMENT\n\nThis policy allow you to configure the contents of the shebang lines you\nwant to allow using [\"formats\"](#formats).\n\n## formats\n\n    [logicLAB::RequireSheBang]\n    formats = #!/usr/local/bin/perl || #!/usr/bin/perl || #!perl || #!env perl\n\nSince the default shebang line enforced by the policy is:\n\n    #!/usr/local/bin/perl\n\nPlease note that if you however what to extend the pattern, you also have\nto specify was is normally the default pattern since configuration\noverwrites the default even for extensions.\n\nThis mean that if you want to allow:\n\n    #!/usr/local/bin/perl\n\n    #!/usr/local/bin/perl -w\n\n    #!/usr/local/bin/perl -wT\n\nYour format should look like the following:\n\n    [logicLAB::RequireSheBang]\n    formats = #!/usr/local/bin/perl || #!/usr/local/bin/perl -w || #!/usr/local/bin/perl -wT\n\n## exempt\\_modules\n\nYou can specify if you want to check modules also. The default is to exempt from checking\nshebang lines in modules.\n\n    [logicLAB::RequireSheBang]\n    exempt_modules = 0\n\n## debug\n\nOptionally and for development purposes I have added a debug flag. This can be set in\nyour [Perl::Critic](https://metacpan.org/pod/Perl::Critic) configuration file as follows:\n\n    [logicLAB::RequireSheBang]\n    debug = 1\n\nThis enables more explicit output on what is going on during the actual processing of\nthe policy.\n\n# DEPENDENCIES AND REQUIREMENTS\n\n- [Perl::Critic](https://metacpan.org/pod/Perl::Critic)\n- [Perl::Critic::Utils](https://metacpan.org/pod/Perl::Critic::Utils)\n- [Readonly](https://metacpan.org/pod/Readonly)\n- [Test::More](https://metacpan.org/pod/Test::More)\n- [Test::Perl::Critic](https://metacpan.org/pod/Test::Perl::Critic)\n- [List::MoreUtils](https://metacpan.org/pod/List::MoreUtils)\n\n# INCOMPATIBILITIES\n\nThis distribution has no known incompatibilities.\n\n# BUGS AND LIMITATIONS\n\nThe distribution has now known bugs or limitations. It locates shebang lines\nthrough out the source code, not limiting itself to the first line. This might\nhowever change in the future, but will propably be made configurable if possible.\n\n# BUG REPORTING\n\nPlease use Request Tracker for bug reporting:\n\n- [http://rt.cpan.org/NoAuth/Bugs.html?Dist=Perl-Critic-logicLAB-RequireSheBang](http://rt.cpan.org/NoAuth/Bugs.html?Dist=Perl-Critic-logicLAB-RequireSheBang)\n\n# TEST AND QUALITY\n\nThe following policies have been disabled for this distribution\n\n- [Perl::Critic::Policy::ValuesAndExpressions::ProhibitConstantPragma](https://metacpan.org/pod/Perl::Critic::Policy::ValuesAndExpressions::ProhibitConstantPragma)\n\n    Constants are good, - see the link below.\n\n    - [https://logiclab.jira.com/wiki/display/OPEN/Perl-Critic-Policy-ValuesAndExpressions-ProhibitConstantPragma](https://logiclab.jira.com/wiki/display/OPEN/Perl-Critic-Policy-ValuesAndExpressions-ProhibitConstantPragma)\n\n- [Perl::Critic::Policy::NamingConventions::Capitalization](https://metacpan.org/pod/Perl::Critic::Policy::NamingConventions::Capitalization)\n- [Data::Dumper](https://metacpan.org/pod/Data::Dumper)\n\nSee also `t/perlcriticrc`\n\n## TEST COVERAGE\n\nCoverage test executed the following way, the coverage report is based on the\nversion described in this documentation (see [\"VERSION\"](#version)).\n\n    ./Build testcover\n\n    ---------------------------- ------ ------ ------ ------ ------ ------ ------\n    File                           stmt   bran   cond    sub    pod   time  total\n    ---------------------------- ------ ------ ------ ------ ------ ------ ------\n    ...ogicLAB/RequireSheBang.pm   70.4   64.3   44.4  100.0  100.0  100.0   72.1\n    Total                          70.4   64.3   44.4  100.0  100.0  100.0   72.1\n    ---------------------------- ------ ------ ------ ------ ------ ------ ------\n\n# SEE ALSO\n\n- [Perl::Critic](https://metacpan.org/pod/Perl::Critic)\n- [http://perldoc.perl.org/perlrun.html](http://perldoc.perl.org/perlrun.html)\n- [http://logiclab.jira.com/wiki/display/OPEN/Development#Development-MakeyourComponentsEnvironmentAgnostic](http://logiclab.jira.com/wiki/display/OPEN/Development#Development-MakeyourComponentsEnvironmentAgnostic)\n- [http://logiclab.jira.com/wiki/display/PCPLRSB/Home](http://logiclab.jira.com/wiki/display/PCPLRSB/Home)\n- [http://logiclab.jira.com/wiki/display/PCLL/Home](http://logiclab.jira.com/wiki/display/PCLL/Home)\n\n# AUTHOR\n\n- Jonas B. Nielsen, jonasbn `\u003cjonasbn@cpan.org\u003e`\n\n# ACKNOWLEDGEMENT\n\n- Erik Johansen (uniejo), feedback to version 0.01\n\n# LICENSE AND COPYRIGHT\n\nCopyright (c) 2011-2015 Jonas B. Nielsen, jonasbn. All rights reserved.\n\nPerl::Critic::Policy::logicLAB::RequireSheBang is released under\nthe Artistic License 2.0\n\nThe distribution is licensed under the Artistic License 2.0, as specified by\nthe license file included in this distribution.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjonasbn%2Fpcplrsb","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjonasbn%2Fpcplrsb","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjonasbn%2Fpcplrsb/lists"}