Synapse

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

Features and Enhancements
-------------------------
- Allow users to list their current permissions and roles with the ``synapse.tools.cellauth`` tool.
(`1460 <https://github.com/vertexproject/synapse/issues/1460>`_)
(`1464 <https://github.com/vertexproject/synapse/pull/1464>`_)
- Allow bytes to be converted to strings, and strings to be converted to bytes, inside of Storm. This is done with
``decode()`` and ``encode()`` StormType functions.
(`1469 <https://github.com/vertexproject/synapse/pull/1469>`_)

Bugfixes
--------
- Fix an error in the ``synapse.lib.scrape`` regular expressions which prevented sequential FQDN and email addresses
from being scrapped.
(`1482 <https://github.com/vertexproject/synapse/pull/1482>`_)

Improved Documentation
----------------------
- Start a Synapse glossary document.
(`1478 <https://github.com/vertexproject/synapse/pull/1478>`_)
- Update the Storm Command reference documentation.
(`1478 <https://github.com/vertexproject/synapse/pull/1478>`_)

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

Features and Enhancements
-------------------------
- Allow for StormType ``query`` objects to be executed similar to a local function.
(`1456 <https://github.com/vertexproject/synapse/pull/1456>`_)
- Add ``syn:cmd`` runt nodes to represent Storm commands available to a given Cortex as Nodes.
(`1446 <https://github.com/vertexproject/synapse/pull/1446>`_)

Bugfixes
--------
- Make CI tests do eager updates of third party libraries to prevent cache key rolling when a buggy library is published
and a subsequent fix is released.
(`1468 <https://github.com/vertexproject/synapse/pull/1468>`_)
- Fix implicit pivot support for runt nodes.
(`1470 <https://github.com/vertexproject/synapse/pull/1470>`_)
- Allow the Storm ``tee`` command to execute queries if there were no inbound nodes.
(`1468 <https://github.com/vertexproject/synapse/pull/1468>`_)
- Allow the PropPivotOut AST node to pivot from an array value to a runt node.
(`1471 <https://github.com/vertexproject/synapse/pull/1471>`_)
- Add some ``asyncio.sleep(0)`` calls to the AST where Python loops could hog CPU time.
(`1472 <https://github.com/vertexproject/synapse/pull/1472>`_)
- Fix an issue with the Storm ``scrape`` command where a non-str repr was not properly scrapped.
(`1474 <https://github.com/vertexproject/synapse/pull/1474>`_)
- Fix an issue with the Storm ``scrape`` command where a relative property was not accepted as an argument to the
command. Relative property syntax is now supported.
(`1474 <https://github.com/vertexproject/synapse/pull/1474>`_)

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

Features and Enhancements
-------------------------
- Allow Storm expression syntax to handle None values gracefully for comparison purposes.
(`1459 <https://github.com/vertexproject/synapse/pull/1459>`_)

Bugfixes
--------
- Fix a bug where removal of a tagprop didn't update the Node object in memory.
(`1454 <https://github.com/vertexproject/synapse/pull/1454>`_)
- Speed up unit test execution by adding an additional Storm parsing cache.
(`1455 <https://github.com/vertexproject/synapse/pull/1455>`_)
- Bump CircleCI cache keys due to a bad multidict release poisoning build caches.
(`1463 <https://github.com/vertexproject/synapse/pull/1463>`_)
- Added an empty layer migration to prevent Cortex downgrading prior to v0.1.41. This is to prevent a user from running
a Cortex on older code, as reverting a Cortex created/used with a Synapse version greater than or equal to v0.1.33 and
v0.1.34, to a version prior than those, can result in apparent data loss. Data is not actually lost but would require
non-trivial effort to recover.
(`1458 <https://github.com/vertexproject/synapse/pull/1458>`_)

Improved Documentation
----------------------
- Fix a broken link. Thank you aaronst for the bug report.
(`1448 <https://github.com/vertexproject/synapse/pull/1448>`_)
(`1463 <https://github.com/vertexproject/synapse/pull/1463>`_)

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

Features and Enhancements
-------------------------
- Add a refs flag to the graph rules which allow getting all refs including edges and make this the default behavior
when ``graph`` option is set to ``True`` when calling ``storm()/eval()`` apis.
(`1453 <https://github.com/vertexproject/synapse/pull/1453>`_)

Bugfixes
--------
- Make error messages for ``geo:dist`` type normalization more understandable.
(`1447 <https://github.com/vertexproject/synapse/pull/1447>`_)
- Fix permissions checks for Storm queue objects being made by non-object owners.
(`1452 <https://github.com/vertexproject/synapse/pull/1452>`_)

Improved Documentation
----------------------
- Some small wordsmithing.
(`1449 <https://github.com/vertexproject/synapse/pull/1449>`_)

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

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

- Group Storm commands which came from Storm packages together when the ``storm help`` command is issued.
(`1440 <https://github.com/vertexproject/synapse/pull/1440>`_)
- Add the secondary property ``:url`` to the ``ou:conference`` form to track ``inet:url`` nodes associated with a
conference.
(`1441 <https://github.com/vertexproject/synapse/pull/1441>`_)
- Add ``:names`` as a secondary property to ``ou:org`` to allow tracking multiple, secondary names for an organization.
(`1444 <https://github.com/vertexproject/synapse/pull/1444>`_)
- The StormType ``$lib.ingest.feed()`` now places the runtime Snap into less-strict mode during execution to prevent
potentially data causing the Storm runtime to be torn down. Errors during node creation or property sets will now
cause ``warn`` messages to be emitted in the message stream.
(`1442 <https://github.com/vertexproject/synapse/pull/1442>`_)

Bugfixes
--------
- Fix an issue where Storm command names were truncated when the ``storm help`` command was issued.
(`1440 <https://github.com/vertexproject/synapse/pull/1440>`_)
- Fix a Storm grammar issue that disallowed ``$(1 and 1 and 0)`` style of expressions.
(`1439 <https://github.com/vertexproject/synapse/pull/1439>`_)
- Fix the CryoApi and CryoCell ``delete()`` APIs used to remove a Cryotank from a CryoCell.
(`1443 <https://github.com/vertexproject/synapse/pull/1443>`_)
- Make NoSuchName errors in StormTypes more friendly by always including the missing name.
(`1445 <https://github.com/vertexproject/synapse/pull/1445>`_)
- When deferencing a value off of a StormType, if a NoSuchName was thrown it was unclear what type of object was being
deferenced, which could lead to difficult to debug Storm code. The NoSuchName errors now includes the class name
of the object to assist with debugging those errors.
(`1445 <https://github.com/vertexproject/synapse/pull/1445>`_)

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

Features and Enhancements
-------------------------
- Add the query text to the error message when a remote Storm query encounters a fatal exception.
(`1432 <https://github.com/vertexproject/synapse/pull/1432>`_)
- Add provenance claim information to provenance recursion errors for better debugging of provenance issues.
(`1432 <https://github.com/vertexproject/synapse/pull/1432>`_)
- Capture ``print`` events from inside of a Storm Daemon and log those to the ``synapse.lib.storm`` logger.
(`1434 <https://github.com/vertexproject/synapse/pull/1434>`_)
- Add ``$lib.list()`` to StormTypes to allow construction of a List StormType.
(`1434 <https://github.com/vertexproject/synapse/pull/1434>`_)
- Add ``:loc`` secondary property to ``mat:item``, ``it:host``, and ``geo:nloc`` forms.
(`1437 <https://github.com/vertexproject/synapse/pull/1437>`_)
- Split a Storm Daemon task into two components; a ``storm:dmon:main`` and ``storm:dmon:loop`` task. Killing the
``storm:dmon:loop`` task will cause the ``storm:dmon:main`` task to respawn the inner task executing Storm.
(`1436 <https://github.com/vertexproject/synapse/pull/1436>`_)

Bugfixes
--------
- Fix a bug where a Storm Daemon coroutine was promoted to a Synapse Task with an incorrect user value.
(`1435 <https://github.com/vertexproject/synapse/pull/1435>`_)
- Fix a Storm Runtime variable scoping issue preventing Storm functions from calling other Storm functions in the same
scope they are declared in.
(`1435 <https://github.com/vertexproject/synapse/pull/1435>`_)
- Fix an bug producing an ambiguity in the Storm ``switch`` case statement. This bugfix does require switch case
statements with a space in them to be enclosed in single or double quotes.
(`1438 <https://github.com/vertexproject/synapse/pull/1438>`_)