Synapse

====================

Features and Enhancements
-------------------------
- In Cmdr, the time when a Storm query is being executed by the Cortex is now emitted to the user.
(`1310 <https://github.com/vertexproject/synapse/pull/1310>`_)
- Implement yield keyword. The keyword "yield" before a subquery causes the output nodes of the subquery to be merged
into the output stream. (`1307 <https://github.com/vertexproject/synapse/pull/1307>`_)
- Allow relative and universal properties to be specified from a variable in Storm.
(`1305 <https://github.com/vertexproject/synapse/pull/1305>`_)
- Allow parentheses in Storm editblocks. Edit operations in parentheses don't receive incoming nodes from left of the
parentheses. (`1303 <https://github.com/vertexproject/synapse/pull/1303>`_)
- For Cron tasks, expose the Storm query and their iden in the Task data structure.
(`1295 <https://github.com/vertexproject/synapse/pull/1295>`_)
- Allow filtering ``inet:fqdn`` properties with ``*`` wildcards, such as ``+inet:fqdn=*.vertex.link``.
(`1292 <https://github.com/vertexproject/synapse/pull/1292>`_)
- Add a Bytes object to StormTypes which allows for ``$gzip()``, ``$gunzip()``, ``$bzip()``, ``$bunzip()``
and ``$json()`` decoding helpers. (`1291 <https://github.com/vertexproject/synapse/pull/1291>`_)

Bugfixes
--------
- The ``syn:prop`` runtime only nodes did not have ``:univ=1`` set on universal properties which were pushed onto the
form specific properties. They now have ``:univ=1`` set on them. (`1313 <https://github.com/vertexproject/synapse/pull/1313>`_)
- Fix invalid tool name references for ``synapse.tools.feed`` and ``synapse.tool.pullfile``.
(`1311 <https://github.com/vertexproject/synapse/pull/1311>`_)
- Add a missing default share name for the Axon cell. (`1309 <https://github.com/vertexproject/synapse/pull/1309>`_)
- Fix that non-runtsafe loops didn't yield nodes, they now do.
(`1307 <https://github.com/vertexproject/synapse/pull/1307>`_)
- Fix that non-runtsafe loops that ran 0 times yielded the inbound node. They now yield no nodes.
(`1307 <https://github.com/vertexproject/synapse/pull/1307>`_)
- Fix ``synapse.tools.csvtool`` help description. (`1306 <https://github.com/vertexproject/synapse/pull/1306>`_)
- Fix uses of s_common genfile where opened files weren't being truncated, or in one case, appended to.
(`1304 <https://github.com/vertexproject/synapse/pull/1304>`_)

Improved Documentation
----------------------
- Add additional Hive API documentation. (`1308 <https://github.com/vertexproject/synapse/pull/1308>`_)
- Add additional type specific documentation for Storm. (`1302 <https://github.com/vertexproject/synapse/pull/1302>`_)
- Add documentation for ``synapse.tools.csvtool``, ``synapse.tools.pushfile``, and ``synapse.tools.pullfile``.
(`1312 <https://github.com/vertexproject/synapse/pull/1312>`_)

====================

Features and Enhancements
-------------------------

- Add ``$lib.user.vars`` and ``$lib.globals`` Storm Types. These allow for persistent variable storage and retrieval inside of Storm across multiple queries. These use ``.set()``, ``.get()``, ``.pop()`` and ``.list()`` methods on the two new Storm Types. (`1287 <https://github.com/vertexproject/synapse/pull/1287>`_)
- Add an optional try operator, ``?=``, to the Storm edit mode blocks. This allows for node creation and property setting to fail silently on BadTypeValu and BadPropValu errors. Example: ``[ inet:ipv4 ?= notAnIpAddress :asn?=NotAnAsn ]``. (`1288 <https://github.com/vertexproject/synapse/pull/1288>`_)
- Add while loop to Storm. (`1290 <https://github.com/vertexproject/synapse/pull/1290>`_)
- Add ``:accuracy`` as a secondary property to the ``tel:mob:telem`` node, so a user can record the accuracy of the ``tel:mob:telem:latlong`` property. (`1294 <https://github.com/vertexproject/synapse/pull/1294>`_)
- Always interpret numbers in expressions as numbers. (`1293 <https://github.com/vertexproject/synapse/pull/1293>`_)
- Add a genr argument to ``iterStormQuery()`` to better facilitate nested Storm queries. (`1297 <https://github.com/vertexproject/synapse/pull/1297>`_)
- Allow headers to be set when using ``$lib.inet.http()`` in Storm. (`1299 <https://github.com/vertexproject/synapse/pull/1299>`_)
- Allow Storm variables to be used to make tag names in a edit block. (`1300 <https://github.com/vertexproject/synapse/pull/1300>`_)
- Allow Storm variables with list values to be used to set multiple tags in a edit block, e.g. ``$foo=(tag1,tag2,tag3) [test:str=x +$foo]``. (`1300 <https://github.com/vertexproject/synapse/pull/1300>`_)
- Allow quoted strings as variable names and fields. (`1298 <https://github.com/vertexproject/synapse/pull/1298>`_)

Bugfixes
--------
- Fix runtime safety scoping issue for variables in Storm. (`1296 <https://github.com/vertexproject/synapse/pull/1296>`_)

====================

Features and Enhancements
-------------------------

- Add sub-command aliases for the Cmdr ``hive`` and ``cron`` commands, so that similar subcommands like ``list`` and ``ls`` work across both commands. (`1281 <https://github.com/vertexproject/synapse/pull/1281>`_)
- Simplify adding structured data to the cell Hive via Cmdr. (`1282 <https://github.com/vertexproject/synapse/pull/1282>`_)

Bugfixes
--------
- Fix an issue in Cmdr for ``hive get`` which could result in failing to properly overwrite files when saving a Hive value to disk. (`1282 <https://github.com/vertexproject/synapse/pull/1282>`_)

Improved Documentation
----------------------
- Add additional logging for ReadTheDocs documentation builds. (`1284 <https://github.com/vertexproject/synapse/pull/1284>`_)
- Add additional Hive API docstrings. (`1285 <https://github.com/vertexproject/synapse/pull/1285>`_)

====================

Features and Enhancements
-------------------------

- Add ``syn:trigger`` runtime only nodes to the Cortex. These represent triggers which have been configured on a Cortex. (`1270 <https://github.com/vertexproject/synapse/pull/1270>`_)
- Add a new packed node helper, ``synapse.lib.nodes.tagsnice()``, to get all the leaf tags on a node and any tags which have a time interval associated with them. (`1271 <https://github.com/vertexproject/synapse/pull/1271>`_)
- Add a ``err?`` column to the output of the ``cron list``. This includes an ``X`` character in the column if the last execution of that Cron task encountered an error. (`1272 <https://github.com/vertexproject/synapse/pull/1272>`_)
- Refactor the Boss commands in cmdr to their own file and improve test coverage for the Cortex ``storm`` command in Cmdr. (`1273 <https://github.com/vertexproject/synapse/pull/1273>`_)
- Add ``$node.globtags()`` method to Storm which accepts a tag glob, and returns a list of the matching glob values. (`1275 <https://github.com/vertexproject/synapse/pull/1275>`_)
- Add there remote Cortex API ``CoreApi.delNodeProp()`` to allow property deletion from a single node. (`1279 <https://github.com/vertexproject/synapse/pull/1279>`_)

Bugfixes
--------

- Update CellApi Hive functions to properly check permissions. (`1274 <https://github.com/vertexproject/synapse/pull/1274>`_)
- Ensure that tearing down a Telepath generator via GeneratorExit from non-async code properly signals the generator to teardown on the ioloop. (`1278 <https://github.com/vertexproject/synapse/pull/1278>`_)
- Fix an issue where Storm subquery variable assignments were being pushed to the global runtime, but were not properly available to the Path objects associated with inbound nodes. (`1280 <https://github.com/vertexproject/synapse/pull/1280>`_)

Improved Documentation
----------------------

- Improve inline API help for a few test helper functions. (`1273 <https://github.com/vertexproject/synapse/pull/1273>`_)
- Update Cmdr reference documentation for trigger and cron updates. (`1277 <https://github.com/vertexproject/synapse/pull/1277>`_)

====================

Features and Enhancements
-------------------------

- Centralize the ``allowed()`` and ``_reqUserAllowed()`` function from the CoreApi class to the CellApi, making permission checking easier for CellApi implementers. (`1268 <https://github.com/vertexproject/synapse/pull/1268>`_)
- Add the ``$path`` built-in Storm variable to the default variables populated in the Storm pipeline. (`1269 <https://github.com/vertexproject/synapse/pull/1269>`_)
- Add a ``$path.trace()`` method to get a object which traces the pivots from a given Path object. The path idens can be obtained via ``trace.iden()``. (`1269 <https://github.com/vertexproject/synapse/pull/1269>`_)
- Add ``$lib.set()`` to Storm Types. This can be used to get a mutable set object. (`1269 <https://github.com/vertexproject/synapse/pull/1269>`_)

Bugfixes
--------

- Fix an issue where the Base ``link()`` API required the linking function to be a coroutine. (`1261 <https://github.com/vertexproject/synapse/pull/1261>`_)

Improved Documentation
----------------------

- Improve inline API help for a few functions. (`1268 <https://github.com/vertexproject/synapse/pull/1268>`_)

====================

Features and Enhancements
-------------------------

- Add an optional facility to lmdbslab to prevent its data from being swapped out of memory. Add a Cortex configuration option (in the cell.yaml file) named ``dedicated`` to enable this for the lmdb slabs that store the graph data in a Cortex. This is currently only supported on Linux. (`1254 <https://github.com/vertexproject/synapse/pull/1254>`_)

Bugfixes
--------

- Fix an issue where the Cmdr color awareness for error highlighting was preventing documentation from building properly. (`1261 <https://github.com/vertexproject/synapse/pull/1261>`_)
- Fix an issue where the ``synapse.servers.cortex`` ``--mirror`` option was not properly mirroring realtime splices. (`1264 <https://github.com/vertexproject/synapse/pull/1264>`_)
- Fix a runtsafe variable order bug in Storm. (`1265 <https://github.com/vertexproject/synapse/pull/1265>`_)
- Work around an issue in prompt-toolkit's ``print_formatted_text`` function. (`1266 <https://github.com/vertexproject/synapse/pull/1266>`_)
- Fix an issue where color awareness was not available for Cmdr sessions launched via ``synapse.tools.csvtool`` and ``synapse.tools.feed``. (`1267 <https://github.com/vertexproject/synapse/pull/1267>`_)

Improved Documentation
----------------------

- Update Storm lift documentation to include lifting by time intervals. (`1260 <https://github.com/vertexproject/synapse/pull/1260>`_)
- Update ReadTheDocs build configuration to utilize a Docker container, instead of a conda environment. (`1262 <https://github.com/vertexproject/synapse/pull/1262>`_)