python.hanwriter.HanDir Class Reference

Inheritance diagram for python.hanwriter.HanDir:

Collaboration diagram for python.hanwriter.HanDir:

Public Member Functions
def	__init__ (self, name)
def	addSubDir (self, name)
def	addHistogram (self, histogram, algorithm, annotations={}, output=DQHanConfMaker._default_output, attributes={})
def	getSubDir (self, name)
def	tohan (self, encoding=None)
def	toprettyhan (self, indent="\t", newl="\n", encoding=None)
def	writehan (self, writer, indent="", addindent="", newl="")
def	appendChild (self, child)
def	setAttribute (self, key, attribute)
def	removeAttribute (self, key)
def	getAttribute (self, key)
def	getSubNode (self, name, nodetype)
def	__str__ (self)

Public Attributes
	acceptChild
	nodeType
	subnodes
	attributes
	name

Detailed Description

Class representing a dir element
A han dir element is a Node with sub nodes of type HanDir or HanHisto

Definition at line 384 of file hanwriter.py.

Constructor & Destructor Documentation

__init__()

def python.hanwriter.HanDir.__init__	(		self,
			name
	)

Creates a han directory element

Reimplemented from python.hanwriter.Node.

Reimplemented in python.hanwriter.Document.

Definition at line 392 of file hanwriter.py.

    def __init__(self, name):
        """
        Creates a han directory element
        """
        Node.__init__(self, name)
        self.acceptChild = [Node.DIR, Node.HIST]
        self.nodeType = Node.DIR
 

Member Function Documentation

__str__()

def python.hanwriter.Node.__str__ (   self )

inherited

Definition at line 192 of file hanwriter.py.

    def __str__(self):
        return "HanNode: "+self.name+" ("+DQHanConfMaker._get_NodeType(self.nodeType)+") Attributes:"+str(self.attributes)+" SubNodes: "+str(self.subnodes)
 
 
# HanHistogram class
# This class represents the configuration for a histogram

addHistogram()

def python.hanwriter.HanDir.addHistogram	(		self,
			histogram,
			algorithm,
			annotations = {},
			output = DQHanConfMaker._default_output,
			attributes = {}
	)

Adds to the directory a histogram specifying the histogram name, the algorithm and the output path.

Definition at line 418 of file hanwriter.py.

    def addHistogram(self, histogram, algorithm, annotations={}, output=DQHanConfMaker._default_output, attributes={}):
        """
        Adds to the directory a histogram specifying the histogram name, the algorithm and the output path.
        """
        histo = HanHistogram(histogram, algorithm,
                             annotations, output, attributes)
        self.appendChild(histo)
        return histo

addSubDir()

def python.hanwriter.HanDir.addSubDir	(		self,
			name
	)

Adds a subdirectory called name to the current directory and returns the newly created sub directory

Definition at line 403 of file hanwriter.py.

    def addSubDir(self, name):
        """
        Adds a subdirectory called name to the current directory and returns the newly created sub directory
        """
        subdir = HanDir(name)
        self.appendChild(subdir)
        return subdir

appendChild()

def python.hanwriter.Node.appendChild (   self,   child  )

inherited

Add a sub node to this node

Definition at line 128 of file hanwriter.py.

    def appendChild(self, child):
        """
        Add a sub node to this node
        """
        try:
            if child.nodeType not in self.acceptChild:
                msg = " Node: "+DQHanConfMaker._get_NodeType(self.nodeType)
                msg += " Cannot have a child of type:", child.nodeType
                raise HanCannotCreateConf(msg)
        except Exception:
            raise HanCannotCreateConf(
                "Object:"+str(child)+" is not a valid Node")
        if not self.subnodes:
            self.subnodes = []
        self.subnodes += [child]
 

getAttribute()

def python.hanwriter.Node.getAttribute (   self,   key  )

inherited

Gets the attribute identified by the key, None if not found

Definition at line 170 of file hanwriter.py.

    def getAttribute(self, key):
        """
        Gets the attribute identified by the key, None if not found
        """
        if self.attributes and key in self.attributes:
            return self.attributes[key]
        return None

getSubDir()

def python.hanwriter.HanDir.getSubDir	(		self,
			name
	)

returns the sub-directory called name

Definition at line 429 of file hanwriter.py.

    def getSubDir(self, name):
        """
        returns the sub-directory called name
        """
        return self.getSubNode(name, Node.DIR)
 
# Class for han output
# This class implements the han output
 
 

getSubNode()

def python.hanwriter.Node.getSubNode (   self,   name,   nodetype  )

inherited

Returns the sub-node identified by name and nodetype

Definition at line 182 of file hanwriter.py.

    def getSubNode(self, name, nodetype):
        """
        Returns the sub-node identified by name and nodetype
        """
        if self.subnodes:
            for sn in self.subnodes:
                if sn.nodeType == nodetype and sn.name == name:
                    return sn
        return None
 

removeAttribute()

def python.hanwriter.Node.removeAttribute (   self,   key  )

inherited

Removes attribute identified by key

Definition at line 158 of file hanwriter.py.

    def removeAttribute(self, key):
        """
        Removes attribute identified by key
        """
        if self.attributes and key in self.attributes:
            del self.attributes[key]
            return True
        return False

setAttribute()

def python.hanwriter.Node.setAttribute (   self,   key,   attribute  )

inherited

The attribute identified by key is added to this node

Definition at line 147 of file hanwriter.py.

    def setAttribute(self, key, attribute):
        """
        The attribute identified by key is added to this node
        """
        if not self.attributes:
            self.attributes = {}
        self.attributes[key] = attribute

tohan()

def python.hanwriter.Node.tohan (   self,   encoding = None  )

inherited

convert the object in a valid han script block

Definition at line 76 of file hanwriter.py.

    def tohan(self, encoding=None):
        """
        convert the object in a valid han script block
        """
        return self.toprettyhan("", "", encoding)
 

toprettyhan()

def python.hanwriter.Node.toprettyhan (   self,   indent = "\t",   newl = "\n",   encoding = None  )

inherited

convert the object in a formatted han string

Definition at line 87 of file hanwriter.py.

    def toprettyhan(self, indent="\t", newl="\n", encoding=None):
        """
        convert the object in a formatted han string
        """
        # restore the following in a future tdaq release
        # writer = DQHanConfMaker._get_StringIO()
        import io
        import six
        writer = io.BytesIO() if six.PY2 else io.StringIO()
        if encoding is not None:
            import codecs
            writer = codecs.lookup(encoding)[3](writer)
        self.writehan(writer, "", indent, newl)
        return writer.getvalue()
 

writehan()

def python.hanwriter.Node.writehan (   self,   writer,   indent = "",   addindent = "",   newl = ""  )

inherited

Converts the object in a han string and writes it in the writer object

Definition at line 107 of file hanwriter.py.

    def writehan(self, writer, indent="", addindent="", newl=""):
        """
        Converts the object in a han string and writes it in the writer object
        """
        writer.write(
            indent+DQHanConfMaker._get_NodeType(self.nodeType)+" "+self.name)
        # if it is a document do not need to add { }
        if self.nodeType != Node.DOCUMENT:
            writer.write(" { %s" % (newl))
        if self.attributes:
            for key, attribute in self.attributes.items():
                writer.write("%s %s = %s%s" % (indent, key, attribute, newl))
        if self.subnodes:
            for node in self.subnodes:
                node.writehan(writer, indent+addindent, addindent, newl)
        if self.nodeType != Node.DOCUMENT:
            writer.write("%s}%s" % (indent, newl))
 

Member Data Documentation

acceptChild

python.hanwriter.HanDir.acceptChild

Definition at line 397 of file hanwriter.py.

attributes

python.hanwriter.Node.attributes

inherited

Definition at line 67 of file hanwriter.py.

name

python.hanwriter.Node.name

inherited

Definition at line 71 of file hanwriter.py.

nodeType

python.hanwriter.HanDir.nodeType

Definition at line 398 of file hanwriter.py.

subnodes

python.hanwriter.Node.subnodes

inherited

Definition at line 66 of file hanwriter.py.

---

The documentation for this class was generated from the following file:

• hanwriter.py