synapse 2.165.0__py311-none-any.whl → 2.167.0__py311-none-any.whl

synapse/tests/test_lib_view.py

@@ -11,18 +11,21 @@ from synapse.tests.utils import alist
 
 class ViewTest(s_t_utils.SynTest):
 
-    async def test_view_nomerge(self):
+    async def test_view_protected(self):
         async with self.getTestCore() as core:
             view = await core.callStorm('return($lib.view.get().fork().iden)')
             opts = {'view': view}
 
             await core.nodes('[ ou:org=* ]', opts=opts)
-            await core.nodes('$lib.view.get().set(nomerge, $lib.true)', opts=opts)
+            await core.nodes('$lib.view.get().set(protected, $lib.true)', opts=opts)
 
             with self.raises(s_exc.CantMergeView):
                 await core.nodes('$lib.view.get().merge()', opts=opts)
 
-            await core.nodes('$lib.view.get().set(nomerge, $lib.false)', opts=opts)
+            with self.raises(s_exc.CantDelView):
+                await core.nodes('$lib.view.del($lib.view.get().iden)', opts=opts)
+
+            await core.nodes('$lib.view.get().set(protected, $lib.false)', opts=opts)
             await core.nodes('$lib.view.get().merge()', opts=opts)
 
             self.len(1, await core.nodes('ou:org'))
@@ -31,6 +34,50 @@ class ViewTest(s_t_utils.SynTest):
             with self.raises(s_exc.BadOptValu):
                 await core.view.setViewInfo('hehe', 10)
 
+        async with self.getTestCore() as core:
+            # Delete this block when nomerge is removed
+            view = await core.callStorm('return($lib.view.get().fork().iden)')
+            opts = {'view': view}
+
+            # Setting/getting nomerge should be redirected to protected
+            getnomerge = 'return($lib.view.get().get(nomerge))'
+            setnomerge = '$lib.view.get().set(nomerge, $valu)'
+
+            getprotected = 'return($lib.view.get().get(protected))'
+            setprotected = '$lib.view.get().set(protected, $valu)'
+
+            nomerge = await core.callStorm(getnomerge, opts=opts)
+            protected = await core.callStorm(getprotected, opts=opts)
+            self.false(nomerge)
+            self.false(protected)
+
+            opts['vars'] = {'valu': True}
+            await core.callStorm(setnomerge, opts=opts)
+
+            nomerge = await core.callStorm(getnomerge, opts=opts)
+            protected = await core.callStorm(getprotected, opts=opts)
+            self.true(nomerge)
+            self.true(protected)
+
+            opts['vars'] = {'valu': False}
+            await core.callStorm(setprotected, opts=opts)
+
+            nomerge = await core.callStorm(getnomerge, opts=opts)
+            protected = await core.callStorm(getprotected, opts=opts)
+            self.false(nomerge)
+            self.false(protected)
+
+    async def test_view_nomerge_migration(self):
+        async with self.getRegrCore('cortex-defaults-v2') as core:
+            view = core.getView('0df16dd693c74109da0d58ab87ba768a')
+            self.none(view.info.get('nomerge'))
+            self.true(view.info.get('protected'))
+
+            with self.raises(s_exc.CantMergeView):
+                await core.callStorm('return($lib.view.get(0df16dd693c74109da0d58ab87ba768a).merge())')
+            with self.raises(s_exc.CantDelView):
+                await core.callStorm('return($lib.view.del(0df16dd693c74109da0d58ab87ba768a))')
+
     async def test_view_set_parent(self):
 
         async with self.getTestCore() as core:

synapse/tests/test_model_files.py

@@ -247,6 +247,9 @@ class FileTest(s_t_utils.SynTest):
             self.raises(s_exc.BadTypeValu, base.norm, 'foo/bar.exe')
             self.raises(s_exc.BadTypeValu, base.norm, '/haha')
 
+            norm, info = path.norm('../.././..')
+            self.eq(norm, '')
+
             norm, info = path.norm('c:\\Windows\\System32\\calc.exe')
 
             self.eq(norm, 'c:/windows/system32/calc.exe')

synapse/tests/test_model_inet.py

@@ -2767,3 +2767,70 @@ class InetModelTest(s_t_utils.SynTest):
             self.eq(nodes[0].get('client'), 'tcp://1.2.3.4')
             self.eq(nodes[0].get('client:ipv4'), 0x01020304)
             self.eq(nodes[0].get('client:ipv6'), '::1')
+
+    async def test_model_inet_tls_handshake(self):
+
+        async with self.getTestCore() as core:
+            props = {
+                'ja3': '1' * 32,
+                'ja3s': '2' * 32,
+                'client': 'tcp://1.2.3.4:8888',
+                'server': 'tcp://5.6.7.8:9999'
+            }
+
+            nodes = await core.nodes('''
+                [
+                    inet:tls:handshake=*
+                        :time=now
+                        :flow=*
+                        :server=$server
+                        :server:cert=*
+                        :server:fingerprint:ja3=$ja3s
+                        :client=$client
+                        :client:cert=*
+                        :client:fingerprint:ja3=$ja3
+                ]
+            ''', opts={'vars': props})
+            self.len(1, nodes)
+            self.nn(nodes[0].get('time'))
+            self.nn(nodes[0].get('flow'))
+            self.nn(nodes[0].get('server:cert'))
+            self.nn(nodes[0].get('client:cert'))
+
+            self.eq(props['ja3'], nodes[0].get('client:fingerprint:ja3'))
+            self.eq(props['ja3s'], nodes[0].get('server:fingerprint:ja3'))
+
+            self.eq(props['client'], nodes[0].get('client'))
+            self.eq(props['server'], nodes[0].get('server'))
+
+    async def test_model_inet_ja3(self):
+
+        async with self.getTestCore() as core:
+
+            ja3 = '76e7b0cb0994d60a4b3f360a088fac39'
+            nodes = await core.nodes('[ inet:tls:ja3:sample=(tcp://1.2.3.4, $md5) ]', opts={'vars': {'md5': ja3}})
+            self.len(1, nodes)
+            self.eq(nodes[0].get('client'), 'tcp://1.2.3.4')
+            self.eq(nodes[0].get('ja3'), ja3)
+
+            ja3 = '4769ad08107979c719d86270e706fed5'
+            nodes = await core.nodes('[ inet:tls:ja3s:sample=(tcp://2.2.2.2, $md5) ]', opts={'vars': {'md5': ja3}})
+            self.len(1, nodes)
+            self.eq(nodes[0].get('server'), 'tcp://2.2.2.2')
+            self.eq(nodes[0].get('ja3s'), ja3)
+
+    async def test_model_inet_tls_certs(self):
+
+        async with self.getTestCore() as core:
+
+            server = 'e4f6db65dbaa7a4598f7379f75dcd5f5'
+            client = 'df8d1f7e04f7c4a322e04b0b252e2851'
+            nodes = await core.nodes('[inet:tls:servercert=(tcp://1.2.3.4:1234, $server)]', opts={'vars': {'server': server}})
+            self.len(1, nodes)
+            self.eq(nodes[0].get('server'), 'tcp://1.2.3.4:1234')
+            self.eq(nodes[0].get('cert'), server)
+
+            nodes = await core.nodes('[inet:tls:clientcert=(tcp://5.6.7.8:5678, $client)]', opts={'vars': {'client': client}})
+            self.len(1, nodes)
+            self.eq(nodes[0].get('client'), 'tcp://5.6.7.8:5678')
+            self.eq(nodes[0].get('cert'), client)

synapse/tests/test_model_risk.py

@@ -435,6 +435,8 @@ class RiskModelTest(s_t_utils.SynTest):
                 :public:url=https://wikileaks.org/acme
                 :reporter={ gen.ou.org vertex }
                 :reporter:name=vertex
+                :size:bytes=99
+                :extortion=*
             ]''')
             self.len(1, nodes)
             self.eq('wikileaks acme leak', nodes[0].get('name'))
@@ -442,9 +444,11 @@ class RiskModelTest(s_t_utils.SynTest):
             self.eq(1698883200000, nodes[0].get('disclosed'))
             self.eq('public.', nodes[0].get('type'))
             self.eq(1, nodes[0].get('public'))
+            self.eq(99, nodes[0].get('size:bytes'))
             self.eq('https://wikileaks.org/acme', nodes[0].get('public:url'))
             self.eq('vertex', nodes[0].get('reporter:name'))
 
+            self.len(1, await core.nodes('risk:leak -> risk:extortion'))
             self.len(1, await core.nodes('risk:leak -> risk:leak:type:taxonomy'))
             self.len(1, await core.nodes('risk:leak :owner -> ps:contact +:orgname=acme'))
             self.len(1, await core.nodes('risk:leak :leaker -> ps:contact +:orgname=wikileaks'))
@@ -454,6 +458,7 @@ class RiskModelTest(s_t_utils.SynTest):
 
             nodes = await core.nodes('''[ risk:extortion=*
                 :demanded=20231102
+                :deadline=20240329
                 :name="APT99 Extorted     ACME"
                 :desc="APT99 extorted ACME for a zillion vertex coins."
                 :type=fingain
@@ -474,6 +479,7 @@ class RiskModelTest(s_t_utils.SynTest):
             self.eq('apt99 extorted acme', nodes[0].get('name'))
             self.eq('APT99 extorted ACME for a zillion vertex coins.', nodes[0].get('desc'))
             self.eq(1698883200000, nodes[0].get('demanded'))
+            self.eq(1711670400000, nodes[0].get('deadline'))
             self.eq('fingain.', nodes[0].get('type'))
             self.eq(1, nodes[0].get('public'))
             self.eq(1, nodes[0].get('success'))

synapse/tests/test_telepath.py

@@ -831,15 +831,17 @@ class TeleTest(s_t_utils.SynTest):
 
             await targ.waitready()
 
-            self.eq(110, await targ.dostuff(100))
+            prox00 = await targ.proxy(timeout=12)
+            self.eq(110, await prox00.dostuff(100))
+
             self.eq(1, fail0.count)
             self.eq(0, fail1.count)
 
-            _prox = await targ.proxy()
             await dmon0.fini()
-            self.true(await _prox.waitfini(10))
+            self.true(await prox00.waitfini(10))
 
-            self.eq(110, await targ.dostuff(100))
+            prox01 = await targ.proxy(timeout=12)
+            self.eq(110, await prox01.dostuff(100))
             self.eq(1, fail0.count)
             self.eq(1, fail1.count)
 
@@ -855,15 +857,36 @@ class TeleTest(s_t_utils.SynTest):
                 mesgs = stream.read()
                 self.notin('password', mesgs)
 
-            self.eq(110, await targ.dostuff(100))
+            prox00 = await targ.proxy(timeout=12)
+            self.eq(110, await prox00.dostuff(100))
 
             self.eq(1, fail0.count)
             self.eq(2, fail1.count)
 
         async with await s_telepath.open(url1) as targ:
-            await targ.waitready()
-            self.eq(110, await targ.dostuff(100))
+            await targ.waitready(timeout=12)
+            prox00 = await targ.proxy(timeout=12)
+            self.eq(110, await prox00.dostuff(100))
+
+        async def onlink(proxy, urlinfo):
+            self.eq(110, await proxy.dostuff(100))
+            _url = s_telepath.zipurl(urlinfo)
+            logger.info(f'Connected to url={_url}')
+
+        with self.getAsyncLoggerStream('synapse.tests.test_telepath',
+                                       f'Connected to url=tcp://127.0.0.1:{addr1[1]}/foo') as stream:
+            async with await s_telepath.open(url1, onlink=onlink) as targ:
+                self.true(await stream.wait(timeout=12))
+
+        # Coverage
+        async def badonlink(proxy, urlinfo):
+            raise ValueError('oopsie')
+
+        with self.getAsyncLoggerStream('synapse.telepath', 'onlink: ') as stream:
+            async with await s_telepath.open(url1, onlink=badonlink) as targ:
+                self.true(await stream.wait(timeout=12))
 
+        await dmon0.fini()
         await dmon1.fini()
 
     async def test_telepath_poolsize(self):

synapse/tests/test_tools_genpkg.py

@@ -254,7 +254,33 @@ class TestStormPkgTest(s_test.StormPkgTest):
     assetdir = s_common.genpath(dirname, 'files', 'stormpkg', 'dotstorm', 'testassets')
     pkgprotos = (s_common.genpath(dirname, 'files', 'stormpkg', 'dotstorm', 'dotstorm.yaml'),)
 
+    async def initTestCore(self, core):
+        await core.callStorm('$lib.globals.set(inittestcore, frob)')
+
     async def test_stormpkg_base(self):
         async with self.getTestCore() as core:
             msgs = await core.stormlist('dotstorm.bar')
             self.stormHasNoWarnErr(msgs)
+            self.eq('frob', await core.callStorm('return($lib.globals.get(inittestcore))'))
+
+    async def stormpkg_preppkghook(self, core):
+        await core.callStorm('$lib.globals.set(stormpkg_preppkghook, boundmethod)')
+
+    async def test_stormpkg_preppkghook(self):
+
+        # inline example
+        async def hook(core):
+            await core.callStorm('$lib.globals.set(inlinehook, haha)')
+
+        async with self.getTestCore(prepkghook=hook) as core:
+            msgs = await core.stormlist('dotstorm.bar')
+            self.stormHasNoWarnErr(msgs)
+            self.eq('haha', await core.callStorm('return($lib.globals.get(inlinehook))'))
+            self.eq('frob', await core.callStorm('return($lib.globals.get(inittestcore))'))
+
+        # bound method example
+        async with self.getTestCore(prepkghook=self.stormpkg_preppkghook) as core:
+            msgs = await core.stormlist('dotstorm.bar')
+            self.stormHasNoWarnErr(msgs)
+            self.eq('boundmethod', await core.callStorm('return($lib.globals.get(stormpkg_preppkghook))'))
+            self.eq('frob', await core.callStorm('return($lib.globals.get(inittestcore))'))

synapse/tests/test_tools_hiveload.py

@@ -48,6 +48,7 @@ class HiveLoadTest(s_test.SynTest):
                 with mock.patch('synapse.telepath.Proxy._getSynVers', _getOldSynVers):
                     outp = self.getTestOutp()
                     retn = await s_hiveload.main(argv, outp=outp)
+                    outp.expect('WARNING: "synapse.tools.hive.load" is deprecated in 2.167.0 and will be removed in 3.0.0')
                     outp.expect('Hive version 0.0.0 is outside of the hive.load supported range')
                     self.eq(1, retn)
 

synapse/tests/test_tools_hivesave.py

@@ -28,6 +28,7 @@ class HiveSaveTest(s_test.SynTest):
                 with mock.patch('synapse.telepath.Proxy._getSynVers', _getOldSynVers):
                     outp = self.getTestOutp()
                     retn = await s_hivesave.main(argv, outp=outp)
+                    outp.expect('WARNING: "synapse.tools.hive.save" is deprecated in 2.167.0 and will be removed in 3.0.0')
                     outp.expect('Hive version 0.0.0 is outside of the hive.save supported range')
                     self.eq(1, retn)
 

synapse/tests/test_tools_modrole.py

@@ -2,6 +2,26 @@ import synapse.lib.output as s_output
 import synapse.tests.utils as s_test
 import synapse.tools.modrole as s_t_modrole
 
+rolelist = s_test.deguidify('''
+Roles:
+  ce6928dfe88cace918c405bbef51e72f - all
+  0f316b3f3e6ec970fcdb9a085fcd5b77 - visi
+'''.strip())
+
+roleinfo = s_test.deguidify('''
+Role: visi (145c3321a0cd0cd06de19174415a7aeb)
+
+  Rules:
+    [0  ] - !foo.bar.baz
+    [1  ] - foo.bar
+
+  Gates:
+    3ad191c63a201df3246c6d6ff81763ad
+      Admin: False
+      [0  ] - !bar.baz.faz
+      [1  ] - bar.baz
+'''.strip())
+
 class ModRoleTest(s_test.SynTest):
 
     async def test_tools_modrole(self):
@@ -40,6 +60,60 @@ class ModRoleTest(s_test.SynTest):
             self.true(bool(visi.allowed('foo.bar.gaz'.split('.'))))
             self.false(bool(visi.allowed('foo.bar.baz'.split('.'))))
 
+            gateiden = core.getLayer().iden
+            argv = (
+                '--svcurl', svcurl,
+                'visi',
+                '--allow', 'bar.baz',
+                '--deny', 'bar.baz.faz',
+                '--gate', gateiden,
+            )
+            outp = s_output.OutPutStr()
+            self.eq(0, await s_t_modrole.main(argv, outp=outp))
+            self.isin(f'...adding allow rule: bar.baz on gate {gateiden}', str(outp))
+            self.isin(f'...adding deny rule: bar.baz.faz on gate {gateiden}', str(outp))
+
+            gate = await core.getAuthGate(gateiden)
+            for role in gate['roles']:
+                if role['iden'] == visi.iden:
+                    self.isin((True, ('bar', 'baz')), role['rules'])
+                    self.isin((False, ('bar', 'baz', 'faz')), role['rules'])
+
+            argv = (
+                '--svcurl', svcurl,
+                '--list',
+            )
+            outp = s_output.OutPutStr()
+            self.eq(0, await s_t_modrole.main(argv, outp=outp))
+            self.isin(rolelist, s_test.deguidify(str(outp)))
+
+            argv = (
+                '--svcurl', svcurl,
+                '--list',
+                'visi',
+            )
+            outp = s_output.OutPutStr()
+            self.eq(0, await s_t_modrole.main(argv, outp=outp))
+            self.isin(roleinfo, s_test.deguidify(str(outp)))
+
+            argv = (
+                '--svcurl', svcurl,
+                '--list',
+                'newprole',
+            )
+            outp = s_output.OutPutStr()
+            self.eq(1, await s_t_modrole.main(argv, outp=outp))
+            self.isin('ERROR: Role not found: newprole', str(outp))
+
+            argv = (
+                '--svcurl', svcurl,
+                'visi',
+                '--gate', 'newp',
+            )
+            outp = s_output.OutPutStr()
+            self.eq(1, await s_t_modrole.main(argv, outp=outp))
+            self.isin('ERROR: No auth gate found with iden: newp', str(outp))
+
             argv = (
                 '--svcurl', svcurl,
                 '--add',
@@ -59,3 +133,10 @@ class ModRoleTest(s_test.SynTest):
             self.eq(0, await s_t_modrole.main(argv, outp=outp))
             self.isin('...deleting role: visi', str(outp))
             self.none(await core.auth.getRoleByName('visi'))
+
+            argv = (
+                '--svcurl', svcurl,
+            )
+            outp = s_output.OutPutStr()
+            self.eq(1, await s_t_modrole.main(argv, outp=outp))
+            self.isin('ERROR: A rolename argument is required when --list is not specified.', str(outp))

synapse/tests/test_tools_moduser.py

@@ -2,6 +2,32 @@ import synapse.lib.output as s_output
 import synapse.tests.utils as s_test
 import synapse.tools.moduser as s_t_moduser
 
+userlist = '''
+Users:
+  root
+  visi
+'''.strip()
+
+userinfo = s_test.deguidify('''
+User: visi (04dddd4ff39e4ce00b36c7d526b9eac7)
+
+  Locked: False
+  Admin: False
+  Email: visi@test.com
+  Rules:
+    [0  ] - !foo.bar.baz
+    [1  ] - foo.bar
+
+  Roles:
+    576a948f9944c58d3953f0d36bc2da81 - all
+
+  Gates:
+    c7b276154c0c799430668cb3c4cd259d
+      Admin: False
+      [0  ] - !bar.baz.faz
+      [1  ] - bar.baz
+'''.strip())
+
 class ModUserTest(s_test.SynTest):
 
     async def test_tools_moduser(self):
@@ -124,6 +150,78 @@ class ModUserTest(s_test.SynTest):
             self.true(bool(visi.allowed('foo.bar.gaz'.split('.'))))
             self.false(bool(visi.allowed('foo.bar.baz'.split('.'))))
 
+            gateiden = core.getLayer().iden
+            argv = (
+                '--svcurl', svcurl,
+                'visi',
+                '--admin', 'true',
+                '--gate', gateiden,
+            )
+            outp = s_output.OutPutStr()
+            self.eq(0, await s_t_moduser.main(argv, outp=outp))
+            self.isin(f'...setting admin: true on gate {gateiden}', str(outp))
+
+            gate = await core.getAuthGate(gateiden)
+            for user in gate['users']:
+                if user['iden'] == visi.iden:
+                    self.true(user['admin'])
+
+            gateiden = core.getLayer().iden
+            argv = (
+                '--svcurl', svcurl,
+                'visi',
+                '--admin', 'false',
+                '--allow', 'bar.baz',
+                '--deny', 'bar.baz.faz',
+                '--gate', gateiden,
+            )
+            outp = s_output.OutPutStr()
+            self.eq(0, await s_t_moduser.main(argv, outp=outp))
+            self.isin(f'...setting admin: false on gate {gateiden}', str(outp))
+            self.isin(f'...adding allow rule: bar.baz on gate {gateiden}', str(outp))
+            self.isin(f'...adding deny rule: bar.baz.faz on gate {gateiden}', str(outp))
+
+            gate = await core.getAuthGate(gateiden)
+            for user in gate['users']:
+                if user['iden'] == visi.iden:
+                    self.isin((True, ('bar', 'baz')), user['rules'])
+                    self.isin((False, ('bar', 'baz', 'faz')), user['rules'])
+
+            argv = (
+                '--svcurl', svcurl,
+                '--list',
+            )
+            outp = s_output.OutPutStr()
+            self.eq(0, await s_t_moduser.main(argv, outp=outp))
+            self.isin(userlist, str(outp))
+
+            argv = (
+                '--svcurl', svcurl,
+                '--list',
+                'visi',
+            )
+            outp = s_output.OutPutStr()
+            self.eq(0, await s_t_moduser.main(argv, outp=outp))
+            self.isin(userinfo, s_test.deguidify(str(outp)))
+
+            argv = (
+                '--svcurl', svcurl,
+                '--list',
+                'newpuser',
+            )
+            outp = s_output.OutPutStr()
+            self.eq(1, await s_t_moduser.main(argv, outp=outp))
+            self.isin('ERROR: User not found: newpuser', str(outp))
+
+            argv = (
+                '--svcurl', svcurl,
+                'visi',
+                '--gate', 'newp',
+            )
+            outp = s_output.OutPutStr()
+            self.eq(1, await s_t_moduser.main(argv, outp=outp))
+            self.isin('ERROR: No auth gate found with iden: newp', str(outp))
+
             argv = (
                 '--svcurl', svcurl,
                 'visi',
@@ -151,3 +249,10 @@ class ModUserTest(s_test.SynTest):
             outp = s_output.OutPutStr()
             self.eq(1, await s_t_moduser.main(argv, outp=outp))
             self.isin('ERROR: User not found (need --add?): visi', str(outp))
+
+            argv = (
+                '--svcurl', svcurl,
+            )
+            outp = s_output.OutPutStr()
+            self.eq(1, await s_t_moduser.main(argv, outp=outp))
+            self.isin('ERROR: A username argument is required when --list is not specified.', str(outp))

synapse/tests/utils.py

@@ -1444,7 +1444,7 @@ class SynTest(unittest.TestCase):
         Get an Aha cell that is configured for provisioning on aha.loop.vertex.link.
 
         Args:
-            conf: Optional configuraiton information for the Aha cell.
+            conf: Optional configuration information for the Aha cell.
             dirn: Optional path to create the Aha cell in.
 
         Returns:
@@ -2344,6 +2344,8 @@ class SynTest(unittest.TestCase):
             return await core.nodes(query, opts)
         return await core.schedCoro(coro())
 
+ONLOAD_TIMEOUT = int(os.getenv('SYNDEV_PKG_LOAD_TIMEOUT', 30))  # seconds
+
 class StormPkgTest(SynTest):
 
     vcr = None
@@ -2351,12 +2353,26 @@ class StormPkgTest(SynTest):
     pkgprotos = ()
 
     @contextlib.asynccontextmanager
-    async def getTestCore(self, conf=None, dirn=None):
+    async def getTestCore(self, conf=None, dirn=None, prepkghook=None):
 
         async with SynTest.getTestCore(self, conf=None, dirn=None) as core:
 
+            if prepkghook is not None:
+                await prepkghook(core)
+
             for pkgproto in self.pkgprotos:
-                self.eq(0, await s_genpkg.main((pkgproto, '--no-docs', '--push', core.getLocalUrl())))
+
+                pkgdef = s_genpkg.loadPkgProto(pkgproto, no_docs=True, readonly=True)
+
+                waiter = None
+                if pkgdef.get('onload') is not None:
+                    waiter = core.waiter(1, 'core:pkg:onload:complete')
+
+                await core.addStormPkg(pkgdef)
+
+                if waiter is not None:
+                    self.nn(await waiter.wait(timeout=ONLOAD_TIMEOUT),
+                            f'Package onload failed to run for {pkgdef.get("name")}')
 
             if self.assetdir is not None:
 
@@ -2372,4 +2388,7 @@ class StormPkgTest(SynTest):
             yield core
 
     async def initTestCore(self, core):
+        '''
+        This is executed after the package has been loaded and a VCR context has been entered.
+        '''
         pass

synapse/tools/autodoc.py

@@ -717,7 +717,7 @@ async def docModel(outp,
                 raise s_exc.SynErr(mesg='Invalid example', form=form, example=example, info=mnfo)
             if mtyp == 'node':
                 node = True
-        if not node:  # pramga: no cover
+        if not node:  # pragma: no cover
             raise s_exc.SynErr(mesg='Unable to make a node from example.', form=form, example=example)
 
     rst = s_autodoc.RstHelp()

synapse/tools/hive/load.py

@@ -14,6 +14,9 @@ reqver = '>=0.2.0,<3.0.0'
 
 async def main(argv, outp=s_output.stdout):
 
+    mesg = s_common.deprecated('synapse.tools.hive.load', curv='2.167.0')
+    outp.printf(f'WARNING: {mesg}')
+
     pars = argparse.ArgumentParser(prog='synapse.tools.hive.load',
                                    description='Load data into a remote hive from a previous hivesave.')
 

synapse/tools/hive/save.py

@@ -14,6 +14,9 @@ reqver = '>=0.2.0,<3.0.0'
 
 async def main(argv, outp=s_output.stdout):
 
+    mesg = s_common.deprecated('synapse.tools.hive.save', curv='2.167.0')
+    outp.printf(f'WARNING: {mesg}')
+
     pars = argparse.ArgumentParser(prog='synapse.tools.hive.save',
                                    description='Save tree data from a remote hive to file.')