Fix #55

Fix #54

Version 2.7.7

Author: hasii2011

albow/demo/screens/DemoTextFieldsScreen.py

@@ -43,7 +43,7 @@ def ok(cls):
         cls.resultLabel.text = "You are a %s called %s." % (cls.raceField.text, cls.nameField.text)
 
     @classmethod
-    def insertText(cls):
+    def appendText(cls):
 
         cls.lineCtr += 1
         line:     str = f"Line {cls.lineCtr}{TextBox.LINE_SEPARATOR}"
@@ -53,25 +53,37 @@ def insertText(cls):
         cls.textBox.setText(oldLines)
 
     @classmethod
-    def deleteText(cls):
+    def insertText(cls):
+        cls.lineCtr += 1
+        line: str = f'Line {cls.lineCtr}'
+        cls.textBox.insertText(theNewLine=line)
+
+    @classmethod
+    def clearText(cls):
 
         cls.textBox.clearText()
         cls.lineCtr = 0
 
+    @classmethod
+    def deleteText(cls):
+        cls.textBox.deleteText(2)
+
     @classmethod
     def makeTextBoxTesterContainer(cls) -> Row:
 
-        cls.textBox = TextBox(theNumberOfColumns=32, theNumberOfRows=6)
+        cls.textBox = TextBox(theNumberOfColumns=20, theNumberOfRows=10)
 
         checkBoxRow: Row = Row([CheckBox(), Label('Last Line Visible')])
 
-        insTextButton: Button = Button('Insert', action=cls.insertText)
-        delTextButton: Button = Button('Clear ',  action=cls.deleteText)
+        appendTextButton: Button = Button('Append', action=cls.appendText)
+        insertTextButton: Button = Button('Insert', action=cls.insertText)
+        deleteTextButton: Button = Button('Delete', action=cls.deleteText)
+        clearTextButton:  Button = Button('Clear ', action=cls.clearText)
 
         contentAttrs = {
             "align": "l"
         }
-        buttHolder:           Column = Column([insTextButton, delTextButton], **contentAttrs)
+        buttHolder:           Column = Column([appendTextButton, insertTextButton, deleteTextButton, clearTextButton], **contentAttrs)
         textBoxControlHolder: Column = Column([checkBoxRow,   buttHolder], **contentAttrs)
 
         container: Row = Row([cls.textBox, textBoxControlHolder])

albow/version.py

@@ -1 +1 @@
-version = '2.7.6'
+version = '2.7.7'

albow/widgets/Control.py

@@ -2,7 +2,7 @@
 from albow.utils import overridable_property
 
 
-class Control():
+class Control:
     """
     Control is a mixin class for use by widgets that display and/or edit a value of some kind. It provides a value
     property that can be linked, via a reference object, to a specific attribute or item of another object.

albow/widgets/TextBox.py

@@ -94,7 +94,13 @@ def getText(self):
         return self._text
 
     def setText(self, theNewText: str):
+        """
+        Replace the contents with this new text
+
+        Args:
+            theNewText:  The text that replaces what was in the widget
 
+        """
         lines = theNewText.strip().split(TextBox.LINE_SEPARATOR)
         self.lines = lines
         self.debugJustInserted = True
@@ -129,6 +135,37 @@ def addText(self, newText: str):
         oldLines += f"{newText}{TextBox.LINE_SEPARATOR}"
         self.setText(oldLines)
 
+    def insertText(self, theNewLine):
+        """
+
+        Args:
+            theNewLine:
+        """
+        oldLines: str = self.getText()
+        oldLines = f"{theNewLine}{TextBox.LINE_SEPARATOR}" + oldLines
+        self.setText(oldLines)
+
+    def deleteText(self, theLineNumber: int = 0):
+        """
+        Lines are defined as strings of text separated by `TextBox.LINE_SEPARATOR`
+        Can't delete any lines if widget is empty (operation is ignored)
+        Can't delete a line that does not exist (operation is ignored)
+
+        Args:
+            theLineNumber:  The line number to delete;  Defaults to the first line (numbered 0)
+        """
+        if len(self.getText()) > 0:
+            oldLines: str       = self.getText()
+            splits:   List[str] = oldLines.splitlines(True)
+            self.logger.info(f'splits: {splits}')
+
+            if len(splits) > theLineNumber:
+                del splits[theLineNumber]
+                newLines: str = ''.join(splits)
+                self.logger.info(f'newLines: {newLines}')
+
+                self.setText(newLines)
+
     def clearText(self):
         """
         Empties the text widget

setup.py

@@ -10,7 +10,7 @@
 
 setup(
     name="python3-albow",
-    version="2.7.6",
+    version="2.7.7",
     description="A Little Bit of Widgetry for PyGame",
     long_description=README,
     long_description_content_type="text/markdown",