fixes #260

Author: jph00

fastcore/_nbdev.py

@@ -67,6 +67,7 @@
          "Int": "01_basics.ipynb",
          "Str": "01_basics.ipynb",
          "Float": "01_basics.ipynb",
+         "concat": "01_basics.ipynb",
          "detuplify": "01_basics.ipynb",
          "replicate": "01_basics.ipynb",
          "setify": "01_basics.ipynb",
@@ -158,6 +159,8 @@
          "Path.mk_write": "03_xtras.ipynb",
          "Path.ls": "03_xtras.ipynb",
          "Path.__repr__": "03_xtras.ipynb",
+         "spark_chars": "03_xtras.ipynb",
+         "sparkline": "03_xtras.ipynb",
          "autostart": "03_xtras.ipynb",
          "time_events": "03_xtras.ipynb",
          "stringfmt_names": "03_xtras.ipynb",

fastcore/basics.py

@@ -6,9 +6,9 @@
            'true', 'stop', 'gen', 'chunked', 'otherwise', 'custom_dir', 'AttrDict', 'type_hints', 'annotations',
            'anno_ret', 'argnames', 'with_cast', 'store_attr', 'attrdict', 'properties', 'camel2snake', 'snake2camel',
            'class2attr', 'getattrs', 'hasattrs', 'setattrs', 'try_attrs', 'GetAttrBase', 'GetAttr', 'delegate_attr',
-           'ShowPrint', 'Int', 'Str', 'Float', 'detuplify', 'replicate', 'setify', 'merge', 'range_of', 'groupby',
-           'last_index', 'filter_dict', 'filter_keys', 'filter_values', 'cycle', 'zip_cycle', 'sorted_ex', 'not_',
-           'argwhere', 'filter_ex', 'range_of', 'renumerate', 'first', 'nested_attr', 'nested_idx', 'val2idx',
+           'ShowPrint', 'Int', 'Str', 'Float', 'concat', 'detuplify', 'replicate', 'setify', 'merge', 'range_of',
+           'groupby', 'last_index', 'filter_dict', 'filter_keys', 'filter_values', 'cycle', 'zip_cycle', 'sorted_ex',
+           'not_', 'argwhere', 'filter_ex', 'range_of', 'renumerate', 'first', 'nested_attr', 'nested_idx', 'val2idx',
            'uniqueify', 'num_methods', 'rnum_methods', 'inum_methods', 'fastuple', 'arg0', 'arg1', 'arg2', 'arg3',
            'arg4', 'bind', 'map_ex', 'compose', 'maps', 'partialler', 'instantiate', 'using_attr', 'Self', 'Self',
            'copy_func', 'patch_to', 'patch', 'patch_property', 'ImportEnum', 'StrEnum', 'str_enum', 'Stateful',
@@ -409,6 +409,11 @@ class Float(float,ShowPrint):
     "An extensible `float`"
     pass
 
+# Cell
+def concat(colls)->list:
+    "Concatenate all collections in `colls`"
+    return list(itertools.chain.from_iterable(colls))
+
 # Cell
 def detuplify(x):
     "If `x` is a tuple with one thing, extract it"

fastcore/xtras.py

@@ -2,9 +2,9 @@
 
 __all__ = ['dict2obj', 'obj2dict', 'repr_dict', 'is_listy', 'shufflish', 'mapped', 'IterLen', 'ReindexCollection',
            'maybe_open', 'image_size', 'bunzip', 'join_path_file', 'loads', 'untar_dir', 'repo_details', 'run',
-           'open_file', 'save_pickle', 'load_pickle', 'autostart', 'time_events', 'stringfmt_names', 'PartialFormatter',
-           'partial_format', 'utc2local', 'local2utc', 'trace', 'round_multiple', 'modified_env', 'ContextManagers',
-           'str2bool', 'sort_by_run']
+           'open_file', 'save_pickle', 'load_pickle', 'spark_chars', 'sparkline', 'autostart', 'time_events',
+           'stringfmt_names', 'PartialFormatter', 'partial_format', 'utc2local', 'local2utc', 'trace', 'round_multiple',
+           'modified_env', 'ContextManagers', 'str2bool', 'sort_by_run']
 
 # Cell
 from .imports import *
@@ -221,6 +221,23 @@ def __repr__(self:Path):
         except: pass
     return f"Path({self.as_posix()!r})"
 
+# Cell
+spark_chars = '▁▂▃▅▆▇'
+
+# Cell
+def _sparkchar(x, mn, incr, empty_zero):
+    if x is None or (empty_zero and not x): return ' '
+    res = int((x-mn)/incr-0.5)
+    return spark_chars[res]
+
+# Cell
+def sparkline(data, empty_zero=False):
+    "Sparkline for `data`, with `None`s (and zero, if `empty_zero`) shown as empty column"
+    valid = [o for o in data if o is not None]
+    mn,mx,n = min(valid),max(valid),len(spark_chars)
+    res = [_sparkchar(o,mn,(mx-mn)/n,empty_zero) for o in data]
+    return ''.join(res)
+
 # Cell
 def autostart(g):
     "Decorator that automatically starts a generator"

nbs/01_basics.ipynb

@@ -2616,6 +2616,38 @@
     "Functions that manipulate popular python collections."
    ]
   },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "#export\n",
+    "def concat(colls)->list:\n",
+    "    \"Concatenate all collections in `colls`\"\n",
+    "    return list(itertools.chain.from_iterable(colls))"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "text/plain": [
+       "[0, 1, 2, 3, 4]"
+      ]
+     },
+     "execution_count": null,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
+   "source": [
+    "concat([(o for o in range(2)),[2,3,4]])"
+   ]
+  },
   {
    "cell_type": "code",
    "execution_count": null,
@@ -5158,6 +5190,8 @@
       "Converted 01_basics.ipynb.\n",
       "Converted 02_foundation.ipynb.\n",
       "Converted 03_xtras.ipynb.\n",
+      "Converted 03a_parallel.ipynb.\n",
+      "Converted 03b_net.ipynb.\n",
       "Converted 04_dispatch.ipynb.\n",
       "Converted 05_transform.ipynb.\n",
       "Converted 07_meta.ipynb.\n",

nbs/03_xtras.ipynb

@@ -618,7 +618,7 @@
     {
      "data": {
       "text/plain": [
-       "['g', 'a', 'b', 'c', 'e', 'f', 'd', 'h']"
+       "['e', 'a', 'c', 'h', 'g', 'b', 'f', 'd']"
       ]
      },
      "execution_count": null,
@@ -1319,6 +1319,64 @@
     "## Other Helpers"
    ]
   },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "#export\n",
+    "spark_chars = '▁▂▃▅▆▇'"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "#export\n",
+    "def _sparkchar(x, mn, incr, empty_zero):\n",
+    "    if x is None or (empty_zero and not x): return ' '\n",
+    "    res = int((x-mn)/incr-0.5)\n",
+    "    return spark_chars[res]"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "#export\n",
+    "def sparkline(data, empty_zero=False):\n",
+    "    \"Sparkline for `data`, with `None`s (and zero, if `empty_zero`) shown as empty column\"\n",
+    "    valid = [o for o in data if o is not None]\n",
+    "    mn,mx,n = min(valid),max(valid),len(spark_chars)\n",
+    "    res = [_sparkchar(o,mn,(mx-mn)/n,empty_zero) for o in data]\n",
+    "    return ''.join(res)"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "without \"empty_zero\": ▅▂ ▁▂▁▃▇▅\n",
+      "   with \"empty_zero\": ▅▂ ▁▂ ▃▇▅\n"
+     ]
+    }
+   ],
+   "source": [
+    "data = [9,6,None,1,4,0,8,15,10]\n",
+    "print(f'without \"empty_zero\": {sparkline(data, empty_zero=False)}')\n",
+    "print(f'   with \"empty_zero\": {sparkline(data, empty_zero=True )}')"
+   ]
+  },
   {
    "cell_type": "code",
    "execution_count": null,