borg-space 2.2__tar.gz → 2.3__tar.gz

borg_space-2.2/README.rst → borg_space-2.3/PKG-INFO

@@ -1,3 +1,31 @@
+Metadata-Version: 2.4
+Name: borg_space
+Version: 2.3
+Summary: Accessory for Emborg used to report and track the size of your Borg repositories
+Keywords: emborg,borg,backups
+Author-email: Ken Kundert <borg-space@nurdletech.com>
+Requires-Python: >=3.6
+Description-Content-Type: text/x-rst
+Classifier: License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)
+Classifier: Natural Language :: English
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Utilities
+License-File: LICENSE
+Requires-Dist: appdirs
+Requires-Dist: arrow
+Requires-Dist: docopt
+Requires-Dist: inform>=1.34
+Requires-Dist: matplotlib
+Requires-Dist: nestedtext
+Requires-Dist: quantiphy
+Requires-Dist: shlib
+Requires-Dist: voluptuous>=0.14
+Project-URL: changelog, https://github.com/KenKundert/ntlog/blob/master/CHANGELOG.rst
+Project-URL: documentation, https://github.com/KenKundert/borg-space/blob/master/README.rst
+Project-URL: homepage, https://github.com/kenkundert/borg-space
+Project-URL: repository, https://github.com/kenkundert/borg-space
+
 Borg-Space — Report and track the size of your Emborg repositories
 ==================================================================
 
@@ -11,8 +39,8 @@ Borg-Space — Report and track the size of your Emborg repositories
     :target: https://pypi.python.org/pypi/borg-space/
 
 :Author: Ken Kundert
-:Version: 2.2
-:Released: 2023-06-12
+:Version: 2.3
+:Released: 2025-05-11
 
 *Borg-Space* is an accessory for Emborg_.  It reports on the space consumed by 
 your *BorgBackup* repositories.  You can get this information using the
@@ -32,6 +60,10 @@ To show the size of one or more repositories, simply run::
     # borg-space home
     home: 12.81 GB
 
+This reports on the latest repository size and, of course, assumes that you have 
+already run *emborg create*.  You must not use the ``--fast`` command line 
+option when running *create*.
+
 You can specify any number of repositories, and they can be composites.  In the 
 following example, *home* is an alias that expands to *borgbase* and *rsync*::
 
@@ -317,7 +349,28 @@ Install with::
     > pip3 install borg-space
 
 
+Borg 2
+------
+
+Borg_ 2 will be released soon, and with it will come Assimilate_, the next 
+generation of Emborg_.  *Assimilate* is intended to be used with *Borg 2.0* and 
+beyond while *Emborg* would be used with older versions of *Borg*.  Currently 
+*Borg-Space* does not support *Assimilate* directly, but the *latest.nt* files 
+produced by *Assimilate* are compatible with *Borg-Space*, only their location 
+differs.  You can get the current version of *Borg-Space* to read *Assimilate* 
+*latest.nt* files by simply creating a symbolic link from the expected location 
+to the actual location.  For example, if you convert your *home* repository from 
+*Emborg* to *Assimilate*, you can use the following commands to get *Borg-Space* 
+to use the *latest.nt* file produced by *Assimilate*::
+
+    cd ~/.local/share/emborg
+    rm home.latest.nt
+    ln -s ../assimilate/home.latest.nt .
+
+.. _assimilate: https://assimilate.readthedocs.io
+.. _borg: https://borgbackup.readthedocs.io
 .. _emborg: https://emborg.readthedocs.io
 .. _nestedtext: https://nestedtext.org
 .. _arrow: https://arrow.readthedocs.io/en/latest/guide.html#supported-tokens
 .. _quantiphy: https://quantiphy.readthedocs.io/en/stable/api.html#quantiphy.Quantity.format
+

borg_space-2.2/PKG-INFO → borg_space-2.3/README.rst

@@ -1,30 +1,3 @@
-Metadata-Version: 2.1
-Name: borg_space
-Version: 2.2
-Summary: Accessory for Emborg used to report and track the size of your Borg repositories
-Keywords: emborg,borg,backups
-Author-email: Ken Kundert <emborg@nurdletech.com>
-Requires-Python: >=3.6
-Description-Content-Type: text/x-rst
-Classifier: License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)
-Classifier: Natural Language :: English
-Classifier: Operating System :: POSIX :: Linux
-Classifier: Programming Language :: Python :: 3
-Classifier: Topic :: Utilities
-Requires-Dist: appdirs
-Requires-Dist: arrow
-Requires-Dist: docopt
-Requires-Dist: inform
-Requires-Dist: matplotlib
-Requires-Dist: nestedtext
-Requires-Dist: quantiphy
-Requires-Dist: shlib
-Requires-Dist: voluptuous
-Project-URL: changelog, https://github.com/KenKundert/ntlog/blob/master/CHANGELOG.rst
-Project-URL: documentation, https://github.com/KenKundert/borg-space/blob/master/README.rst
-Project-URL: homepage, https://github.com/kenkundert/borg-space
-Project-URL: repository, https://github.com/kenkundert/borg-space
-
 Borg-Space — Report and track the size of your Emborg repositories
 ==================================================================
 
@@ -38,8 +11,8 @@ Borg-Space — Report and track the size of your Emborg repositories
     :target: https://pypi.python.org/pypi/borg-space/
 
 :Author: Ken Kundert
-:Version: 2.2
-:Released: 2023-06-12
+:Version: 2.3
+:Released: 2025-05-11
 
 *Borg-Space* is an accessory for Emborg_.  It reports on the space consumed by 
 your *BorgBackup* repositories.  You can get this information using the
@@ -59,6 +32,10 @@ To show the size of one or more repositories, simply run::
     # borg-space home
     home: 12.81 GB
 
+This reports on the latest repository size and, of course, assumes that you have 
+already run *emborg create*.  You must not use the ``--fast`` command line 
+option when running *create*.
+
 You can specify any number of repositories, and they can be composites.  In the 
 following example, *home* is an alias that expands to *borgbase* and *rsync*::
 
@@ -344,8 +321,27 @@ Install with::
     > pip3 install borg-space
 
 
+Borg 2
+------
+
+Borg_ 2 will be released soon, and with it will come Assimilate_, the next 
+generation of Emborg_.  *Assimilate* is intended to be used with *Borg 2.0* and 
+beyond while *Emborg* would be used with older versions of *Borg*.  Currently 
+*Borg-Space* does not support *Assimilate* directly, but the *latest.nt* files 
+produced by *Assimilate* are compatible with *Borg-Space*, only their location 
+differs.  You can get the current version of *Borg-Space* to read *Assimilate* 
+*latest.nt* files by simply creating a symbolic link from the expected location 
+to the actual location.  For example, if you convert your *home* repository from 
+*Emborg* to *Assimilate*, you can use the following commands to get *Borg-Space* 
+to use the *latest.nt* file produced by *Assimilate*::
+
+    cd ~/.local/share/emborg
+    rm home.latest.nt
+    ln -s ../assimilate/home.latest.nt .
+
+.. _assimilate: https://assimilate.readthedocs.io
+.. _borg: https://borgbackup.readthedocs.io
 .. _emborg: https://emborg.readthedocs.io
 .. _nestedtext: https://nestedtext.org
 .. _arrow: https://arrow.readthedocs.io/en/latest/guide.html#supported-tokens
 .. _quantiphy: https://quantiphy.readthedocs.io/en/stable/api.html#quantiphy.Quantity.format
-

{borg_space-2.2 → borg_space-2.3}/borg_space/config.py

@@ -113,7 +113,7 @@ class Repository:
         raw_data = nt.loads(content)
         self.latest = data = {}
         if 'repository size' in raw_data:
-            data['size'] = Quantity(raw_data['repository size'], 'B')
+            data['size'] = Quantity(raw_data['repository size'], 'B', binary=True)
         if 'create last run' in raw_data:
             data['last_create'] = arrow.get(raw_data['create last run'])
         if 'prune last run' in raw_data:

{borg_space-2.2 → borg_space-2.3}/borg_space/main.py

@@ -32,11 +32,10 @@ Settings are held in ~/.config/borg-space/settings.nt.
 
 # imports {{{1
 from .config import settings, get_repos
-from .trees import tree
 import arrow
 from appdirs import user_data_dir
 from docopt import docopt
-from inform import Error, display, error, os_error, terminate, warn
+from inform import Error, display, error, os_error, terminate, warn, tree
 from pathlib import Path
 from quantiphy import Quantity
 import json
@@ -45,13 +44,15 @@ import matplotlib
 import matplotlib.pyplot as plt
 from matplotlib.dates import AutoDateFormatter, AutoDateLocator
 from matplotlib.ticker import FuncFormatter
+# from labellines import labelLines
+
 
 # globals {{{1
 data_dir = Path(user_data_dir('borg-space'))
 now = str(arrow.now())
 Quantity.set_prefs(prec='full')
-__version__ = "2.2"
-__released__ = "2023-06-12"
+__version__ = "2.3"
+__released__ = "2025-05-11"
 date_format = settings.get('date_format', 'D MMMM YYYY')
 size_format = settings.get('size_format', '.2b')
 nestedtext_size_format = settings.get('nestedtext_size_format', size_format)
@@ -174,6 +175,7 @@ def generate_graph(repos, svg_file, log_scale):
 
     # draw the graph {{{3
     ax.legend(loc='upper left')
+    # labelLines(ax.get_lines())
     if svg_file:
         plt.savefig(svg_file)
     else:
@@ -269,7 +271,7 @@ def print_tree_report(repos):
                 fmt = formatter,
                 fields = fields,
                 missing = not_available,
-            )
+            ), squeeze=True
         )
     )
 

{borg_space-2.2 → borg_space-2.3}/pyproject.toml

@@ -1,13 +1,13 @@
 [project]
 name = "borg_space"
 dist-name = "borg-space"
-version = "2.2"
+version = "2.3"
 description = "Accessory for Emborg used to report and track the size of your Borg repositories"
 readme = "README.rst"
 requires-python = ">=3.6"
 license = {file = "LICENSE"}
 keywords = ["emborg", "borg", "backups"]
-authors = [{name = "Ken Kundert", email = "emborg@nurdletech.com"}]
+authors = [{name = "Ken Kundert", email = "borg-space@nurdletech.com"}]
 classifiers = [
     "License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)",
     "Natural Language :: English",
@@ -19,12 +19,13 @@ dependencies = [
     "appdirs",
     "arrow",
     "docopt",
-    "inform",
+    "inform>=1.34",
     "matplotlib",
+    # "matplotlib-label-lines",
     "nestedtext",
     "quantiphy",
     "shlib",
-    "voluptuous",
+    "voluptuous>=0.14",
 ]
 
 [project.urls]

borg_space-2.2/borg_space/trees.py

@@ -1,94 +0,0 @@
-# Format a Tree
-# Description {{{1
-# Given a data hierarchy consisting of zero or more levels of dictionaries with 
-# lists as leaf values, where each dictionary key and list value is a string, 
-# this function creates a Unicode diagram of that tree.
-#
-# For example, here is a filesystem sub-hierarchy:
-#
-#     tests/
-#     ├── examples/
-#     │   ├── test_example_01.py
-#     │   ├── test_example_02.py
-#     │   └── test_example_03.py
-#     ├── foobar/
-#     │   ├── test_foobar_01.py
-#     │   ├── test_foobar_02.py
-#     │   └── test_foobar_03.py
-#     └── hello/
-#         └── world/
-#             ├── test_world_01.py
-#             ├── test_world_02.py
-#             └── test_world_03.py
-
-# Imports {{{1
-from inform import Info, conjoin, is_collection
-
-def gen_connectors(width):
-    space = " "     # This is a non-breaking space, needed with variable width fonts
-    line = "─"      # This is horizontal rule
-    connector_seeds = dict(
-        item = "├",
-        last_item = "└",
-        lead = "│",
-        last_lead = space,
-    )
-    pad = space if width > 1 else ''
-
-    def extend(seed):
-        fill = space if seed in [space, "│"] else line
-        return seed + (width - 2)*fill + pad
-
-    return Info(**{k: extend(v) for k, v in connector_seeds.items()})
-
-connectors = gen_connectors(4)
-
-def tree(data, key_suffix=''):
-    return _tree(data, key_suffix, top=True)
-
-def _tree(data, key_suffix, top=False, leader=''):
-    lines = []
-    if hasattr(data, 'items'):
-        last = len(data) - 1
-        for i, item in enumerate(data.items()):
-            key, value = item
-            # determine key-leader-supplement and item-leader-supplement
-            if top:
-                kls = ''
-                ils = ''
-            elif i < last:
-                kls = connectors.item
-                ils = connectors.lead
-            else:
-                kls = connectors.last_item
-                ils = connectors.last_lead
-
-            if is_collection(value):
-                # append dictionary to those already processed
-                lines += [
-                    leader + kls + key + key_suffix,
-                    _tree(value, key_suffix, leader = leader + ils) if value else None
-                ]
-            else:
-                # the value is a scalar, so squeeze key & value on one line
-                lines += [
-                    leader + kls + key + ': ' + value,
-                ]
-        return '\n'.join(l for l in lines if l)
-
-    elif not is_collection(data):
-        data = [str(data)]
-
-    if top:
-        joiner = '\n'
-        terminator = '\n'
-        items = conjoin(data, sep='\n', conj='\n')
-    else:
-        joiner = '\n' + leader + connectors.item
-        terminator = '\n' + leader + connectors.last_item
-        connector = connectors.item if len(data) > 1 else connectors.last_item
-        items = leader + connector + conjoin(data, sep=joiner, conj=terminator)
-
-    if items:
-        lines.append(items)
-    return '\n'.join(lines)