Fslib - compatibility module, use Treex::PML for new projects instead!

DEPRECATED!

This module is provided for backward compatibility only. Please use Treex::PML instead!

The module defines Fslib and FSFile (almost by importing/deriving from Treex::PML and Treex::PML::Document) and provides the following package aliasing:

    FSNode           => Treex::PML::Node
    FSFormat         => Treex::PML::FSFormat
    FSBackend        => Treex::PML::Backend::FS
    IOBackend        => Treex::PML::IO
    PMLBackend       => Treex::PML::Backend::PML
    PMLSchema        => Treex::PML::Schema
    PMLInstance      => Treex::PML::Instance

    Fslib::Struct    => Treex::PML::Struct
    Fslib::List      => Treex::PML::List
    Fslib::Alt       => Treex::PML::Alt
    Fslib::Seq       => Treex::PML::Seq
    Fslib::Container => Treex::PML::Container
    Fslib::Attribute => Treex::PML::Attribute

To force creation of objects from the old Fslib family of classes (left) rather than from the new Treex::PML family (right) in factory calls, set the environment variable FORCE_FS_CLASSES to 1 or call

	Fslib::Factory->make_default();

In order to port code using the old Fslib interfaces to Treex::PML, one has to do the following steps:

• Replace 'use Fslib' with 'use Treex::PML'.
• Replace 'use OldClass' with 'use NewClass' according to the package aliasing map given above.
• Replace all explicit calls to constructors with calls to the Treex::PML::Factory creators. Here are the rules:
  
  
  
  

    FSFile->newFSFile($filename,$enc,\@backends)
      --> Treex::PML::Factory->createDocumentFromFile($filename,{
            encoding=>$enc,
            backends=>\@backends
          })
  
  

  
  
  
  
  

    FSFile->load($filename,{...}) --> Treex::PML::Factory->createDocumentFromFile($filename,{encoding=>$enc,{...})
  
  

  
  
  
  
  

    FSFile->new() --> Treex::PML::Factory->createDocument()
  
  

  
  
  
  
  

    FSFile->create({...}) --> Treex::PML::Factory->createDocument({...})
  
  

  
  
  
  
  

    FSNode->new(...); $node->set_type($type)
       --> Treex::PML::Factory->createTypedNode($type,...)
  
  

  
  
  
  
  

    FSNode->new(...); $node->set_type_by_name($schema,$type_name);
       --> Treex::PML::Factory->createTypedNode($type_name,$schema,...)
  
  

  
  
  
  
  

    FSNode->new(...)
       --> Treex::PML::Factory->createNode(...)
  
  

  
  
  
  
  

    Fslib::Struct->new(...)
       --> Treex::PML::Factory->createStructure(...)
  
  

  
  
  
  
  

    Fslib::Seq->new(...)
       --> Treex::PML::Factory->createSeq(...)
  
  

  
  
  
  
  

    Fslib::Container->new(...)
       --> Treex::PML::Factory->createContainer(...)
  
  

  
  
  
  
  

    Fslib::List->new(@array)
       --> Treex::PML::Factory->createList(\@array)
       or
       --> Treex::PML::Factory->createList([@array],1)
  
  

  
  
  
  
  

    Fslib::List->new_from_ref($array_ref,$reuse)
       --> Treex::PML::Factory->createList($array_ref,$reuse)
  
  

  
  
  
  
  

    Fslib::Alt->new(@array)
       --> Treex::PML::Factory->createAlt(\@array)
       or
       --> Treex::PML::Factory->createAlt([@array],1)
  
  

  
  
  
  
  

    Fslib::Alt->new_from_ref($array_ref,$reuse)
       --> Treex::PML::Factory->createAlt($array_ref,$reuse)
  
  

  
  
  
  
  
  
  
  
  

    PMLInstance->new()
       --> Treex::PML::Factory->createPMLInstance(...)
  
  

  
  
  
  
  

    PMLInstance->load(...)
       --> Treex::PML::Factory->createPMLInstance(...)
  
  

  
  
  
  
  
  
  
  
  

    PMLSchema->new()
       --> Treex::PML::Factory->createPMLSchema(...)
  
  

  
  
  
  
  

    PMLSchema->load(...)
       --> Treex::PML::Factory->createPMLSchema(...)
  
  

  
  
  
  
  

    FSFormat->create(@header)
       --> Treex::PML::Factory->createFSFormat(\@header)
  
  

  
  
  
  
  

    FSFormat->new($hashRef)
       --> Treex::PML::Factory->createFSFormat($hashRef)
  
  

  
  
  
  
  

    FSFormat->readFrom(\@header)
       --> Treex::PML::Factory->createFSFormat(\@header)
  
  

  
  
  
  
  

    FSFormat->readFrom(FILEHANDLE)
       --> Treex::PML::Factory->createFSFormat(FILEHANDLE)
  
  

• Replace calls like:
  
  
  
  

    UNIVERSAL::isa($object,'OldClass')
    $object->isa($object,'OldClass')
    ref($object) eq 'OldClass'
  
  

  
  
  
  
  with
  
  
  
  

    Treex::PML::does($object,'NewClass');
  
  

  
  
  
  
  or
  
  
  
  

    use UNIVERSAL::DOES;
  
  

  
  
  
  
  

    UNIVERSAL::DOES::does($object,'NewClass');
  
  

• Replace calls to obsolete Fslib functions (possibly imported!) with the corresponding object method calls.
  
  
  
  This is how to rewrite the functions Fslib exported by default (note that they may appear unqualified in user code):
  
  
  
  

    Next($node)       --> $node->following
    Prev($node)       --> $node->previous
    DeleteLeaf($node) --> $node->destroy_leaf
    Cut($node)        --> $node->cut()
  
  

  
  
  
  
  This is how to rewrite calls to other Fslib functions (note that they may therefore appear unqualified in the user code if they were explicitly imported):
  
  
  
  

    Fslib::Paste($node,$parent,$ord)  --> $node->paste_on($parent,$ord)
    Fslib::Parent($node)              --> $node->parent
    Fslib::LBrother($node)            --> $node->lbrother
    Fslib::RBrother($node)            --> $node->rbrother
    Fslib::FirstSon($node)            --> $node->firstson
  
  

  
  
  
  
  The following functions should never be used in code ported to Treex::PML (use node methods paste_on(), paste_after(), and paste_before() instead):
  
  
  
  

    Fslib::SetParent($node,$parent)     --> DON'T USE, $node->set_parent($parent) if you must!
    Fslib::SetLBrother($node,$brother)  --> DON'T USE, $node->set_lbrother($brother) if you must!
    Fslib::SetRBrother($node,$brother)  --> DON'T USE, $node->set_rbrother($brother) if you must!
    Fslib::SetFirstSon($node,$son)      --> DON'T USE, $node->set_firstson($son) if you must!
  
  

  
  
  
  
  Although all these functions are also available in Treex::PML (implementing the rewritten version according to the above rules), none of them is exported by the Treex::PML module by default and it is recommended to avoid them.
• Replace remaining package function calls with new package function calls, i.e. rewrite
  
  
  
  

    OldClass::function(...);
  
  

  
  
  
  
  to
  
  
  
  

    NewClass::function(...);
  
  

  
  
  
  
  according to the aliasing map given above.

Treex::PML

Copyright (C) 2010 by Petr Pajas

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself, either Perl version 5.8.2 or, at your option, any later version of Perl 5 you may have available.

None reported... yet.