forked from pool/perl-namespace-clean
fix description
OBS-URL: https://build.opensuse.org/package/show/devel:languages:perl/perl-namespace-clean?expand=0&rev=6
This commit is contained in:
parent
10219f7ed5
commit
2ad2d62d84
@ -45,83 +45,16 @@ Requires: perl(vars)
|
|||||||
|
|
||||||
%description
|
%description
|
||||||
Keeping packages clean
|
Keeping packages clean
|
||||||
When you define a function, or import one, into a Perl package, it will
|
When you define a function, or import one, into a Perl package, it will
|
||||||
naturally also be available as a method. This does not per se cause
|
naturally also be available as a method. This does not per se cause
|
||||||
problems, but it can complicate subclassing and, for example, plugin
|
problems, but it can complicate subclassing and, for example, plugin
|
||||||
classes that are included via multiple inheritance by loading them as
|
classes that are included via multiple inheritance by loading them as
|
||||||
base classes.
|
base classes.
|
||||||
|
|
||||||
The 'namespace::clean' pragma will remove all previously declared or
|
The 'namespace::clean' pragma will remove all previously declared or
|
||||||
imported symbols at the end of the current package's compile cycle.
|
imported symbols at the end of the current package's compile cycle.
|
||||||
Functions called in the package itself will still be bound by their
|
Functions called in the package itself will still be bound by their
|
||||||
name, but they won't show up as methods on your class or instances.
|
name, but they won't show up as methods on your class or instances.
|
||||||
|
|
||||||
By unimporting via 'no' you can tell 'namespace::clean' to start
|
|
||||||
collecting functions for the next 'use namespace::clean;'
|
|
||||||
specification.
|
|
||||||
|
|
||||||
You can use the '-except' flag to tell 'namespace::clean' that you
|
|
||||||
don't want it to remove a certain function or method. A common use
|
|
||||||
would be a module exporting an 'import' method along with some
|
|
||||||
functions:
|
|
||||||
|
|
||||||
use ModuleExportingImport;
|
|
||||||
use namespace::clean -except => [qw( import )];
|
|
||||||
|
|
||||||
If you just want to '-except' a single sub, you can pass it directly.
|
|
||||||
For more than one value you have to use an array reference.
|
|
||||||
|
|
||||||
Explicitely removing functions when your scope is compiled
|
|
||||||
It is also possible to explicitely tell 'namespace::clean' what
|
|
||||||
packages to remove when the surrounding scope has finished compiling.
|
|
||||||
Here is an example:
|
|
||||||
|
|
||||||
package Foo;
|
|
||||||
use strict;
|
|
||||||
|
|
||||||
# blessed NOT available
|
|
||||||
|
|
||||||
sub my_class {
|
|
||||||
use Scalar::Util qw( blessed );
|
|
||||||
use namespace::clean qw( blessed );
|
|
||||||
|
|
||||||
# blessed available
|
|
||||||
return blessed shift;
|
|
||||||
}
|
|
||||||
|
|
||||||
# blessed NOT available
|
|
||||||
|
|
||||||
Moose
|
|
||||||
When using 'namespace::clean' together with the Moose manpage you want
|
|
||||||
to keep the installed 'meta' method. So your classes should look like:
|
|
||||||
|
|
||||||
package Foo;
|
|
||||||
use Moose;
|
|
||||||
use namespace::clean -except => 'meta';
|
|
||||||
...
|
|
||||||
|
|
||||||
Same goes for the Moose::Role manpage.
|
|
||||||
|
|
||||||
Cleaning other packages
|
|
||||||
You can tell 'namespace::clean' that you want to clean up another
|
|
||||||
package instead of the one importing. To do this you have to pass in
|
|
||||||
the '-cleanee' option like this:
|
|
||||||
|
|
||||||
package My::MooseX::namespace::clean;
|
|
||||||
use strict;
|
|
||||||
|
|
||||||
use namespace::clean (); # no cleanup, just load
|
|
||||||
|
|
||||||
sub import {
|
|
||||||
namespace::clean->import(
|
|
||||||
-cleanee => scalar(caller),
|
|
||||||
-except => 'meta',
|
|
||||||
);
|
|
||||||
}
|
|
||||||
|
|
||||||
If you don't care about 'namespace::clean's discover-and-'-except'
|
|
||||||
logic, and just want to remove subroutines, try the /clean_subroutines
|
|
||||||
manpage.
|
|
||||||
|
|
||||||
%prep
|
%prep
|
||||||
%setup -q -n %{cpan_name}-%{version}
|
%setup -q -n %{cpan_name}-%{version}
|
||||||
@ -139,7 +72,7 @@ Cleaning other packages
|
|||||||
%perl_gen_filelist
|
%perl_gen_filelist
|
||||||
|
|
||||||
%clean
|
%clean
|
||||||
%{__rm} -rf %{buildroot}
|
%{?buildroot:%__rm -rf "%{buildroot}"}
|
||||||
|
|
||||||
%files -f %{name}.files
|
%files -f %{name}.files
|
||||||
%defattr(644,root,root,755)
|
%defattr(644,root,root,755)
|
||||||
|
Loading…
Reference in New Issue
Block a user