https://github.com/perl-ide/perl-critic-policy-prohibitimplicitimport

https://github.com/perl-ide/perl-critic-policy-prohibitimplicitimport

Last synced: about 2 months ago
JSON representation

• Host: GitHub
• URL: https://github.com/perl-ide/perl-critic-policy-prohibitimplicitimport
• Owner: perl-ide
• License: other
• Created: 2020-11-18T16:25:35.000Z (about 4 years ago)
• Default Branch: main
• Last Pushed: 2021-06-16T17:50:19.000Z (over 3 years ago)
• Last Synced: 2024-04-15T00:16:45.755Z (9 months ago)
• Language: Perl
• Homepage:
• Size: 47.9 KB
• Stars: 1
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Changelog: Changes
  • License: LICENSE

Awesome Lists containing this project

README

        
[![Actions Status](https://github.com/oalders/Perl-Critic-Policy-ProhibitImplicitImport/workflows/dzil-build-and-test/badge.svg)](https://github.com/oalders/Perl-Critic-Policy-ProhibitImplicitImport/actions)

[![codecov](https://codecov.io/gh/oalders/Perl-Critic-Policy-ProhibitImplicitImport/branch/master/graph/badge.svg)](https://codecov.io/gh/oalders/Perl-Critic-Policy-ProhibitImplicitImport)

[![Kwalitee status](https://cpants.cpanauthors.org/dist/Perl-Critic-Policy-ProhibitImplicitImport.png)](https://cpants.cpanauthors.org/dist/Perl-Critic-Policy-ProhibitImplicitImport)

[![GitHub tag](https://img.shields.io/github/tag/oalders/Perl-Critic-Policy-ProhibitImplicitImport.svg)]()

[![Cpan license](https://img.shields.io/cpan/l/Perl-Critic-Policy-ProhibitImplicitImport.svg)](https://metacpan.org/release/Perl-Critic-Policy-ProhibitImplicitImport)

# NAME

Perl::Critic::Policy::ProhibitImplicitImport - Prefer symbol imports to be explicit

# VERSION

version 0.000001

# DESCRIPTION

Some Perl modules can implicitly import many symbols if no imports are

specified. To avoid this, and to assist in finding where symbols have been

imported from, specify the symbols you want to import explicitly in the `use`

statement.  Alternatively, specify an empty import list with `use Foo ()` to

avoid importing any symbols at all, and fully qualify the functions or

constants, such as `Foo::strftime`.

    use POSIX;                                                         # not ok

    use POSIX ();                                                      # ok

    use POSIX qw(fcntl);                                               # ok

    use POSIX qw(O_APPEND O_CREAT O_EXCL O_RDONLY O_RDWR O_WRONLY);    # ok

For modules which inherit from [Test::Builder::Module](https://metacpan.org/pod/Test%3A%3ABuilder%3A%3AModule), you may need to use a

different import syntax.

    use Test::JSON;                          # not ok

    use Test::JSON import => ['is_json'];    # ok

# CONFIGURATION

By default, this policy ignores many modules (like [Moo](https://metacpan.org/pod/Moo) and [Moose](https://metacpan.org/pod/Moose)) for

which implicit imports provide the expected behaviour. See the source of this

module for a complete list. If you would like to ignore additional modules,

this can be done via configuration:

    [ProhibitImplicitImport]

    ignored_modules = Git::Sub Regexp::Common

# ACKNOWLEDGEMENTS

Much of this code and even some documentation has been inspired by and borrowed

directly from [Perl::Critic::Policy::Freenode::POSIXImports](https://metacpan.org/pod/Perl%3A%3ACritic%3A%3APolicy%3A%3AFreenode%3A%3APOSIXImports) and

[Perl::Critic::Policy::TooMuchCode](https://metacpan.org/pod/Perl%3A%3ACritic%3A%3APolicy%3A%3ATooMuchCode).

# AUTHOR

Olaf Alders 

# COPYRIGHT AND LICENSE

This software is copyright (c) 2020 by Olaf Alders.

This is free software; you can redistribute it and/or modify it under

the same terms as the Perl 5 programming language system itself.