encommon 0.22.4__tar.gz → 0.22.5__tar.gz

{encommon-0.22.4/encommon.egg-info → encommon-0.22.5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.2
 Name: encommon
-Version: 0.22.4
+Version: 0.22.5
 Summary: Enasis Network Common Library
 License: MIT
 Project-URL: Source, https://github.com/enasisnetwork/encommon

{encommon-0.22.4 → encommon-0.22.5}/encommon/utils/__init__.py

@@ -7,6 +7,7 @@ is permitted, for more information consult the project license file.
 
 
 
+from .files import append_text
 from .files import read_text
 from .files import save_text
 from .match import fuzz_match
@@ -27,6 +28,7 @@ from .stdout import strip_ansi
 
 
 __all__ = [
+    'append_text',
     'array_ansi',
     'fuzz_match',
     'kvpair_ansi',

{encommon-0.22.4 → encommon-0.22.5}/encommon/utils/files.py

@@ -23,6 +23,8 @@ def read_text(
 
     Example
     -------
+    >>> path.exists()
+    False
     >>> save_text(path, 'foo')
     'foo'
     >>> read_text(path)
@@ -52,6 +54,8 @@ def save_text(
 
     Example
     -------
+    >>> path.exists()
+    False
     >>> save_text(path, 'foo')
     'foo'
     >>> read_text(path)
@@ -69,3 +73,38 @@ def save_text(
         encoding='utf-8')
 
     return read_text(path)
+
+
+
+def append_text(
+    path: str | Path,
+    content: str,
+) -> None:
+    """
+    Append the provided text content into provided file path.
+
+    .. testsetup::
+       >>> tmpdir = getfixture('tmpdir')
+       >>> path = Path(f'{tmpdir}/text.txt')
+
+    Example
+    -------
+    >>> path.exists()
+    False
+    >>> append_text(path, 'foo')
+    >>> append_text(path, 'foo')
+    >>> read_text(path)
+    'foofoo'
+
+    :param path: Complete or relative path to the text file.
+    :param content: Content that will be written to the file.
+    """
+
+    path = Path(path).resolve()
+
+    with path.open(
+        mode='a',
+        encoding='utf-8',
+    ) as file:
+
+        file.write(f'{content}')

{encommon-0.22.4 → encommon-0.22.5}/encommon/utils/test/test_files.py

@@ -9,6 +9,7 @@ is permitted, for more information consult the project license file.
 
 from pathlib import Path
 
+from ..files import append_text
 from ..files import read_text
 from ..files import save_text
 
@@ -33,3 +34,30 @@ def test_readsave_text(
         f'{tmp_path}/test.txt')
 
     assert loaded == content
+
+
+
+def test_append_text(
+    tmp_path: Path,
+) -> None:
+    """
+    Perform various tests associated with relevant routines.
+
+    :param tmp_path: pytest object for temporal filesystem.
+    """
+
+    content = 'pytest'
+
+    append_text(
+        f'{tmp_path}/test.txt',
+        content)
+
+    append_text(
+        f'{tmp_path}/test.txt',
+        content)
+
+    loaded = read_text(
+        f'{tmp_path}/test.txt')
+
+    assert loaded == (
+        f'{content}{content}')

encommon-0.22.5/encommon/version.txt

@@ -0,0 +1 @@
+0.22.5

{encommon-0.22.4 → encommon-0.22.5/encommon.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.2
 Name: encommon
-Version: 0.22.4
+Version: 0.22.5
 Summary: Enasis Network Common Library
 License: MIT
 Project-URL: Source, https://github.com/enasisnetwork/encommon

encommon-0.22.4/encommon/version.txt

@@ -1 +0,0 @@
-0.22.4