text: added CT_jc and CT_textDirection

added CT_jc and CT_textDirection functions and got them working.

Author: onlyjus

docx/oxml/__init__.py

@@ -12,7 +12,7 @@
 # custom element class mappings
 # ===========================================================================
 
-from docx.oxml.shared import CT_DecimalNumber, CT_OnOff, CT_String, CT_Shading
+from docx.oxml.shared import CT_DecimalNumber, CT_OnOff, CT_String, CT_Shd
 
 from docx.oxml.shape import (
     CT_Blip, CT_BlipFillProperties, CT_GraphicalObject,
@@ -54,7 +54,7 @@
 register_custom_element_class('w:tr', CT_Row)
 register_custom_element_class('w:tcPr', CT_TcPr)
 register_custom_element_class('w:gridSpan', CT_DecimalNumber)
-register_custom_element_class('w:shd', CT_Shading)
+register_custom_element_class('w:shd', CT_Shd)
 
 from docx.oxml.text import CT_Br, CT_P, CT_PPr, CT_R, CT_RPr, CT_Text
 register_custom_element_class('w:b', CT_OnOff)

docx/oxml/shared.py

@@ -341,6 +341,115 @@ def val(self):
     def val(self, val):
         return self.set(qn('w:val'), val)
 
+class CT_Ind(OxmlBaseElement):
+    @classmethod
+    def new(cls, nsptagname, valDict):
+        """
+        Return a new ``CT_Ind`` element with tagname *nsptagname* and
+        attributes set by key, value pairs in  *valDict*.
+        """
+        attrsDict = {}
+        for k, v in valDict.iteritems():
+            attrsDict[qn('w:'+str(k))] = v
+        return OxmlElement(nsptagname, attrs=attrsDict)
+        
+    @property
+    def valDict(self):
+        valDict={}
+        for val in ['start','startChars','end','endChars','left','leftChars',
+                    'right','rightChars','hanging','hangingChars','firstLine',
+                    'firstLineChars']:
+            valDict[val] = self.get(qn('w:'+val))
+        return valDict
+    @valDict.setter
+    def valDict(self, valDict):
+        for k, v in valDict:
+            self.set(qn('w:'+str(k)), v)
+        return
+        
+    @property
+    def start(self):
+        return self.get(qn('w:start'))
+    @start.setter
+    def start(self, start):
+        return self.set(qn('w:start'), start)
+        
+    @property
+    def startChars(self):
+        return self.get(qn('w:startChars'))
+    @startChars.setter
+    def startChars(self, startChars):
+        return self.set(qn('w:startChars'), startChars)
+        
+    @property
+    def end(self):
+        return self.get(qn('w:end'))
+    @end.setter
+    def end(self, end):
+        return self.set(qn('w:end'), end)
+        
+    @property
+    def endChars(self):
+        return self.get(qn('w:endChars'))
+    @endChars.setter
+    def endChars(self, endChars):
+        return self.set(qn('w:endChars'), endChars)
+        
+    @property
+    def left(self):
+        return self.get(qn('w:left'))
+    @left.setter
+    def left(self, left):
+        return self.set(qn('w:left'), left)
+        
+    @property
+    def leftChars(self):
+        return self.get(qn('w:leftChars'))
+    @leftChars.setter
+    def leftChars(self, leftChars):
+        return self.set(qn('w:leftChars'), leftChars)
+    
+    @property
+    def right(self):
+        return self.get(qn('w:right'))
+    @right.setter
+    def right(self, right):
+        return self.set(qn('w:right'), right)
+        
+    @property
+    def rightChars(self):
+        return self.get(qn('w:rightChars'))
+    @rightChars.setter
+    def rightChars(self, rightChars):
+        return self.set(qn('w:rightChars'), rightChars)
+    
+    @property
+    def hanging(self):
+        return self.get(qn('w:hanging'))
+    @hanging.setter
+    def hanging(self, hanging):
+        return self.set(qn('w:hanging'), hanging)
+        
+    @property
+    def hangingChars(self):
+        return self.get(qn('w:hangingChars'))
+    @hangingChars.setter
+    def hangingChars(self, hangingChars):
+        return self.set(qn('w:hangingChars'), hangingChars)
+        
+    @property
+    def firstLine(self):
+        return self.get(qn('w:firstLine'))
+    @firstLine.setter
+    def firstLine(self, firstLine):
+        return self.set(qn('w:firstLine'), firstLine)
+        
+    @property
+    def firstLineChars(self):
+        return self.get(qn('w:firstLineChars'))
+    @firstLineChars.setter
+    def firstLineChars(self, firstLineChars):
+        return self.set(qn('w:firstLineChars'), firstLineChars)
 
 class CT_Shd(OxmlBaseElement):
     @classmethod

docx/oxml/text.py

@@ -7,7 +7,8 @@
 
 from docx.oxml.parts.numbering import CT_NumPr
 from docx.oxml.shared import (
-    CT_String, nsdecls, OxmlBaseElement, OxmlElement, oxml_fromstring, qn
+    CT_String,
+    nsdecls, OxmlBaseElement, OxmlElement, oxml_fromstring, qn
 )
 from docx.enum.text import WD_UNDERLINE
 
@@ -102,6 +103,46 @@ def style(self, style):
         """
         pPr = self.get_or_add_pPr()
         pPr.style = style
+        
+    @property
+    def jc(self):
+        """
+        String contained in w:val attribute of <w:pPr><w:jc> child, or
+        None if that element is not present.
+        """
+        pPr = self.pPr
+        if pPr is None:
+            return None
+        return pPr.jc
+
+    @jc.setter
+    def jc(self, jc):
+        """
+        Set style of this <w:p> element to *jc*. If *jc* is None,
+        remove the style element.
+        """
+        pPr = self.get_or_add_pPr()
+        pPr.jc = jc
+        
+    @property
+    def textDirection(self):
+        """
+        String contained in w:val attribute of <w:pPr><w:textDirection> child,
+        or None if that element is not present.
+        """
+        pPr = self.pPr
+        if pPr is None:
+            return None
+        return pPr.textdirection
+
+    @textDirection.setter
+    def textDirection(self, textdirection):
+        """
+        Set style of this <w:p> element to *style*. If *style* is None,
+        remove the style element.
+        """
+        pPr = self.get_or_add_pPr()
+        pPr.textdirection = textdirection
 
     def _add_pPr(self):
         """
@@ -133,6 +174,15 @@ def get_or_add_pStyle(self):
         if pStyle is None:
             pStyle = self._add_pStyle()
         return pStyle
+        
+    def get_or_add_textDirectionElement(self):
+        """
+        Return the textDirection child element, newly added if not present.
+        """
+        textDirection = self.textDirection
+        if textDirection is None:
+            textDirection = self._add_textDirection()
+        return textDirection
 
     @staticmethod
     def new():
@@ -186,6 +236,80 @@ def style(self, style):
             self._add_pStyle(style)
         else:
             self.pStyle.val = style
+            
+    @property
+    def jcElement(self):
+        """
+        ``<w:jc>`` child element or None if not present.
+        """
+        return self.find(qn('w:jc'))
+        
+    def remove_jcElement(self):
+        jcElement = self.jcElement
+        if jcElement is not None:
+            self.remove(jcElement)
+            
+    @property
+    def jc(self):
+        """
+        String contained in <w:jc> child, or None if that element is
+        not present.
+        """
+        jc = self.jcElement
+        if jc is None:
+            return None
+        return jc.get(qn('w:val'))
+        
+    @jc.setter
+    def jc(self, jc):
+        """
+        Set val attribute of <w:jc> child element to *jc*, adding a
+        new element if necessary. If *jc* is |None|, remove the <w:jc>
+        element if present.
+        """
+        if jc is None:
+            self.remove_jcDirection()
+        elif self.jcElement is None:
+            self._add_jcElement(jc)
+        else:
+            self.jcElement.val = jc
+            
+    @property
+    def textDirectionElement(self):
+        """
+        ``<w:pStyle>`` child element or None if not present.
+        """
+        return self.find(qn('w:textDirection'))
+        
+    def remove_textDirectionElement(self):
+        textDirectionElement = self.textDirectionElement
+        if textDirectionElement is not None:
+            self.remove(textDirectionElement)
+            
+    @property
+    def textDirection(self):
+        """
+        String contained in <w:textDirection> child, or None if that element is
+        not present.
+        """
+        textDirection = self.textDirectionElement
+        if textDirection is None:
+            return None
+        return textDirection.get(qn('w:val'))
+        
+    @textDirection.setter
+    def textDirection(self, textDirection):
+        """
+        Set val attribute of <w:textDirection> child element to
+        *textDirection*, adding a new element if necessary. If *textDirection*
+        is |None|, remove the <w:textDirection> element if present.
+        """
+        if textDirection is None:
+            self.remove_textDirectionElement()
+        elif self.textDirectionElement is None:
+            self._add_textDirectionElement(textDirection)
+        else:
+            self.textDirectionElement.val = textDirection
 
     def _add_numPr(self):
         numPr = CT_NumPr.new()
@@ -194,6 +318,14 @@ def _add_numPr(self):
     def _add_pStyle(self, style):
         pStyle = CT_String.new_pStyle(style)
         return self._insert_pStyle(pStyle)
+        
+    def _add_jcElement(self, jc):
+        jcElement = CT_String.new('w:jc', jc)
+        return self._insert_jcElement(jcElement)
+        
+    def _add_textDirectionElement(self, textDirection):
+        textDirectionElement = CT_String.new('w:textDirection', textDirection)
+        return self._insert_textDirectionElement(textDirectionElement)
 
     def _insert_numPr(self, numPr):
         return self.insert_element_before(
@@ -210,7 +342,20 @@ def _insert_numPr(self, numPr):
     def _insert_pStyle(self, pStyle):
         self.insert(0, pStyle)
         return pStyle
-
+        
+    def _insert_jcElement(self, jc):
+        return self.insert_element_before(
+            jc, 'w:textDirection', 'w:textAlignment', 'w:textboxTightWrap',
+            'w:outlineLvl', 'w:divId', 'w:cnfStyle', 'w:rPr', 'w:sectPr',
+            'w:pPrChange'
+        )        
+        
+    def _insert_textDirectionElement(self, textDirection):
+        return self.insert_element_before(
+            textDirection, 'w:textAlignment', 'w:textboxTightWrap',
+            'w:outlineLvl', 'w:divId', 'w:cnfStyle', 'w:rPr', 'w:sectPr',
+            'w:pPrChange'
+        )
 
 class CT_R(OxmlBaseElement):
     """

docx/text.py

@@ -87,6 +87,18 @@ def style(self):
     @style.setter
     def style(self, style):
         self._p.style = None if style == 'Normal' else style
+        
+    @property
+    def jc(self):
+        """
+        Justification for this paragraph. Read/Write.
+        """
+        jc = self._p.jc
+        return jc if jc is not None else 'start'
+
+    @jc.setter
+    def jc(self, jc):
+        self._p.jc = jc
 
     @property
     def text(self):