synapse 2.181.0__tar.gz → 2.183.0__tar.gz

{synapse-2.181.0/synapse.egg-info → synapse-2.183.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: synapse
-Version: 2.181.0
+Version: 2.183.0
 Summary: Synapse Intelligence Analysis Framework
 Author-email: The Vertex Project LLC <root@vertex.link>
 License: Apache License 2.0
@@ -22,7 +22,7 @@ License-File: LICENSE
 Requires-Dist: pyOpenSSL<25.0.0,>=24.0.0
 Requires-Dist: cryptography<44.0.0,>=43.0.1
 Requires-Dist: msgpack<1.1.0,>=1.0.5
-Requires-Dist: xxhash<3.5.0,>=1.4.4
+Requires-Dist: xxhash<3.6.0,>=1.4.4
 Requires-Dist: lmdb<1.5.0,>=1.2.1
 Requires-Dist: tornado<7.0.0,>=6.2.0
 Requires-Dist: regex>=2022.9.11
@@ -34,7 +34,7 @@ Requires-Dist: aiosmtplib<3.1.0,>=3.0.0
 Requires-Dist: prompt-toolkit<3.1.0,>=3.0.4
 Requires-Dist: lark==1.1.9
 Requires-Dist: Pygments<2.18.0,>=2.7.4
-Requires-Dist: packaging<24.0,>=20.0
+Requires-Dist: packaging<25.0,>=20.0
 Requires-Dist: fastjsonschema<2.20.0,>=2.18.0
 Requires-Dist: stix2-validator<4.0.0,>=3.2.0
 Requires-Dist: vcrpy<5.2.0,>=4.3.1

{synapse-2.181.0 → synapse-2.183.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = 'setuptools.build_meta'
 
 [project]
 name = 'synapse'
-version = '2.181.0'
+version = '2.183.0'
 authors = [
     { name = 'The Vertex Project LLC', email = 'root@vertex.link'},
 ]
@@ -26,7 +26,7 @@ dependencies = [
     'pyOpenSSL>=24.0.0,<25.0.0',
     'cryptography>=43.0.1,<44.0.0',
     'msgpack>=1.0.5,<1.1.0',
-    'xxhash>=1.4.4,<3.5.0',
+    'xxhash>=1.4.4,<3.6.0',
     'lmdb>=1.2.1,<1.5.0',
     'tornado>=6.2.0,<7.0.0',
     'regex>=2022.9.11',
@@ -38,7 +38,7 @@ dependencies = [
     'prompt-toolkit>=3.0.4,<3.1.0',
     'lark==1.1.9',
     'Pygments>=2.7.4,<2.18.0',
-    'packaging>=20.0,<24.0',
+    'packaging>=20.0,<25.0',
     'fastjsonschema>=2.18.0,<2.20.0',
     'stix2-validator>=3.2.0,<4.0.0',
     'vcrpy>=4.3.1,<5.2.0',

{synapse-2.181.0 → synapse-2.183.0}/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-2.181.0 → synapse-2.183.0}/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-2.181.0 → synapse-2.183.0}/synapse/lib/auth.py

@@ -579,11 +579,28 @@ class Auth(s_nexus.Pusher):
         await self.feedBeholder('user:add', user.pack())
 
     async def addRole(self, name, iden=None):
+        '''
+        Add a Role to the Auth system.
+
+        Args:
+            name (str): The name of the role.
+            iden (str): A optional iden to use as the role iden.
+
+        Returns:
+            Role: A Role.
+        '''
         if self.roleidenbynamecache.get(name) is not None:
             raise s_exc.DupRoleName(mesg=f'Duplicate role name, {name=} already exists.', name=name)
 
         if iden is None:
             iden = s_common.guid()
+        else:
+            if not s_common.isguid(iden):
+                raise s_exc.BadArg(name='iden', arg=iden, mesg=f'Argument {iden} it not a valid iden.')
+
+            if self.rolebyidencache.get(iden) is not None:
+                raise s_exc.DupIden(name=name, iden=iden,
+                                    mesg=f'Role already exists for {iden=}.')
 
         await self._push('role:add', iden, name)
 

{synapse-2.181.0 → synapse-2.183.0}/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-2.181.0 → synapse-2.183.0}/synapse/lib/cell.py

@@ -443,8 +443,8 @@ class CellApi(s_base.Base):
         return await self.cell.delUser(iden)
 
     @adminapi(log=True)
-    async def addRole(self, name):
-        return await self.cell.addRole(name)
+    async def addRole(self, name, iden=None):
+        return await self.cell.addRole(name, iden=iden)
 
     @adminapi(log=True)
     async def delRole(self, iden):
@@ -1637,12 +1637,10 @@ class Cell(s_nexus.Pusher, s_telepath.Aware):
                        f'{disk.free / disk.total * 100:.2f}%), setting Cell to read-only.'
                 logger.error(mesg)
 
-            elif nexsroot.readonly:
-
-                await nexsroot.delWriteHold(diskspace)
+            elif nexsroot.readonly and await nexsroot.delWriteHold(diskspace):
 
                 mesg = f'Free space on {self.dirn} above minimum threshold (currently ' \
-                       f'{disk.free / disk.total * 100:.2f}%), re-enabling writes.'
+                       f'{disk.free / disk.total * 100:.2f}%), removing free space write hold.'
                 logger.error(mesg)
 
             await self._checkspace.timewait(timeout=self.FREE_SPACE_CHECK_FREQ)
@@ -2883,8 +2881,8 @@ class Cell(s_nexus.Pusher, s_telepath.Aware):
         logger.info(f'Deleted user={name}',
                    extra=await self.getLogExtra(target_user=iden, target_username=name, status='DELETE'))
 
-    async def addRole(self, name):
-        role = await self.auth.addRole(name)
+    async def addRole(self, name, iden=None):
+        role = await self.auth.addRole(name, iden=iden)
         logger.info(f'Added role={name}',
                     extra=await self.getLogExtra(target_role=role.iden, target_rolename=role.name, status='CREATE'))
         return role.pack()

{synapse-2.181.0 → synapse-2.183.0}/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',
         },
@@ -3691,6 +3714,12 @@ class MergeCmd(Cmd):
           expressions for specifying tags. For more information on tag glob
           expressions, check the Synapse documentation for $node.globtags().
 
+    NOTE: If --wipe is specified, and there are nodes that cannot be merged,
+          they will be skipped (with a warning printed) and removed when
+          the top layer is replaced. This should occur infrequently, for example,
+          when a form is locked due to deprecation, a form no longer exists,
+          or the data at rest fails normalization.
+
     Examples:
 
         // Having tagged a new #cno.mal.redtree subgraph in a forked view...
@@ -3923,6 +3952,8 @@ class MergeCmd(Cmd):
         async with await runt.snap.view.parent.snap(user=runt.user.iden) as snap:
             snap.strict = False
 
+            snap.on('warn', runt.snap.dist)
+
             async for node, path in genr:
 
                 # the timestamp for the adds/subs of each node merge will match
@@ -3971,10 +4002,14 @@ class MergeCmd(Cmd):
                             await runt.printf(f'{nodeiden} {form} = {valurepr}')
                         else:
                             delnode = True
-                            protonode = await editor.addNode(form, valu[0])
+                            if (protonode := await editor.addNode(form, valu[0])) is None:
+                                await asyncio.sleep(0)
+                                continue
 
                     elif doapply:
-                        protonode = await editor.addNode(form, node.ndef[1], norminfo={})
+                        if (protonode := await editor.addNode(form, node.ndef[1], norminfo={})) is None:
+                            await asyncio.sleep(0)
+                            continue
 
                     for name, (valu, stortype) in sode.get('props', {}).items():
 
@@ -4020,7 +4055,9 @@ class MergeCmd(Cmd):
                                 subs.append((s_layer.EDIT_PROP_DEL, (name, valu, stortype), ()))
 
                 if doapply and protonode is None:
-                    protonode = await editor.addNode(form, node.ndef[1], norminfo={})
+                    if (protonode := await editor.addNode(form, node.ndef[1], norminfo={})) is None:
+                        await asyncio.sleep(0)
+                        continue
 
                 if not notags:
                     for tag, valu in sode.get('tags', {}).items():

{synapse-2.181.0 → synapse-2.183.0}/synapse/lib/stormlib/auth.py

@@ -1969,6 +1969,7 @@ class LibRoles(s_stormtypes.Lib):
          'type': {'type': 'function', '_funcname': '_methRolesAdd',
                   'args': (
                       {'name': 'name', 'type': 'str', 'desc': 'The name of the role.', },
+                      {'name': 'iden', 'type': 'str', 'desc': 'The iden to assign to the new role.', 'default': None},
                   ),
                   'returns': {'type': 'auth:role', 'desc': 'The new role object.', }}},
         {'name': 'del', 'desc': 'Delete a Role from the Cortex.',
@@ -2028,10 +2029,11 @@ class LibRoles(s_stormtypes.Lib):
         if rdef is not None:
             return Role(self.runt, rdef['iden'])
 
-    async def _methRolesAdd(self, name):
+    async def _methRolesAdd(self, name, iden=None):
         if not self.runt.allowed(('auth', 'role', 'add')):
             self.runt.confirm(('storm', 'lib', 'auth', 'roles', 'add'))
-        rdef = await self.runt.snap.core.addRole(name)
+        iden = await s_stormtypes.tostr(iden, noneok=True)
+        rdef = await self.runt.snap.core.addRole(name, iden=iden)
         return Role(self.runt, rdef['iden'])
 
     async def _methRolesDel(self, iden):

{synapse-2.181.0 → synapse-2.183.0}/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-2.181.0 → synapse-2.183.0}/synapse/lib/stormlib/easyperm.py

@@ -38,7 +38,7 @@ class LibEasyPerm(s_stormtypes.Lib):
          'type': {'type': 'function', '_funcname': '_allowedEasyPerm',
                   'args': (
                       {'name': 'edef', 'type': 'dict', 'desc': 'The easy perm dictionary to check.'},
-                      {'name': 'level', 'type': 'str', 'desc': 'The required permission level number.'},
+                      {'name': 'level', 'type': 'int', 'desc': 'The required permission level number.'},
                   ),
                   'returns': {'type': 'boolean',
                               'desc': 'True if the user meets the requirement, false otherwise.', }}},
@@ -46,7 +46,7 @@ class LibEasyPerm(s_stormtypes.Lib):
          'type': {'type': 'function', '_funcname': '_confirmEasyPerm',
                   'args': (
                       {'name': 'edef', 'type': 'dict', 'desc': 'The easy perm dictionary to check.'},
-                      {'name': 'level', 'type': 'str', 'desc': 'The required permission level number.'},
+                      {'name': 'level', 'type': 'int', 'desc': 'The required permission level number.'},
                       {'name': 'mesg', 'type': 'str', 'default': None,
                        'desc': 'Optional error message to present if user does not have required permission level.'},
                   ),

{synapse-2.181.0 → synapse-2.183.0}/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-2.181.0 → synapse-2.183.0}/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-2.183.0/synapse/lib/stormlib/random.py

@@ -0,0 +1,117 @@
+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):
+    '''
+    A Storm library for generating random values.
+    '''
+    _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': '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._methInt,
+            'generator': self._methGenerator,
+        }
+
+    @s_stormtypes.stormfunc(readonly=True)
+    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:
+            raise s_exc.BadArg(mesg=f'Minval must be less than or equal to maxval, minval={minval}, maxval={maxval}',
+                               minval=minval, maxval=maxval)
+        return randinst.randint(minval, maxval)

{synapse-2.181.0 → synapse-2.183.0}/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-2.181.0 → synapse-2.183.0}/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, 181, 0)
+version = (2, 183, 0)
 verstring = '.'.join([str(x) for x in version])
-commit = '9241eebaad4a9c7bb007c6c5abb63be4e4ffac44'
+commit = '68e4f3dd36f4ff9dd7818ea2c8180b086092148f'