libSBML Python API  5.18.0
libsbml.SBMLFileResolver Class Reference
Inheritance diagram for libsbml.SBMLFileResolver:
[legend]

Detailed Description

comp Resolves documents stored on a file system.

This class of objects is defined by libSBML only and has no direct equivalent in terms of SBML components. It is a class used in the implementation of extra functionality provided by libSBML.

In SBML, resolvers come into play with the SBML Level 3 Hierarchical Model Composition package (“comp”); this package includes features that allow a model to be composed from pieces that are external to a given SBML document, which implies the need to be able to identify and locate those external pieces. The identifiers used in “comp” are URIs (Uniform Resource Identifiers).

SBMLFileResolver is a class implementing the ability to resolve URIs to files. It works on the local file system only. It can resolve relative and absolute paths, and directories to be searched can be specified using the methodsSBMLFileResolver.addAdditionalDir() and SBMLFileResolver.clearAdditionalDirs().

See also
SBMLResolver
SBMLUri

Public Member Functions

def __init__ (self, args)
 This method has multiple variants; they differ in the arguments they accept. More...
 
def addAdditionalDir (self, dir)
 Adds a directory to the list of directories to search for files to resolve. More...
 
def clearAdditionalDirs (self)
 Removes the list of directories to search for files to resolve. More...
 
def clone (self)
 Creates and returns a deep copy of this SBMLFileResolver object. More...
 
def resolve (self, args)
 Resolves the document for the given URI. More...
 
def resolveUri (self, args)
 Resolves the full URI for a given URI without actually reading the document. More...
 

Constructor & Destructor Documentation

def libsbml.SBMLFileResolver.__init__ (   self,
  args 
)

This method has multiple variants; they differ in the arguments they accept.

__init__()   SBMLFileResolver
__init__(SBMLFileResolver c)   SBMLFileResolver

Each variant is described separately below.


Method variant with the following signature:
SBMLFileResolver(SBMLFileResolver c)

Copy constructor. Creates a copy of an SBMLFileResolver object.

Parameters
cthe SBMLFileResolver object to copy.

Method variant with the following signature:
SBMLFileResolver()

Creates a new SBMLFileResolver object.

Member Function Documentation

def libsbml.SBMLFileResolver.addAdditionalDir (   self,
  dir 
)

Adds a directory to the list of directories to search for files to resolve.

addAdditionalDir(string dir)
Parameters
dirthe directory to add.
See also
clearAdditionalDirs()
def libsbml.SBMLFileResolver.clearAdditionalDirs (   self)

Removes the list of directories to search for files to resolve.

clearAdditionalDirs()

After this method is called, SBMLFileResolver.resolve() will only search absolute or relative directories. New directories can be added using SBMLFileResolver.addAdditionalDir().

See also
addAdditionalDir()
def libsbml.SBMLFileResolver.clone (   self)

Creates and returns a deep copy of this SBMLFileResolver object.

clone()   SBMLFileResolver
Returns
a (deep) copy of this SBMLFileResolver object.
def libsbml.SBMLFileResolver.resolve (   self,
  args 
)

Resolves the document for the given URI.

resolve(string uri, string baseUri)   SBMLDocument
resolve(string uri)   SBMLDocument
Parameters
urithe URI to the target document.
baseUribase URI, in case the URI is a relative one.
Returns
the document, if this resolver can resolve the document or None.
def libsbml.SBMLFileResolver.resolveUri (   self,
  args 
)

Resolves the full URI for a given URI without actually reading the document.

resolveUri(string uri, string baseUri)   SBMLUri
resolveUri(string uri)   SBMLUri
Parameters
urithe URI to the target document.
baseUribase URI, in case the URI is a relative one.
Returns
the full URI to the document, if this resolver can resolve the document or None.