synapse 2.223.0__py311-none-any.whl → 2.225.0__py311-none-any.whl

synapse/lib/storm.py

@@ -932,6 +932,7 @@ stormcmds = (
     },
     {
         'name': 'ps.list',
+        'deprecated': {'eolvers': 'v3.0.0', 'mesg': 'Use ``task.list`` instead.'},
         'descr': 'List running tasks in the cortex.',
         'cmdargs': (
             ('--verbose', {'default': False, 'action': 'store_true', 'help': 'Enable verbose output.'}),
@@ -958,6 +959,7 @@ stormcmds = (
     },
     {
         'name': 'ps.kill',
+        'deprecated': {'eolvers': 'v3.0.0', 'mesg': 'Use ``task.kill`` instead.'},
         'descr': 'Kill a running task/query within the cortex.',
         'cmdargs': (
             ('iden', {'help': 'Any prefix that matches exactly one valid process iden is accepted.'}),
@@ -1111,6 +1113,16 @@ stormcmds = (
     },
 )
 
+def deprmesg(name, depritem):
+    if (mesg := depritem.get('mesg')) is not None:
+        return f'"{name}" is deprecated: {mesg}'
+
+    if (eolvers := depritem.get('eolvers')) is not None:
+        return f'"{name}" is deprecated and will be removed in {eolvers}.'
+
+    eoldate = depritem.get('eoldate')
+    return f'"{name}" is deprecated and will be removed on {eoldate}.'
+
 @s_cache.memoize(size=1024)
 def queryhash(text):
     return s_common.queryhash(text)
@@ -1906,6 +1918,7 @@ class Parser:
         self.root = root
         self.exited = False
         self.mesgs = []
+        self.deprs = {}
 
         self.optargs = {}
         self.posargs = []
@@ -1931,7 +1944,7 @@ class Parser:
 
         choices = opts.get('choices')
         if choices is not None and opts.get('action') in ('store_true', 'store_false'):
-            mesg = f'Argument choices are not supported when action is store_true or store_false'
+            mesg = 'Argument choices are not supported when action is store_true or store_false'
             raise s_exc.BadArg(mesg=mesg, argtype=str(argtype))
 
         dest = self._get_dest(names)
@@ -1988,6 +2001,9 @@ class Parser:
 
             dest = argdef.get('dest')
 
+            if (deprecated := argdef.get('deprecated')) is not None:
+                self.deprs[item] = deprecated
+
             oact = argdef.get('action', 'store')
             if oact == 'store_true':
                 opts[dest] = True
@@ -2177,6 +2193,12 @@ class Parser:
 
         self._printf(f'Usage: {self.prog} [options] {posargs}')
 
+        if self.cdef is not None and (deprecated := self.cdef.get('deprecated')) is not None:
+            dmsg = deprmesg(self.prog, deprecated)
+            self._printf('')
+            self._printf(f'Deprecated: {dmsg}')
+            self._printf('')
+
         if self.cdef is not None and (endpoints := self.cdef.get('endpoints')):
             self._printf('')
             self._printf('Endpoints:')
@@ -2286,6 +2308,10 @@ class Parser:
         wrap_first = self._wrap_text(first, wrap_w)
         self._printf(f'{base:<{base_w-2}}: {wrap_first[0]}')
 
+        if (deprecated := argdef.get('deprecated')) is not None:
+            mesg = deprmesg(names[0], deprecated)
+            self._printf(f'{"":<{base_w-2}}  Deprecated: {mesg}')
+
         for ln in wrap_first[1:]: self._printf(f'{"":<{base_w}}{ln}')
         for ln in helplst[1:]:
             lead_s = len(ln) - len(ln.lstrip())
@@ -2401,6 +2427,10 @@ class Cmd:
         except s_exc.BadSyntax:  # pragma: no cover
             pass
 
+        for item, depr in self.pars.deprs.items():
+            mesg = deprmesg(item, depr)
+            await self.runt.snap.warnonce(mesg)
+
         for line in self.pars.mesgs:
             await self.runt.snap.printf(line)
 
@@ -2515,13 +2545,21 @@ class PureCmd(Cmd):
 
         cmdopts = s_stormtypes.CmdOpts(self)
 
+        cmdconf = self.cdef.get('cmdconf', {})
+        if cmdconf:
+            cmdconf = s_msgpack.deepcopy(cmdconf, use_list=True)
+
         opts = {
             'vars': {
                 'cmdopts': cmdopts,
-                'cmdconf': self.cdef.get('cmdconf', {}),
+                'cmdconf': cmdconf,
             }
         }
 
+        if (deprecated := self.cdef.get('deprecated')) is not None:
+            mesg = deprmesg(name, deprecated)
+            await self.runt.warnonce(mesg)
+
         if self.runtsafe:
             data = {'pathvars': {}}
             async def genx():

synapse/lib/stormhttp.py

@@ -12,6 +12,7 @@ import synapse.common as s_common
 
 import synapse.lib.base as s_base
 import synapse.lib.json as s_json
+import synapse.lib.const as s_const
 import synapse.lib.msgpack as s_msgpack
 import synapse.lib.version as s_version
 import synapse.lib.stormtypes as s_stormtypes
@@ -400,7 +401,12 @@ class LibHttp(s_stormtypes.Lib):
         proxy = await s_stormtypes.toprim(proxy)
         ssl_opts = await s_stormtypes.toprim(ssl_opts)
 
-        kwargs = {'allow_redirects': allow_redirects}
+        kwargs = {
+            'max_line_size': s_const.MAX_LINE_SIZE,
+            'max_field_size': s_const.MAX_FIELD_SIZE,
+            'allow_redirects': allow_redirects,
+        }
+
         if params:
             kwargs['params'] = s_stormtypes.strifyHttpArg(params, multi=True)
 

synapse/lib/stormlib/imap.py

@@ -526,14 +526,22 @@ class ImapLib(s_stormtypes.Lib):
 
         try:
             imap = await s_common.wait_for(coro, timeout)
-        except asyncio.TimeoutError:
+        except TimeoutError:
             raise s_exc.TimeOut(mesg='Timed out waiting for IMAP server hello.') from None
 
         async def fini():
-            async def _logout():
-                await s_common.wait_for(imap.logout(), 5)
+            async def imapfini():
+                if imap.isfini:
+                    return
+
+                try:
+                    await s_common.wait_for(imap.logout(), 5)
+                except TimeoutError:
+                    pass # pragma: no cover
+
                 await imap.fini()
-            s_coro.create_task(_logout())
+
+            self.runt.snap.core.schedCoro(imapfini())
 
         self.runt.snap.onfini(fini)
 

synapse/lib/stormlib/task.py

@@ -1,4 +1,3 @@
-import asyncio
 import logging
 
 import synapse.exc as s_exc

synapse/lib/stormtypes.py

@@ -1910,6 +1910,7 @@ class LibPs(Lib):
          'type': {'type': 'function', '_funcname': '_list',
                   'returns': {'type': 'list', 'desc': 'A list of task definitions.', }}},
     )
+    _storm_lib_deprecation = {'eolvers': 'v3.0.0', 'mesg': 'Use the corresponding ``$lib.task`` function.'}
     _storm_lib_path = ('ps',)
 
     def getObjLocals(self):
@@ -2968,7 +2969,13 @@ class LibTime(Lib):
 
                     storm> $now=$lib.time.now() $str=$lib.time.format($now, '%A %d, %B %Y') $lib.print($str)
 
-                    Tuesday 14, July 2020''',
+                    Tuesday 14, July 2020
+
+                Format a timestamp into a string using included format string::
+
+                    storm> $now=$lib.time.now() $str=$lib.time.format($now, $lib.time.formats.iso8601) $lib.print($str)
+
+                    2025-10-02T09:34:00Z''',
          'type': {'type': 'function', '_funcname': '_format',
                   'args': (
                       {'name': 'valu', 'type': 'int', 'desc': 'A timestamp in epoch milliseconds.', },
@@ -3103,6 +3110,10 @@ class LibTime(Lib):
                       {'name': 'timezone', 'desc': 'A timezone name. See python pytz docs for options.', 'type': 'str'},
                   ),
                   'returns': {'type': 'list', 'desc': 'An ($ok, $valu) tuple.', }}},
+        {'name': 'formats.iso8601', 'desc': 'ISO8601 time format string in UTC timezone (Z).', 'type': 'str'},
+        {'name': 'formats.iso8601us', 'desc': 'ISO8601 time format string (with microseconds) in UTC timezone (Z).', 'type': 'str'},
+        {'name': 'formats.rfc2822', 'desc': 'RFC 2822 time format string in UT timezone.', 'type': 'str'},
+        {'name': 'formats.synapse', 'desc': 'Synapse time format string.', 'type': 'str'},
     )
     _storm_lib_path = ('time',)
 
@@ -3127,6 +3138,13 @@ class LibTime(Lib):
             'dayofyear': self.dayofyear,
             'dayofmonth': self.dayofmonth,
             'monthofyear': self.monthofyear,
+
+            'formats': {
+                'iso8601': '%Y-%m-%dT%H:%M:%SZ',
+                'iso8601us': '%Y-%m-%dT%H:%M:%S.%fZ',
+                'rfc2822': '%d %b %Y %H:%M:%S UT',
+                'synapse': '%Y/%m/%d %H:%M:%S.%f',
+            },
         }
 
     @stormfunc(readonly=True)

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, 223, 0)
+version = (2, 225, 0)
 verstring = '.'.join([str(x) for x in version])
-commit = 'b40e64b75fa2820856ad138b8ad9f8c4b6e9547e'
+commit = 'd2ab923e3df9fe64611ac05b6ffdd7e8c2dc1b22'

synapse/models/inet.py

@@ -3700,6 +3700,9 @@ class InetModule(s_module.CoreModule):
                     )),
                     ('inet:service:platform', {}, (
 
+                        ('id', ('str', {'strip': True}), {
+                            'doc': 'An ID which identifies the platform.'}),
+
                         ('url', ('inet:url', {}), {
                             'ex': 'https://twitter.com',
                             'alts': ('urls',),
@@ -3708,6 +3711,13 @@ class InetModule(s_module.CoreModule):
                         ('urls', ('array', {'type': 'inet:url', 'sorted': True, 'uniq': True}), {
                             'doc': 'An array of alternate URLs for the platform.'}),
 
+                        ('zone', ('inet:fqdn', {}), {
+                            'alts': ('zones',),
+                            'doc': 'The primary zone for the platform.'}),
+
+                        ('zones', ('array', {'type': 'inet:fqdn', 'sorted': True, 'uniq': True}), {
+                            'doc': 'An array of alternate zones for the platform.'}),
+
                         ('name', ('str', {'onespace': True, 'lower': True}), {
                             'ex': 'twitter',
                             'alts': ('names',),
@@ -3722,6 +3732,21 @@ class InetModule(s_module.CoreModule):
                             'disp': {'hint': 'text'},
                             'doc': 'A description of the service platform.'}),
 
+                        ('parent', ('inet:service:platform', {}), {
+                            'doc': 'A parent platform which owns this platform.'}),
+
+                        ('status', ('inet:service:object:status', {}), {
+                            'doc': 'The status of the platform.'}),
+
+                        ('period', ('ival', {}), {
+                            'doc': 'The period when the platform existed.'}),
+
+                        ('creator', ('inet:service:account', {}), {
+                            'doc': 'The service account which created the platform.'}),
+
+                        ('remover', ('inet:service:account', {}), {
+                            'doc': 'The service account which removed or decommissioned the platform.'}),
+
                         ('provider', ('ou:org', {}), {
                             'doc': 'The organization which operates the platform.'}),
 
@@ -3794,8 +3819,12 @@ class InetModule(s_module.CoreModule):
                     ('inet:service:account', {}, (
 
                         ('user', ('inet:user', {}), {
+                            'alts': ('users',),
                             'doc': 'The current user name of the account.'}),
 
+                        ('users', ('array', {'type': 'inet:user', 'sorted': True, 'uniq': True}), {
+                            'doc': 'An array of alternate user names for this account.'}),
+
                         ('parent', ('inet:service:account', {}), {
                             'doc': 'A parent account which owns this account.'}),
 

synapse/models/media.py

@@ -35,6 +35,10 @@ class MediaModule(s_module.CoreModule):
                     'disp': {'hint': 'text'},
                     'doc': 'A brief summary of the news item.'}),
 
+                ('body', ('str', {}), {
+                    'disp': {'hint': 'text', 'syntax': 'markdown'},
+                    'doc': 'The body of the news item.'}),
+
                 ('publisher', ('ou:org', {}), {
                     'doc': 'The organization which published the news.'}),
 

synapse/models/proj.py

@@ -166,6 +166,9 @@ class ProjectModule(s_module.CoreModule):
                         ('created', ('time', {}), {
                             'doc': 'The time the comment was added.'}),
 
+                        ('ext:creator', ('ps:contact', {}), {
+                            'doc': 'The contact information of the creator from an external system.'}),
+
                         ('updated', ('time', {'ismax': True}), {
                             'doc': 'The last time the comment was updated.'}),
 

synapse/models/risk.py

@@ -269,6 +269,9 @@ class RiskModule(s_module.CoreModule):
 
                 (('risk:outage', 'impacted', None), {
                     'doc': 'The outage event impacted the availability of the target node.'}),
+
+                (('risk:alert', 'about', None), {
+                    'doc': 'The alert is about the target node.'}),
             ),
             'forms': (
 
@@ -417,6 +420,9 @@ class RiskModule(s_module.CoreModule):
                     ('type', ('risk:mitigation:type:taxonomy', {}), {
                         'doc': 'A taxonomy type entry for the mitigation.'}),
 
+                    ('id', ('str', {'strip': True}), {
+                        'doc': 'An identifier for the mitigation.'}),
+
                     ('desc', ('str', {}), {
                         'disp': {'hint': 'text'},
                         'doc': 'A description of the mitigation approach for the vulnerability.'}),
@@ -800,6 +806,9 @@ class RiskModule(s_module.CoreModule):
                     ('detected', ('time', {}), {
                         'doc': 'The time the alerted condition was detected.'}),
 
+                    ('updated', ('time', {}), {
+                        'doc': 'The time the alert was most recently modified.'}),
+
                     ('vuln', ('risk:vuln', {}), {
                         'doc': 'The optional vulnerability that the alert indicates.'}),
 

synapse/models/syn.py

@@ -365,6 +365,14 @@ class SynModule(s_module.CoreModule):
                     ('nodedata', ('array', {'type': 'syn:nodedata'}), {
                         'deprecated': True,
                         'doc': 'The list of nodedata that may be added by the command.', 'uniq': True, 'sorted': True, 'ro': True}),
+                    ('deprecated', ('bool', {}), {
+                        'doc': 'Set to true if this command is scheduled to be removed.'}),
+                    ('deprecated:version', ('it:semver', {}), {
+                        'doc': 'The Synapse version when this command will be removed.'}),
+                    ('deprecated:date', ('time', {}), {
+                        'doc': 'The date when this command will be removed.'}),
+                    ('deprecated:mesg', ('str', {}), {
+                        'doc': 'Optional description of this deprecation.'}),
                 )),
             ),
         }),)

synapse/tests/test_common.py

@@ -75,6 +75,10 @@ class CommonTest(s_t_utils.SynTest):
         self.ne('15c8a3727942fa01e04d6a7a525666a2', s_common.guid(item))
         self.eq('15c8a3727942fa01e04d6a7a525666a2', s_common.guid(s_common.flatten(item)))
 
+        item = {'foo': 'bar', 'baz': 10, 'gronk': True, 'hehe': ['ha', 'ha'], 'tupl': (1, 'two', 1.23), 'newp': None}
+        self.ne('02efa9b7612f371dbb65a596cd303d9a', s_common.guid(item))
+        self.eq('02efa9b7612f371dbb65a596cd303d9a', s_common.guid(s_common.flatten(item)))
+
     def test_common_vertup(self):
         self.eq(s_common.vertup('1.3.30'), (1, 3, 30))
         self.true(s_common.vertup('30.40.50') > (9, 0))

synapse/tests/test_cortex.py

@@ -28,8 +28,8 @@ import synapse.lib.version as s_version
 import synapse.lib.modelrev as s_modelrev
 import synapse.lib.stormsvc as s_stormsvc
 
-import synapse.tools.backup as s_tools_backup
-import synapse.tools.promote as s_tools_promote
+import synapse.tools.service.backup as s_tools_backup
+import synapse.tools.service.promote as s_tools_promote
 
 import synapse.tests.utils as s_t_utils
 from synapse.tests.utils import alist
@@ -6650,6 +6650,57 @@ class CortexBasicTest(s_t_utils.SynTest):
                     with self.raises(s_exc.BadPropDef):
                         await prox.addTagProp('_blah:blah^blah', ('int', {}), {})
 
+        # Mirrors on newer model versions should not be able to add extended model elements
+        # based on model elements the leader doesn't have
+        async with self.getTestAha() as aha:
+
+            conf = {'aha:provision': await aha.addAhaSvcProv('00.cortex')}
+            core00 = await aha.enter_context(self.getTestCore(conf=conf))
+
+            conf = {'aha:provision': await aha.addAhaSvcProv('01.cortex', {'mirror': 'cortex'})}
+            core01 = await aha.enter_context(self.getTestCore(conf=conf))
+
+            # Add a type directly to the mirror's model to simulate different model version
+            core01.model.addType('_newmodel:type', 'str', {}, {})
+
+            with self.raises(s_exc.NoSuchType):
+                await core01.addType('_test:type', '_newmodel:type', {}, {})
+
+            await core01.sync()
+            self.none(core01.model.type('_test:type'))
+
+            with self.raises(s_exc.NoSuchType):
+                await core01.addUnivProp('_woot', ('_newmodel:type', {}), {})
+
+            await core01.sync()
+            self.none(core01.model.prop('._woot'))
+
+            with self.raises(s_exc.NoSuchType):
+                await core01.addForm('_hehe:haha', '_newmodel:type', {}, {})
+
+            await core01.sync()
+            self.none(core01.model.form('_hehe:haha'))
+
+            with self.raises(s_exc.NoSuchType):
+                await core01.addFormProp('inet:asn', '_newer', ('_newmodel:type', {}), {})
+
+            await core01.sync()
+            self.none(core01.model.prop('inet:asn:_newer'))
+
+            with self.raises(s_exc.NoSuchType):
+                await core01.addTagProp('user', ('_newmodel:type', {}), {})
+
+            await core01.sync()
+            self.none(core01.model.tagprop('user'))
+
+            core01.model.addForm('_newmodel:type', {}, {})
+
+            with self.raises(s_exc.NoSuchForm):
+                await core01.addEdge(('_newmodel:type', '_foo', None), {})
+
+            await core01.sync()
+            self.none(core01.model.edge(('_newmodel:type', '_foo', None)))
+
     async def test_cortex_axon(self):
         async with self.getTestCore() as core:
             # By default, a cortex has a local Axon instance available

synapse/tests/test_lib_agenda.py

@@ -9,7 +9,7 @@ import synapse.exc as s_exc
 import synapse.common as s_common
 import synapse.tests.utils as s_t_utils
 
-import synapse.tools.backup as s_tools_backup
+import synapse.tools.service.backup as s_tools_backup
 
 import synapse.lib.agenda as s_agenda
 from synapse.lib.agenda import TimeUnit as s_tu

synapse/tests/test_lib_cell.py

@@ -38,7 +38,7 @@ import synapse.lib.lmdbslab as s_lmdbslab
 import synapse.lib.crypto.passwd as s_passwd
 import synapse.lib.platforms.linux as s_linux
 
-import synapse.tools.backup as s_tools_backup
+import synapse.tools.service.backup as s_tools_backup
 
 import synapse.tests.utils as s_t_utils
 

synapse/tests/test_lib_certdir.py

@@ -9,7 +9,7 @@ import synapse.common as s_common
 import synapse.lib.certdir as s_certdir
 import synapse.lib.msgpack as s_msgpack
 import synapse.tests.utils as s_t_utils
-import synapse.tools.genpkg as s_genpkg
+import synapse.tools.storm.pkg.gen as s_genpkg
 
 import cryptography.x509 as c_x509
 import cryptography.exceptions as c_exc

synapse/tests/test_lib_httpapi.py

@@ -5,7 +5,7 @@ import aiohttp
 import aiohttp.client_exceptions as a_exc
 
 import synapse.common as s_common
-import synapse.tools.backup as s_backup
+import synapse.tools.service.backup as s_backup
 
 import synapse.exc as s_exc
 import synapse.lib.coro as s_coro

synapse/tests/test_lib_layer.py

@@ -13,7 +13,7 @@ import synapse.lib.layer as s_layer
 import synapse.lib.msgpack as s_msgpack
 import synapse.lib.spooled as s_spooled
 
-import synapse.tools.backup as s_tools_backup
+import synapse.tools.service.backup as s_tools_backup
 
 import synapse.tests.utils as s_t_utils
 

synapse/tests/test_lib_multislabseqn.py

@@ -226,6 +226,28 @@ class MultiSlabSeqn(s_t_utils.SynTest):
                 # Iterator exhausted: should have just the cache slab (10) and the tail slab (20)
                 self.len(2, msqn._openslabs)
 
+    async def test_multislabseqn_retnpack(self):
+
+        with self.getTestDir() as dirn:
+
+            async with await s_multislabseqn.MultiSlabSeqn.anit(dirn) as msqn:
+
+                self.eq((0, b'\xa4foo1'), await msqn.addWithPackRetn('foo1'))
+                self.eq((1, b'\xa4foo2'), await msqn.addWithPackRetn('foo2'))
+                self.eq((0, b'\xa4foo3'), await msqn.addWithPackRetn('foo3', indx=0))
+
+                await msqn.addWithPackRetn('foo4', indx=10)
+                await msqn.rotate()
+                await msqn.addWithPackRetn('foo5')
+                await msqn.addWithPackRetn('foo6', indx=7)
+
+                self.true(await msqn.cull(10))
+
+                with self.raises(s_exc.BadIndxValu):
+                    await msqn.addWithPackRetn('foo7', indx=7)
+
+                self.eq((12, b'\xa4foo8'), msqn.tailseqn.addWithPackRetn('foo8'))
+
     async def test_multislabseqn_cull(self):
 
         with self.getTestDir() as dirn:

synapse/tests/test_lib_nexus.py

@@ -1,4 +1,5 @@
 import asyncio
+import contextlib
 from unittest import mock
 
 import synapse.exc as s_exc
@@ -61,7 +62,7 @@ class SampleNexus2(SampleNexus, SampleMixin):
 
 class NexusTest(s_t_utils.SynTest):
 
-    async def test_nexus(self):
+    async def test_nexus_base(self):
 
         with self.getTestDir() as dirn:
             dir1 = s_common.genpath(dirn, 'nexus1')
@@ -111,6 +112,19 @@ class NexusTest(s_t_utils.SynTest):
                     stream.seek(0)
                     self.isin('while replaying log', stream.read())
 
+                    nexsindx = nexus1.nexsroot.nexslog.index()
+
+                    async def listen():
+                        async for item in nexus1.getNexusChanges(nexsindx, wait=True):
+                            break
+                        return item
+
+                    task = nexus1.schedCoro(listen())
+                    self.eq('foo', await nexus1.doathing(eventdict))
+                    offs, item = await asyncio.wait_for(task, timeout=12)
+                    self.eq(offs, nexsindx)
+                    self.eq(item[1], 'thing:doathing')
+
     async def test_nexus_modroot(self):
 
         async with self.getTestCell() as cell:
@@ -395,3 +409,30 @@ class NexusTest(s_t_utils.SynTest):
                 await core.nodes('[ it:dev:str=foo ]', opts={'view': forkiden})
 
             core.nexsroot._nexskids[layriden] = layr
+
+    async def test_nexus_iter(self):
+        async with self.getTestCell(conf={'nexslog:en': True}) as cell:
+            await cell.sync()
+
+            # Force nexus events to be added while constructing a Window
+            orig = s_nexus.NexsRoot.getMirrorWindow
+
+            @contextlib.asynccontextmanager
+            async def slowwindow(self):
+                await cell.sync()
+                async with orig(self) as wind:
+                    await cell.sync()
+                    yield wind
+
+            items = []
+            with mock.patch('synapse.lib.nexus.NexsRoot.getMirrorWindow', slowwindow):
+                async with cell.getLocalProxy() as prox:
+                    async for indx, item in prox.getNexusChanges(0):
+                        items.append(indx)
+                        if indx == 2:
+                            await cell.sync()
+                        elif indx == 3:
+                            break
+
+            # We didn't miss or duplicate items added during window construction
+            self.eq([0, 1, 2, 3], items)

synapse/tests/test_lib_slabseqn.py

@@ -15,7 +15,7 @@ class SlabSeqn(s_t_utils.SynTest):
     def chk_size(self, seqn):
         self.eq(seqn.stat()['entries'], seqn.size)
 
-    async def test_slab_seqn(self):
+    async def test_slab_seqn_base(self):
 
         with self.getTestDir() as dirn:
 
@@ -174,3 +174,32 @@ class SlabSeqn(s_t_utils.SynTest):
 
                 res = await asyncio.wait_for(genr.__anext__(), timeout=1)
                 self.eq((1, 'bar'), res)
+
+    async def test_slab_seqn_retnpack(self):
+
+        with self.getTestDir() as dirn:
+            async with await s_lmdbslab.Slab.anit(dirn, map_size=10_0000) as slab:
+
+                seqn = s_slabseqn.SlabSeqn(slab, 'seqn:test')
+
+                self.eq((0, b'\xa4foo1'), seqn.addWithPackRetn('foo1'))
+                self.eq((1, b'\xa4foo2'), seqn.addWithPackRetn('foo2'))
+                self.eq((0, b'\xa4foo3'), seqn.addWithPackRetn('foo3', indx=0))
+
+                seqn.addWithPackRetn('foo4', indx=10)
+                seqn.addWithPackRetn('foo5')
+                seqn.addWithPackRetn('foo6', indx=7)
+                seqn.addWithPackRetn('foo7', indx=7)
+
+                self.eq((12, b'\xa4foo8'), seqn.addWithPackRetn('foo8'))
+
+                valus = [valu for valu in seqn.iter(0)]
+                evals = [
+                    (0, 'foo3',),
+                    (1, 'foo2'),
+                    (7, 'foo7'),
+                    (10, 'foo4'),
+                    (11, 'foo5'),
+                    (12, 'foo8'),
+                ]
+                self.eq(valus, evals)