synapse 2.153.0__py311-none-any.whl → 2.154.0__py311-none-any.whl

synapse/lib/stormlib/json.py

@@ -62,9 +62,11 @@ class JsonSchema(s_stormtypes.StormType):
             'validate': self._validate,
         }
 
+    @s_stormtypes.stormfunc(readonly=True)
     async def _schema(self):
         return copy.deepcopy(self.schema)
 
+    @s_stormtypes.stormfunc(readonly=True)
     async def _validate(self, item):
         item = await s_stormtypes.toprim(item)
 
@@ -112,6 +114,7 @@ class JsonLib(s_stormtypes.Lib):
             'schema': self._jsonSchema,
         }
 
+    @s_stormtypes.stormfunc(readonly=True)
     async def _jsonSave(self, item):
         try:
             item = await s_stormtypes.toprim(item)
@@ -120,6 +123,7 @@ class JsonLib(s_stormtypes.Lib):
             mesg = f'Argument is not JSON compatible: {item}'
             raise s_exc.MustBeJsonSafe(mesg=mesg)
 
+    @s_stormtypes.stormfunc(readonly=True)
     async def _jsonLoad(self, text):
         text = await s_stormtypes.tostr(text)
         try:
@@ -128,6 +132,7 @@ class JsonLib(s_stormtypes.Lib):
             mesg = f'Text is not valid JSON: {text}'
             raise s_exc.BadJsonText(mesg=mesg)
 
+    @s_stormtypes.stormfunc(readonly=True)
     async def _jsonSchema(self, schema, use_default=True):
         schema = await s_stormtypes.toprim(schema)
         use_default = await s_stormtypes.tobool(use_default)

synapse/lib/stormlib/mime.py

@@ -29,6 +29,7 @@ class LibMimeHtml(s_stormtypes.Lib):
             'totext': self.totext,
         }
 
+    @s_stormtypes.stormfunc(readonly=True)
     async def totext(self, html):
         html = await s_stormtypes.tostr(html)
         return await s_coro.semafork(htmlToText, html)

synapse/lib/stormlib/model.py

@@ -251,10 +251,12 @@ class LibModelTags(s_stormtypes.Lib):
         self.runt.confirm(('model', 'tag', 'set'))
         return await self.runt.snap.core.delTagModel(tagname)
 
+    @s_stormtypes.stormfunc(readonly=True)
     async def _getTagModel(self, tagname):
         tagname = await s_stormtypes.tostr(tagname)
         return await self.runt.snap.core.getTagModel(tagname)
 
+    @s_stormtypes.stormfunc(readonly=True)
     async def _listTagModel(self):
         return await self.runt.snap.core.listTagModel()
 
@@ -325,24 +327,28 @@ class LibModel(s_stormtypes.Lib):
         }
 
     @s_cache.memoizemethod(size=100)
+    @s_stormtypes.stormfunc(readonly=True)
     async def _methType(self, name):
         type_ = self.model.type(name)
         if type_ is not None:
             return ModelType(type_)
 
     @s_cache.memoizemethod(size=100)
+    @s_stormtypes.stormfunc(readonly=True)
     async def _methProp(self, name):
         prop = self.model.prop(name)
         if prop is not None:
             return ModelProp(prop)
 
     @s_cache.memoizemethod(size=100)
+    @s_stormtypes.stormfunc(readonly=True)
     async def _methForm(self, name):
         form = self.model.form(name)
         if form is not None:
             return ModelForm(form)
 
     @s_cache.memoize(size=100)
+    @s_stormtypes.stormfunc(readonly=True)
     async def _methTagProp(self, name):
         tagprop = self.model.getTagProp(name)
         if tagprop is not None:
@@ -387,6 +393,7 @@ class ModelForm(s_stormtypes.Prim):
     def _ctorFormType(self, path=None):
         return ModelType(self.valu.type, path=path)
 
+    @s_stormtypes.stormfunc(readonly=True)
     def _getFormProp(self, name):
         prop = self.valu.prop(name)
         if prop is not None:
@@ -490,15 +497,21 @@ class ModelType(s_stormtypes.Prim):
         s_stormtypes.Prim.__init__(self, valu, path=path)
         self.locls.update(self.getObjLocals())
         self.locls.update({'name': valu.name,
-                           'norm': self._methNorm,
-                           'repr': self._methRepr,
                            'stortype': valu.stortype,
                            })
 
+    def getObjLocals(self):
+        return {
+            'norm': self._methNorm,
+            'repr': self._methRepr,
+        }
+
+    @s_stormtypes.stormfunc(readonly=True)
     async def _methRepr(self, valu):
         nval = self.valu.norm(valu)
         return self.valu.repr(nval[0])
 
+    @s_stormtypes.stormfunc(readonly=True)
     async def _methNorm(self, valu):
         return self.valu.norm(valu)
 
@@ -544,7 +557,7 @@ class LibModelEdge(s_stormtypes.Lib):
     # Note: The use of extprops in hive paths in this class is an artifact of the
     # original implementation which used extended property language which had a
     # very bad cognitive overload with the cortex extended properties, but we
-    # dont' want to change underlying data. epiphyte 20200703
+    # don't want to change underlying data. epiphyte 20200703
 
     # restrict list of keys which we allow to be set/del through this API.
     validedgekeys = (
@@ -578,9 +591,11 @@ class LibModelEdge(s_stormtypes.Lib):
             raise s_exc.NoSuchProp(mesg=f'The requested key is not valid for light edge metadata.',
                                    name=key)
 
+    @s_stormtypes.stormfunc(readonly=True)
     def _methValidKeys(self):
         return self.validedgekeys
 
+    @s_stormtypes.stormfunc(readonly=True)
     async def _methEdgeGet(self, verb):
         verb = await s_stormtypes.tostr(verb)
         await self._chkEdgeVerbInView(verb)
@@ -620,6 +635,7 @@ class LibModelEdge(s_stormtypes.Lib):
 
         await self.runt.snap.core.setHiveKey(path, kvdict)
 
+    @s_stormtypes.stormfunc(readonly=True)
     async def _methEdgeList(self):
         retn = []
         async for verb in self.runt.snap.view.getEdgeVerbs():

synapse/lib/stormlib/modelext.py

@@ -156,6 +156,7 @@ class LibModelExt(s_stormtypes.Lib):
         s_stormtypes.confirm(('model', 'tagprop', 'del'))
         await self.runt.snap.core.delTagProp(propname)
 
+    @s_stormtypes.stormfunc(readonly=True)
     async def getExtModel(self):
         return await self.runt.snap.core.getExtModel()
 

synapse/lib/stormlib/notifications.py

@@ -65,6 +65,7 @@ class NotifyLib(s_stormtypes.Lib):
             # 'bytype':
         }
 
+    @s_stormtypes.stormfunc(readonly=True)
     async def get(self, indx):
         indx = await s_stormtypes.toint(indx)
         mesg = await self.runt.snap.core.getUserNotif(indx)
@@ -81,6 +82,7 @@ class NotifyLib(s_stormtypes.Lib):
             raise s_exc.AuthDeny(mesg=mesg, user=self.runt.user.iden, username=self.runt.user.name)
         await self.runt.snap.core.delUserNotif(indx)
 
+    @s_stormtypes.stormfunc(readonly=True)
     async def list(self, size=None):
         size = await s_stormtypes.toint(size, noneok=True)
         async for mesg in self.runt.snap.core.iterUserNotifs(self.runt.user.iden, size=size):

synapse/lib/stormlib/pack.py

@@ -34,6 +34,7 @@ class LibPack(s_stormtypes.Lib):
             'un': self.un,
         }
 
+    @s_stormtypes.stormfunc(readonly=True)
     async def en(self, fmt, items):
         fmt = await s_stormtypes.tostr(fmt)
         items = await s_stormtypes.toprim(items)
@@ -47,6 +48,7 @@ class LibPack(s_stormtypes.Lib):
         except struct.error as e:
             raise s_exc.BadArg(mesg=str(e))
 
+    @s_stormtypes.stormfunc(readonly=True)
     async def un(self, fmt, byts, offs=0):
 
         fmt = await s_stormtypes.tostr(fmt)

synapse/lib/stormlib/random.py

@@ -26,6 +26,7 @@ class LibRandom(s_stormtypes.Lib):
             'int': self._int,
         }
 
+    @s_stormtypes.stormfunc(readonly=True)
     async def _int(self, maxval, minval=0):
         maxval = await s_stormtypes.toint(maxval)
         minval = await s_stormtypes.toint(minval)

synapse/lib/stormlib/smtp.py

@@ -130,19 +130,15 @@ class SmtpMessage(s_stormtypes.StormType):
             'sender': self._setSenderEmail,
         })
 
-    @s_stormtypes.stormfunc(readonly=True)
     async def _setSenderEmail(self, valu):
-        # TODO handle inet:email and ps:contact Nodes
         self.sender = await s_stormtypes.tostr(valu)
 
     async def _getSenderEmail(self):
         return self.sender
 
-    @s_stormtypes.stormfunc(readonly=True)
     async def _setEmailText(self, text):
         self.bodytext = await s_stormtypes.tostr(text)
 
-    @s_stormtypes.stormfunc(readonly=True)
     async def _setEmailHtml(self, html):
         self.bodyhtml = await s_stormtypes.tostr(html)
 
@@ -152,9 +148,6 @@ class SmtpMessage(s_stormtypes.StormType):
     async def _getEmailHtml(self):
         return self.bodyhtml
 
-    # TODO
-    # async def attach(self, sha256, name, mime):
-
     async def send(self, host, port=25, user=None, passwd=None, usetls=False, starttls=False, timeout=60):
 
         self.runt.confirm(('storm', 'inet', 'smtp', 'send'))

synapse/lib/stormlib/stats.py

@@ -131,6 +131,7 @@ class LibStats(s_stormtypes.Lib):
             'tally': self.tally,
         }
 
+    @s_stormtypes.stormfunc(readonly=True)
     async def tally(self):
         return StatTally(path=self.path)
 
@@ -198,10 +199,12 @@ class StatTally(s_stormtypes.Prim):
     def __len__(self):
         return len(self.counters)
 
+    @s_stormtypes.stormfunc(readonly=True)
     async def inc(self, name, valu=1):
         valu = await s_stormtypes.toint(valu)
         self.counters[name] += valu
 
+    @s_stormtypes.stormfunc(readonly=True)
     async def get(self, name):
         return self.counters.get(name, 0)
 
@@ -212,6 +215,7 @@ class StatTally(s_stormtypes.Prim):
         for item in tuple(self.counters.items()):
             yield item
 
+    @s_stormtypes.stormfunc(readonly=True)
     async def sorted(self, byname=False, reverse=False):
         if byname:
             return list(sorted(self.counters.items(), reverse=reverse))

synapse/lib/stormlib/stix.py

@@ -653,10 +653,12 @@ class LibStix(s_stormtypes.Lib):
             'validate': self.validateBundle,
         }
 
+    @s_stormtypes.stormfunc(readonly=True)
     async def validateBundle(self, bundle):
         bundle = await s_stormtypes.toprim(bundle)
         return await s_coro.semafork(validateStix, bundle)
 
+    @s_stormtypes.stormfunc(readonly=True)
     async def liftBundle(self, bundle):
         bundle = await s_stormtypes.toprim(bundle)
 
@@ -861,6 +863,7 @@ class LibStixImport(s_stormtypes.Lib):
             'ingest': self.ingest,
         }
 
+    @s_stormtypes.stormfunc(readonly=True)
     async def config(self):
         return s_msgpack.deepcopy(stixingest, use_list=True)
 
@@ -1129,10 +1132,12 @@ class LibStixExport(s_stormtypes.Lib):
             'timestamp': self.timestamp,
         }
 
+    @s_stormtypes.stormfunc(readonly=True)
     async def config(self):
         # make a new mutable config
         return json.loads(json.dumps(_DefaultConfig))
 
+    @s_stormtypes.stormfunc(readonly=True)
     async def bundle(self, config=None):
 
         if config is None:
@@ -1265,6 +1270,7 @@ class StixBundle(s_stormtypes.Prim):
     # async def addPropMap(self, formname, stixtype, propname, stormtext):
     # async def addRelsMap(self, formname, stixtype, relname, targtype,  stormtext):
 
+    @s_stormtypes.stormfunc(readonly=True)
     async def add(self, node, stixtype=None):
 
         if len(self.objs) >= self.maxsize:
@@ -1380,6 +1386,7 @@ class StixBundle(s_stormtypes.Prim):
         }
         return ret
 
+    @s_stormtypes.stormfunc(readonly=True)
     def pack(self):
         objects = list(self.objs.values())
         if self.synextension:
@@ -1391,6 +1398,7 @@ class StixBundle(s_stormtypes.Prim):
         }
         return bundle
 
+    @s_stormtypes.stormfunc(readonly=True)
     def size(self):
         return len(self.objs)
 

synapse/lib/stormlib/storm.py

@@ -23,6 +23,7 @@ class LibStorm(s_stormtypes.Lib):
             'eval': self._evalStorm,
         }
 
+    @s_stormtypes.stormfunc(readonly=True)
     async def _evalStorm(self, text, cast=None):
 
         text = await s_stormtypes.tostr(text)

synapse/lib/stormlib/version.py

@@ -45,12 +45,15 @@ class VersionLib(s_stormtypes.Lib):
             'synapse': self._getSynVersion,
         }
 
+    @s_stormtypes.stormfunc(readonly=True)
     async def _getSynVersion(self):
         return s_version.version
 
+    @s_stormtypes.stormfunc(readonly=True)
     async def _getSynCommit(self):
         return s_version.commit
 
+    @s_stormtypes.stormfunc(readonly=True)
     async def matches(self, vertup, reqstr):
         reqstr = await s_stormtypes.tostr(reqstr)
         vertup = tuple(await s_stormtypes.toprim(vertup))

synapse/lib/stormlib/xml.py

@@ -49,6 +49,7 @@ class XmlElement(s_stormtypes.Prim):
         for elem in self.elem:
             yield XmlElement(self.runt, elem)
 
+    @s_stormtypes.stormfunc(readonly=True)
     async def find(self, name, nested=True):
         name = await s_stormtypes.tostr(name)
         nested = await s_stormtypes.tobool(nested)
@@ -60,6 +61,7 @@ class XmlElement(s_stormtypes.Prim):
             for elem in self.elem.findall(name):
                 yield XmlElement(self.runt, elem)
 
+    @s_stormtypes.stormfunc(readonly=True)
     async def get(self, name):
         name = await s_stormtypes.tostr(name)
         elem = self.elem.find(name)
@@ -87,6 +89,7 @@ class LibXml(s_stormtypes.Lib):
             'parse': self.parse,
         }
 
+    @s_stormtypes.stormfunc(readonly=True)
     async def parse(self, valu):
         valu = await s_stormtypes.tostr(valu)
         try:

synapse/lib/stormlib/yaml.py

@@ -34,11 +34,13 @@ class LibYaml(s_stormtypes.Lib):
             'load': self.load,
         }
 
+    @s_stormtypes.stormfunc(readonly=True)
     async def save(self, valu, sort_keys=True):
         valu = await s_stormtypes.toprim(valu)
         sort_keys = await s_stormtypes.tobool(sort_keys)
         return yaml.dump(valu, sort_keys=sort_keys, Dumper=s_common.Dumper)
 
+    @s_stormtypes.stormfunc(readonly=True)
     async def load(self, valu):
         valu = await s_stormtypes.tostr(valu)
         try: