E.g. the module's top level code in some lib/Module.pm
And the code for any submodules that are really part of the module in the directory tree under lib/Module, e.g. lib/Module/SubModule.pm
So you cannot simply operate on one filesusem object for the module: e.g.g you cannot do:
mv lib/Module some-other-lib-path/Module
Instead, you must do
mv lib/Module.pm some-other-lib-path/Module.pmA minor difference, two commands rather than one, something that can odten be patched over by regexps.
mv lib/Module.pm some-other-lib-path/Module.pm
But an important difference: I would go so far as to say that the representation of Perl modules (classes) in the filesystem is not object oriented. I would say that one of the key characteristics of an object, in this class treating the code for a class as an object, is that it behaves like it is a single object, unless explicitly opened up to look inside.
---+ Bad Influence on Perl CPAN class structure
I think this decision, to have lib/Module.pm and lib/Module/SubModule.pm, has had a bad, or at least confusing, influence on CPAN's module structure.
Sometimes a CPAN module Foo::Bar (lib/Foo/Bar.pm) is actually a module completely unrelated[*] to module Foo (lib/Foo.pm). More confusing if module Foo actually has some internal modules Foo::Fu (lib/Foo/Fu.pm).
(Note *: OK, not "completely unrelated". How about "unrelated wrt code structure", or "related only by topic, but not actual code".)
Then there is no localization of Foo in the filesystem. Some parts of lib/Foo are part of module Foo, and some are not. And not everthing in module Foo is under lib/Foo.
I.e. the Perl CPAN filesystem structure sometimes reflects module structure, and sometimes it just reflects theme.
For this reason, I often make my modules appear as Foo::Foo, i.e. lib/Foo/Foo.pm.
But this can become tiresome. Tiresome. Repetitious. And it does not prevent somebody else from defining Foo::Bar, and wanting to live in the same directory tree (if not in separate PATH elements).
So I might try Topic::Long_Module_Name_Unlikely_To_Conflict::Short_Module_Name
Similarly, I might use a level of indirection to group internal submodules
use - perldoc.perl.org: <
require - perldoc.perl.org: <
'via Blog this'