synapse 3.0.0__py314-none-any.whl

synapse/__init__.py

@@ -0,0 +1,27 @@
+'''
+The synapse intelligence analysis framework.
+'''
+
+import sys
+if (sys.version_info.major, sys.version_info.minor) < (3, 14):  # pragma: no cover
+    raise Exception('synapse is not supported on Python versions < 3.14')
+
+# checking maximum *signed* integer size to determine the interpreter arch
+if sys.maxsize < 9223372036854775807:  # pragma: no cover
+    raise Exception('synapse is only supported on 64 bit architectures')
+
+# Checking if the interpreter is running with -OO - if so, this breaks
+# behavior which relies on __doc__ being set.  Warn the user of this
+# degraded behavior.  Could affect Cli, Cortex, and other components.
+if sys.flags.optimize >= 2:
+    import warnings
+    mesg = '''Synapse components may experience degraded capabilities with sys.flags.optimize >=2.'''
+    warnings.warn(mesg, RuntimeWarning)
+
+import lmdb
+if tuple([int(x) for x in lmdb.__version__.split('.')]) < (1, 0, 0):  # pragma: no cover
+    raise Exception('synapse is only supported on version >= 1.0.0 of the lmdb python module')
+
+from synapse.lib.version import version  # noqa: F401
+# Friendly __version__ string alias
+__version__ = version

synapse/assets/__init__.py

@@ -0,0 +1,35 @@
+import os
+import logging
+
+import synapse.common as s_common
+
+logger = logging.getLogger(__name__)
+dirname = os.path.dirname(__file__)
+
+def getStorm(*names):
+    '''
+    Return a storm file from the synapse storm folder.
+
+    Example:
+
+        text = storm.get('migrate.storm')
+        await core.callStorm(text)
+
+    Example #2:
+        text = storm.get('migrations', 'model-0.2.28.storm')
+        await core.callStorm(text)
+    '''
+    fp = getAssetPath('storm', *names)
+    with open(fp, 'rb') as fd:
+        text = fd.read()
+    return text.decode('utf8')
+
+def getAssetPath(*names):
+    fp = s_common.genpath(dirname, *names)
+    if not fp.startswith(dirname):
+        logger.error(f'{fp} is not in {dirname}')
+        raise ValueError(f'Path escaping detected for {names}')
+    if not os.path.isfile(fp):
+        logger.error('{} does not exist'.format(fp))
+        raise ValueError(f'Asset does not exist for {names}')
+    return fp