tinyshift 0.0.1__tar.gz

tinyshift-0.0.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Lucas Leão
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+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 OR COPYRIGHT HOLDERS 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.

tinyshift-0.0.1/PKG-INFO

@@ -0,0 +1,120 @@
+Metadata-Version: 2.1
+Name: tinyshift
+Version: 0.0.1
+Summary: A small toolbox for mlops
+Author: Lucas Leão
+Author-email: Lucas Leão <heylucasleao@gmail.com>
+License: MIT License
+Project-URL: Homepage, https://github.com/HeyLucasLeao/tinyshift
+Project-URL: Issues, https://github.com/HeyLucasLeao/tinyshift/issues
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.1
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: pandas
+Requires-Dist: scipy
+Requires-Dist: plotly
+Requires-Dist: scikit-learn
+Requires-Dist: numpy
+
+# TinyShift
+
+**TinyShift** is a small experimental Python library designed to detect **data drifts** and **performance drops** in machine learning models over time. The main goal of the project is to provide quick and tiny monitoring tools to help identify when data or model performance unexpectedly change.
+For more robust solutions, I highly recommend [Nannyml.](https://github.com/NannyML/nannyml)
+
+## Technologies Used
+
+- **Python 3.x**
+- **Scikit-learn**
+- **Pandas**
+- **NumPy**
+- **Plotly**
+- **Scipy**
+
+## Installation
+
+To install **TinyShift** in your development environment, use **pip**:
+
+
+```bash
+pip install tinyshift
+```
+If you prefer to clone the repository and install manually:
+```bash
+git clone https://github.com/HeyLucasLeao/tinyshift.git
+cd tinyshift    
+pip install .
+```
+
+## Usage
+Below are basic examples of how to use TinyShift's features.
+### 1. Data Drift Detection
+To detect data drift, simply score in a new dataset to compare with the reference data. The DataDriftDetector will calculate metrics to identify significant differences.
+
+```python
+from tinyshift.detector import CategoricalDriftDetector
+
+df = pd.DataFrame("examples.csv")
+df_reference = df[(df["datetime"] < '2024-07-01')].copy()
+df_analysis = df[(df["datetime"] >= '2024-07-01')].copy()
+
+detector = CategoricalDriftDetector(df_reference, 'discrete_1', "datetime", "W", drift_limit='mad')
+
+analysis_score = detector.score(df_analysis, "discrete_1", "datetime")
+
+print(analysis_score)
+```
+
+### 2. Performance Tracker
+To track model performance over time, use the PerformanceMonitor, which will compare model accuracy on both old and new data.
+```python
+from tinyshift.tracker import PerformanceTracker
+
+df_reference = pd.read_csv('refence.csv')
+df_analysis = pd.read_csv('analysis.csv')
+model = load_model('model.pkl') 
+df_analysis['prediction'] = model.predict(df_analysis["feature_0"])
+
+tracker = PerformanceTracker(df_reference, 'target', 'prediction', 'datetime', "W")
+
+analysis_score = tracker.score(df_analysis, 'target', 'prediction', 'datetime')
+
+print(analysis_score)
+```
+
+### 3. Visualization
+TinyShift also provides graphs to visualize the magnitude of drift and performance changes over time.
+```python
+tracker.plot.scatterplot_over_time(analysis_score, fig_type="png")
+
+tracker.plot.diverging_bar_over_time(analysis_score, fig_type="png")
+```
+
+## Project Structure
+The basic structure of the project is as follows:
+```
+tinyshift
+├── LICENSE
+├── README.md
+├── example.ipynb
+├── pyproject.toml
+└── tinyshift
+    ├── base
+    │   ├── __init__.py
+    │   └── model.py
+    ├── detector
+    │   ├── __init__.py
+    │   ├── categorical.py
+    │   └── continuous.py
+    ├── plot
+    │   ├── __init__.py
+    │   └── plot.py
+    └── tracker
+        ├── __init__.py
+        └── performance.py          
+```
+
+### License
+This project is licensed under the MIT License - see the LICENSE file for more details.

tinyshift-0.0.1/README.md

@@ -0,0 +1,99 @@
+# TinyShift
+
+**TinyShift** is a small experimental Python library designed to detect **data drifts** and **performance drops** in machine learning models over time. The main goal of the project is to provide quick and tiny monitoring tools to help identify when data or model performance unexpectedly change.
+For more robust solutions, I highly recommend [Nannyml.](https://github.com/NannyML/nannyml)
+
+## Technologies Used
+
+- **Python 3.x**
+- **Scikit-learn**
+- **Pandas**
+- **NumPy**
+- **Plotly**
+- **Scipy**
+
+## Installation
+
+To install **TinyShift** in your development environment, use **pip**:
+
+
+```bash
+pip install tinyshift
+```
+If you prefer to clone the repository and install manually:
+```bash
+git clone https://github.com/HeyLucasLeao/tinyshift.git
+cd tinyshift    
+pip install .
+```
+
+## Usage
+Below are basic examples of how to use TinyShift's features.
+### 1. Data Drift Detection
+To detect data drift, simply score in a new dataset to compare with the reference data. The DataDriftDetector will calculate metrics to identify significant differences.
+
+```python
+from tinyshift.detector import CategoricalDriftDetector
+
+df = pd.DataFrame("examples.csv")
+df_reference = df[(df["datetime"] < '2024-07-01')].copy()
+df_analysis = df[(df["datetime"] >= '2024-07-01')].copy()
+
+detector = CategoricalDriftDetector(df_reference, 'discrete_1', "datetime", "W", drift_limit='mad')
+
+analysis_score = detector.score(df_analysis, "discrete_1", "datetime")
+
+print(analysis_score)
+```
+
+### 2. Performance Tracker
+To track model performance over time, use the PerformanceMonitor, which will compare model accuracy on both old and new data.
+```python
+from tinyshift.tracker import PerformanceTracker
+
+df_reference = pd.read_csv('refence.csv')
+df_analysis = pd.read_csv('analysis.csv')
+model = load_model('model.pkl') 
+df_analysis['prediction'] = model.predict(df_analysis["feature_0"])
+
+tracker = PerformanceTracker(df_reference, 'target', 'prediction', 'datetime', "W")
+
+analysis_score = tracker.score(df_analysis, 'target', 'prediction', 'datetime')
+
+print(analysis_score)
+```
+
+### 3. Visualization
+TinyShift also provides graphs to visualize the magnitude of drift and performance changes over time.
+```python
+tracker.plot.scatterplot_over_time(analysis_score, fig_type="png")
+
+tracker.plot.diverging_bar_over_time(analysis_score, fig_type="png")
+```
+
+## Project Structure
+The basic structure of the project is as follows:
+```
+tinyshift
+├── LICENSE
+├── README.md
+├── example.ipynb
+├── pyproject.toml
+└── tinyshift
+    ├── base
+    │   ├── __init__.py
+    │   └── model.py
+    ├── detector
+    │   ├── __init__.py
+    │   ├── categorical.py
+    │   └── continuous.py
+    ├── plot
+    │   ├── __init__.py
+    │   └── plot.py
+    └── tracker
+        ├── __init__.py
+        └── performance.py          
+```
+
+### License
+This project is licensed under the MIT License - see the LICENSE file for more details.

tinyshift-0.0.1/pyproject.toml

@@ -0,0 +1,24 @@
+[tool.poetry.dependencies]
+python = "^3.1"
+pandas = "^1.3.0"
+scikit-learn = "^0.24.2"
+plotly = "^5.3.0"
+scipy = "^1.7.0"
+[project]
+name = "tinyshift"
+version = "0.0.1"
+authors = [
+  { name="Lucas Leão", email="heylucasleao@gmail.com" },
+]
+description = "A small toolbox for mlops"
+readme = "README.md"
+requires-python = ">=3.1"
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+]
+
+[project.urls]
+Homepage = "https://github.com/HeyLucasLeao/tinyshift"
+Issues = "https://github.com/HeyLucasLeao/tinyshift/issues"

tinyshift-0.0.1/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

tinyshift-0.0.1/setup.py

@@ -0,0 +1,17 @@
+from setuptools import setup
+
+with open("README.md", "r") as arq:
+    readme = arq.read()
+
+setup(
+    name="tinyshift",
+    version="0.0.1",
+    license="MIT License",
+    author="Lucas Leão",
+    long_description=readme,
+    long_description_content_type="text/markdown",
+    author_email="heylucasleao@gmail.com",
+    description="A small toolbox for mlops",
+    packages=["tinyshift"],
+    install_requires=["pandas", "scipy", "plotly", "scikit-learn", "numpy"],
+)

tinyshift-0.0.1/tinyshift.egg-info/PKG-INFO

@@ -0,0 +1,120 @@
+Metadata-Version: 2.1
+Name: tinyshift
+Version: 0.0.1
+Summary: A small toolbox for mlops
+Author: Lucas Leão
+Author-email: Lucas Leão <heylucasleao@gmail.com>
+License: MIT License
+Project-URL: Homepage, https://github.com/HeyLucasLeao/tinyshift
+Project-URL: Issues, https://github.com/HeyLucasLeao/tinyshift/issues
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.1
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: pandas
+Requires-Dist: scipy
+Requires-Dist: plotly
+Requires-Dist: scikit-learn
+Requires-Dist: numpy
+
+# TinyShift
+
+**TinyShift** is a small experimental Python library designed to detect **data drifts** and **performance drops** in machine learning models over time. The main goal of the project is to provide quick and tiny monitoring tools to help identify when data or model performance unexpectedly change.
+For more robust solutions, I highly recommend [Nannyml.](https://github.com/NannyML/nannyml)
+
+## Technologies Used
+
+- **Python 3.x**
+- **Scikit-learn**
+- **Pandas**
+- **NumPy**
+- **Plotly**
+- **Scipy**
+
+## Installation
+
+To install **TinyShift** in your development environment, use **pip**:
+
+
+```bash
+pip install tinyshift
+```
+If you prefer to clone the repository and install manually:
+```bash
+git clone https://github.com/HeyLucasLeao/tinyshift.git
+cd tinyshift    
+pip install .
+```
+
+## Usage
+Below are basic examples of how to use TinyShift's features.
+### 1. Data Drift Detection
+To detect data drift, simply score in a new dataset to compare with the reference data. The DataDriftDetector will calculate metrics to identify significant differences.
+
+```python
+from tinyshift.detector import CategoricalDriftDetector
+
+df = pd.DataFrame("examples.csv")
+df_reference = df[(df["datetime"] < '2024-07-01')].copy()
+df_analysis = df[(df["datetime"] >= '2024-07-01')].copy()
+
+detector = CategoricalDriftDetector(df_reference, 'discrete_1', "datetime", "W", drift_limit='mad')
+
+analysis_score = detector.score(df_analysis, "discrete_1", "datetime")
+
+print(analysis_score)
+```
+
+### 2. Performance Tracker
+To track model performance over time, use the PerformanceMonitor, which will compare model accuracy on both old and new data.
+```python
+from tinyshift.tracker import PerformanceTracker
+
+df_reference = pd.read_csv('refence.csv')
+df_analysis = pd.read_csv('analysis.csv')
+model = load_model('model.pkl') 
+df_analysis['prediction'] = model.predict(df_analysis["feature_0"])
+
+tracker = PerformanceTracker(df_reference, 'target', 'prediction', 'datetime', "W")
+
+analysis_score = tracker.score(df_analysis, 'target', 'prediction', 'datetime')
+
+print(analysis_score)
+```
+
+### 3. Visualization
+TinyShift also provides graphs to visualize the magnitude of drift and performance changes over time.
+```python
+tracker.plot.scatterplot_over_time(analysis_score, fig_type="png")
+
+tracker.plot.diverging_bar_over_time(analysis_score, fig_type="png")
+```
+
+## Project Structure
+The basic structure of the project is as follows:
+```
+tinyshift
+├── LICENSE
+├── README.md
+├── example.ipynb
+├── pyproject.toml
+└── tinyshift
+    ├── base
+    │   ├── __init__.py
+    │   └── model.py
+    ├── detector
+    │   ├── __init__.py
+    │   ├── categorical.py
+    │   └── continuous.py
+    ├── plot
+    │   ├── __init__.py
+    │   └── plot.py
+    └── tracker
+        ├── __init__.py
+        └── performance.py          
+```
+
+### License
+This project is licensed under the MIT License - see the LICENSE file for more details.

tinyshift-0.0.1/tinyshift.egg-info/SOURCES.txt

@@ -0,0 +1,9 @@
+LICENSE
+README.md
+pyproject.toml
+setup.py
+tinyshift.egg-info/PKG-INFO
+tinyshift.egg-info/SOURCES.txt
+tinyshift.egg-info/dependency_links.txt
+tinyshift.egg-info/requires.txt
+tinyshift.egg-info/top_level.txt

tinyshift-0.0.1/tinyshift.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

tinyshift-0.0.1/tinyshift.egg-info/requires.txt

@@ -0,0 +1,5 @@
+pandas
+scipy
+plotly
+scikit-learn
+numpy

tinyshift-0.0.1/tinyshift.egg-info/top_level.txt

@@ -0,0 +1 @@
+tinyshift