pyroid 0.2.7__tar.gz → 0.2.8__tar.gz

{pyroid-0.2.7 → pyroid-0.2.8}/Cargo.lock

@@ -608,7 +608,7 @@ dependencies = [
 
 [[package]]
 name = "pyroid"
-version = "0.2.7"
+version = "0.2.8"
 dependencies = [
  "criterion",
  "futures",

{pyroid-0.2.7 → pyroid-0.2.8}/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "pyroid"
-version = "0.2.7"
+version = "0.2.8"
 edition = "2021"
 authors = ["Andrew O", "Pyroid Team"]
 description = "High-performance Rust functions for Python"
@@ -24,13 +24,24 @@ ml = []
 
 [dependencies]
 # Core dependencies
-pyo3 = { version = "0.20.0", features = ["extension-module", "auto-initialize", "abi3-py38"] }
+pyo3 = { version = "0.20.0", features = [
+  "extension-module",
+  "auto-initialize",
+  "abi3-py38",
+] }
 rayon = "1.10.0"
 serde_json = "1.0.114"
 num_cpus = "1.16.0"
 
 # Optional dependencies based on features
-tokio = { version = "1.44.1", features = ["rt", "rt-multi-thread", "macros", "io-util", "fs", "time"], optional = true }
+tokio = { version = "1.44.1", features = [
+  "rt",
+  "rt-multi-thread",
+  "macros",
+  "io-util",
+  "fs",
+  "time",
+], optional = true }
 futures = { version = "0.3.31", optional = true }
 regex = { version = "1.10.3", optional = true }
 
@@ -53,3 +64,4 @@ strip = true
 [profile.dev]
 opt-level = 0
 debug = true
+

{pyroid-0.2.7 → pyroid-0.2.8}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pyroid
-Version: 0.2.7
+Version: 0.2.8
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3.8
 Classifier: Programming Language :: Python :: 3.9
@@ -151,13 +151,13 @@ import pyroid
 
 # Basic string operations
 text = "Hello, world!"
-reversed_text = pyroid.string.reverse(text)
-uppercase = pyroid.string.to_uppercase(text)
-lowercase = pyroid.string.to_lowercase(text)
+reversed_text = pyroid.text.reverse(text)
+uppercase = pyroid.text.to_uppercase(text)
+lowercase = pyroid.text.to_lowercase(text)
 
 # Base64 encoding/decoding
-encoded = pyroid.string.base64_encode(text)
-decoded = pyroid.string.base64_decode(encoded)
+encoded = pyroid.text.base64_encode(text)
+decoded = pyroid.text.base64_decode(encoded)
 print(f"Original: {text}")
 print(f"Encoded: {encoded}")
 print(f"Decoded: {decoded}")
@@ -168,24 +168,21 @@ print(f"Decoded: {decoded}")
 ```python
 import pyroid
 
-# Create a dictionary representing a DataFrame
-df = {
-    'A': [1, 2, 3, 4, 5],
-    'B': [10, 20, 30, 40, 50],
-    'C': [100, 200, 300, 400, 500]
-}
-
-# Create a DataFrame object
-dataframe = pyroid.data.dataframe.PyDataFrame(df)
+# Create a DataFrame
+df = pyroid.data.DataFrame({
+    'id': [1, 2, 3, 4, 5],
+    'name': ['Alice', 'Bob', 'Charlie', 'David', 'Eve'],
+    'age': [25, 30, 35, 40, 45]
+})
 
 # Apply a function to each column
-def square(x):
-    return [val * val for val in x]
+result = pyroid.data.apply(df, lambda x: x * 2, axis=0)
+print(f"DataFrame: {df}")
+print(f"Applied function: {result}")
 
-result = dataframe.apply(square)
-print(f"DataFrame shape: {dataframe.shape}")
-print(f"DataFrame columns: {dataframe.columns}")
-print(f"Result: {result.to_dict()}")
+# Group by and aggregate
+grouped = pyroid.data.groupby_aggregate(df, "age", {"name": "count"})
+print(f"Grouped by age: {grouped}")
 ```
 
 ### Collection Operations
@@ -195,21 +192,21 @@ import pyroid
 
 # Filter a list
 numbers = [1, 2, 3, 4, 5, 6, 7, 8, 9, 10]
-even_numbers = pyroid.data.collections.filter(numbers, lambda x: x % 2 == 0)
+even_numbers = pyroid.data.filter(numbers, lambda x: x % 2 == 0)
 print(f"Even numbers: {even_numbers}")
 
 # Map a function over a list
-squared = pyroid.data.collections.map(numbers, lambda x: x * x)
+squared = pyroid.data.map(numbers, lambda x: x * x)
 print(f"Squared numbers: {squared}")
 
 # Reduce a list
-sum_result = pyroid.data.collections.reduce(numbers, lambda x, y: x + y)
+sum_result = pyroid.data.reduce(numbers, lambda x, y: x + y)
 print(f"Sum: {sum_result}")
 
 # Sort a list
 unsorted = [5, 2, 8, 1, 9, 3]
-sorted_list = pyroid.data.collections.sort(unsorted)
-print(f"Sorted: {sorted_list}")
+sorted_list = pyroid.data.sort(unsorted, reverse=True)  # Note: supports reverse parameter
+print(f"Sorted (descending): {sorted_list}")
 ```
 
 ### File I/O Operations
@@ -218,17 +215,16 @@ print(f"Sorted: {sorted_list}")
 import pyroid
 
 # Read a file
-content = pyroid.io.file.read_file("example.txt")
+content = pyroid.io.read_file("example.txt")
 print(f"File content length: {len(content)}")
 
 # Write a file
-pyroid.io.file.write_file("output.txt", b"Hello, world!")
+pyroid.io.write_file("output.txt", "Hello, world!")  # Note: string, not bytes
 
 # Read multiple files
 files = ["file1.txt", "file2.txt", "file3.txt"]
-contents = pyroid.io.file.read_files(files)
-for file, content in contents.items():
-    print(f"{file}: {len(content)} bytes")
+contents = pyroid.io.read_files(files)
+print(f"Read multiple files: {contents}")
 ```
 
 ### Network Operations
@@ -237,14 +233,11 @@ for file, content in contents.items():
 import pyroid
 
 # Make a GET request
-response = pyroid.io.network.get("https://example.com")
-print(f"Status: {response['status']}")
-print(f"Body length: {len(response['body'])}")
-
-# Make a POST request with JSON data
-data = {"name": "John", "age": 30}
-response = pyroid.io.network.post("https://example.com/api", json=data)
-print(f"Status: {response['status']}")
+response = pyroid.io.get("https://example.com")
+print(f"HTTP GET response length: {len(response)}")
+
+# Note: POST requests might not be implemented in the current version
+# If you need to make POST requests, check the documentation for the latest API
 ```
 
 ### Async Operations
@@ -256,22 +249,15 @@ import pyroid
 async def main():
     # Async sleep
     print("Sleeping for 1 second...")
-    await pyroid.io.async_io.sleep(1.0)
+    await pyroid.io.sleep(0.1)
     print("Awake!")
     
     # Async file operations
-    await pyroid.io.async_io.write_file_async("async_test.txt", b"Hello, async world!")
-    content = await pyroid.io.async_io.read_file_async("async_test.txt")
+    content = await pyroid.io.read_file_async("example.txt")
     print(f"File content: {content}")
     
-    # Async HTTP requests
-    response = await pyroid.io.async_io.http_get_async("https://example.com")
-    print(f"Response length: {len(response)}")
-    
-    # Async HTTP POST
-    data = {"name": "John", "age": 30}
-    response = await pyroid.io.async_io.http_post_async("https://example.com/api", json=data)
-    print(f"Response length: {len(response)}")
+    # Note: Other async operations might not be fully implemented
+    # in the current version. Check the documentation for the latest API.
 
 # Run the async main function
 asyncio.run(main())
@@ -317,27 +303,26 @@ data = [
     [1.0, 2.0], [1.5, 1.8], [5.0, 8.0],
     [8.0, 8.0], [1.0, 0.6], [9.0, 11.0]
 ]
-result = pyroid.ml.basic.kmeans(data, k=2)
-print(f"Centroids: {result['centroids']}")
-print(f"Clusters: {result['clusters']}")
+kmeans_result = pyroid.ml.basic.kmeans(data, k=2)
+print(f"K-means centroids: {kmeans_result['centroids']}")
+print(f"K-means clusters: {kmeans_result['clusters']}")
 
 # Linear regression
-x = [1.0, 2.0, 3.0, 4.0, 5.0]
-y = [2.0, 4.0, 5.0, 4.0, 6.0]
-result = pyroid.ml.basic.linear_regression(x, y)
-print(f"Slope: {result['slope']}")
-print(f"Intercept: {result['intercept']}")
-print(f"R-squared: {result['r_squared']}")
+# Note: Linear regression expects X as 2D array and y as 1D array
+X = [[1, 1], [1, 2], [2, 2], [2, 3]]
+y = [6, 8, 9, 11]
+regression_result = pyroid.ml.basic.linear_regression(X, y)
+print(f"Linear regression coefficients: {regression_result['coefficients']}")
+print(f"Linear regression intercept: {regression_result['intercept']}")
+print(f"Linear regression R-squared: {regression_result['r_squared']}")
 
 # Data normalization
-values = [10.0, 20.0, 30.0, 40.0, 50.0]
-normalized = pyroid.ml.basic.normalize(values, method="minmax")
-print(f"Normalized (min-max): {normalized}")
+normalized_data = pyroid.ml.basic.normalize(data, method="min-max")
+print(f"Normalized data (min-max): {normalized_data}")
 
 # Distance matrix
-points = [[1.0, 2.0], [3.0, 4.0], [5.0, 6.0]]
-distances = pyroid.ml.basic.distance_matrix(points, metric="euclidean")
-print(f"Distance matrix: {distances}")
+distance_matrix = pyroid.ml.basic.distance_matrix(data, metric="euclidean")
+print(f"Distance matrix shape: {len(distance_matrix)}x{len(distance_matrix[0])}")
 ```
 
 ## 📊 Performance Considerations

{pyroid-0.2.7 → pyroid-0.2.8}/README.md

@@ -127,13 +127,13 @@ import pyroid
 
 # Basic string operations
 text = "Hello, world!"
-reversed_text = pyroid.string.reverse(text)
-uppercase = pyroid.string.to_uppercase(text)
-lowercase = pyroid.string.to_lowercase(text)
+reversed_text = pyroid.text.reverse(text)
+uppercase = pyroid.text.to_uppercase(text)
+lowercase = pyroid.text.to_lowercase(text)
 
 # Base64 encoding/decoding
-encoded = pyroid.string.base64_encode(text)
-decoded = pyroid.string.base64_decode(encoded)
+encoded = pyroid.text.base64_encode(text)
+decoded = pyroid.text.base64_decode(encoded)
 print(f"Original: {text}")
 print(f"Encoded: {encoded}")
 print(f"Decoded: {decoded}")
@@ -144,24 +144,21 @@ print(f"Decoded: {decoded}")
 ```python
 import pyroid
 
-# Create a dictionary representing a DataFrame
-df = {
-    'A': [1, 2, 3, 4, 5],
-    'B': [10, 20, 30, 40, 50],
-    'C': [100, 200, 300, 400, 500]
-}
-
-# Create a DataFrame object
-dataframe = pyroid.data.dataframe.PyDataFrame(df)
+# Create a DataFrame
+df = pyroid.data.DataFrame({
+    'id': [1, 2, 3, 4, 5],
+    'name': ['Alice', 'Bob', 'Charlie', 'David', 'Eve'],
+    'age': [25, 30, 35, 40, 45]
+})
 
 # Apply a function to each column
-def square(x):
-    return [val * val for val in x]
+result = pyroid.data.apply(df, lambda x: x * 2, axis=0)
+print(f"DataFrame: {df}")
+print(f"Applied function: {result}")
 
-result = dataframe.apply(square)
-print(f"DataFrame shape: {dataframe.shape}")
-print(f"DataFrame columns: {dataframe.columns}")
-print(f"Result: {result.to_dict()}")
+# Group by and aggregate
+grouped = pyroid.data.groupby_aggregate(df, "age", {"name": "count"})
+print(f"Grouped by age: {grouped}")
 ```
 
 ### Collection Operations
@@ -171,21 +168,21 @@ import pyroid
 
 # Filter a list
 numbers = [1, 2, 3, 4, 5, 6, 7, 8, 9, 10]
-even_numbers = pyroid.data.collections.filter(numbers, lambda x: x % 2 == 0)
+even_numbers = pyroid.data.filter(numbers, lambda x: x % 2 == 0)
 print(f"Even numbers: {even_numbers}")
 
 # Map a function over a list
-squared = pyroid.data.collections.map(numbers, lambda x: x * x)
+squared = pyroid.data.map(numbers, lambda x: x * x)
 print(f"Squared numbers: {squared}")
 
 # Reduce a list
-sum_result = pyroid.data.collections.reduce(numbers, lambda x, y: x + y)
+sum_result = pyroid.data.reduce(numbers, lambda x, y: x + y)
 print(f"Sum: {sum_result}")
 
 # Sort a list
 unsorted = [5, 2, 8, 1, 9, 3]
-sorted_list = pyroid.data.collections.sort(unsorted)
-print(f"Sorted: {sorted_list}")
+sorted_list = pyroid.data.sort(unsorted, reverse=True)  # Note: supports reverse parameter
+print(f"Sorted (descending): {sorted_list}")
 ```
 
 ### File I/O Operations
@@ -194,17 +191,16 @@ print(f"Sorted: {sorted_list}")
 import pyroid
 
 # Read a file
-content = pyroid.io.file.read_file("example.txt")
+content = pyroid.io.read_file("example.txt")
 print(f"File content length: {len(content)}")
 
 # Write a file
-pyroid.io.file.write_file("output.txt", b"Hello, world!")
+pyroid.io.write_file("output.txt", "Hello, world!")  # Note: string, not bytes
 
 # Read multiple files
 files = ["file1.txt", "file2.txt", "file3.txt"]
-contents = pyroid.io.file.read_files(files)
-for file, content in contents.items():
-    print(f"{file}: {len(content)} bytes")
+contents = pyroid.io.read_files(files)
+print(f"Read multiple files: {contents}")
 ```
 
 ### Network Operations
@@ -213,14 +209,11 @@ for file, content in contents.items():
 import pyroid
 
 # Make a GET request
-response = pyroid.io.network.get("https://example.com")
-print(f"Status: {response['status']}")
-print(f"Body length: {len(response['body'])}")
-
-# Make a POST request with JSON data
-data = {"name": "John", "age": 30}
-response = pyroid.io.network.post("https://example.com/api", json=data)
-print(f"Status: {response['status']}")
+response = pyroid.io.get("https://example.com")
+print(f"HTTP GET response length: {len(response)}")
+
+# Note: POST requests might not be implemented in the current version
+# If you need to make POST requests, check the documentation for the latest API
 ```
 
 ### Async Operations
@@ -232,22 +225,15 @@ import pyroid
 async def main():
     # Async sleep
     print("Sleeping for 1 second...")
-    await pyroid.io.async_io.sleep(1.0)
+    await pyroid.io.sleep(0.1)
     print("Awake!")
     
     # Async file operations
-    await pyroid.io.async_io.write_file_async("async_test.txt", b"Hello, async world!")
-    content = await pyroid.io.async_io.read_file_async("async_test.txt")
+    content = await pyroid.io.read_file_async("example.txt")
     print(f"File content: {content}")
     
-    # Async HTTP requests
-    response = await pyroid.io.async_io.http_get_async("https://example.com")
-    print(f"Response length: {len(response)}")
-    
-    # Async HTTP POST
-    data = {"name": "John", "age": 30}
-    response = await pyroid.io.async_io.http_post_async("https://example.com/api", json=data)
-    print(f"Response length: {len(response)}")
+    # Note: Other async operations might not be fully implemented
+    # in the current version. Check the documentation for the latest API.
 
 # Run the async main function
 asyncio.run(main())
@@ -293,27 +279,26 @@ data = [
     [1.0, 2.0], [1.5, 1.8], [5.0, 8.0],
     [8.0, 8.0], [1.0, 0.6], [9.0, 11.0]
 ]
-result = pyroid.ml.basic.kmeans(data, k=2)
-print(f"Centroids: {result['centroids']}")
-print(f"Clusters: {result['clusters']}")
+kmeans_result = pyroid.ml.basic.kmeans(data, k=2)
+print(f"K-means centroids: {kmeans_result['centroids']}")
+print(f"K-means clusters: {kmeans_result['clusters']}")
 
 # Linear regression
-x = [1.0, 2.0, 3.0, 4.0, 5.0]
-y = [2.0, 4.0, 5.0, 4.0, 6.0]
-result = pyroid.ml.basic.linear_regression(x, y)
-print(f"Slope: {result['slope']}")
-print(f"Intercept: {result['intercept']}")
-print(f"R-squared: {result['r_squared']}")
+# Note: Linear regression expects X as 2D array and y as 1D array
+X = [[1, 1], [1, 2], [2, 2], [2, 3]]
+y = [6, 8, 9, 11]
+regression_result = pyroid.ml.basic.linear_regression(X, y)
+print(f"Linear regression coefficients: {regression_result['coefficients']}")
+print(f"Linear regression intercept: {regression_result['intercept']}")
+print(f"Linear regression R-squared: {regression_result['r_squared']}")
 
 # Data normalization
-values = [10.0, 20.0, 30.0, 40.0, 50.0]
-normalized = pyroid.ml.basic.normalize(values, method="minmax")
-print(f"Normalized (min-max): {normalized}")
+normalized_data = pyroid.ml.basic.normalize(data, method="min-max")
+print(f"Normalized data (min-max): {normalized_data}")
 
 # Distance matrix
-points = [[1.0, 2.0], [3.0, 4.0], [5.0, 6.0]]
-distances = pyroid.ml.basic.distance_matrix(points, metric="euclidean")
-print(f"Distance matrix: {distances}")
+distance_matrix = pyroid.ml.basic.distance_matrix(data, metric="euclidean")
+print(f"Distance matrix shape: {len(distance_matrix)}x{len(distance_matrix[0])}")
 ```
 
 ## 📊 Performance Considerations

{pyroid-0.2.7 → pyroid-0.2.8}/benchmarks/README.md

@@ -11,6 +11,20 @@ The benchmark suite provides:
 - Comprehensive visualizations for marketing materials
 - Real-world scenario benchmarks that simulate practical use cases
 
+## Performance Benchmarks
+
+Pyroid significantly outperforms pure Python implementations. Here are some benchmark results:
+
+| Operation | Pure Python | NumPy | pyroid | Speedup vs Python | Speedup vs NumPy |
+|-----------|-------------|-------|--------|-------------------|------------------|
+| Sum 10M numbers | Timed out (10s) | 50.15ms | 45.32ms | >220x | 1.11x |
+| Regex replace 1M chars | 250.45ms | N/A | 20.35ms | 12.31x | N/A |
+| Parallel map 1M items | 450.78ms | N/A | 35.67ms | 12.64x | N/A |
+| HTTP fetch 100 URLs | 5000.34ms | N/A | 500.12ms | 10.00x | N/A |
+| Data Processing Pipeline | Timed out (30s) | N/A | 250.34ms | >120x | N/A |
+
+> Note: These are example results. Run the benchmark suite in the `benchmarks` directory to generate actual results for your system.
+
 ## Quick Start
 
 ### Jupyter Notebook
@@ -60,13 +74,32 @@ For a quick demonstration of Pyroid's performance advantages:
 python benchmarks/demo.py
 ```
 
+## Benchmark Dashboard
+
+The benchmark suite includes a comprehensive dashboard with visualizations that showcase Pyroid's performance advantages:
+
+- Performance metrics summary
+- Speedup comparison charts
+- Implementation comparison charts (log and linear scales)
+- Scaling analysis showing how performance scales with dataset size
+- Real-world scenario benchmarks
+
+To run the benchmarks and generate the dashboard:
+
+```bash
+python -m benchmarks.run_benchmarks
+```
+
+The dashboard will be available at `benchmarks/dashboard/dashboard.html`.
+
+![Benchmark Dashboard Preview](dashboard/images/speedup_comparison.png)
+
 ## Directory Structure
 
 ```
 benchmarks/
 ├── benchmark_plan.md     # Detailed implementation plan
 ├── README.md             # This file
-├── README_update.md      # Template for updating the main README
 ├── pyroid_benchmarks.ipynb # Jupyter notebook for interactive benchmarks
 ├── run_benchmarks.py     # Main entry point for command-line benchmarks
 ├── demo.py               # Demo script for showcasing performance
@@ -107,7 +140,9 @@ benchmarks/
    - Task concurrency vs. asyncio.gather
 
 5. **Real-world Scenarios**
-   - Data Processing Pipeline
-   - Web Scraping and Processing
-   - Text Processing Pipeline
-   - Scientific Computing
+   - Data Processing Pipeline: ETL operations on large datasets
+   - Web Scraping: Concurrent URL fetching and text processing
+   - Text Processing: NLP preprocessing tasks
+   - Scientific Computing: Statistical analysis and mathematical transformations
+
+These benchmarks simulate practical use cases that users can relate to, demonstrating how Pyroid can significantly accelerate your Python code in production environments.