expml 0.1.0__tar.gz

expml-0.1.0/PKG-INFO

@@ -0,0 +1,46 @@
+Metadata-Version: 2.3
+Name: expml
+Version: 0.1.0
+Summary: Add your description here
+Requires-Python: >=3.13
+Description-Content-Type: text/markdown
+
+# expml
+
+A Python package for quick access and reference to standard Machine Learning experiment codes.
+
+## Features
+
+- **Password Protection**: Authenticate before accessing experiment blocks.
+- **Listing Function**: View available machine learning programs.
+- **Get Snippets**: Retrieve code blocks programmatically as strings using program indices.
+
+## Installation
+
+```bash
+pip install expml
+```
+
+## Usage
+
+### In Python Scripts / Notebooks:
+
+```python
+import expml
+
+# 1. Authenticate (Password: banana)
+expml.login("banana")
+
+# 2. List all available programs
+expml.list()  # or expml.list_progs()
+
+# 3. Retrieve code block by index
+code_text = expml.get(1)
+print(code_text)
+```
+
+### Command Line Interface (CLI):
+
+```bash
+expml
+```

expml-0.1.0/README.md

@@ -0,0 +1,39 @@
+# expml
+
+A Python package for quick access and reference to standard Machine Learning experiment codes.
+
+## Features
+
+- **Password Protection**: Authenticate before accessing experiment blocks.
+- **Listing Function**: View available machine learning programs.
+- **Get Snippets**: Retrieve code blocks programmatically as strings using program indices.
+
+## Installation
+
+```bash
+pip install expml
+```
+
+## Usage
+
+### In Python Scripts / Notebooks:
+
+```python
+import expml
+
+# 1. Authenticate (Password: banana)
+expml.login("banana")
+
+# 2. List all available programs
+expml.list()  # or expml.list_progs()
+
+# 3. Retrieve code block by index
+code_text = expml.get(1)
+print(code_text)
+```
+
+### Command Line Interface (CLI):
+
+```bash
+expml
+```

expml-0.1.0/pyproject.toml

@@ -0,0 +1,14 @@
+[project]
+name = "expml"
+version = "0.1.0"
+description = "Add your description here"
+readme = "README.md"
+requires-python = ">=3.13"
+dependencies = []
+
+[project.scripts]
+expml = "expml:main"
+
+[build-system]
+requires = ["uv_build>=0.13.6,<0.14.0"]
+build-backend = "uv_build"

expml-0.1.0/pyproject.toml.orig

@@ -0,0 +1,14 @@
+[project]
+name = "expml"
+version = "0.1.0"
+description = "Add your description here"
+readme = "README.md"
+requires-python = ">=3.13"
+dependencies = []
+
+[project.scripts]
+expml = "expml:main"
+
+[build-system]
+requires = ["uv_build>=0.13.6,<0.14.0"]
+build-backend = "uv_build"

expml-0.1.0/src/expml/__init__.py

@@ -0,0 +1,28 @@
+"""expml: Machine Learning Experiments Package."""
+
+from .auth import login, is_authenticated
+from .progs import list_progs, get, code, PROGRAMS
+
+# Provide an alias 'list' if imported as 'from expml import list' or expml.list()
+list = list_progs
+
+__all__ = ["login", "is_authenticated", "list_progs", "list", "get", "code", "PROGRAMS"]
+
+
+def main():
+    """CLI entrypoint."""
+    import sys
+    print("Welcome to expml!")
+    if not login():
+        sys.exit(1)
+    
+    list_progs()
+    try:
+        choice = input("Enter program number to view (or 'q' to quit): ").strip()
+        if choice.lower() != 'q' and choice.isdigit():
+            idx = int(choice)
+            print("\n" + "=" * 50)
+            print(get(idx))
+            print("=" * 50)
+    except KeyboardInterrupt:
+        print("\nExiting.")

expml-0.1.0/src/expml/auth.py

@@ -0,0 +1,35 @@
+"""Authentication module for expml."""
+
+_authenticated = False
+_PASSWORD = "banana"
+
+
+def login(password: str | None = None) -> bool:
+    """Authenticate to unlock access to programs.
+    
+    If password is not passed, prompts user securely via getpass.
+    """
+    global _authenticated
+    if password is None:
+        import getpass
+        password = getpass.getpass("Enter password: ")
+
+    if password == _PASSWORD:
+        _authenticated = True
+        print("Login successful.")
+        return True
+    else:
+        _authenticated = False
+        print("Incorrect password.")
+        return False
+
+
+def is_authenticated() -> bool:
+    """Return True if currently authenticated."""
+    return _authenticated
+
+
+def require_auth() -> None:
+    """Raise PermissionError or prompt login if not authenticated."""
+    if not is_authenticated():
+        raise PermissionError("Access denied. Please call login('password') first.")

expml-0.1.0/src/expml/progs.py

@@ -0,0 +1,228 @@
+"""Programs catalogue and retrieval module."""
+
+from .auth import is_authenticated, require_auth
+
+PROGRAMS = {
+    1: {
+        "title": "Linear Regression",
+        "description": "Simple Linear Regression using Scikit-Learn & SciPy linregress",
+        "code": '''import numpy as np
+from sklearn.linear_model import LinearRegression
+from sklearn.metrics import r2_score
+
+# Dataset
+X = np.array([[500], [600], [700], [800], [900],
+              [1000], [1100], [1200], [1300], [1400]])
+
+y = np.array([20, 25, 30, 35, 40, 45, 50, 55, 60, 65])
+
+# Create model
+model = LinearRegression()
+
+# Train model
+model.fit(X, y)
+
+# Predict
+pred = model.predict(X)
+
+# Display results
+print("Predicted prices:", pred)
+print("R2 Score:", r2_score(y, pred))
+
+# Predict price for a new house
+print("Price:", model.predict([[1500]]))
+
+
+# Using linregress
+from scipy.stats import linregress
+
+# Step 1: Create dataset
+x = np.array([500, 600, 700, 800, 900,
+              1000, 1100, 1200, 1300, 1400])
+
+y = np.array([20, 25, 30, 35, 40,
+              45, 50, 55, 60, 65])
+
+# Step 2: Apply Linear Regression
+slope, intercept, r, p, se = linregress(x, y)
+
+# Step 3: Predict values
+pred = slope * x + intercept
+
+# Step 4: Display results
+print("Slope:", slope)
+print("Intercept:", intercept)
+print("Predicted Prices:", pred)
+print("R2 Score:", r**2)
+
+# Step 5: Predict a new house price
+area = 1500
+price = slope * area + intercept
+
+print("Predicted Price:", price)
+'''
+    },
+    2: {
+        "title": "Logistic Regression",
+        "description": "Binary classification using Logistic Regression",
+        "code": '''import numpy as np
+from sklearn.linear_model import LogisticRegression
+from sklearn.metrics import accuracy_score
+
+# Dataset
+X = np.array([[1], [2], [3], [4], [5],
+              [6], [7], [8], [9], [10]])
+
+y = np.array([0, 0, 0, 0, 0, 1, 1, 1, 1, 1])
+
+# Create model
+model = LogisticRegression()
+
+# Train model
+model.fit(X, y)
+
+# Predict
+pred = model.predict(X)
+
+# Display results
+print("Predictions:", pred)
+print("Accuracy:", accuracy_score(y, pred))
+
+# Predict for a new student
+print("Result:", model.predict([[7]]))
+'''
+    },
+    3: {
+        "title": "AdaBoost Classifier",
+        "description": "Boosting classification using AdaBoostClassifier",
+        "code": '''import numpy as np
+from sklearn.ensemble import AdaBoostClassifier
+from sklearn.metrics import accuracy_score
+
+# Dataset: Study hours, Attendance
+X = np.array([
+    [1, 40], [2, 45], [3, 50], [4, 55], [5, 60],
+    [6, 65], [7, 70], [8, 75], [9, 85], [10, 90]
+])
+
+# 0 = Fail, 1 = Pass
+y = np.array([0, 0, 0, 0, 0, 1, 1, 1, 1, 1])
+
+# Create model
+model = AdaBoostClassifier(n_estimators=10, random_state=42)
+
+# Train model
+model.fit(X, y)
+
+# Predict
+pred = model.predict(X)
+
+# Display results
+print("Predictions:", pred)
+print("Accuracy:", accuracy_score(y, pred))
+
+# Predict for new student
+print("Result:", model.predict([[7, 75]]))
+'''
+    },
+    4: {
+        "title": "Multiple Linear Regression (MLR)",
+        "description": "Multi-feature regression using LinearRegression",
+        "code": '''import numpy as np
+from sklearn.linear_model import LinearRegression
+from sklearn.metrics import r2_score
+
+# Dataset: Area, Bedrooms, Age
+X = np.array([
+    [500, 1, 10], [600, 2, 8], [700, 2, 7],
+    [800, 2, 5], [900, 3, 6], [1000, 3, 4],
+    [1100, 3, 3], [1200, 4, 4], [1300, 4, 2],
+    [1400, 4, 1]
+])
+
+# House prices in lakhs
+y = np.array([20, 25, 30, 35, 40, 45, 50, 55, 60, 65])
+
+# Create model
+model = LinearRegression()
+
+# Train model
+model.fit(X, y)
+
+# Predict
+pred = model.predict(X)
+
+# Display results
+print("Predictions:", pred)
+print("R2 Score:", r2_score(y, pred))
+
+# Predict for new house
+print("Price:", model.predict([[1500, 4, 2]]))
+'''
+    },
+    5: {
+        "title": "Support Vector Machine (SVM)",
+        "description": "Classification with standard scaling and SVC",
+        "code": '''import numpy as np
+from sklearn.svm import SVC
+from sklearn.metrics import accuracy_score
+from sklearn.preprocessing import StandardScaler
+
+# Dataset: Study hours, Attendance
+X = np.array([
+    [1, 40], [2, 45], [3, 50], [4, 55], [5, 60],
+    [6, 65], [7, 70], [8, 75], [9, 85], [10, 90]
+])
+
+# 0 = Fail, 1 = Pass
+y = np.array([0, 0, 0, 0, 0, 1, 1, 1, 1, 1])
+
+# Feature scaling
+scaler = StandardScaler()
+X = scaler.fit_transform(X)
+
+# Create model
+model = SVC(kernel='linear')
+
+# Train model
+model.fit(X, y)
+
+# Predict
+pred = model.predict(X)
+
+# Display results
+print("Predictions:", pred)
+print("Accuracy:", accuracy_score(y, pred))
+
+# Predict for new student
+new_student = scaler.transform([[7, 75]])
+print("Result:", model.predict(new_student))
+'''
+    }
+}
+
+
+def list_progs() -> None:
+    """List all available ML programs with index numbers."""
+    require_auth()
+    print("\n--- Available ML Programs ---")
+    for idx, item in PROGRAMS.items():
+        print(f"[{idx}] {item['title']} - {item['description']}")
+    print("-----------------------------\n")
+
+
+def get(index: int) -> str:
+    """Return the code string for the program at the specified index."""
+    require_auth()
+    if index in PROGRAMS:
+        return PROGRAMS[index]["code"]
+    raise IndexError(f"Program index {index} not found. Available indexes: {list(PROGRAMS.keys())}")
+
+
+def code(choice: int) -> None:
+    """Print the program code (for backward compatibility)."""
+    try:
+        content = get(choice)
+        print(content)
+    except Exception as e:
+        print(e)