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

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

@@ -1,3 +1,31 @@
+Metadata-Version: 2.4
+Name: borg_space
+Version: 2.4
+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.4
+:Released: 2026-01-27
 
 *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*::
 
@@ -99,6 +131,7 @@ You can create a NestedText_ settings file to specify default behaviors and
 define composite repositories.  For example::
 
     default repository: home
+    default path: ~{user}/.local/share/assimilate/{config}.latest.nt
     report style: tree
     compact format: {name}: {size:{fmt}}.  Last back up: {last_create:ddd, MMM DD}.  Last squeeze: {last_squeeze:ddd, MMM DD}.
     table format: {host:<8} {user:<5} {config:<9} {size:<8.2b} {last_create:ddd, MMM DD}
@@ -114,7 +147,11 @@ define composite repositories.  For example::
         dev: root@dev~root
         mail: root@mail~root
         files: root@files~root
-        bastion: root@bastion~root
+        bastion:
+            config: root
+            host: bastion
+            user: root
+            path: /root/.local/share/emborg/root.latest.nt
         media: root@media~root
         web: root@web~root
         cluster: home@cluster
@@ -134,7 +171,17 @@ define composite repositories.  For example::
             children: home servers root
 
 default repository:
-    The name of the repository to be used if none are given on the command line.
+    The name (or names) of the repository to be used if none are given on the 
+    command line.
+
+default path:
+    The path to the *Emborg* or *Assimilate* generated latest.nt files.  If not 
+    give, it defaults to::
+
+      ~{user}/.local/share/emborg/{config}.latest.nt
+
+    ``{config}`` and ``{user}`` are placeholders that are replaced by the 
+    corresponding component of the repository specification.
 
 report style:
     The report style to be used if none is specified on the command line.  
@@ -230,6 +277,7 @@ repositories:
                 config: home
                 host: host
                 user: user
+                path: ~user/.local/share/emborg/home.latest.nt
 
         repositiories:
             all: home@host~user work@host~user
@@ -248,6 +296,7 @@ repositories:
                     config: home
                     host: host
                     user: user
+                    path: ~user/.local/share/emborg/home.latest.nt
                 -
                     config: work
                     host: host
@@ -310,14 +359,30 @@ scaled nicely on the same graph::
 Installation
 ------------
 
-*Borg-Space* requires *Emborg* version 1.37 or newer.
+*Borg-Space* requires *Emborg* version 1.37 or newer or *Assimilate*.
 
 Install with::
 
     > pip3 install borg-space
 
 
+Assimilate and 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*.  To use 
+*Assimilate* you should set the *default path* accordingly.  To support both 
+*Emborg* and *Assimilate* simultaneously, you should set *default path* for one 
+and then use *path* overrides for individual repositories.
+
+*Assimilate* only saves the space used by the repository when running 
+a *compact* command and only if the *get_repo_size* is set to ``'yes``.
+
+.. _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.4/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.4
+:Released: 2026-01-27
 
 *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*::
 
@@ -126,6 +103,7 @@ You can create a NestedText_ settings file to specify default behaviors and
 define composite repositories.  For example::
 
     default repository: home
+    default path: ~{user}/.local/share/assimilate/{config}.latest.nt
     report style: tree
     compact format: {name}: {size:{fmt}}.  Last back up: {last_create:ddd, MMM DD}.  Last squeeze: {last_squeeze:ddd, MMM DD}.
     table format: {host:<8} {user:<5} {config:<9} {size:<8.2b} {last_create:ddd, MMM DD}
@@ -141,7 +119,11 @@ define composite repositories.  For example::
         dev: root@dev~root
         mail: root@mail~root
         files: root@files~root
-        bastion: root@bastion~root
+        bastion:
+            config: root
+            host: bastion
+            user: root
+            path: /root/.local/share/emborg/root.latest.nt
         media: root@media~root
         web: root@web~root
         cluster: home@cluster
@@ -161,7 +143,17 @@ define composite repositories.  For example::
             children: home servers root
 
 default repository:
-    The name of the repository to be used if none are given on the command line.
+    The name (or names) of the repository to be used if none are given on the 
+    command line.
+
+default path:
+    The path to the *Emborg* or *Assimilate* generated latest.nt files.  If not 
+    give, it defaults to::
+
+      ~{user}/.local/share/emborg/{config}.latest.nt
+
+    ``{config}`` and ``{user}`` are placeholders that are replaced by the 
+    corresponding component of the repository specification.
 
 report style:
     The report style to be used if none is specified on the command line.  
@@ -257,6 +249,7 @@ repositories:
                 config: home
                 host: host
                 user: user
+                path: ~user/.local/share/emborg/home.latest.nt
 
         repositiories:
             all: home@host~user work@host~user
@@ -275,6 +268,7 @@ repositories:
                     config: home
                     host: host
                     user: user
+                    path: ~user/.local/share/emborg/home.latest.nt
                 -
                     config: work
                     host: host
@@ -337,15 +331,29 @@ scaled nicely on the same graph::
 Installation
 ------------
 
-*Borg-Space* requires *Emborg* version 1.37 or newer.
+*Borg-Space* requires *Emborg* version 1.37 or newer or *Assimilate*.
 
 Install with::
 
     > pip3 install borg-space
 
 
+Assimilate and 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*.  To use 
+*Assimilate* you should set the *default path* accordingly.  To support both 
+*Emborg* and *Assimilate* simultaneously, you should set *default path* for one 
+and then use *path* overrides for individual repositories.
+
+*Assimilate* only saves the space used by the repository when running 
+a *compact* command and only if the *get_repo_size* is set to ``'yes``.
+
+.. _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.4}/borg_space/config.py

@@ -32,7 +32,6 @@ if new_home:  # pragma: no cover
 
 # GLOBALS {{{1
 set_prefs(use_inform=True)
-settings_file = to_path(user_config_dir('borg-space')) / 'settings.nt'
 voluptuous_error_msg_mappings = {
     "extra keys not allowed": ("unknown key", "key"),
     "expected a dictionary": ("expected key:value pair", "value"),
@@ -41,24 +40,43 @@ voluptuous_key_prefix = "key contains"
 hostname = socket.gethostname().split('.')[0]
     # version of the hostname (the hostname without any domain name)
 username = pwd.getpwuid(os.getuid()).pw_name
+program_name = 'borg-space'
+if 'XDG_CONFIG_HOME' in os.environ:
+    config_dir = os.sep.join([os.environ['XDG_CONFIG_HOME'], program_name])
+else:
+    config_dir = user_config_dir(program_name)
+settings_file = to_path(config_dir) / 'settings.nt'
 
 
 # REPOSITORY {{{1
 # Repository class {{{2
 class Repository:
     def __init__(self, spec, name=None):
-        prefix, _, user = spec.partition('~')
-        config, _, host = prefix.partition('@')
+        if is_str(spec):
+            prefix, _, user = spec.partition('~')
+            config, _, host = prefix.partition('@')
+            path = None
+        else:
+            user = spec.get('user')
+            config = spec.get('config')
+            host = spec.get('host')
+            path = spec.get('path')
+            spec = spec.get('spec')
+
         if not config:
             raise Error("spec is missing Emborg config name.", culprit=spec)
         if not name:
             name = spec
 
-        self.spec = spec
-        self.name = name
-        self.config = a_name(config)
-        self.host = a_name(host) or hostname
-        self.user = a_name(user) or username
+        try:
+            self.spec = spec
+            self.name = name
+            self.config = a_name(config)
+            self.host = a_name(host) or hostname
+            self.user = a_name(user) or username
+            self.path = path
+        except Invalid as e:
+            raise Error(e, culprit=spec)
         self.latest = None
 
     def __str__(self):
@@ -87,14 +105,21 @@ class Repository:
             user = self.user,
             full_spec = str(self)
         )
-        info.update(self.latest)
+        if self.latest:
+            info.update(self.latest)
         return info
 
     def get_path(self):
         user = self.user if self.user else getpass.getuser()
         config = self.config
         assert config
-        path = f"~{user}/.local/share/emborg/{config}.latest.nt"
+        path = self.path
+        if not path:
+            path = settings.get(
+                'default_path',
+                "~{user}/.local/share/emborg/{config}.latest.nt"
+            )
+        path = path.format(user=user, config=config)
         return (self.host, path)
 
     def get_latest(self):
@@ -109,11 +134,11 @@ class Repository:
             try:
                 content = to_path(path).read_text()
             except FileNotFoundError:
-                raise Error('unknown repository.', culprit=str(self))
+                raise Error(f'repository not found: {path}', culprit=str(self))
         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:
@@ -128,27 +153,27 @@ class Repository:
 def get_repos(spec):
     if not spec:
         spec = settings.get('default_repository')
-    if not spec:
-        raise Error('there is no default repository.')
 
-    try:
-        children = repositories[spec]
-    except (TypeError, KeyError):
-        # not found in repositories specified in settings file.
-        # see if it exists on local machine
-        children = [Repository(spec)]
-
-    results = {}
-    for child in children:
-        host, path = child.get_path()
-        name = str(child)
+    specs = spec.split()
+    for spec in specs:
         try:
-            child.get_latest()
-            results[name] = child
-        except Error as e:
-            e.report(culprit=name)
-        except OSError as e:
-            error(os_error(e), culprit=name)
+            children = repositories[spec]
+        except (TypeError, KeyError):
+            # not found in repositories specified in settings file.
+            # see if it exists on local machine
+            children = [Repository(spec)]
+
+        results = {}
+        for child in children:
+            # host, path = child.get_path()
+            name = str(child)
+            try:
+                child.get_latest()
+                results[name] = child
+            except Error as e:
+                e.report(culprit=name)
+            except OSError as e:
+                error(os_error(e), culprit=name)
     return results
 
 
@@ -168,7 +193,7 @@ def to_list(args):
     if is_str(args):
         args = args.split()
     if is_mapping(args):
-        raise Invalid(f"expected a list or string")
+        raise Invalid("expected a list or string")
     return args
 
 # a_name() {{{2
@@ -200,7 +225,7 @@ def a_spec(arg):
     if is_str(arg):
         return arg
     if is_mapping(arg):
-        unknown_keys = arg.keys() - set(['config', 'host', 'user'])
+        unknown_keys = arg.keys() - set(['config', 'host', 'user', 'path'])
         if unknown_keys:
             raise Invalid(f"unknown {plural(unknown_keys):key}: {conjoin(unknown_keys)}.")
         if 'config' not in arg:
@@ -210,7 +235,8 @@ def a_spec(arg):
             spec = f"{spec}@{arg.get('host')}"
         if arg.get('user'):
             spec = f"{spec}~{arg.get('user')}"
-        return spec
+        arg['spec'] = spec
+        return arg
     raise Invalid("expected a specification")
 
 # to_specs() {{{2
@@ -218,7 +244,7 @@ def to_specs(arg):
     if is_str(arg):
         return [a_spec(r) for r in arg.split()]
     if is_mapping(arg):
-        unknown_keys = arg.keys() - set(['config', 'host', 'user'])
+        unknown_keys = arg.keys() - set(['config', 'host', 'user', 'path'])
         if unknown_keys:
             raise Invalid(f"unknown {plural(unknown_keys):key}: {conjoin(unknown_keys)}.")
         return [a_spec(arg)]
@@ -230,6 +256,7 @@ def to_specs(arg):
 validate_settings = Schema({
     'repositories': {key_as_name: to_specs},
     'default_repository': str,
+    'default_path': str,
     'report_style': str,
     'compact_format': str,
     'table_format': str,
@@ -264,9 +291,12 @@ try:
                 repositories[name] = []
                 alias = name if len(specs) <= 1 else None
                 for spec in specs:
-                    if spec in repositories and spec != name:
+                    specname = spec
+                    if is_mapping(spec):
+                        specname = spec['spec']
+                    if specname in repositories and specname != name:
                         # this is a known (previously defined) repository
-                        repositories[name].extend(repositories[spec])
+                        repositories[name].extend(repositories[specname])
                     else:
                         repositories[name].append(Repository(spec, alias))
             else:

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

@@ -31,12 +31,11 @@ Settings are held in ~/.config/borg-space/settings.nt.
 """
 
 # imports {{{1
-from .config import settings, get_repos
-from .trees import tree
+from .config import settings, get_repos, program_name
 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,19 @@ import matplotlib
 import matplotlib.pyplot as plt
 from matplotlib.dates import AutoDateFormatter, AutoDateLocator
 from matplotlib.ticker import FuncFormatter
+# from labellines import labelLines
+import os
+
 
 # globals {{{1
-data_dir = Path(user_data_dir('borg-space'))
+if 'XDG_DATA_HOME' in os.environ:
+    data_dir = Path(os.sep.join([os.environ['XDG_DATA_HOME'], program_name]))
+else:
+    data_dir = Path(user_data_dir(program_name))
 now = str(arrow.now())
 Quantity.set_prefs(prec='full')
-__version__ = "2.2"
-__released__ = "2023-06-12"
+__version__ = "2.4"
+__released__ = "2026-01-27"
 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)
@@ -64,6 +69,8 @@ not_available = "⟪not available⟫"
 # collect_repos() {{{1
 def collect_repos(requests, record_size):
     repos = {}
+    if not requests:
+        raise Error('there is no default repository.')
     for request in requests:
         new_repos = get_repos(request)
         repos.update(new_repos)
@@ -73,7 +80,7 @@ def collect_repos(requests, record_size):
         for name, repo in repos.items():
 
             # read previously recorded sizes
-            data_path = Path(data_dir / f'{name}.nt')
+            data_path = data_dir / f'{name}.nt'
             try:
                 data = nt.load(data_path, top=dict)
             except FileNotFoundError:
@@ -174,6 +181,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 +277,7 @@ def print_tree_report(repos):
                 fmt = formatter,
                 fields = fields,
                 missing = not_available,
-            )
+            ), squeeze=True
         )
     )
 
@@ -328,7 +336,7 @@ def main():
 
     requests = cmdline['<spec>']
     if not requests:
-        requests = ['']  # this gets the default config
+        requests = settings.get('default_repository', '').split()
 
     try:
         repos = collect_repos(requests, cmdline['--record'])

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

@@ -1,13 +1,13 @@
 [project]
 name = "borg_space"
 dist-name = "borg-space"
-version = "2.2"
+version = "2.4"
 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]
@@ -39,3 +40,16 @@ borg-space = "borg_space.main:main"
 [build-system]
 requires = ["flit_core >=2,<4"]
 build-backend = "flit_core.buildapi"
+
+[tool.pytest.ini_options]
+addopts = "--tb=short"
+
+[tool.ruff]
+exclude = [".tox", "doc", "Diffs"]
+
+[tool.ruff.lint]
+select = ["F"]
+ignore = []
+
+[tool.ruff.lint.per-file-ignores]
+"borg_space/__init__.py" = ["F401"]

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)