smilo 0.1.0__py3-none-any.whl

smilo/__init__.py

@@ -0,0 +1,7 @@
+from .clean import *
+from .split import *
+from .stats import *
+from .utils import *
+from .viz import *
+
+__version__ = "0.1.0"

smilo/clean.py

@@ -0,0 +1,31 @@
+"""
+Smilo Data Cleaning Module
+Author: Fahad
+"""
+
+def remove_nulls(data):
+    """
+    Remove None values from a list.
+    """
+    return [item for item in data if item is not None]
+
+
+def fill_nulls(data, value=0):
+    """
+    Replace None values with a specified value.
+    """
+    return [value if item is None else item for item in data]
+
+
+def remove_duplicates(data):
+    """
+    Remove duplicate values while preserving order.
+    """
+    return list(dict.fromkeys(data))
+
+
+def remove_empty_strings(data):
+    """
+    Remove empty strings from a list.
+    """
+    return [item for item in data if item != ""]

smilo/split.py

@@ -0,0 +1,47 @@
+"""
+Smilo Data Splitting Module
+Author: Fahad
+"""
+
+import random
+
+
+def train_test_split(data, test_size=0.2, seed=None):
+    """
+    Split a list of data into train and test sets.
+
+    Parameters:
+        data (list): The dataset to split.
+        test_size (float): Proportion of data to use as test set (0-1).
+        seed (int): Optional random seed for reproducibility.
+
+    Returns:
+        tuple: (train_data, test_data)
+    """
+    if seed is not None:
+        random.seed(seed)
+
+    shuffled = data.copy()
+    random.shuffle(shuffled)
+
+    split_index = int(len(shuffled) * (1 - test_size))
+    train_data = shuffled[:split_index]
+    test_data = shuffled[split_index:]
+
+    return train_data, test_data
+
+
+def k_fold_split(data, k=5):
+    """
+    Split data into k equal-sized folds for cross-validation.
+
+    Parameters:
+        data (list): The dataset to split.
+        k (int): Number of folds.
+
+    Returns:
+        list of lists: k folds of data.
+    """
+    fold_size = len(data) // k
+    folds = [data[i * fold_size:(i + 1) * fold_size] for i in range(k)]
+    return folds

smilo/stats.py

@@ -0,0 +1,75 @@
+"""
+Smilo Statistics Module
+Author: Fahad
+"""
+
+from collections import Counter
+
+
+def mean(data):
+    """Return the average of a list."""
+    if not data:
+        raise ValueError("Data cannot be empty.")
+    return sum(data) / len(data)
+
+
+def median(data):
+    """Return the median of a list."""
+    if not data:
+        raise ValueError("Data cannot be empty.")
+
+    data = sorted(data)
+    n = len(data)
+    mid = n // 2
+
+    if n % 2 == 0:
+        return (data[mid - 1] + data[mid]) / 2
+    return data[mid]
+
+
+def mode(data):
+    """Return the most frequent value."""
+    if not data:
+        raise ValueError("Data cannot be empty.")
+
+    count = Counter(data)
+    return count.most_common(1)[0][0]
+
+
+def minimum(data):
+    """Return the minimum value."""
+    return min(data)
+
+
+def maximum(data):
+    """Return the maximum value."""
+    return max(data)
+
+
+def data_range(data):
+    """Return the range (max - min)."""
+    return max(data) - min(data)
+
+
+def total(data):
+    """Return the sum of all values."""
+    return sum(data)
+
+
+def count(data):
+    """Return the number of values."""
+    return len(data)
+
+
+def variance(data):
+    """Return the population variance."""
+    if not data:
+        raise ValueError("Data cannot be empty.")
+
+    avg = mean(data)
+    return sum((x - avg) ** 2 for x in data) / len(data)
+
+
+def standard_deviation(data):
+    """Return the population standard deviation."""
+    return variance(data) ** 0.5

smilo/utils.py

@@ -0,0 +1,45 @@
+"""
+Smilo Utilities Module
+Author: Fahad
+"""
+
+import pandas as pd
+
+
+def load_csv(filepath):
+    """
+    Load a CSV file into a pandas DataFrame.
+
+    Parameters:
+        filepath (str): Path to the CSV file.
+
+    Returns:
+        pd.DataFrame: Loaded data.
+    """
+    return pd.read_csv(filepath)
+
+
+def dataset_info(df):
+    """
+    Print a quick summary of a DataFrame: shape, columns, missing values.
+
+    Parameters:
+        df (pd.DataFrame): The dataset to inspect.
+    """
+    print(f"Shape: {df.shape}")
+    print(f"Columns: {list(df.columns)}")
+    print("Missing values per column:")
+    print(df.isnull().sum())
+
+
+def column_types(df):
+    """
+    Return a dictionary of column names and their data types.
+
+    Parameters:
+        df (pd.DataFrame): The dataset to inspect.
+
+    Returns:
+        dict: {column_name: dtype}
+    """
+    return df.dtypes.astype(str).to_dict()

smilo/viz.py

@@ -0,0 +1,43 @@
+"""
+Smilo Visualization Module
+Author: Fahad
+"""
+
+import matplotlib.pyplot as plt
+
+
+def quick_hist(data, column, bins=20, title=None):
+    """
+    Plot a quick histogram for a DataFrame column.
+
+    Parameters:
+        data (pd.DataFrame): The dataset.
+        column (str): Column name to plot.
+        bins (int): Number of histogram bins.
+        title (str): Optional plot title.
+    """
+    plt.figure(figsize=(8, 5))
+    plt.hist(data[column].dropna(), bins=bins, color="skyblue", edgecolor="black")
+    plt.title(title or f"Distribution of {column}")
+    plt.xlabel(column)
+    plt.ylabel("Frequency")
+    plt.show()
+
+
+def quick_corr(data, title="Correlation Heatmap"):
+    """
+    Plot a correlation heatmap for numeric columns in a DataFrame.
+
+    Parameters:
+        data (pd.DataFrame): The dataset.
+        title (str): Plot title.
+    """
+    corr = data.corr(numeric_only=True)
+    plt.figure(figsize=(8, 6))
+    plt.imshow(corr, cmap="coolwarm", interpolation="none")
+    plt.colorbar()
+    plt.xticks(range(len(corr.columns)), corr.columns, rotation=90)
+    plt.yticks(range(len(corr.columns)), corr.columns)
+    plt.title(title)
+    plt.tight_layout()
+    plt.show()

smilo-0.1.0.dist-info/METADATA

@@ -0,0 +1,51 @@
+Metadata-Version: 2.4
+Name: smilo
+Version: 0.1.0
+Summary: A beginner-friendly Python data analysis library.
+Author-email: Fahad <dr.fahad1001@gmail.com>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/yourusername/smilo
+Project-URL: Repository, https://github.com/yourusername/smilo
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: numpy>=1.24
+Requires-Dist: pandas>=2.0
+Requires-Dist: matplotlib>=3.7
+Dynamic: license-file
+
+# smilo
+
+A beginner-friendly Python data analysis library for cleaning, splitting, exploring, and visualizing data.
+
+## Installation
+
+pip install smilo
+
+## Usage
+
+from smilo.clean import remove_nulls
+from smilo.split import train_test_split
+from smilo.stats import mean, median, standard_deviation
+from smilo.utils import load_csv, dataset_info
+from smilo.viz import quick_hist
+
+data = [1, None, 2, None, 3]
+clean_data = remove_nulls(data)
+print(clean_data)  # [1, 2, 3]
+
+train, test = train_test_split([1,2,3,4,5,6,7,8,9,10], test_size=0.2, seed=42)
+
+print(mean([1, 2, 3, 4, 5]))  # 3.0
+
+## Modules
+
+- **clean.py** — remove_nulls, fill_nulls, remove_duplicates, remove_empty_strings
+- **split.py** — train_test_split, k_fold_split
+- **stats.py** — mean, median, mode, minimum, maximum, data_range, total, count, variance, standard_deviation
+- **utils.py** — load_csv, dataset_info, column_types
+- **viz.py** — quick_hist, quick_corr
+
+## License
+
+MIT

smilo-0.1.0.dist-info/RECORD

@@ -0,0 +1,11 @@
+smilo/__init__.py,sha256=3eWMZfta_LXGuxpKboNhAgUXLnwwazcAIO4dvdBN368,131
+smilo/clean.py,sha256=J5mwecdpqBPMRY5G86laKz0WW60fFYIq-K1dCyL-2zY,642
+smilo/split.py,sha256=9M7qorQzxtEk8qWcsvO9dfO79v8TYNmHGuynJGz4uZQ,1134
+smilo/stats.py,sha256=eNbyHdsQ-QB-aGPuBYC5J5tzoxkHwwNGLxtjOsoid5M,1517
+smilo/utils.py,sha256=4M7zx382iO_-G4DMTkjnQ9FoEIBCd5kY9js61HTsfrU,928
+smilo/viz.py,sha256=m4oJD1wa08Q0e98rlWGmEyym6On-q_TkC16XMpgyNIg,1225
+smilo-0.1.0.dist-info/licenses/LICENSE,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+smilo-0.1.0.dist-info/METADATA,sha256=K9HtOd3FCgT9cxJ8_02Q627T4pP5miVanpesuec1YAU,1506
+smilo-0.1.0.dist-info/WHEEL,sha256=K260EYznzXsJYBQGqmI8VTxEdiZYNvDZwW9cBh9-_MA,91
+smilo-0.1.0.dist-info/top_level.txt,sha256=cmFzxOu8We3QKVZGpoQ5qjNUsByt4c7oKdl3UhVfYIw,6
+smilo-0.1.0.dist-info/RECORD,,

smilo-0.1.0.dist-info/WHEEL

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

smilo-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+smilo