sferriol-python 0.4.1__tar.gz

sferriol-python-0.4.1/LICENSE

@@ -0,0 +1,24 @@
+This is free and unencumbered software released into the public domain.
+
+Anyone is free to copy, modify, publish, use, compile, sell, or
+distribute this software, either in source code form or as a compiled
+binary, for any purpose, commercial or non-commercial, and by any
+means.
+
+In jurisdictions that recognize copyright laws, the author or authors
+of this software dedicate any and all copyright interest in the
+software to the public domain. We make this dedication for the benefit
+of the public at large and to the detriment of our heirs and
+successors. We intend this dedication to be an overt act of
+relinquishment in perpetuity of all present and future rights to this
+software under copyright law.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY CLAIM, DAMAGES OR
+OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
+ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
+OTHER DEALINGS IN THE SOFTWARE.
+
+For more information, please refer to <https://unlicense.org>

sferriol-python-0.4.1/PKG-INFO

@@ -0,0 +1,26 @@
+Metadata-Version: 2.1
+Name: sferriol-python
+Version: 0.4.1
+Summary: python utilities
+Home-page: https://gitlab.in2p3.fr/sferriol-ip2i/sferriol-python
+Author: Sylvain Ferriol
+Author-email: s.ferriol@ipnl.in2p3.fr
+Classifier: License :: OSI Approved :: The Unlicense (Unlicense)
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Description-Content-Type: text/markdown
+License-File: LICENSE
+
+# sferriol-python
+
+sferriol-python is a set of useful python libraries.
+
+Clone the project
+
+	git clone  git@gitlab.in2p3.fr:sferriol-ip2i/sferriol-python.git
+	
+Install it in your environment
+
+	python -m pip install .
+
+

sferriol-python-0.4.1/README.md

@@ -0,0 +1,13 @@
+# sferriol-python
+
+sferriol-python is a set of useful python libraries.
+
+Clone the project
+
+	git clone  git@gitlab.in2p3.fr:sferriol-ip2i/sferriol-python.git
+	
+Install it in your environment
+
+	python -m pip install .
+
+

sferriol-python-0.4.1/pyproject.toml

@@ -0,0 +1,10 @@
+[build-system]
+requires = [ "setuptools>=41", "wheel", "setuptools-git-versioning>=2.0,<3", ]
+build-backend = "setuptools.build_meta"
+
+[tool.setuptools-git-versioning]
+enabled = true
+version_file = "VERSION"
+count_commits_from_version_file = true
+dev_template = "{tag}+{branch}{ccount}.git.{sha}"
+dirty_template = "{tag}+{branch}{ccount}.git.{sha}.dirty"

sferriol-python-0.4.1/setup.cfg

@@ -0,0 +1,24 @@
+[metadata]
+author = Sylvain Ferriol
+author_email = s.ferriol@ipnl.in2p3.fr
+classifiers = 
+	License :: OSI Approved :: The Unlicense (Unlicense)
+	Operating System :: OS Independent
+	Programming Language :: Python :: 3
+description = python utilities
+long_description = file: README.md
+long_description_content_type = text/markdown
+name = sferriol-python
+url = https://gitlab.in2p3.fr/sferriol-ip2i/sferriol-python
+
+[options]
+packages = find_namespace:
+
+[options.packages.find]
+exclude = *.test
+include = sferriol.*
+
+[egg_info]
+tag_build = 
+tag_date = 0
+

sferriol-python-0.4.1/setup.py

@@ -0,0 +1,13 @@
+#!/usr/bin/env python
+# -*- coding: utf-8 -*-
+import importlib
+import time
+import warnings
+
+from setuptools import setup
+
+version = '0.1.0'
+
+setup(
+    version_config=True,
+)

sferriol-python-0.4.1/sferriol/python/__init__.py

@@ -0,0 +1,57 @@
+import importlib.util
+import pathlib
+import time
+import types
+from typing import Any, Callable
+
+
+def load_module_from_file(fpath):
+    """
+    Load a module from a python file. 
+    The module name is the file name without file extension. 
+    """
+    name = module_name_from_file(fpath)
+    spec = importlib.util.spec_from_file_location(name, fpath)
+    module = importlib.util.module_from_spec(spec)
+    spec.loader.exec_module(module)
+    return module
+
+
+def loop_until(fct: Callable, ret: Any, every: float, timeout: float | int):
+    """Loops the execution of the function until it returns ret parameter
+    
+    It raises TimeoutError if the expected value is not returned by the function
+ 
+    Args:
+      fct: Function to be called
+      ret: The expected return value
+      every: Number of seconds to wait at the end of each loop
+      timeout: Timeout duration
+    """
+    start_time = time.perf_counter()
+    while True:
+        if fct() == ret:
+            return
+        time.sleep(every)
+        if time.perf_counter() - start_time >= timeout:
+            raise TimeoutError()
+
+
+def method(obj):
+    """
+    Decorator used to define a function as a new method of the object obj.
+    The method name is the function name.
+    """
+    def _(func):
+        name = func.__name__
+        setattr(obj, name, types.MethodType(func, obj))
+        return getattr(obj, name)
+
+    return _
+
+
+def module_name_from_file(fpath):
+    """
+    Return The module name of the associated python file.
+    """
+    return pathlib.Path(fpath).stem

sferriol-python-0.4.1/sferriol/python/dictionary/__init__.py

@@ -0,0 +1,82 @@
+#!/usr/bin/env python
+# -*- coding: utf-8 -*-
+#
+#  Copyright 2020 sferriol <sferriol@ipnl.in2p3.fr>
+
+
+class adict(dict):
+    """Attribute dictionary
+    """
+    def __delattr__(self, name):
+        self.__delitem__(name)
+
+    def __getattr__(self, name):
+        try:
+            ret = getattr(adict, name)
+        except AttributeError as e:
+            try:
+                ret = self.__getitem__(name)
+            except KeyError:
+                # if nothing is found, raise AttributeError instead of KeyError
+                raise e
+        return ret
+
+    def __setattr__(self, name, value):
+        self.__setitem__(name, value)
+
+
+def as_adict(elt):
+    return dict_to_adict(elt)
+
+
+class cdict(adict):
+    """Config dictionary.
+    c = cdict()
+    c['a.b'] = 2 # is equivalent to c['a'] = {'b':2}
+    assert c['a.b'] == c['a']['b']
+    assert c['a.b'] == c.a.b
+    """
+    def __getitem__(self, key):
+        di = self
+        l = key.split('.')
+        for k in l[:-1]:
+            di = di[k]
+        return adict.__getitem__(di, l[-1])
+
+    def __setitem__(self, key, value):
+        di = self
+        l = key.split('.')
+        for k in l[:-1]:
+            di.setdefault(k, adict())
+            di = di[k]
+        adict.__setitem__(di, l[-1], value)
+
+
+def dict_merge(di_1, di_2):
+    def _dict(di_1, di_2):
+        for key, value in di_2.items():
+            if isinstance(value, dict):
+                if key not in di_1:
+                    di_1[key] = {}
+                _dict(di_1[key], di_2[key])
+            else:
+                di_1[key] = value
+
+    _dict(di_1, di_2)
+    return di_1
+
+
+def dict_to_adict(di):
+    # build an adict from a dictionary
+    # and all sub dictionary will be trannform in Attribute_Dict too
+    def _di2adi(elt):
+        if isinstance(elt, list):
+            return [_di2adi(e) for e in elt]
+        if isinstance(elt, dict):
+            adi = adict()
+            for k, v in elt.items():
+                adi[k] = _di2adi(v)
+            return adi
+        return elt
+
+    return _di2adi(di)

sferriol-python-0.4.1/sferriol/python/json.py

@@ -0,0 +1,16 @@
+# -*- coding: utf-8 -*-
+#
+#  Copyright 2023 sferriol <s.ferriol@ip2i.in2p3.fr>
+
+import json
+import tempfile
+
+
+def dump_temporary(obj, prefix=None, dir=None):
+    """
+    Serialize obj as a JSON formatted stream to a temporary file and returns its file path. The file is created securely, using the same rules as mkstemp().  The user is responsible for deleting the temporary file when done with it.
+    """
+    _, fpath = tempfile.mkstemp(prefix=prefix, suffix='.json', dir=dir)
+    with open(fpath, 'w') as f:
+        json.dump(obj, f)
+    return fpath

sferriol-python-0.4.1/sferriol/python/net.py

@@ -0,0 +1,24 @@
+# -*- coding: utf-8 -*-
+#
+#  Copyright 2023 sferriol <s.ferriol@ip2i.in2p3.fr>
+"""Network utilities"""
+import socket
+
+
+def is_port_in_use(port: int) -> bool:
+    """Test if the port is already used"""
+    with socket.socket(socket.AF_INET, socket.SOCK_STREAM) as s:
+        return s.connect_ex(('localhost', port)) == 0
+
+
+def unused_port() -> int:
+    """Return an unsued port
+
+    Returns:
+      Port value
+    """
+    sock = socket.socket()
+    sock.bind(('127.0.0.1', 0))
+    _, port = sock.getsockname()
+    sock.close()
+    return port

sferriol-python-0.4.1/sferriol/python/object.py

@@ -0,0 +1,55 @@
+# -*- coding: utf-8 -*-
+import types
+
+
+class Attribute:
+    def __init__(self, ns):
+        self.__sf__ns__ = ns
+
+    def __call__(self, fct):
+        setattr(self, fct.__name__, fct)
+
+    def __setattr__(self, name, value):
+        if hasattr(self, '__sf__ns__'):
+            ns = self.__sf__ns__
+            ns.__sf__obj_attributes__[name] = value
+            setattr(ns, name, value)
+        else:
+            object.__setattr__(self, name, value)
+
+
+def attribute(ns):
+    return Attribute(ns)
+
+
+class Object:
+    def __init__(self):
+        self.__sf__namespaces = dict()
+
+    def __set_ns__(self, ns):
+        for name, value in ns.__sf__obj_attributes__.items():
+            if callable(value):
+                value = types.MethodType(value, self)
+            setattr(self, name, value)
+        self.__sf__namespaces[ns.__sf__name__] = ns
+
+
+class Namespace:
+    def __init__(self, name):
+        self.__sf__name__ = name
+        self.__sf__obj_attributes__ = dict()
+
+    def __call__(self, obj=None):
+        if obj is None:
+            obj = Object()
+        obj.__set_ns__(self)
+        return obj
+
+
+def namespace():
+    def wrapper(fct):
+        ns = Namespace(fct.__name__)
+        fct(ns)
+        return ns
+
+    return wrapper

sferriol-python-0.4.1/sferriol/python/os.py

@@ -0,0 +1,11 @@
+# -*- coding: utf-8 -*-
+#
+#  Copyright 2023 sferriol <s.ferriol@ip2i.in2p3.fr>
+
+import contextlib
+import os
+
+
+def remove_if_exists(fpath):
+    with contextlib.suppress(FileNotFoundError):
+        os.remove(fpath)

sferriol-python-0.4.1/sferriol_python.egg-info/PKG-INFO

@@ -0,0 +1,26 @@
+Metadata-Version: 2.1
+Name: sferriol-python
+Version: 0.4.1
+Summary: python utilities
+Home-page: https://gitlab.in2p3.fr/sferriol-ip2i/sferriol-python
+Author: Sylvain Ferriol
+Author-email: s.ferriol@ipnl.in2p3.fr
+Classifier: License :: OSI Approved :: The Unlicense (Unlicense)
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Description-Content-Type: text/markdown
+License-File: LICENSE
+
+# sferriol-python
+
+sferriol-python is a set of useful python libraries.
+
+Clone the project
+
+	git clone  git@gitlab.in2p3.fr:sferriol-ip2i/sferriol-python.git
+	
+Install it in your environment
+
+	python -m pip install .
+
+

sferriol-python-0.4.1/sferriol_python.egg-info/SOURCES.txt

@@ -0,0 +1,15 @@
+LICENSE
+README.md
+pyproject.toml
+setup.cfg
+setup.py
+sferriol/python/__init__.py
+sferriol/python/json.py
+sferriol/python/net.py
+sferriol/python/object.py
+sferriol/python/os.py
+sferriol/python/dictionary/__init__.py
+sferriol_python.egg-info/PKG-INFO
+sferriol_python.egg-info/SOURCES.txt
+sferriol_python.egg-info/dependency_links.txt
+sferriol_python.egg-info/top_level.txt

sferriol-python-0.4.1/sferriol_python.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

sferriol-python-0.4.1/sferriol_python.egg-info/top_level.txt

@@ -0,0 +1 @@
+sferriol