synapse 2.182.0__py311-none-any.whl → 2.183.0__py311-none-any.whl

synapse/cortex.py

@@ -1453,6 +1453,11 @@ class Cortex(s_oauth.OAuthMixin, s_cell.Cell):  # type: ignore
             {'perm': ('storm', 'macro', 'edit'), 'gate': 'cortex',
              'desc': 'Controls access to edit a storm macro.'},
 
+            {'perm': ('task', 'get'), 'gate': 'cortex',
+             'desc': 'Controls access to view other users tasks.'},
+            {'perm': ('task', 'del'), 'gate': 'cortex',
+             'desc': 'Controls access to terminate other users tasks.'},
+
             {'perm': ('view',), 'gate': 'cortex',
              'desc': 'Controls all view permissions.'},
             {'perm': ('view', 'add'), 'gate': 'cortex',

synapse/lib/ast.py

@@ -4517,7 +4517,7 @@ class EditTagAdd(Edit):
         else:
             oper_offset = 0
 
-        excignore = (s_exc.BadTypeValu,) if oper_offset == 1 else ()
+        excignore = (s_exc.BadTypeValu, s_exc.BadTag) if oper_offset == 1 else ()
 
         hasval = len(self.kids) > 2 + oper_offset
 

synapse/lib/autodoc.py

@@ -28,6 +28,7 @@ stormtype_doc_schema = {
                          'description': 'For a function argument, the name of the argument.'},
                 'desc': {'type': 'string',
                          'description': 'For a function argument or return value, the description of the value.'},
+                'deprecated': {'$ref': '#/definitions/deprecatedItem'},
                 'type': {'$ref': '#/definitions/stormType'},
                 'args': {
                     'type': 'array',
@@ -46,7 +47,28 @@ stormtype_doc_schema = {
                            'documentation for.',
             'additionalProperties': False,
         },
-
+        'deprecatedItem': {
+            'type': 'object',
+            'properties': {
+                'eolvers': {'type': 'string', 'minLength': 1,
+                            'description': "The version which will not longer support the item."},
+                'eoldate': {'type': 'string', 'minLength': 1,
+                            'description': 'Optional string indicating Synapse releases after this date may no longer support the item.'},
+                'mesg': {'type': ['string', 'null'], 'default': None,
+                         'description': 'Optional message to include in the warning text.'}
+            },
+            'oneOf': [
+                {
+                    'required': ['eolvers'],
+                    'not': {'required': ['eoldate']}
+                },
+                {
+                    'required': ['eoldate'],
+                    'not': {'required': ['eolvers']}
+                }
+            ],
+            'additionalProperties': False,
+        },
         'stormtypeDoc': {
             'type': 'object',
             'properties': {
@@ -54,6 +76,7 @@ stormtype_doc_schema = {
                          'description': 'The name of the object.'},
                 'desc': {'type': 'string',
                          'description': 'The docstring of the object.'},
+                'deprecated': {'$ref': '#/definitions/deprecatedItem'},
                 'type': {'$ref': '#/definitions/stormType'}
             },
             'additionalProperties': False,
@@ -186,6 +209,34 @@ def getArgLines(rtype):
 
     return lines
 
+def genDeprecationWarning(name, depr, runt=False):
+    assert name is not None
+    assert depr is not None
+    lines = []
+    if runt:
+        lines.append('.. warning::')
+    else:
+        lines.append('Warning:')
+
+    mesg = depr.get('mesg')
+    date = depr.get('eoldate')
+    vers = depr.get('eolvers')
+
+    ws = ''
+    if runt:
+        ws = '   '
+
+    if date:
+        lines.append(f'{ws}``{name}`` has been deprecated and will be removed on or after {date}.')
+    else:
+        lines.append(f'{ws}``{name}`` has been deprecated and will be removed in version {vers}.')
+    if mesg:
+        lines.append(f'{ws}{mesg}')
+
+    lines.append('\n')
+
+    return lines
+
 def runtimeGetArgLines(rtype):
     lines = []
     args = rtype.get('args', ())
@@ -424,6 +475,9 @@ def docStormTypes(page, docinfo, linkprefix, islib=False, lvl=1,
             assert rtype is not None
 
             link = f'.. _{linkprefix}-{loclname.replace(":", ".").replace(".", "-")}:'
+            lines = []
+            if depr := locl.get('deprecated'):
+                lines.extend(genDeprecationWarning(f'${loclname}', depr, True))
 
             if isinstance(rtype, dict):
                 rname = rtype.get('type')
@@ -445,7 +499,7 @@ def docStormTypes(page, docinfo, linkprefix, islib=False, lvl=1,
                 if rname == 'stor' or 'stor' in rname:
                     isstor = True
 
-                lines = prepareRstLines(desc)
+                lines.extend(prepareRstLines(desc))
                 arglines = getArgLines(rtype)
                 lines.extend(arglines)
 
@@ -461,7 +515,7 @@ def docStormTypes(page, docinfo, linkprefix, islib=False, lvl=1,
 
             else:
                 header = name
-                lines = prepareRstLines(desc)
+                lines.extend(prepareRstLines(desc))
 
                 retlines = getReturnLines(rtype, known_types=known_types, types_prefix=types_prefix,
                                           suffix=types_suffix)
@@ -472,6 +526,7 @@ def docStormTypes(page, docinfo, linkprefix, islib=False, lvl=1,
                 header = f'${header}'
 
             page.addHead(header, lvl=lvl + 1, link=link)
+
             page.addLines(*lines)
 
 def runtimeDocStormTypes(page, docinfo, islib=False, lvl=1,
@@ -568,13 +623,17 @@ def runtimeDocStormTypes(page, docinfo, islib=False, lvl=1,
             assert desc is not None
             assert rtype is not None
 
+            lines = []
+            if (depr := locl.get('deprecated')) and not oneline:
+                lines.extend(genDeprecationWarning(f'${loclname}', depr))
+
             if isinstance(rtype, dict):
                 rname = rtype.get('type')
 
                 if isinstance(rname, dict):
                     raise AssertionError(f'rname as dict not supported loclname={loclname} rname={rname}')
 
-                lines = prepareRstLines(desc)
+                lines.extend(prepareRstLines(desc))
                 arglines = runtimeGetArgLines(rtype)
                 lines.extend(arglines)
 
@@ -588,7 +647,7 @@ def runtimeDocStormTypes(page, docinfo, islib=False, lvl=1,
 
             else:
                 header = name
-                lines = prepareRstLines(desc)
+                lines.extend(prepareRstLines(desc))
 
                 retlines = runtimeGetReturnLines(rtype)
                 lines.extend(retlines)

synapse/lib/storm.py

@@ -342,6 +342,7 @@ reqValidPkgdef = s_config.getJsValidator({
             'properties': {
                 'name': {'type': 'string'},
                 'desc': {'type': 'string'},
+                'deprecated': {'$ref': '#/definitions/deprecatedItem'},
                 'type': {
                     'type': 'object',
                     'properties': {
@@ -395,6 +396,28 @@ reqValidPkgdef = s_config.getJsValidator({
             'additionalProperties': False,
             'required': ['name', 'desc', 'type']
         },
+        'deprecatedItem': {
+            'type': 'object',
+            'properties': {
+                'eolvers': {'type': 'string', 'minLength': 1,
+                            'description': "The version which will not longer support the item."},
+                'eoldate': {'type': 'string', 'minLength': 1,
+                            'description': 'Optional string indicating Synapse releases after this date may no longer support the item.'},
+                'mesg': {'type': ['string', 'null'], 'default': None,
+                         'description': 'Optional message to include in the warning text.'}
+            },
+            'oneOf': [
+                {
+                    'required': ['eolvers'],
+                    'not': {'required': ['eoldate']}
+                },
+                {
+                    'required': ['eoldate'],
+                    'not': {'required': ['eolvers']}
+                }
+            ],
+            'additionalProperties': False,
+        },
         'apitype': {
             'type': 'string',
         },

synapse/lib/stormlib/cortex.py

@@ -715,6 +715,7 @@ class HttpPermsList(s_stormtypes.List):
                   ),
                   'returns': {'type': 'any', 'desc': 'The permission present in the list at the index position.', }}},
         {'name': 'length', 'desc': 'Get the length of the list. This is deprecated; please use ``.size()`` instead.',
+         'deprecated': {'eolvers': 'v3.0.0'},
          'type': {'type': 'function', '_funcname': '_methListLength',
                   'returns': {'type': 'int', 'desc': 'The size of the list.', }}},
         {'name': 'append', 'desc': 'Append a permission to the list.',

synapse/lib/stormlib/infosec.py

@@ -537,6 +537,7 @@ class CvssLib(s_stormtypes.Lib):
                   'returns': {'type': 'dict', 'desc': 'A dictionary containing the computed score and subscores.', }
         }},
         {'name': 'vectToProps', 'desc': 'Parse a CVSS v3.1 vector and return a dictionary of risk:vuln props.',
+         'deprecated': {'eolvers': 'v3.0.0'},
          'type': {'type': 'function', '_funcname': 'vectToProps',
                   'args': (
                       {'name': 'text', 'type': 'str', 'desc': 'A CVSS vector string.'},
@@ -544,6 +545,7 @@ class CvssLib(s_stormtypes.Lib):
                   'returns': {'type': 'dict', 'desc': 'A dictionary of risk:vuln secondary props.', }
         }},
         {'name': 'saveVectToNode', 'desc': 'Parse a CVSS v3.1 vector and record properties on a risk:vuln node.',
+         'deprecated': {'eolvers': 'v3.0.0'},
          'type': {'type': 'function', '_funcname': 'saveVectToNode',
                   'args': (
                       {'name': 'node', 'type': 'node',

synapse/lib/stormlib/model.py

@@ -543,7 +543,7 @@ class ModelType(s_stormtypes.Prim):
 @s_stormtypes.registry.registerLib
 class LibModelEdge(s_stormtypes.Lib):
     '''
-    A Storm Library for interacting with light edges and manipulating their key-value attributes.
+    A Storm Library for interacting with light edges and manipulating their key-value attributes. This Library is deprecated.
     '''
     _storm_locals = (
         {'name': 'get', 'desc': 'Get the key-value data for a given Edge verb.',
@@ -588,6 +588,7 @@ class LibModelEdge(s_stormtypes.Lib):
     hivepath = ('cortex', 'model', 'edges')
 
     _storm_lib_path = ('model', 'edge')
+    _storm_lib_deprecation = {'eolvers': 'v3.0.0'}
 
     def __init__(self, runt, name=()):
         s_stormtypes.Lib.__init__(self, runt, name)

synapse/lib/stormlib/random.py

@@ -1,10 +1,77 @@
 import random
 
 import synapse.exc as s_exc
+import synapse.common as s_common
+
 import synapse.lib.stormtypes as s_stormtypes
 
+from typing import Optional
+
 randinst = random.SystemRandom()
 
+
+@s_stormtypes.registry.registerType
+class Random(s_stormtypes.StormType):
+    '''
+    A random number generator.
+    '''
+    _storm_typename = 'random'
+    _storm_locals = (
+        {'name': 'int', 'desc': 'Generate a random integer.',
+         'type': {'type': 'function', '_funcname': '_methInt',
+                  'args': (
+                      {'name': 'maxval', 'type': 'int', 'desc': 'The maximum random value.'},
+                      {'name': 'minval', 'type': 'int', 'desc': 'The minimum random value.', 'default': 0},
+                  ),
+                  'returns': {'type': 'int', 'desc': 'A random integer in the range min-max inclusive.'}}},
+        {'name': 'seed', 'desc': 'The seed used for the generator. Setting this value resets the generator state.',
+         'type': {'type': ['gtor', 'stor'], '_storfunc': '_storSeed', '_gtorfunc': '_gtorSeed',
+                  'returns': {'type': ['str', 'null']}}},
+    )
+    _ismutable = False
+
+    def __init__(self, runt, seed: Optional[str] =None):
+        s_stormtypes.StormType.__init__(self)
+        self.runt = runt
+        self._seed = seed
+        self.robj = random.Random()
+        if seed is not None:
+            self.robj.seed(self._seed, version=2)
+        self.locls.update(self.getObjLocals())
+        self.gtors.update({
+            'seed': self._gtorSeed,
+        })
+        self.stors.update({
+            'seed': self._storSeed,
+        })
+
+    async def stormrepr(self):
+        ret = f'{self._storm_typename}'
+        if self._seed is not None:
+            ret = f'{ret} seed={s_common.trimText(self._seed, n=40)}'
+        return ret
+
+    def getObjLocals(self):
+        return {
+            'int': self._methInt,
+        }
+
+    async def _gtorSeed(self):
+        return self._seed
+
+    async def _storSeed(self, seed):
+        self._seed = await s_stormtypes.tostr(seed, noneok=True)
+        self.robj.seed(self._seed)
+
+    @s_stormtypes.stormfunc(readonly=True)
+    async def _methInt(self, maxval, minval=0):
+        maxval = await s_stormtypes.toint(maxval)
+        minval = await s_stormtypes.toint(minval)
+        if minval > maxval:
+            raise s_exc.BadArg(mesg=f'Minval must be less than or equal to maxval, minval={minval}, maxval={maxval}',
+                               minval=minval, maxval=maxval)
+        return self.robj.randint(minval, maxval)
+
 @s_stormtypes.registry.registerLib
 class LibRandom(s_stormtypes.Lib):
     '''
@@ -12,22 +79,36 @@ class LibRandom(s_stormtypes.Lib):
     '''
     _storm_locals = (
         {'name': 'int', 'desc': 'Generate a random integer.',
-         'type': {'type': 'function', '_funcname': '_int',
+         'type': {'type': 'function', '_funcname': '_methInt',
                   'args': (
                       {'name': 'maxval', 'type': 'int', 'desc': 'The maximum random value.'},
                       {'name': 'minval', 'type': 'int', 'desc': 'The minimum random value.', 'default': 0},
                   ),
                   'returns': {'type': 'int', 'desc': 'A random integer in the range min-max inclusive.'}}},
+        {'name': 'generator', 'desc': 'Make a random generator with a given seed.',
+         'type': {'type': 'function', '_funcname': '_methGenerator',
+                  'args': (
+                      {'name': 'seed', 'type': 'str', 'default': None,
+                       'desc': 'The seed value used for the random generator.'},
+                  ),
+                  'returns': {'type': 'random', 'desc': 'The random generator object.'}}
+        }
     )
     _storm_lib_path = ('random',)
 
     def getObjLocals(self):
         return {
-            'int': self._int,
+            'int': self._methInt,
+            'generator': self._methGenerator,
         }
 
     @s_stormtypes.stormfunc(readonly=True)
-    async def _int(self, maxval, minval=0):
+    async def _methGenerator(self, seed=None):
+        seed = await s_stormtypes.tostr(seed, noneok=True)
+        return Random(self.runt, seed=seed)
+
+    @s_stormtypes.stormfunc(readonly=True)
+    async def _methInt(self, maxval, minval=0):
         maxval = await s_stormtypes.toint(maxval)
         minval = await s_stormtypes.toint(minval)
         if minval > maxval:

synapse/lib/stormtypes.py

@@ -277,6 +277,7 @@ class StormTypesRegistry:
                 'desc': getDoc(slib, sname),
                 'locals': locs,
                 'path': ('lib',) + slib._storm_lib_path,
+                'deprecated': slib._storm_lib_deprecation,
             }
             for info in sorted(slib._storm_locals, key=lambda x: x.get('name')):
                 info = s_msgpack.deepcopy(info)
@@ -509,6 +510,7 @@ class Lib(StormType):
     _storm_query = None
     _storm_typename = 'lib'
     _storm_lib_perms = ()
+    _storm_lib_deprecation = None
 
     def __init__(self, runt, name=()):
         StormType.__init__(self)
@@ -2659,6 +2661,7 @@ class LibBytes(Lib):
                   'returns': {'type': 'list', 'desc': 'A tuple of the file size and sha256 value.', }}},
     )
     _storm_lib_path = ('bytes',)
+    _storm_lib_deprecation = {'eolvers': 'v3.0.0'}
 
     def getObjLocals(self):
         return {
@@ -5005,6 +5008,7 @@ class List(Prim):
                   ),
                   'returns': {'type': 'any', 'desc': 'The item present in the list at the index position.', }}},
         {'name': 'length', 'desc': 'Get the length of the list. This is deprecated; please use ``.size()`` instead.',
+         'deprecated': {'eolvers': 'v3.0.0'},
          'type': {'type': 'function', '_funcname': '_methListLength',
                   'returns': {'type': 'int', 'desc': 'The size of the list.', }}},
         {'name': 'append', 'desc': 'Append a value to the list.',

synapse/lib/version.py

@@ -223,6 +223,6 @@ def reqVersion(valu, reqver,
 ##############################################################################
 # The following are touched during the release process by bumpversion.
 # Do not modify these directly.
-version = (2, 182, 0)
+version = (2, 183, 0)
 verstring = '.'.join([str(x) for x in version])
-commit = '72e535c8c22073fd1b7428121849de4b9fb034ae'
+commit = '68e4f3dd36f4ff9dd7818ea2c8180b086092148f'

synapse/models/infotech.py

@@ -2709,15 +2709,12 @@ class ItModule(s_module.CoreModule):
                         'doc': 'The path for the file.',
                     }),
                     ('path:dir', ('file:path', {}), {
-                        'ro': True,
                         'doc': 'The parent directory of the file path (parsed from :path).',
                     }),
                     ('path:ext', ('str', {'lower': True, 'strip': True}), {
-                        'ro': True,
                         'doc': 'The file extension of the file name (parsed from :path).',
                     }),
                     ('path:base', ('file:base', {}), {
-                        'ro': True,
                         'doc': 'The final component of the file path (parsed from :path).',
                     }),
                     ('file', ('file:bytes', {}), {
@@ -2755,15 +2752,12 @@ class ItModule(s_module.CoreModule):
                         'doc': 'The path where the file was created.',
                     }),
                     ('path:dir', ('file:path', {}), {
-                        'ro': True,
                         'doc': 'The parent directory of the file path (parsed from :path).',
                     }),
                     ('path:ext', ('str', {'lower': True, 'strip': True}), {
-                        'ro': True,
                         'doc': 'The file extension of the file name (parsed from :path).',
                     }),
                     ('path:base', ('file:base', {}), {
-                        'ro': True,
                         'doc': 'The final component of the file path (parsed from :path).',
                     }),
                     ('file', ('file:bytes', {}), {
@@ -2789,15 +2783,12 @@ class ItModule(s_module.CoreModule):
                         'doc': 'The path where the file was deleted.',
                     }),
                     ('path:dir', ('file:path', {}), {
-                        'ro': True,
                         'doc': 'The parent directory of the file path (parsed from :path).',
                     }),
                     ('path:ext', ('str', {'lower': True, 'strip': True}), {
-                        'ro': True,
                         'doc': 'The file extension of the file name (parsed from :path).',
                     }),
                     ('path:base', ('file:base', {}), {
-                        'ro': True,
                         'doc': 'The final component of the file path (parsed from :path).',
                     }),
                     ('file', ('file:bytes', {}), {
@@ -2823,15 +2814,12 @@ class ItModule(s_module.CoreModule):
                         'doc': 'The path where the file was read.',
                     }),
                     ('path:dir', ('file:path', {}), {
-                        'ro': True,
                         'doc': 'The parent directory of the file path (parsed from :path).',
                     }),
                     ('path:ext', ('str', {'lower': True, 'strip': True}), {
-                        'ro': True,
                         'doc': 'The file extension of the file name (parsed from :path).',
                     }),
                     ('path:base', ('file:base', {}), {
-                        'ro': True,
                         'doc': 'The final component of the file path (parsed from :path).',
                     }),
                     ('file', ('file:bytes', {}), {
@@ -2857,15 +2845,12 @@ class ItModule(s_module.CoreModule):
                         'doc': 'The path where the file was written to/modified.',
                     }),
                     ('path:dir', ('file:path', {}), {
-                        'ro': True,
                         'doc': 'The parent directory of the file path (parsed from :path).',
                     }),
                     ('path:ext', ('str', {'lower': True, 'strip': True}), {
-                        'ro': True,
                         'doc': 'The file extension of the file name (parsed from :path).',
                     }),
                     ('path:base', ('file:base', {}), {
-                        'ro': True,
                         'doc': 'The final component of the file path (parsed from :path).',
                     }),
                     ('file', ('file:bytes', {}), {

synapse/tests/files/stormpkg/testpkg.yaml

@@ -30,6 +30,16 @@ modules:
             returns:
               type: dict
               desc: A status dictionary.
+        - name: newp
+          desc: Some nonexistent function.
+          deprecated:
+            eolvers: v2.300.4
+            mesg: Newp is no longer maintained. Use bar() instead.
+          type:
+            type: function
+            returns:
+              type: 'null'
+              desc: '``newp()`` does not return data.'
 
 onload: |
   $lib.time.sleep($lib.globals.get(onload_sleep, 0))

synapse/tests/test_cortex.py

@@ -2985,6 +2985,16 @@ class CortexBasicTest(s_t_utils.SynTest):
             info = await view.pack()
             self.eq(info['name'], 'default')
 
+            depr = [x for x in coreinfo['stormdocs']['libraries'] if x['path'] == ('lib', 'bytes')]
+            self.len(1, depr)
+            deprinfo = depr[0].get('deprecated')
+            self.nn(deprinfo)
+            self.eq(deprinfo.get('eolvers'), 'v3.0.0')
+
+            depr = [x for x in coreinfo['stormdocs']['libraries'] if x['path'] == ('lib', 'infosec', 'cvss')]
+            self.len(1, depr)
+            self.len(2, [x for x in depr[0]['locals'] if x.get('deprecated')])
+
     async def test_cortex_model_dict(self):
 
         async with self.getTestCoreAndProxy() as (core, prox):
@@ -7195,6 +7205,12 @@ class CortexBasicTest(s_t_utils.SynTest):
             with self.raises(s_exc.BadTag):
                 await core.nodes('[ inet:ipv4=1.2.3.4 +#cno.cve.12345 ]')
 
+            nodes = await core.nodes('[ test:str=beep +?#cno.cve.12345 ]')
+            self.len(1, nodes)
+            self.none(nodes[0].get('#cno'))
+            self.none(nodes[0].get('#cno.cve'))
+            self.none(nodes[0].get('#cno.cve.12345'))
+
             self.eq((None, None, '[0-9]{4}', '[0-9]{5}'), await core.callStorm('''
                 return($lib.model.tags.pop(cno.cve, regex))
             '''))

synapse/tests/test_lib_autodoc.py

@@ -1,4 +1,6 @@
 import copy
+
+import synapse.exc as s_exc
 import synapse.lib.autodoc as s_autodoc
 import synapse.lib.stormtypes as s_stormtypes
 
@@ -153,6 +155,10 @@ LibTst for testing!
 beep(valu)
 ==========
 
+.. warning::
+   ``$lib.test.beep`` has been deprecated and will be removed on or after 8080-08-08.
+
+
 Example storm func.
 
 Notes:
@@ -173,6 +179,11 @@ Returns:
 someargs(valu, bar=$lib.true, faz=$lib.null)
 ============================================
 
+.. warning::
+   ``$lib.test.someargs`` has been deprecated and will be removed in version v3.0.0.
+   This is a test library was deprecated from the day it was made.
+
+
 Example storm func with args.
 
 
@@ -220,6 +231,10 @@ LibTst for testing!
 $lib.test.beep(valu)
 ====================
 
+.. warning::
+   ``$lib.test.beep`` has been deprecated and will be removed on or after 8080-08-08.
+
+
 Example storm func.
 
 Notes:
@@ -240,6 +255,11 @@ Returns:
 $lib.test.someargs(valu, bar=$lib.true, faz=$lib.null)
 ======================================================
 
+.. warning::
+   ``$lib.test.someargs`` has been deprecated and will be removed in version v3.0.0.
+   This is a test library was deprecated from the day it was made.
+
+
 Example storm func with args.
 
 
@@ -257,3 +277,14 @@ Args:
 Returns:
     The beeped string. The return type is ``str``.'''
         self.eq(text, expected)
+
+        badlocls = copy.deepcopy(libtst._storm_locals)
+        badlocls[0]['deprecated']['eolvers'] = 'v4.4.4'
+        page = s_autodoc.RstHelp()
+        doc = {
+            'desc': s_stormtypes.getDoc(libtst, "err"),
+            'path': ('lib',) + libtst._storm_lib_path,
+            'locals': badlocls,
+        }
+        with self.raises(s_exc.SchemaViolation):
+            s_autodoc.docStormTypes(page, (doc,), linkprefix='test')

synapse/tests/test_lib_storm.py

@@ -3913,6 +3913,10 @@ class StormTest(s_t_utils.SynTest):
             self.stormIsInPrint('Returns an ou:org by name, adding the node if it does not exist.\n'
                                 'Args:\n    name (str): The name of the org.', msgs)
 
+            msgs = await core.stormlist('help --verbose $lib.infosec.cvss.saveVectToNode')
+            self.stormIsInPrint('Warning', msgs)
+            self.stormIsInPrint('``$lib.infosec.cvss.saveVectToNode`` has been deprecated and will be removed in version v3.0.0.', msgs)
+
             msgs = await core.stormlist('help $lib.inet')
             self.stormIsInPrint('The following libraries are available:\n\n'
                                 '$lib.inet.http                : A Storm Library exposing an HTTP client API.\n'

synapse/tests/test_lib_stormlib_random.py

@@ -20,3 +20,96 @@ class TestLibStormRandom(s_test.SynTest):
 
             with self.raises(s_exc.BadArg):
                 await core.callStorm('return($lib.random.int(maxval=0, minval=1))')
+
+    async def test_stormlib_random_generator(self):
+        async with self.getTestCore() as core:
+
+            # Seedless generators
+            q = '''$r=$lib.random.generator()
+            return(($r.int(10), $r.int(10), $r.int(10)))
+            '''
+            valu = await core.callStorm(q)
+            for v in valu:
+                self.true(v >= 0 and v <= 10)
+
+            # There is no seed on the generator
+            q = '''$r=$lib.random.generator() return ( $r.seed )'''
+            valu = await core.callStorm(q)
+            self.none(valu)
+
+            # Generators can be made and seeds set
+            q = '''$r=$lib.random.generator() $r.seed=myCoolTestSeed
+            return ( (($r.int(10), $r.int(10), $r.int(10)), $r.seed) )'''
+            valu = await core.callStorm(q)
+            self.eq(valu, ((5, 9, 1), 'myCoolTestSeed'))
+
+            # Setting a seed resets the generator
+            q = '''$r=$lib.random.generator(seed=myCoolTestSeed) $ret=()
+            $ret.append($r.int(10)) $ret.append($r.int(10)) $ret.append($r.int(10))
+            $r.seed=myCoolTestSeed
+            $ret.append($r.int(10)) $ret.append($r.int(10)) $ret.append($r.int(10))
+            return ($ret)'''
+            valu = await core.callStorm(q)
+            self.eq(valu, (5, 9, 1, 5, 9, 1))
+
+            # Clearing the seed makes the generator random.
+            q = '''$r=$lib.random.generator(seed=myCoolTestSeed) $ret=()
+            $ret.append($r.int(10)) $ret.append($r.int(10)) $ret.append($r.int(10))
+            $r.seed=(null)
+            $ret.append($r.int(10)) $ret.append($r.int(10)) $ret.append($r.int(10))
+            return ($ret)'''
+            valu = await core.callStorm(q)
+            self.len(6, valu)
+            self.eq(valu[:3], (5, 9, 1))
+            self.ne(valu[3:], (5, 9, 1))
+            for v in valu[3:]:
+                self.true(v >= 0 and v <= 10)
+
+            # Seeded generators are consistent
+            q = '''$r=$lib.random.generator(seed=myCoolTestSeed)
+            return(($r.int(10), $r.int(10), $r.int(10)))
+            '''
+            valu = await core.callStorm(q)
+            self.eq(valu, (5, 9, 1))
+
+            new_valu = await core.callStorm(q)
+            self.eq(valu, new_valu)
+
+            q = '''$r=$lib.random.generator(seed=myCoolTestSeed)
+            $r2 = $lib.random.generator(seed=$r.seed)
+            return(($r.int(10), $r2.int(10)))
+            '''
+            valu = await core.callStorm(q)
+            self.eq(valu, (5, 5))
+
+            q = '''return($lib.vars.type($lib.random.generator(x)))'''
+            valu = await core.callStorm(q)
+            self.eq(valu, 'random')
+
+            # Seeds are stringified
+            q = '''$r=$lib.random.generator(seed=1234567890)
+            $r2 = $lib.random.generator(seed=(1234567890))
+            return(($r.int(10), $r2.int(10), $r.seed, $r2.seed))
+            '''
+            valu = await core.callStorm(q)
+            self.eq(valu, (5, 5, '1234567890', '1234567890'))
+
+            # Empty string value is still a str
+            q = '''$r=$lib.random.generator(seed='') return ($r.int(10))'''
+            valu = await core.callStorm(q)
+            self.eq(valu, 7)
+
+            # Sad path
+            with self.raises(s_exc.BadArg):
+                await core.callStorm('$r=$lib.random.generator(seed="") return($r.int(maxval=0, minval=1))')
+
+            # Printing objects
+            msgs = await core.stormlist('$lib.print($lib.random.generator())')
+            self.stormIsInPrint('random', msgs)
+            self.stormNotInPrint('seed=', msgs)
+
+            msgs = await core.stormlist('$lib.print($lib.random.generator(seed=""))')
+            self.stormIsInPrint('random seed=', msgs)
+
+            msgs = await core.stormlist('$lib.print($lib.random.generator(seed=haha))')
+            self.stormIsInPrint('random seed=haha', msgs)

synapse/tests/test_model_infotech.py

@@ -1547,6 +1547,45 @@ class InfotechModelTest(s_t_utils.SynTest):
                 self.nn(node.get('reg'))
                 self.eq(node.get('sandbox:file'), sandfile)
 
+        async with self.getTestCore() as core:
+            forms = [
+                'it:fs:file',
+                'it:exec:file:add',
+                'it:exec:file:del',
+                'it:exec:file:read',
+                'it:exec:file:write',
+            ]
+
+            for form in forms:
+                opts = {'vars': {'form': form}}
+                nodes = await core.nodes('[ *$form=($form, calc) :path="c:/windows/system32/calc.exe" ]', opts=opts)
+                self.len(1, nodes)
+                self.eq(nodes[0].get('path'), 'c:/windows/system32/calc.exe')
+                self.eq(nodes[0].get('path:base'), 'calc.exe')
+                self.eq(nodes[0].get('path:dir'), 'c:/windows/system32')
+                self.eq(nodes[0].get('path:ext'), 'exe')
+
+                nodes = await core.nodes('*$form=($form, calc) [ :path="c:/users/blackout/script.ps1" ]', opts=opts)
+                self.len(1, nodes)
+                self.eq(nodes[0].get('path'), 'c:/users/blackout/script.ps1')
+                self.eq(nodes[0].get('path:base'), 'script.ps1')
+                self.eq(nodes[0].get('path:dir'), 'c:/users/blackout')
+                self.eq(nodes[0].get('path:ext'), 'ps1')
+
+                nodes = await core.nodes('*$form=($form, calc) [ -:path:base -:path:dir -:path:ext ]', opts=opts)
+                self.len(1, nodes)
+                self.eq(nodes[0].get('path'), 'c:/users/blackout/script.ps1')
+                self.none(nodes[0].get('path:base'))
+                self.none(nodes[0].get('path:dir'))
+                self.none(nodes[0].get('path:ext'))
+
+                nodes = await core.nodes('*$form=($form, calc) [ :path="c:/users/admin/superscript.bat" ]', opts=opts)
+                self.len(1, nodes)
+                self.eq(nodes[0].get('path'), 'c:/users/admin/superscript.bat')
+                self.eq(nodes[0].get('path:base'), 'superscript.bat')
+                self.eq(nodes[0].get('path:dir'), 'c:/users/admin')
+                self.eq(nodes[0].get('path:ext'), 'bat')
+
     async def test_it_app_yara(self):
 
         async with self.getTestCore() as core:

synapse/tests/test_tools_autodoc.py

@@ -191,6 +191,12 @@ class TestAutoDoc(s_t_utils.SynTest):
 
             self.isin('status()', s)
 
+            self.isin('newp()', s)
+            self.isin('.. warning::\n', s)
+            self.isin('``newp`` has been deprecated and will be removed in version v2.300.4.', s)
+            self.isin('Newp is no longer maintained. Use bar() instead.', s)
+            self.isin('Some nonexistent function', s)
+
             # coverage for no apidefs
             rst = s_l_autodoc.RstHelp()
             await s_autodoc.processStormModules(rst, 'foo', [])

synapse/tests/utils.py

@@ -157,6 +157,7 @@ class LibTst(s_stormtypes.Lib):
     '''
     _storm_locals = (
         {'name': 'beep',
+         'deprecated': {'eoldate': '8080-08-08'},
          'desc': '''
         Example storm func.
 
@@ -169,6 +170,7 @@ class LibTst(s_stormtypes.Lib):
                   'returns': {'type': 'str', 'desc': 'The beeped string.', }}},
         {'name': 'someargs',
          'desc': '''Example storm func with args.''',
+         'deprecated': {'eolvers': 'v3.0.0', 'mesg': 'This is a test library was deprecated from the day it was made.'},
          'type': {'type': 'function', '_funcname': 'someargs',
                   'args': (
                       {'name': 'valu', 'type': 'str', 'desc': 'The value to beep.', },

synapse/tools/autodoc.py

@@ -617,7 +617,8 @@ async def processStormModules(rst, pkgname, modules):
 
             callsig = s_autodoc.genCallsig(apitype)
             rst.addHead(f'{apiname}{callsig}', lvl=4)
-
+            if depr := apidef.get('deprecated'):
+                rst.addLines(*s_autodoc.genDeprecationWarning(apiname, depr, True))
             rst.addLines(*s_autodoc.prepareRstLines(apidesc))
             rst.addLines(*s_autodoc.getArgLines(apitype))
             rst.addLines(*s_autodoc.getReturnLines(apitype))

synapse/tools/changelog.py

@@ -222,13 +222,25 @@ class ModelDiffer:
                     deprecated_props_noiface[prop] = cpinfo
                     continue
 
+                okeys = set(opinfo.keys())
+                nkeys = set(cpinfo.keys())
+
+                if nkeys - okeys:
+                    # We've added a key to the prop def.
+                    raise s_exc.NoSuchImpl(mesg='Have not implemented support for a prop def having a key added')
+
+                if okeys - nkeys:
+                    # We've removed a key from the prop def.
+                    updated_props[prop] = {'type': 'delkey', 'keys': list(okeys - nkeys)}
+                    continue
+
                 # Check if type change happened, we'll want to document that.
                 ctyp = cpinfo.get('type')
                 otyp = opinfo.get('type')
                 if ctyp == otyp:
                     continue
 
-                updated_props[prop] = {'new_type': ctyp, 'old_type': otyp}
+                updated_props[prop] = {'type': 'type_change', 'new_type': ctyp, 'old_type': otyp}
                 is_ifaceprop = False
                 for iface in self.cur_type2iface[form]:
                     upt_iface = self.changes.get('interfaces').get('updated_interfaces', {}).get(iface)
@@ -237,7 +249,7 @@ class ModelDiffer:
                         break
                 if is_ifaceprop:
                     continue
-                updated_props_noiface[prop] = {'new_type': ctyp, 'old_type': otyp}
+                updated_props_noiface[prop] = {'type': 'type_change', 'new_type': ctyp, 'old_type': otyp}
 
             if updated_props:
                 updated_forms[form]['updated_properties'] = updated_props
@@ -317,13 +329,25 @@ class ModelDiffer:
                     deprecated_props[prop] = cpinfo
                     continue
 
+                okeys = set(opinfo.keys())
+                nkeys = set(cpinfo.keys())
+
+                if nkeys - okeys:
+                    # We've added a key to the prop def.
+                    raise s_exc.NoSuchImpl(mesg='Have not implemented support for a prop def having a key added')
+
+                if okeys - nkeys:
+                    # We've removed a key from the prop def.
+                    updated_props[prop] = {'type': 'delkey', 'keys': list(okeys - nkeys)}
+                    continue
+
                 # Check if type change happened, we'll want to document that.
                 ctyp = cpinfo.get('type')
                 otyp = opinfo.get('type')
                 if ctyp == otyp:
                     continue
 
-                updated_props[prop] = {'new_type': ctyp, 'old_type': otyp}
+                updated_props[prop] = {'type': 'type_change', 'new_type': ctyp, 'old_type': otyp}
             if updated_props:
                 updated_interfaces[iface]['updated_properties'] = updated_props
 
@@ -569,8 +593,14 @@ def _gen_model_rst(version, model_ref, changes, current_model, outp: s_output.Ou
                         lines.append('\n')
                 elif key == 'updated_properties':
                     for prop, pnfo in sorted(valu.items(), key=lambda x: x[0]):
-                        mesg = f'The property ``{prop}`` has been modified from {pnfo.get("old_type")}' \
-                               f' to {pnfo.get("new_type")}.'
+                        ptyp = pnfo.get('type')
+                        if ptyp == 'type_change':
+                            mesg = f'The property ``{prop}`` has been modified from {pnfo.get("old_type")}' \
+                                   f' to {pnfo.get("new_type")}.'
+                        elif ptyp == 'delkey':
+                            mesg = f'The property ``{prop}`` had the ``{pnfo.get("keys")}`` keys removed from its definition.'
+                        else:
+                            raise s_exc.NoSuchImpl(mesg=f'pnfo.type={ptyp} not supported.')
                         lines.extend(textwrap.wrap(mesg, initial_indent='  ', subsequent_indent='  ',
                                                    width=width))
                         lines.append('\n')
@@ -621,11 +651,17 @@ def _gen_model_rst(version, model_ref, changes, current_model, outp: s_output.Ou
             rst.addLines(f'``{form}``')
             upd_form_props = list(info.get('updated_properties').items())
             if len(upd_form_props) > 1:
-                rst.addLines('  The form had the following updated properties:', '\n')
+                rst.addLines('  The form had the following properties updated:', '\n')
                 upd_form_props.sort(key=lambda x: x[0])
                 for prop, pnfo in upd_form_props:
-                    mesg = f'The property ``{prop}`` has been modified from {pnfo.get("old_type")}' \
-                           f' to {pnfo.get("new_type")}.'
+                    ptyp = pnfo.get('type')
+                    if ptyp == 'type_change':
+                        mesg = f'The property ``{prop}`` has been modified from {pnfo.get("old_type")}' \
+                               f' to {pnfo.get("new_type")}.'
+                    elif ptyp == 'delkey':
+                        mesg = f'The property ``{prop}`` had the ``{pnfo.get("keys")}`` keys removed from its definition.'
+                    else:
+                        raise s_exc.NoSuchImpl(mesg=f'pnfo.type={ptyp} not supported.')
                     lines = [
                         *textwrap.wrap(mesg, initial_indent='    ', subsequent_indent='    ',
                                        width=width),
@@ -635,8 +671,15 @@ def _gen_model_rst(version, model_ref, changes, current_model, outp: s_output.Ou
 
             else:
                 prop, pnfo = upd_form_props[0]
-                mesg = f'The property ``{prop}`` has been modified from {pnfo.get("old_type")}' \
-                       f' to {pnfo.get("new_type")}.'
+                ptyp = pnfo.get('type')
+                if ptyp == 'type_change':
+                    mesg = f'The property ``{prop}`` has been modified from {pnfo.get("old_type")}' \
+                           f' to {pnfo.get("new_type")}.'
+                elif ptyp == 'delkey':
+                    mesg = f'The property ``{prop}`` had the ``{pnfo.get("keys")}`` keys removed from its definition.'
+                else:
+                    raise s_exc.NoSuchImpl(mesg=f'pnfo.type={ptyp} not supported.')
+
                 lines = [
                     '  The form had the following property updated:',
                     '\n',

{synapse-2.182.0.dist-info → synapse-2.183.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: synapse
-Version: 2.182.0
+Version: 2.183.0
 Summary: Synapse Intelligence Analysis Framework
 Author-email: The Vertex Project LLC <root@vertex.link>
 License: Apache License 2.0

{synapse-2.182.0.dist-info → synapse-2.183.0.dist-info}/RECORD

@@ -2,7 +2,7 @@ synapse/__init__.py,sha256=R2kOXlF5j-8m6G0JkHuN7rXRPg_tHLmbMxr__94mHQk,1145
 synapse/axon.py,sha256=DQu_Ps4BDRDnmdHmqCbpd3W_91yzhdo7AzAk-wtQC3s,61520
 synapse/cells.py,sha256=eNvdglfAoTURVhGOLGcgMXCGpfsIX1a02SQnyiklo3E,308
 synapse/common.py,sha256=JRGiA6FCkCZP2pBc3s_H7MsQGwc9jU_vkJFQP3XpVLs,36523
-synapse/cortex.py,sha256=GD-LqaPLRisk7EKm3ezb79A6B_Z3HQUjx26yPLZSQB0,254327
+synapse/cortex.py,sha256=DHJegMCR9oUfMLx3Wl_bvj_w1G1iJISAM9K5aCpvqA0,254581
 synapse/cryotank.py,sha256=oTbAOKq-q8WqAkYmY46Mc8hy85W3ZcQMxmP2EJDFyZ0,12124
 synapse/daemon.py,sha256=-xy6EnmD5CodWQs_S-v7apKILECmn5EEYBpEPG-MDns,16986
 synapse/datamodel.py,sha256=Axyn6u0Crbo1_2F0CQeJNw9pBqUGPufupHyB_tFYB_0,36785
@@ -87,9 +87,9 @@ synapse/data/jsonschemas/raw.githubusercontent.com/oasis-open/cti-stix2-json-sch
 synapse/lib/__init__.py,sha256=qLS7nt8-Iot8jnD2Xss_6wZi5lJoyv2rqxF9kkektT0,129
 synapse/lib/agenda.py,sha256=ddr6FrbDY5YslJS3vdBqUUcoh32XwiEj1OkomFg-NAg,33107
 synapse/lib/aha.py,sha256=vUFzh_s4VYSYXb73C3GYVcQRIaQow_0PSrSYOvz5wis,50308
-synapse/lib/ast.py,sha256=GqrMmTMqdTT-zFoJyvRyjbFQZNiYV_qEJBdq_ctH8X8,154963
+synapse/lib/ast.py,sha256=TDSYImz4BAuwQ8Fh4APKt6mkfr4Y-ET7t2NkKhDv-7s,154976
 synapse/lib/auth.py,sha256=MfSyR7RWWwDuSv5zQW_-CtYLJfnIuCRTEcyfa1vnxvw,52313
-synapse/lib/autodoc.py,sha256=CsGaX0tAKGh21YbIvUtvaUnZyqmsx6j-E9QD_vhKSP4,20747
+synapse/lib/autodoc.py,sha256=FW9M00ZX3kmGGzO7BQ9MVdVrbMxyC_f3OzFlCuxu0FA,22880
 synapse/lib/base.py,sha256=FfS6k30ZcS1CVfHPa5LNKog1f48rJ0xE14PI89vW7tM,23634
 synapse/lib/boss.py,sha256=rYu4jkHJ3Y5GLX23Hlrwe9H17LF27LZ0BkK_A_9Aqh0,2056
 synapse/lib/cache.py,sha256=N8BoNFQXOaYQU33LLYQcVkdV6IYjSNaUoaKue55y7H0,6275
@@ -143,12 +143,12 @@ synapse/lib/slabseqn.py,sha256=LJ2SZEsZlROBAD3mdS-3JxNVVPXXkBW8GIJXsW0OGG8,10287
 synapse/lib/snap.py,sha256=PpMDg8zp0AMLMWYyTSpLclqEX7GHRZSA-gJl-j3e6Qs,60055
 synapse/lib/spooled.py,sha256=00x_RS1TiJkfuTXwwdUcYifuECGYgC8B1tX-sX7nb_k,5385
 synapse/lib/storm.lark,sha256=c79oBF4ykuNHwq7HIPBrZl9rLAB0gZP3tNBNymEWQdQ,26315
-synapse/lib/storm.py,sha256=Y3WWjqmygawVz7-gWmdI3y1YP1hFpWVtIJtOSEdFPR8,212151
+synapse/lib/storm.py,sha256=UQviFMeomWP6EuHy-Drzk-e4XK9FRvvi1Dm00M4PQRw,213209
 synapse/lib/storm_format.py,sha256=3C7SAzxOcc7a3JUuFeVRK46C7N1En7XMy7RylSeAYoo,4790
 synapse/lib/stormctrl.py,sha256=XvyZ6M0Ew8sXsjGvRTWbXh0MjktZrGi_zQ9kNa7AWTE,285
 synapse/lib/stormhttp.py,sha256=tw0LuO0UfxZT50sfF_V9hemudv5yZc2M9nFMkGrRHRw,28884
 synapse/lib/stormsvc.py,sha256=dKREBhzYAncOXBbI-FYLRy9VusGIbRyF0TaDDz7mMXw,7581
-synapse/lib/stormtypes.py,sha256=U1E2MNvd2d9u3iSdWIOw95Xkrv08U3QKtvYY2XWcqAM,386940
+synapse/lib/stormtypes.py,sha256=4BwCyUtYxMuEqp3tUraRibFWhItftWudPICmICQfmJo,387130
 synapse/lib/stormwhois.py,sha256=efG4s1_UOShY3YD8N2OLEa_ELOnzsfLaMEMfDCJYeLQ,2275
 synapse/lib/structlog.py,sha256=qiuD7TTdwCyYEDF2f-88G2iX54SuB-lJ1pqlYokL1r8,1303
 synapse/lib/task.py,sha256=krDjQvNh0EpAs1PILK8CJJa9DMeM0depI0K8Eimp010,5733
@@ -159,7 +159,7 @@ synapse/lib/time.py,sha256=FKTYwpdvpuAj8p8sSodRjOxoA7Vu67CIbbXz55gtghk,9231
 synapse/lib/trigger.py,sha256=mnfkoBHB88JfqPoxb5oflvAaBKZpNvYdxP247YS53fE,20697
 synapse/lib/types.py,sha256=er9Jj4Mb3qh8YY4mUukyM7C164eIjO_fJeZvVJmSHFE,69500
 synapse/lib/urlhelp.py,sha256=j-DvWGi-xH0TcO0NbCuwG7guUuiV8wxIxfMyJOzDygo,2523
-synapse/lib/version.py,sha256=IDaz45RPs6DDTjr0mk7F0_KG3bRP1Lfvnipu1wNd8i8,7162
+synapse/lib/version.py,sha256=n3U-ECv-9Lwae9z0kcPVQT_TNXskSqJzf3dMBiRhj-I,7162
 synapse/lib/view.py,sha256=bP1lMl8Wm0yaMIlc4cfwobm5ojNzMsWguPFnPUkKhoM,60567
 synapse/lib/crypto/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 synapse/lib/crypto/coin.py,sha256=_dhlkzIrHT8BvHdJOWK7PDThz3sK3dDRnWAUqjRpZJc,4910
@@ -181,7 +181,7 @@ synapse/lib/stormlib/basex.py,sha256=BHnThzA7xv_wBaoxO3sVjjPGgS7K5PMXyGrFFQzmX2Y
 synapse/lib/stormlib/cache.py,sha256=uC7whmdnqaDAcZLTE1AlFQl18RXM_tYUVjpveCDgtz8,7869
 synapse/lib/stormlib/cell.py,sha256=qJlG1JvfNHdyx-xhIA-B129M-SZQoZMp_M5n3RmAsKg,13959
 synapse/lib/stormlib/compression.py,sha256=ZOEuGv0MGiXuXOfarTgVGK6lB1ta6X7tDmXvOza9TDQ,6284
-synapse/lib/stormlib/cortex.py,sha256=Ktv82cSpsSHWCGV2Po-nCwBSNj5iEB5qmkH2TJdE-ls,55559
+synapse/lib/stormlib/cortex.py,sha256=9e6KHb0jwHbIIo-zY5vxHat_7GJqSwBt_i_xW7wfgGU,55605
 synapse/lib/stormlib/easyperm.py,sha256=QNaxDhYIJIGapISs4WNHYFpbB3EyEgWAj1UlHlQD8UU,5851
 synapse/lib/stormlib/env.py,sha256=0e5w92jPl_lpVJkyOd8Ia8Lrl6bysXZZIGAT2LsxMW8,1627
 synapse/lib/stormlib/ethereum.py,sha256=hsgQD4tQpS7mS9lrbghxZF5gEwop4OeeN2Tf3CfncuY,1219
@@ -191,7 +191,7 @@ synapse/lib/stormlib/graph.py,sha256=00gFB0boj2dYv9vMY8nfIOwb2mhr_DyXOYK6O2sUrj4
 synapse/lib/stormlib/hashes.py,sha256=h0gtVLiC70FZboJH8gPSR9G53i8-T6WNCFjVfXAH4ig,4751
 synapse/lib/stormlib/hex.py,sha256=nB4nByxkiFs6Kt7V8WGXD0AnWvCtHEN5LKOj4swEsXQ,5849
 synapse/lib/stormlib/imap.py,sha256=ScF-b5JxNkgJcBpYQeewKSmJXTm5I9r7q367Dd2Edis,12733
-synapse/lib/stormlib/infosec.py,sha256=it6FX10-1NcqMORlpGFEFI9OYwQ8TBY-5KXZ2lTi7_8,30193
+synapse/lib/stormlib/infosec.py,sha256=dP8kbKiSoV2ske5R5i_F0EIK1uC9-Kiwa4GD7BatJ04,30285
 synapse/lib/stormlib/ipv6.py,sha256=Ik50Hpd6T-XCc7gVzJqmYqGQF8jfIwFIQvNCDPCMtLs,1557
 synapse/lib/stormlib/iters.py,sha256=TnceDb1bTCpDT2RgaFJ3rpXETZp2GyPzlId6iyah0Os,3159
 synapse/lib/stormlib/json.py,sha256=MwLMfrhvODvvyWXFPErUMfLJf-5_UtF54sDc0CUtcHE,5907
@@ -199,13 +199,13 @@ synapse/lib/stormlib/log.py,sha256=wdV-lqzQMM0C3GXNJKJKvkSKjk0CBsUfjd-Cl06LOtE,7
 synapse/lib/stormlib/macro.py,sha256=7iQ18mCaNZcslmfXGQvOmGQ71HxD7JeDp0HDmu5-EKM,8807
 synapse/lib/stormlib/math.py,sha256=3RKHj40GkYFiJSINa2AZZOAA-GqqeEP98bWw2JNity8,1149
 synapse/lib/stormlib/mime.py,sha256=WMDAcUiF8RkABKL8EUOScrO77pwi5EHPTko7hI2FPIE,1095
-synapse/lib/stormlib/model.py,sha256=RpDw7-YGcv95nAT3LudrhpHXM-hxt2pIdGwCopVlQ8g,52006
+synapse/lib/stormlib/model.py,sha256=iVebuWcpOqjpGiW6j6Q0IZLyNAhwtYbcMhxP7sVKoXU,52085
 synapse/lib/stormlib/modelext.py,sha256=h_uGVK-OjsFXOC--W-2WwTKVWIhDnWatSa2CRAHo4ZE,13073
 synapse/lib/stormlib/notifications.py,sha256=6y1YuMavQs34WwnW5D_KrLPZ0DQlQKg5VFU56sounSA,3305
 synapse/lib/stormlib/oauth.py,sha256=hgfjI--w8vbvgNbGvZlzINTOEdQv68nk5mB27CkC93M,13011
 synapse/lib/stormlib/pack.py,sha256=9KuF6NnN503qp2TGRid0VYs9vu7ASjeeTTXjS8fBKbY,2639
 synapse/lib/stormlib/project.py,sha256=EWigF9lWRMifl408qs3a78JEr_-QtCicCj8x6h220nc,34494
-synapse/lib/stormlib/random.py,sha256=BHcnpNkJNAM6-ZZqv98Hx1zCnJv8Guu7_jiuwr36Ht4,1331
+synapse/lib/stormlib/random.py,sha256=tDhp3dCUf6uvIFC-pDIHN0BwKK-uur1zwosc3xPtDBE,4456
 synapse/lib/stormlib/scrape.py,sha256=8KKAw9F3f1rQbqLYaVa9FXi_APczeo07kYVDtzFuZIw,6875
 synapse/lib/stormlib/smtp.py,sha256=xlyLUu3DxXx5RBu_XDltEwmvjeLbsBHNkzpS7lReLDM,7737
 synapse/lib/stormlib/spooled.py,sha256=f-JZcZBngTlWQW732mPaZ7IVwPZ9M-e4xqS9wKSYo4U,4106
@@ -238,7 +238,7 @@ synapse/models/files.py,sha256=tGb7sCb06Ehg-LmjFgA3TtJPzNHUUXcMCv-KgPgB4iU,33512
 synapse/models/geopol.py,sha256=QbSw5hhXVeOhGcB6oP1v4TPsYPbeK_3tQIYs_dLt_eU,11256
 synapse/models/geospace.py,sha256=MY1vPyZXBCQ4GJPj0RCvx0WGaYy0Rue03WfKzMCteko,19345
 synapse/models/inet.py,sha256=4iIbIW2yO5wuwR65b4ORjgPUNpviNT_XeAEgJv2Cdjg,168035
-synapse/models/infotech.py,sha256=Dn9F4tiILFsErRNzAjIwN7-wdLWATLEr9BkTXrnEUr4,147999
+synapse/models/infotech.py,sha256=k0KMSwYaAgQ_2BiF7RiHM3P-laTAeMrnsRxLm_r4WFw,147459
 synapse/models/language.py,sha256=hBVVIf5kc_FSIV7HZhWnberoc9ssxuqeff4fqC9iz4o,3640
 synapse/models/material.py,sha256=d-nonZKyJpHc32ebghtkm5tSifwVFN_ctx2kb8N4NqI,3214
 synapse/models/math.py,sha256=5zDLSwGbOcWI6T5-KspPL20sR8Bcs59pnRK2nEELzss,1775
@@ -272,7 +272,7 @@ synapse/tests/test_cmds_boss.py,sha256=SdBwM2qJHFzzfrjWYiZOLBKeye8uru7KeJ3NU_YSk
 synapse/tests/test_cmds_cortex.py,sha256=LWFz8HyuvsIGjtz2DqXYh-R-5QbiQWzLlQKqew7gabY,17157
 synapse/tests/test_cmds_hive.py,sha256=aRH_Gh8oF_1BsfpmffyhDDNIqnTqsuF2cavdtGke1-0,5912
 synapse/tests/test_common.py,sha256=2SAJ4M2iLdZuPPV-j16QVwE073VrikyW75cYTPRMjWI,16940
-synapse/tests/test_cortex.py,sha256=gSzDgNrolSuGwH6jWAYhZAD4J5F_vNcvMBzqSFxemKQ,351814
+synapse/tests/test_cortex.py,sha256=Pw78vx3Xeqs4OZUKElK-MYCUPsWY-LUNDhWL7AhpzGU,352552
 synapse/tests/test_cryotank.py,sha256=ms2VkL0aUskMi-LArTzRt8LUYw0z_y8nQfOOBDiCkvI,12027
 synapse/tests/test_daemon.py,sha256=QqKELhm1HF0q_8Kbk0Uf9fnUg3K5nLQ7MocGIyuKKIw,7715
 synapse/tests/test_data.py,sha256=f8L-q6kpMq8XPG3hq1jwlyaFRQEinSBf7ZlsRFeCuoM,196
@@ -284,7 +284,7 @@ synapse/tests/test_lib_agenda.py,sha256=nVIaM7P9JOr5IK_NtvsSdVaY2WdMYoPRh0B7Fl_v
 synapse/tests/test_lib_aha.py,sha256=nRHs14-LtnsSRi-C7nRu24g3ENN-R3S-0Uk8Oq2LVy4,61945
 synapse/tests/test_lib_ast.py,sha256=aS9WNuEh7rYndAMJnv_LwqXBRvNgu2iLOmvt6YtxUqw,178055
 synapse/tests/test_lib_auth.py,sha256=NnRMiGfVm4SQmDEBTSs1aJ1g7TKmFs3Vi8udOKJ3GaM,37815
-synapse/tests/test_lib_autodoc.py,sha256=H9Yb7cvzXOMPGBIoCCqNClcyIp6zEWcawtfudKbG-2U,6282
+synapse/tests/test_lib_autodoc.py,sha256=-MTRi1m3VCHqM90iUpQWN0x5BYu15DXKoy_YoUQsxxI,7281
 synapse/tests/test_lib_base.py,sha256=yhGOfA-OgZrdhISTXwSl6l6YGqN5nqO3pcDes6oICPg,14550
 synapse/tests/test_lib_boss.py,sha256=gZEuJnMO99Fu9gQ7Ct0g67umBW5XFCs8vcwInB5qr14,1598
 synapse/tests/test_lib_cache.py,sha256=oQgEBhm8pZFCEvMfcD3znTDQgl8Gv91fEOB-3eb2IIg,8594
@@ -332,7 +332,7 @@ synapse/tests/test_lib_slaboffs.py,sha256=FHQ8mGZ27dGqVwGk6q2UJ4gkPRZN22eIVzS8hM
 synapse/tests/test_lib_slabseqn.py,sha256=74V6jU7DRTsy_hqUFDuT4C6dPlJ6ObNnjmI9qhbbyVc,5230
 synapse/tests/test_lib_snap.py,sha256=OviJtj9N5LhBV-56TySkWvRly7f8VH9d-VBcNFLAtmg,27805
 synapse/tests/test_lib_spooled.py,sha256=dC5hba4c0MehALt4qW-cokqJl-tZsIsmABCGMIclXNM,2776
-synapse/tests/test_lib_storm.py,sha256=Pd9pZqsLLCauqZctzZqlURTpvRmiqAlupQrvmtBqzu4,221579
+synapse/tests/test_lib_storm.py,sha256=wBFqu3Nla3SD4WKhztdpAMVp_47IGM34UozwhHkmCCU,221857
 synapse/tests/test_lib_storm_format.py,sha256=tEZgQMmKAeG8FQZE5HUjOT7bnKawVTpNaVQh_3Wa630,277
 synapse/tests/test_lib_stormhttp.py,sha256=ZS8iONsisWjEi2CXx9AttiQ9bOrPs9x4GCwXlJEB_u0,42592
 synapse/tests/test_lib_stormlib_aha.py,sha256=2x3KQa64LN86wzSdJwAu3QFb5NNR3WNx1o9aD3N954o,8796
@@ -362,7 +362,7 @@ synapse/tests/test_lib_stormlib_model.py,sha256=ylsrjecdl3IxLojcmVsMmOU7i0bdTKBT
 synapse/tests/test_lib_stormlib_modelext.py,sha256=gmwmwbAeMS7bHLnVAddf__qg72LmEZ-uv9pT-DgT9Us,23338
 synapse/tests/test_lib_stormlib_oauth.py,sha256=rb6ZWyLrWwcDT32VfjdQUg3AurwlhzbQv-kXIfPeRsQ,28858
 synapse/tests/test_lib_stormlib_pack.py,sha256=YSb4dErPM3CeU0piqvhIQF_F1m3YjApo3nA14ewPWf0,1563
-synapse/tests/test_lib_stormlib_random.py,sha256=1P-7-FzDJEPQbxHEGOnIa9EfQkCjhv31Fo8BwA_wbiU,796
+synapse/tests/test_lib_stormlib_random.py,sha256=8bncEY6Unwry7h29CFqIUaAk9lkiNy7Qq9UNINeqpXE,4656
 synapse/tests/test_lib_stormlib_scrape.py,sha256=CY20KZ6y-LKCGvgMYDWLXKX8jczzld1-3sIfhBkj2Z8,9335
 synapse/tests/test_lib_stormlib_smtp.py,sha256=cQY3HReNZlRJL9lfAbHfYDoTQZvtSikbkFQhwPnPWKc,4365
 synapse/tests/test_lib_stormlib_spooled.py,sha256=GJxziVDX0TNjk7CAvuVE1LKKbRdXT3_L-OuS_ZXbAlE,6608
@@ -402,7 +402,7 @@ synapse/tests/test_model_gov_cn.py,sha256=FnfKNM_wnvmScLm4cYFSQXZ21kVaTPPDusiCD7
 synapse/tests/test_model_gov_intl.py,sha256=v5BZhQnoMurzZYhM9hkzALzQzp92KidweYxVlghXDws,770
 synapse/tests/test_model_gov_us.py,sha256=kvZ9DudBrbKtZmqGm8X-b_IOw4oJ7XZMnvTgiDkzsrY,1525
 synapse/tests/test_model_inet.py,sha256=vJs4OjwY9Bx3H9YfxuGse-hWQ_Cd7sSv17S_7fK4NUU,150463
-synapse/tests/test_model_infotech.py,sha256=IDBtj2djfqbOJ-6iIPZJAB28pjbaxZUsgpkPGMrnB2I,108688
+synapse/tests/test_model_infotech.py,sha256=W4O7CddWWi5zc5k8JSaABQNDMVVh5u0GGMNT_4Dp2D0,110691
 synapse/tests/test_model_language.py,sha256=49stF1B8_EwWJB67Xa5VXCG563Zfbr6S85iKN9Iom48,3046
 synapse/tests/test_model_material.py,sha256=M7ACDCuMtavm-xtwAIZa1M-bHVq5PCUedDfR-Ty9_F4,1975
 synapse/tests/test_model_math.py,sha256=x-rHBfm-59ueZdHXXzSi53eshldvVURoJeLeexWTL2U,826
@@ -423,7 +423,7 @@ synapse/tests/test_servers_stemcell.py,sha256=TJabX5aQVLbGNLffiVd3B7Uj5dH12Y-0Kq
 synapse/tests/test_servers_univ.py,sha256=mEeaXLeLx8Wm_58iym87lPFRhPbDL_fJ8U79i6xU5OY,3271
 synapse/tests/test_telepath.py,sha256=AfOBOe8zx71h2-VTWzROCksYwJCBvY-J_r8pa0qHOq0,44327
 synapse/tests/test_tools_aha.py,sha256=9WEg2chGwgLdhjH-KXEhRFhFencpl8zPTNbq5eQ9d-8,7280
-synapse/tests/test_tools_autodoc.py,sha256=TD4FMDCCMFTCJ8ZLuetkV6c5t_NBUB4_7XUDtn-IXmg,8592
+synapse/tests/test_tools_autodoc.py,sha256=5j3QPfaNqhHl_aKbyn7X1C8SMI7k3fAW1-0qEzX78zk,8900
 synapse/tests/test_tools_axon2axon.py,sha256=A6JU9UI8lLMCS5rJ_w5shks4Oyo_VjlXQTOPtaTBE_M,1346
 synapse/tests/test_tools_backup.py,sha256=HyqogKfvF8fLJFp97ereMu_30NIL3O5nBQO8QjsTGEQ,4242
 synapse/tests/test_tools_cellauth.py,sha256=ocCOuJ9mK-Mxzm47zZeA-ckMsKgZiLCuwsuwgkSFO1Y,12395
@@ -451,7 +451,7 @@ synapse/tests/test_tools_storm.py,sha256=QkyPX4HS67n1q4LbmsCGF9yUSyMLHK4BjNRX3JC
 synapse/tests/test_utils.py,sha256=sI-uDhUpkVQHSKHa2-czmWNvyXL2QTsCojtPAV2jueI,8688
 synapse/tests/test_utils_getrefs.py,sha256=bBV7yZ9tnOXmjqpsU1YKV5pw0behoKpzpwHJDxLjmLs,2304
 synapse/tests/test_utils_stormcov.py,sha256=H9p1vFH8kNE6qMLrGzSV0eH7KOgdZFh7QuarFe47FtU,6149
-synapse/tests/utils.py,sha256=UdujTFcuj7HHtAxyJHfofbqGCqaTU4R1FvALIsIa8eQ,76946
+synapse/tests/utils.py,sha256=9_JbJ1BtmwHvn-RWZf9wwQBvdFGi_ZGArcf7tLMrZwE,77117
 synapse/tests/files/TestUtilsGetrefs.test_basics.yaml,sha256=Ch8cEGFYfDUCZTEvzAqW5Ir79OnYb49pq4i9OJ7K9T0,8257
 synapse/tests/files/__init__.py,sha256=iqkaqGCD7UedfSwVc6hoQDu2UGSZOkybUCZeFRHAFgQ,1786
 synapse/tests/files/cpedata.json,sha256=e_wajnxn4ZClQ3-hwlOxK-2MWzLQwrqgtWVUV5dUVF4,13799445
@@ -500,7 +500,7 @@ synapse/tests/files/stormpkg/nomime.yaml,sha256=-T5YO3_Zs7mik2c8CB9-v7C-ZyclG5yE
 synapse/tests/files/stormpkg/nopath.yaml,sha256=HVYy3QchMPdGER5fuuwjUjoGJ19eNuD5hHiMKiwB4L4,56
 synapse/tests/files/stormpkg/nosuchfile.yaml,sha256=x6NxrWzuNj3oAICYK5TBJN0WhVL7fhY5DntQ40HWdCc,79
 synapse/tests/files/stormpkg/notitle.yaml,sha256=hrkizBl_JZZEW4C_9rZVynXP1K5oXs11_ymOlx0Ri4M,63
-synapse/tests/files/stormpkg/testpkg.yaml,sha256=GfEYkt2w4vGqn8z9Fa-5qjFDqWWy8vgHkLEANUp-4LM,3175
+synapse/tests/files/stormpkg/testpkg.yaml,sha256=HxVTMFdKzVzCYB4KEozCgOzxMNtBVKMusBvrOy1enS0,3504
 synapse/tests/files/stormpkg/docs/foobar.md,sha256=sisAkTRiK2UI11bxBiRV1xpwJllOrLC634H09neSnr4,7
 synapse/tests/files/stormpkg/docs/foobar.svg,sha256=ZW6cRia9bLRWi5RRgptPwYdMMfBIzxj2kPBGh1tcoRk,6
 synapse/tests/files/stormpkg/dotstorm/dotstorm.yaml,sha256=QyRZqAw3KexsRvCv07lzxVhqlpy8MhfYeTMty_JltsQ,160
@@ -517,11 +517,11 @@ synapse/tests/files/stormpkg/workflows/testpkg-baz.yaml,sha256=i1x0osBg5QF2qnbw6
 synapse/tests/files/stormpkg/workflows/testpkg-foo.yaml,sha256=zoN8HxrO1QNumYZJy5q0FJNmR3gBe4VI_546rkmc32Q,31
 synapse/tests/files/testcore/cell.yaml,sha256=fBUjBfX1L-0nGQD-VhLMy_IjrDepI9zRzbmgsVFJSYY,46
 synapse/tools/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-synapse/tools/autodoc.py,sha256=3U1OWl9ryjGX35U8WovOuZcNaeZQHIwJEXjQSqKGD1A,34950
+synapse/tools/autodoc.py,sha256=-esajH0-4ftIJHzW93t7FwQEJ4WsvH8iV5em_sf1Wlw,35082
 synapse/tools/axon2axon.py,sha256=FOaBLUrHH-r5Vw8FABwfTNGn_fJCg7jJxtP0ALpJUGM,1654
 synapse/tools/backup.py,sha256=Cz3OSaYMRND7gE55FdyjrBr3C1_qd68yJ23O4-mukCM,5969
 synapse/tools/cellauth.py,sha256=2ACKpOsOK_9F1B-HV5qhzGORSN7MhlElkL01Q710M1k,12122
-synapse/tools/changelog.py,sha256=-SYAW3LnDOrieWJDfSo6Xh_agON8bmmnSr3B44CCrnY,42902
+synapse/tools/changelog.py,sha256=MMp8rjl1p-CNIQ8_-qZC-1ld9Bz3Gya-7aaU1bf_LaU,45122
 synapse/tools/cmdr.py,sha256=VdXzGU6ekhgvO0LmXFQlIWwH-T0v_q0VBZsKqONmhlg,1692
 synapse/tools/csvtool.py,sha256=n3TB1qLgb7-0Du6Z6CZtu2vxaHUtzncwr2aQmQjgzi0,7477
 synapse/tools/easycert.py,sha256=naoYnWfg0m6NrBraKUVk3FK5OW53yVBZH8rv6RrXRH8,4531
@@ -600,8 +600,8 @@ synapse/vendor/xrpl/tests/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJW
 synapse/vendor/xrpl/tests/test_codec.py,sha256=Zwq6A5uZUK_FWDL3BA932c5b-rL3hnC6efobWHSLC4o,6651
 synapse/vendor/xrpl/tests/test_main.py,sha256=kZQwWk7I6HrP-PMvLdsUUN4POvWD9I-iXDHOwdeF090,4299
 synapse/vendor/xrpl/tests/test_main_test_cases.py,sha256=vTlUM4hJD2Hd2wCIdd9rfsvcMZZZQmNHWdCTTFeGz2Y,4221
-synapse-2.182.0.dist-info/LICENSE,sha256=xllut76FgcGL5zbIRvuRc7aezPbvlMUTWJPsVr2Sugg,11358
-synapse-2.182.0.dist-info/METADATA,sha256=g9dI52Vey98p2ZCe1ukjO2jwph8UslICAUKgBHw03SE,4860
-synapse-2.182.0.dist-info/WHEEL,sha256=0gYN5xNdqpdGsLVVyA9-Xf3Xnq-9PwlAwkekQ_z55rY,93
-synapse-2.182.0.dist-info/top_level.txt,sha256=v_1YsqjmoSCzCKs7oIhzTNmWtSYoORiBMv1TJkOhx8A,8
-synapse-2.182.0.dist-info/RECORD,,
+synapse-2.183.0.dist-info/LICENSE,sha256=xllut76FgcGL5zbIRvuRc7aezPbvlMUTWJPsVr2Sugg,11358
+synapse-2.183.0.dist-info/METADATA,sha256=-P71izjuDTMfQKjakuvwy7xatQhqxBduvnT0CL0-Wiw,4860
+synapse-2.183.0.dist-info/WHEEL,sha256=0gYN5xNdqpdGsLVVyA9-Xf3Xnq-9PwlAwkekQ_z55rY,93
+synapse-2.183.0.dist-info/top_level.txt,sha256=v_1YsqjmoSCzCKs7oIhzTNmWtSYoORiBMv1TJkOhx8A,8
+synapse-2.183.0.dist-info/RECORD,,