jupyter-analysis-tools 1.0.0__py3-none-any.whl → 1.1.0__py3-none-any.whl

jupyter_analysis_tools/__init__.py

@@ -1,16 +1,13 @@
 # -*- coding: utf-8 -*-
 # __init__.py
 
-__version__ = "1.0.0"
+__version__ = "1.1.0"
 
 from .binning import reBin
 from .git import checkRepo, isNBstripoutActivated, isNBstripoutInstalled, isRepo
-from .notebook_utils import currentNBpath
 from .readdata import readdata
 from .readdata import readdata as readPDH
 from .utils import setLocaleUTF8
 from .widgets import PathSelector, showBoolStatus
 
 setLocaleUTF8()
-
-# vim: set ts=4 sts=4 sw=4 tw=0:

jupyter_analysis_tools/utils.py

@@ -17,7 +17,7 @@ indent = "    "
 
 
 def setLocaleUTF8():
-    """Fix the Jupyter locale which is not UTF-8 by default on some systems (older Windows?)."""
+    """Fix the Jupyter locale which is not UTF-8 by default on Windows."""
     locOld = locale.getpreferredencoding(False).lower()
 
     def getpreferredencoding(do_setlocale=True):
@@ -42,8 +42,7 @@ def isWindows():
 
 
 def isList(obj):
-    """Return true if the provided object is list-like including a numpy array
-    but not a string.
+    """Return true if the provided object is list-like including a numpy array but not a string.
 
     >>> isList([1, 2, 'a'])
     True
@@ -68,18 +67,41 @@ def shortenWinPath(path):
     return win32api.GetShortPathName(path)
 
 
-def appendToPATH(parentPath, subdirs=None):
+def appendToPATH(parentPath, subdirs=None, verbose=False):
     """Adds the given path with each subdirectory to the PATH environment variable."""
-    if not os.path.isdir(parentPath):
+    parentPath = Path(parentPath)
+    if not parentPath.is_dir():
         return  # nothing to do
     if subdirs is None:
         subdirs = ["."]
+    sep = ";" if isWindows() else ":"
+    PATH = os.environ["PATH"].split(sep)
     for path in subdirs:
-        path = os.path.realpath(os.path.join(parentPath, *path.split("/")))
-        print(indent, path, "\t[{}]".format(os.path.isdir(path)))
-        if path in os.environ["PATH"]:
-            continue
-        os.environ["PATH"] += ";" + path
+        path = parentPath / path
+        if verbose:
+            print(indent, path, "[exists: {}]".format(path.is_dir()))
+        if path not in PATH:
+            PATH.append(str(path))
+    os.environ["PATH"] = sep.join(PATH)
+
+
+def addEnvScriptsToPATH():
+    """Prepends the *Scripts* directory of the current Python environment base directory to systems
+    PATH variable.
+
+    It is intended for Conda (Miniforge) environments on Windows that do not have this in their PATH environment variable, causing them to miss many commands provided from this location.
+    """
+    envPath = [p for p in sys.path if p.endswith("Lib")]
+    if not envPath:
+        return  # probably not a Miniforge environment
+    envPath = envPath[0]
+    envPath = Path(envPath).parent / "Scripts"
+    sep = ";" if isWindows() else ":"
+    environPATH = os.environ["PATH"].split(sep)
+    # print(environPATH)
+    if envPath.exists() and str(envPath) not in environPATH:
+        environPATH = [str(envPath)] + environPATH
+        os.environ["PATH"] = sep.join(environPATH)
 
 
 def checkWinFor7z():
@@ -126,9 +148,11 @@ def pushd(new_dir):
 
 
 def setPackage(globalsdict):
-    """Sets the current directory of the notebook as python package
-    to make relative module imports work.
-    Usage: `setPackage(globals())`"""
+    """Sets the current directory of the notebook as python package to make relative module imports
+    work.
+
+    Usage: `setPackage(globals())`
+    """
     path = Path().resolve()
     searchpath = str(path.parent)
     if searchpath not in sys.path:
@@ -145,7 +169,7 @@ def grouper(iterable, n, fillvalue=None):
 
 
 def fmtErr(val, std, precision=2, width=None):
-    """Formats a given value and its std. deviation to physics notation, e.g. '1.23(4)'."""
+    """Formats a given value and its stdandard deviation to physics notation, e.g. '1.23(4)'."""
     if width is None:
         width = ""
     fmt = "{:" + str(width) + "." + str(precision) + "f}({:.0f})"

{jupyter_analysis_tools-1.0.0.dist-info → jupyter_analysis_tools-1.1.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: jupyter-analysis-tools
-Version: 1.0.0
+Version: 1.1.0
 Summary: Yet another Python library with helpers and utilities for data analysis and processing.
 Author-email: Ingo Breßler <dev@ingobressler.net>
 License: MIT license
@@ -30,7 +30,10 @@ Classifier: Intended Audience :: Science/Research
 Description-Content-Type: text/x-rst
 License-File: LICENSE
 License-File: AUTHORS.rst
-Requires-Dist: notebook
+Requires-Dist: numpy
+Requires-Dist: scipy
+Requires-Dist: pandas
+Requires-Dist: matplotlib
 Requires-Dist: ipywidgets
 Dynamic: license-file
 
@@ -50,8 +53,8 @@ Yet another Python library with helpers and utilities for data analysis and proc
     :target: https://pypi.org/project/jupyter-analysis-tools
     :alt: PyPI Package latest release
 
-.. |commits-since| image:: https://img.shields.io/github/commits-since/BAMresearch/jupyter-analysis-tools/v1.0.0.svg
-    :target: https://github.com/BAMresearch/jupyter-analysis-tools/compare/v1.0.0...main
+.. |commits-since| image:: https://img.shields.io/github/commits-since/BAMresearch/jupyter-analysis-tools/v1.1.0.svg
+    :target: https://github.com/BAMresearch/jupyter-analysis-tools/compare/v1.1.0...main
     :alt: Commits since latest release
 
 .. |license| image:: https://img.shields.io/pypi/l/jupyter-analysis-tools.svg
@@ -124,6 +127,30 @@ Note, to combine the coverage data from all the tox environments run:
 
 # CHANGELOG
 
+## v1.1.0 (2025-07-10)
+
+### Bug fixes
+
+* packaging: add dependencies for project and testing ([`2729a45`](https://github.com/BAMresearch/jupyter-analysis-tools/commit/2729a45958893c9acd07af9463bbf7d657db626b))
+
+### Documentation
+
+* utils: reformat doc strings ([`1cf9b9b`](https://github.com/BAMresearch/jupyter-analysis-tools/commit/1cf9b9b969e075a75a41e19bfb526378b68a0ed7))
+
+### Features
+
+* utils: addEnvScriptsToPATH() ([`a8c22e0`](https://github.com/BAMresearch/jupyter-analysis-tools/commit/a8c22e0d37a5627d5955c1f7f7eebcb0bc99206e))
+
+* notebook_utils: remove method for finding notebook file path currentNBpath() ([`13a5a60`](https://github.com/BAMresearch/jupyter-analysis-tools/commit/13a5a60436c7926c478f2ab3f2c309a86b653218))
+
+### Refactoring
+
+* utils: appendToPATH() using pathlib, verifed test included ([`35f37fc`](https://github.com/BAMresearch/jupyter-analysis-tools/commit/35f37fc19cdcf4b575dc0525400f3c0212bb0faf))
+
+### Testing
+
+* readdata: test data for reading PDH and SSFZ ([`9b919d2`](https://github.com/BAMresearch/jupyter-analysis-tools/commit/9b919d24e1fa5679b49cebf576e471d6e4e9b655))
+
 ## v1.0.0 (2025-07-09)
 
 ### Bug fixes

{jupyter_analysis_tools-1.0.0.dist-info → jupyter_analysis_tools-1.1.0.dist-info}/RECORD

@@ -1,17 +1,16 @@
-jupyter_analysis_tools/__init__.py,sha256=56tfdRxdt1BLkFcipMas0-sbeVXpldPVoggIHrkEJMw,419
+jupyter_analysis_tools/__init__.py,sha256=I4Vdvl5uMDvIcs12ZZlMYaFzLrCrUerH5ZkWzgSKhUs,343
 jupyter_analysis_tools/analysis.py,sha256=AiAvUO648f0PYXqLfal1kDH926neasE5c1RYFu9wtYg,1768
 jupyter_analysis_tools/binning.py,sha256=d6eXRC3IOnnJIF25OfEASyWedT71EX2nF7jAgGJ9suQ,14536
 jupyter_analysis_tools/datalocations.py,sha256=BakfiZOMcBwp-_DAn7l57lGWZmZGNnk0j73V75nLBUA,4322
 jupyter_analysis_tools/distrib.py,sha256=uyh2jXDdXR6dfd36CAoE5_psoFF0bfA6l1wletPD7Xo,16515
 jupyter_analysis_tools/git.py,sha256=mqSk5nnAFrmk1_2KFuKVrDWOkRbGbAQOq2N1DfxhNpg,2216
-jupyter_analysis_tools/notebook_utils.py,sha256=5MwYjUy4Skn9goFOP_qKFPPBN4VkffBishHVSD_fPFo,1263
 jupyter_analysis_tools/plotting.py,sha256=L2gwSjlBVK8OneAfSuna3vCJIg2rSEdvd9TfEbM2Als,1183
 jupyter_analysis_tools/readdata.py,sha256=Z0LCAYKEauItdDF6H0gJYR74EKgR2-XFHo5gKlTz7cw,1348
-jupyter_analysis_tools/utils.py,sha256=KEzQMp4fY8KfL1Cc03Kj85lftoBWYuzEu7HmwNW761M,4402
+jupyter_analysis_tools/utils.py,sha256=cwbviD1YP06rVhtItdORHEbp8fQ7JfhcrYDONRM336Y,5315
 jupyter_analysis_tools/widgets.py,sha256=rA8qPvY9nS1OtykZwXtCTG29K-N_MYFVb5Aj8yK40_s,2996
-jupyter_analysis_tools-1.0.0.dist-info/licenses/AUTHORS.rst,sha256=SUxxgElDBm6WdCbBBFfcr0ZE3SolWL0T0aS5Fym1198,100
-jupyter_analysis_tools-1.0.0.dist-info/licenses/LICENSE,sha256=SrbIwXA1ZLTO6uwZneJMpvdgiC-3fhNl0vwb3ALoY4g,1107
-jupyter_analysis_tools-1.0.0.dist-info/METADATA,sha256=RmJTHcgRAtcwIOgDrII1GgRnHg1zanDEpsIIwWoUoHc,34113
-jupyter_analysis_tools-1.0.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-jupyter_analysis_tools-1.0.0.dist-info/top_level.txt,sha256=ei_0x-BF85FLoJ_h67ySwDFowtqus_gI4_0GR466PEU,23
-jupyter_analysis_tools-1.0.0.dist-info/RECORD,,
+jupyter_analysis_tools-1.1.0.dist-info/licenses/AUTHORS.rst,sha256=SUxxgElDBm6WdCbBBFfcr0ZE3SolWL0T0aS5Fym1198,100
+jupyter_analysis_tools-1.1.0.dist-info/licenses/LICENSE,sha256=SrbIwXA1ZLTO6uwZneJMpvdgiC-3fhNl0vwb3ALoY4g,1107
+jupyter_analysis_tools-1.1.0.dist-info/METADATA,sha256=34HMf-Q8hrdj1SemL1o8-eJEAyhLBz--BX3c2B_6GUM,35291
+jupyter_analysis_tools-1.1.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+jupyter_analysis_tools-1.1.0.dist-info/top_level.txt,sha256=ei_0x-BF85FLoJ_h67ySwDFowtqus_gI4_0GR466PEU,23
+jupyter_analysis_tools-1.1.0.dist-info/RECORD,,

jupyter_analysis_tools/notebook_utils.py

@@ -1,36 +0,0 @@
-# -*- coding: utf-8 -*-
-# notebook_utils.py
-
-import json
-import os
-import urllib
-
-import ipykernel
-
-try:
-    from notebook import notebookapp
-except ImportError:
-    from notebook import app as notebookapp
-
-
-def currentNBpath():
-    """Returns the absolute path of the Notebook or None if it cannot be determined
-    NOTE: works only for *Jupyter Notebook* (not Jupyter Lab)
-    and when the security is token-based or there is also no password.
-    """
-    connection_file = os.path.basename(ipykernel.get_connection_file())
-    kernel_id = connection_file.split("-", 1)[1].split(".")[0]
-
-    for srv in notebookapp.list_running_servers():
-        try:
-            if srv["token"] == "" and not srv["password"]:  # No token and no password, ahem...
-                req = urllib.request.urlopen(srv["url"] + "api/sessions")
-            else:
-                req = urllib.request.urlopen(srv["url"] + "api/sessions?token=" + srv["token"])
-            sessions = json.load(req)
-            for sess in sessions:
-                if sess["kernel"]["id"] == kernel_id:
-                    return os.path.join(srv["notebook_dir"], sess["notebook"]["path"])
-        except OSError:
-            pass  # There may be stale entries in the runtime directory
-    return None