Synapse

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

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

- Add ``$node.iden()`` method in Storm to expose the iden of a node. (`1257 <https://github.com/vertexproject/synapse/pull/1257>`_)
- Add ``$lib.text()`` method in Storm Lib to add a mutable string formatting object. (`1258 <https://github.com/vertexproject/synapse/pull/1258>`_)

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

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

- Add colored error reporting in Cmdr when a BadSyntax exception is sent to the user. (`1248 <https://github.com/vertexproject/synapse/pull/1248>`_)
- Expose the local Synapse version information in Cmdr via the ``locs`` command. (`1250 <https://github.com/vertexproject/synapse/pull/1250>`_)
- Add reflected class names to the Telepath shareinfo. Expose this with the ``Proxy._getClasses()`` API. (`1250 <https://github.com/vertexproject/synapse/pull/1250>`_)
- Add ``--file`` and ``--optsfile`` arguments to the Cmdr ``storm`` command. These, respectively, allow a user to provide a file containing a raw Storm query and variable arguments as a json file. (`1252 <https://github.com/vertexproject/synapse/pull/1252>`_)

Bugfixes
--------

- Fix an issue where the Cmdr ``log`` command did not clean up all of its settings. (`1249 <https://github.com/vertexproject/synapse/pull/1249>`_)
- Fix an issue with the Storm ``switch`` statement handling of non-runtsafe values. (`1251 <https://github.com/vertexproject/synapse/pull/1251>`_)
- Fix an issue with the Storm ``if`` statement handling of non-runtsafe values. (`1253 <https://github.com/vertexproject/synapse/pull/1253>`_)
- Fix an issue with when connecting to a Cortex via Telepath for the default remote layer, which previously could have pointed to a layer which was not the correct layer for the default view. (`1255 <https://github.com/vertexproject/synapse/pull/1255>`_)

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

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

- Add if/elif/else statement. Add and/or/not inside dollar expressions. Have expressions always return an int. (`1235 <https://github.com/vertexproject/synapse/pull/1235>`_)
- Add variable and expression filters. Test for and correct all known grammar ambiguities. Tag filters with a comparison, e.g. ``+$foo=$bar``, now don't raise an exception (`1241 <https://github.com/vertexproject/synapse/pull/1235>`_)
- Add ability to enable and disable cron jobs and triggers. (`1242 <https://github.com/vertexproject/synapse/pull/1242>`_)

Bugfixes
--------

- Fix a bug where a tag addition could cause a splice to be generated if the tag window being added was inside of the existing tag window. (`1243 <https://github.com/vertexproject/synapse/pull/1243>`_)
- csvtool now correctly handles print events (`1245 <https://github.com/vertexproject/synapse/pull/1245>`_)

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

- Update release process documentation. (`1244 <https://github.com/vertexproject/synapse/pull/1244>`_)

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

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>`_)