rename( ppi => PPI::Document $ppi, filename => Str ) =item rename( code => Str $code, filename => Str )
Accepts either a PPI::Document to process or a string containing
the code (which will be converted into a PPI::Document) to process.
Replaces the package name with that supplied in the filename
parameter and returns a PPIx::EditorTools::ReturnObject with the
new code available via the ppi or code accessors, as a
PPI::Document or string, respectively.
An attempt will be made to derive the package name from the filename passed
as a parameter. The filenames path will converted to an absolute path and
it will be searched for a lib directory which will be assumed the start
of the package name. If no lib directory can be found in the absolute
path, the relative path will be used.
Croaks with a package name not found exception if unable to find the