data-manipulation-utilities 0.0.6__py3-none-any.whl → 0.0.9__py3-none-any.whl

{data_manipulation_utilities-0.0.6.data → data_manipulation_utilities-0.0.9.data}/scripts/publish

@@ -69,9 +69,20 @@ create_tag()
     git tag -a $VERSION
 }
 # --------------------------
+push_all()
+{
+    for REMOTE in $(git remote);do
+        echo "Pushing tags and commits to remote: $REMOTE"
+        git add pyproject.toml
+        git commit -m "Publication commit"
+
+        git push -u $REMOTE HEAD
+        git push    $REMOTE --tags
+    done
+}
+# --------------------------
 get_opts "$@"
 
 get_version
 create_tag
-git push -u origin HEAD
-git push --tags
+push_all

{data_manipulation_utilities-0.0.6.dist-info → data_manipulation_utilities-0.0.9.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: data_manipulation_utilities
-Version: 0.0.6
+Version: 0.0.9
 Description-Content-Type: text/markdown
 Requires-Dist: zfit
 Requires-Dist: logzero
@@ -18,12 +18,39 @@ Requires-Dist: hist[plot]
 Requires-Dist: polars
 Requires-Dist: pandas
 Provides-Extra: dev
-Requires-Dist: pytest ; extra == 'dev'
+Requires-Dist: pytest; extra == "dev"
 
 # D(ata) M(anipulation) U(tilities)
 
 These are tools that can be used for different data analysis tasks.
 
+For LHCb specific tools (not useful for people outside LHCb) see [this](doc/lhcb.md)
+
+# GIT
+
+## Pushing
+
+From the root directory of a version controlled project (i.e. a directory with the `.git` subdirectory) 
+using a `pyproject.toml` file, run:
+
+```bash
+publish
+```
+
+such that:
+
+1. The `pyproject.toml` file is checked and the version of the project is extracted.
+1. If a tag named as the version exists move to the steps below. 
+1. If it does not, make a new tag with the name as the version
+
+Then, for each remote it pushes the tags and the commits. 
+
+*Why?* 
+
+1. Tags should be named as the project's version
+1. As soon as a new version is created, that version needs to be tagged.
+1. In GitHub, one can configure actions to publish projects when the commits are tagged.
+
 # Generic
 
 This section describes generic tools that could not be put in a specific category, but tend to be useful.

{data_manipulation_utilities-0.0.6.dist-info → data_manipulation_utilities-0.0.9.dist-info}/RECORD

@@ -1,4 +1,4 @@
-data_manipulation_utilities-0.0.6.data/scripts/publish,sha256=9DPzH1NcyuyXo6uHjQitIce192jugsoCCjRY7HR7mCg,1684
+data_manipulation_utilities-0.0.9.data/scripts/publish,sha256=MHDsn93GTeJxpsM3hNbOJ7JEtsugX21WOFQ2PGWairU,1943
 dmu/arrays/utilities.py,sha256=PKoYyybPptA2aU-V3KLnJXBudWxTXu4x1uGdIMQ49HY,1722
 dmu/generic/utilities.py,sha256=0Xnq9t35wuebAqKxbyAiMk1ISB7IcXK4cFH25MT1fgw,1741
 dmu/logging/log_store.py,sha256=v0tiNz-6ktT_afD5DuvCZ8Nmr82JKQOPli8hgd28P1Q,3960
@@ -6,6 +6,7 @@ dmu/ml/cv_classifier.py,sha256=n81m7i2M6Zq96AEd9EZGwXSrbG5m9jkS5RdeXvbsAXU,3712
 dmu/ml/cv_predict.py,sha256=Bqxu-f6qquKJokFljhCzL_kiGcjLJLQFhVBD130fsyw,4893
 dmu/ml/train_mva.py,sha256=d_n-A07DFweikz5nXap4OE_Mqx8VprFT7zbxmnQAbac,9638
 dmu/ml/utilities.py,sha256=Nue7O9zi1QXgjGRPH6wnSAW9jusMQ2ZOSDJzBqJKIi0,3687
+dmu/physics/utilities.py,sha256=SGUNZT9qHvo6hpS12857cJRd4BPEwGDLpWaO5BhUJDk,1579
 dmu/plotting/plotter.py,sha256=laa6Kl7P-ZOIhaOFBVjOH4XQ4kPCV7wBNvLIMBnyCwM,7181
 dmu/plotting/plotter_1d.py,sha256=G-i94uzm2TjNaog1A4agAKar_G0qNdkAqIPCmzhe85Y,3660
 dmu/plotting/plotter_2d.py,sha256=SWPKns-CfpUZHgBXvwm3gceH3k2eL_mKGXQ8sWpZJB0,2919
@@ -20,6 +21,7 @@ dmu/testing/utilities.py,sha256=WbMM4e9Cn3-B-12Vr64mB5qTKkV32joStlRkD-48lG0,3460
 dmu/text/transformer.py,sha256=4lrGknbAWRm0-rxbvgzOO-eR1-9bkYk61boJUEV3cQ0,6100
 dmu_data/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 dmu_data/ml/tests/train_mva.yaml,sha256=TCniCVpXMEFxZcHa8IIqollKA7ci4OkBnRznLEkXM9o,925
+dmu_data/physics/evt_name.yaml,sha256=lf1SIIJIpG2PNVZ_AngMUG_IAYXbPsqUTgejtuGL1Dk,427546
 dmu_data/plotting/tests/2d.yaml,sha256=lTMNheK3DB8klp4O5QjMDwBI1A1Oh2_Wp2F2Ro9VQKM,282
 dmu_data/plotting/tests/fig_size.yaml,sha256=7ROq49nwZ1A2EbPiySmu6n3G-Jq6YAOkc3d2X3YNZv0,294
 dmu_data/plotting/tests/high_stat.yaml,sha256=bLglBLCZK6ft0xMhQ5OltxE76cWsBMPMjO6GG0OkDr8,522
@@ -33,14 +35,15 @@ dmu_data/text/transform.txt,sha256=EX760da6Vkf-_EPxnQlC5hGSkfFhJCCGCD19NU-1Qto,4
 dmu_data/text/transform_set.toml,sha256=Jeh7BTz82idqvbOQJtl9-ur56mZkzDn5WtvmIb48LoE,150
 dmu_data/text/transform_set.txt,sha256=1KivMoP9LxPn9955QrRmOzjEqduEjhTetQ9MXykO5LY,46
 dmu_data/text/transform_trf.txt,sha256=zxBRTgcSmX7RdqfmWF88W1YqbyNHa4Ccruf1MmnYv2A,74
-dmu_scripts/git/publish,sha256=9DPzH1NcyuyXo6uHjQitIce192jugsoCCjRY7HR7mCg,1684
+dmu_scripts/git/publish,sha256=MHDsn93GTeJxpsM3hNbOJ7JEtsugX21WOFQ2PGWairU,1943
 dmu_scripts/physics/check_truth.py,sha256=b1P_Pa9ef6VcFtyY6Y9KS9Om9L-QrCBjDKp4dqca0PQ,3964
+dmu_scripts/physics/update_decinfo.py,sha256=Y5cO3GdUWtVHeXVd37Q04xlFtQBMTLlqCF-medL8SM8,3322
 dmu_scripts/rfile/compare_root_files.py,sha256=T8lDnQxsRNMr37x1Y7YvWD8ySHrJOWZki7ZQynxXX9Q,9540
 dmu_scripts/rfile/print_trees.py,sha256=Ze4Ccl_iUldl4eVEDVnYBoe4amqBT1fSBR1zN5WSztk,941
 dmu_scripts/ssh/coned.py,sha256=lhilYNHWRCGxC-jtyJ3LQ4oUgWW33B2l1tYCcyHHsR0,4858
 dmu_scripts/text/transform_text.py,sha256=9akj1LB0HAyopOvkLjNOJiptZw5XoOQLe17SlcrGMD0,1456
-data_manipulation_utilities-0.0.6.dist-info/METADATA,sha256=t5uc_pnOn1_UBjs2HCrpiNY5Kg4saETW4BsbdVOAvQo,19299
-data_manipulation_utilities-0.0.6.dist-info/WHEEL,sha256=R06PA3UVYHThwHvxuRWMqaGcr-PuniXahwjmQRFMEkY,91
-data_manipulation_utilities-0.0.6.dist-info/entry_points.txt,sha256=1TIZDed651KuOH-DgaN5AoBdirKmrKE_oM1b6b7zTUU,270
-data_manipulation_utilities-0.0.6.dist-info/top_level.txt,sha256=n_x5J6uWtSqy9mRImKtdA2V2NJNyU8Kn3u8DTOKJix0,25
-data_manipulation_utilities-0.0.6.dist-info/RECORD,,
+data_manipulation_utilities-0.0.9.dist-info/METADATA,sha256=raGR5TDWVLfnMm2_Tpv5PgpLmZzKDSaVi3Vlb3l3sCo,20074
+data_manipulation_utilities-0.0.9.dist-info/WHEEL,sha256=PZUExdf71Ui_so67QXpySuHtCi3-J3wvF4ORK6k_S8U,91
+data_manipulation_utilities-0.0.9.dist-info/entry_points.txt,sha256=-nNgwig7t-dba8EXsI5TxmvLaDet9_qQAbpusuq64Xc,327
+data_manipulation_utilities-0.0.9.dist-info/top_level.txt,sha256=n_x5J6uWtSqy9mRImKtdA2V2NJNyU8Kn3u8DTOKJix0,25
+data_manipulation_utilities-0.0.9.dist-info/RECORD,,

{data_manipulation_utilities-0.0.6.dist-info → data_manipulation_utilities-0.0.9.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: setuptools (75.5.0)
+Generator: setuptools (75.6.0)
 Root-Is-Purelib: true
 Tag: py3-none-any
 

{data_manipulation_utilities-0.0.6.dist-info → data_manipulation_utilities-0.0.9.dist-info}/entry_points.txt

@@ -4,3 +4,4 @@ compare_root_files = dmu_scripts.rfile.compare_root_files:main
 coned = dmu_scripts.ssh.coned:main
 print_trees = dmu_scripts.rfile.print_trees:main
 transform_text = dmu_scripts.text.transform_text:main
+update_decinfo = dmu_scripts.physics.update_decinfo:main

dmu/physics/utilities.py

@@ -0,0 +1,57 @@
+'''
+Module containing utility functions
+'''
+from importlib.resources import files
+from functools           import cache
+
+import yaml
+
+# ---------------------------------
+@cache
+def _get_evt_name() -> dict[str,str]:
+    file_path = files('dmu_data').joinpath('physics/evt_name.yaml')
+    file_path = str(file_path)
+    with open(file_path, encoding='utf-8') as ifile:
+        d_data = yaml.safe_load(ifile)
+
+    return d_data
+# ---------------------------------
+def _format_nickname(nickname : str, style : str) -> str:
+    if style == 'literal':
+        return nickname
+
+    if style != 'safe_1':
+        raise ValueError(f'Invalid style: {style}')
+
+    nickname = nickname.replace('.',   'p')
+    nickname = nickname.replace('-',   'mn')
+    nickname = nickname.replace('+',   'pl')
+    nickname = nickname.replace('=', '_eq_')
+    nickname = nickname.replace(',',    '_')
+
+    return nickname
+# ---------------------------------
+def read_decay_name(event_type : str, style : str = 'safe_1') -> str:
+    '''
+    Takes event type, and style strings, returns nickname of decay as defined in DecFiles package
+
+    Styles:
+
+    literal         : No change is made to nickname
+    safe_1 (default): With following replacements:
+        . -> p
+        = -> _eq_
+        - -> mn
+        + -> pl
+        , -> _
+    '''
+    d_evt_name = _get_evt_name()
+
+    if event_type not in d_evt_name:
+        raise ValueError(f'Event type {event_type} not found')
+
+    value = d_evt_name[event_type]
+    value = _format_nickname(value, style)
+
+    return value
+# ---------------------------------