Synapse

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

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

- Add the Synapse version information in the Telepath handshake. Expose this with the ``Proxy._getSynVers()`` API and in the Cmdr CLI via the ``locs`` command. (`1238 <https://github.com/vertexproject/synapse/pull/1238>`_)
- Add a ``--save-nodes`` argument to the Storm command in Cmdr to do a one-shot record of nodes returned by a Storm query. (`1239 <https://github.com/vertexproject/synapse/pull/1239>`_)
- Allow ``synapse.tools.cmdr`` to take a second argument and run that argument as a Cmdr command. (`1239 <https://github.com/vertexproject/synapse/pull/1239>`_)
- Add ``$node.repr()`` to Storm types. This allows the user to get the repr of the primary property, or a secondary property, and assign it to a variable in storm. (`1222 <https://github.com/vertexproject/synapse/pull/1222>`_)
- Add ``lib.csv.emit()`` to Storm types. This allows the user to emit a message during a Storm query which can easily be joined into a CSV. (`1236 <https://github.com/vertexproject/synapse/pull/1236>`_)
- Add a ``--export`` option to ``synapse.tools.csvtool``. This allows the user to create a CSV file from a query that uses the ``$lib.csv.emit()`` Storm function. (`1236 <https://github.com/vertexproject/synapse/pull/1236>`_)

Bugfixes
--------

- Resolve Storm grammar ambiguity between tag condition filters with value and left join. (`1237 <https://github.com/vertexproject/synapse/pull/1237>`_)
- Resolve Storm grammar ambiguity to prevent reserved words from being identified as a Storm command. (`1240 <https://github.com/vertexproject/synapse/pull/1240>`_)

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

Bugfixes
--------

- Fix an ambuguity in the Storm grammer regarding quoted command arguments. (`1234 <https://github.com/vertexproject/synapse/pull/1234>`_)

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

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

- Make Ndef, Edge and TimeEdge repr implementations consistent. (`1217 <https://github.com/vertexproject/synapse/pull/1217>`_)
- Add jsonl support the ``synapse.tools.feed`` tool. (`1220 <https://github.com/vertexproject/synapse/pull/1220>`_)
- Add ``/api/v1/model`` API route for the Cortex HTTP API to expose the data model for a running Cortex. (`1221 <https://github.com/vertexproject/synapse/pull/1221>`_)
- Add ``fire()`` function to Storm types to fire ``storm:fire`` messages during Storm command execution. (`1221 <https://github.com/vertexproject/synapse/pull/1221>`_)
- Add ``$()`` expression syntax to Storm for mathematical operations, along with a new parsing engine built around Lark. (`1216 <https://github.com/vertexproject/synapse/pull/1216>`_)
- Add a warning when Synapse is imported if the user is running Python with ``-OO`` optimizations, since that can degrade the library capabilities. (`1219 <https://github.com/vertexproject/synapse/pull/1219>`_)
- Cleanup some exception chains so that type normalization errors do not result in large tracebacks on the server. (`1224 <https://github.com/vertexproject/synapse/pull/1224>`_)
- Allow ``$lib.print()`` to accept curly brace ``{}`` formatted strings for using variable substitution when printing values in Storm. (`1227 <https://github.com/vertexproject/synapse/pull/1227>`_)

Bugfixes
--------

- Fix an issue in Storm with lifting or filtering nodes by tags when the tag value is a variable. (`1223 <https://github.com/vertexproject/synapse/pull/1223>`_)
- Fix an issue which was preventing a tag variable value reference in Storm from behaving correctly. (`1228 <https://github.com/vertexproject/synapse/pull/1228>`_)
- Fix a missing await statement which prevented properly setting layers for a Cortex View object. (`1231 <https://github.com/vertexproject/synapse/pull/1231>`_)

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

- Fix some docstrings related to test code helpers. (`1230 <https://github.com/vertexproject/synapse/pull/1230>`_)

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

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

- Add POST support to the ``/api/v1/model/norm`` HTTP API endpoint. (`1207 <https://github.com/vertexproject/synapse/pull/1207>`_)
- Add ``getPropNorm()`` and ``getTypeNorm()`` Telepath API endpoints to the Cortex and CoreApi. (`1207 <https://github.com/vertexproject/synapse/pull/1207>`_)
- Add list ``length()`` and ``index()`` methods to Storm types. (`1208 <https://github.com/vertexproject/synapse/pull/1208>`_)
- Add helper functions to ``synapse.lib.node`` for extracting repr values from packed nodes. (`1212 <https://github.com/vertexproject/synapse/pull/1212>`_)
- Add ``--nodes-only`` to the Cmdr ``log`` command to only record raw nodes. (`1213 <https://github.com/vertexproject/synapse/pull/1213>`_)
- Add ``guid()``, ``min()``, ``max()`` functions to Storm types. (`1215 <https://github.com/vertexproject/synapse/pull/1215>`_)
- Add ``getStormEval()`` to the ``synapse.lib.storm.Cmd`` class. This helper can be used by Storm command implementers in resolving variables, full property, and relative property values off of the Storm runtime. (`1215 <https://github.com/vertexproject/synapse/pull/1215>`_)
- The Storm ``min`` and ``max`` commands may now accept a relative property path, a full property path, or a variable. (`1215 <https://github.com/vertexproject/synapse/pull/1215>`_)
- Add a ``--mirror`` to ``synapse.servers.cortex`` to allow easier mirroring of a backup Cortex from its source Cortex. (`1197 <https://github.com/vertexproject/synapse/pull/1197>`_)

Bugfixes
--------

- Fix an error in PropPivotOut and FormPivot where a None object could be yielded in the Storm pipeline. (`1210 <https://github.com/vertexproject/synapse/pull/1210>`_)
- Shut down HTTP API servers on Cell ``fini()``. (`1211 <https://github.com/vertexproject/synapse/pull/1211>`_)

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

- Convert developer guide from static RST to Jupyter Notebook. (`1209 <https://github.com/vertexproject/synapse/pull/1209>`_)
- Convert HTTP API guide from static RST to Jupyter Notebook. (`1211 <https://github.com/vertexproject/synapse/pull/1211>`_)
- Add a note about backing up and restoring a cortex to the quickstart guide. (`1214 <https://github.com/vertexproject/synapse/pull/1214>`_)

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

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

- Add the ability to delete a role via HTTP API, as well as being able to mark a user as being archived. Archiving a user will also lock a user. (`1205 <https://github.com/vertexproject/synapse/pull/1205>`_)
- Add support to archiving for user to the CellApi for use via Telepath. (`1206 <https://github.com/vertexproject/synapse/pull/1206>`_)

Bugfixes
--------

- Fix remote layer bug injected by previous optimization that would result in missing nodes from lifts when the node
only resides in the distant layer. (`1203 <https://github.com/vertexproject/synapse/pull/1203>`_)

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

- Fix error in the HTTP API documentation. (`1204 <https://github.com/vertexproject/synapse/pull/1204>`_)

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

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

- Automatically run unit tests for the master every day. (`1192 <https://github.com/vertexproject/synapse/pull/1192>`_)
- Add test suite for ``synapse.lib.urlhelp``. (`1195 <https://github.com/vertexproject/synapse/pull/1195>`_)
- Improve multi-layer and single layer performance. This is a backwards-incompatible API change in that 0.1.2 cortex
will not interoperate with 0.1.2 remote layers before version 0.1.2. Persistent storage format has not changed.
(`1196 <https://github.com/vertexproject/synapse/pull/1196>`_)
- Add skeleton for reverse engineering model. (`1198 <https://github.com/vertexproject/synapse/pull/1198>`_)

Bugfixes
--------

- When using ``synapse.tools.cmdr``, issuing ctrl-c to cancel a running command in could result in the Telepath Proxy object being fini'd. This has been resolved by adding a signal handler to the ``synapse.lib.cli.Cli`` class which is registered by cmdr. (`1199 <https://github.com/vertexproject/synapse/pull/1199>`_)
- Fix an issue where deleting a property which has no index failed. (`1200 <https://github.com/vertexproject/synapse/pull/1200>`_)
- Single letter form and property names were improperly disallowed. They are now allowed. (`1201 <https://github.com/vertexproject/synapse/pull/1201>`_)


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

- Add some example developer guide documentation. (`1193 <https://github.com/vertexproject/synapse/pull/1193>`_)