birdnotes.py: Objects to represent bird note files

Given a parent node, this method attaches sighting-notes content from the instance to that parent. See Section 15.7, “SightNotes.writeChild(): Attach narrative to a child”.

# - - -   S i g h t N o t e s . w r i t e N o d e

    def writeNode ( self, parent ):
        """Translate to XML.
        """
        #-- 1 --
        # [ if self.desc is not None ->
        #     parent  :=  parent with a new rnc.DESC_N child
        #                 attached containing self.desc
        #   else -> I ]
        self.writeChild ( parent, rnc.DESC_N, self.desc )

The other optional single items are handled similarly.

        #-- 2 --
        # [ simile ]
        self.writeChild ( parent, rnc.BEHAVIOR_N, self.behavior )

        #-- 3 --
        self.writeChild ( parent, rnc.VOC_N, self.voc )

        #-- 4  --
        self.writeChild ( parent, rnc.BREEDING_N, self.breeding )

There may be any number of photo children; see Section 16.3, “Photo.writeNode()”.

        #-- 5 --
        if  len(self.__photoList):
            for  photo in self.__photoList:
                photo.writeNode ( parent )

If the .notes attribute is not None, it contains a Narrative instance, which is added to the tree using Section 17.6, “Narrative.writeNode(): Write as XML”.

        #-- 6 --
        if  self.notes:
            self.notes.writeNode ( parent )