devlacruz-hashlib 0.1.0__tar.gz

devlacruz_hashlib-0.1.0/Cargo.lock

@@ -0,0 +1,250 @@
+# This file is automatically @generated by Cargo.
+# It is not intended for manual editing.
+version = 4
+
+[[package]]
+name = "autocfg"
+version = "1.4.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "ace50bade8e6234aa140d9a2f552bbee1db4d353f69b8217bc503490fc1a9f26"
+
+[[package]]
+name = "block-buffer"
+version = "0.10.4"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "3078c7629b62d3f0439517fa394996acacc5cbc91c5a20d8c658e77abd503a71"
+dependencies = [
+ "generic-array",
+]
+
+[[package]]
+name = "cfg-if"
+version = "1.0.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "baf1de4339761588bc0619e3cbc0120ee582ebb74b53b4efbf79117bd2da40fd"
+
+[[package]]
+name = "cpufeatures"
+version = "0.2.17"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "59ed5838eebb26a2bb2e58f6d5b5316989ae9d08bab10e0e6d103e656d1b0280"
+dependencies = [
+ "libc",
+]
+
+[[package]]
+name = "crypto-common"
+version = "0.1.6"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "1bfb12502f3fc46cca1bb51ac28df9d618d813cdc3d2f25b9fe775a34af26bb3"
+dependencies = [
+ "generic-array",
+ "typenum",
+]
+
+[[package]]
+name = "devlacruz_hashlib"
+version = "0.1.0"
+dependencies = [
+ "hex",
+ "pyo3",
+ "sha2",
+]
+
+[[package]]
+name = "digest"
+version = "0.10.7"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "9ed9a281f7bc9b7576e61468ba615a66a5c8cfdff42420a70aa82701a3b1e292"
+dependencies = [
+ "block-buffer",
+ "crypto-common",
+]
+
+[[package]]
+name = "generic-array"
+version = "0.14.7"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "85649ca51fd72272d7821adaf274ad91c288277713d9c18820d8499a7ff69e9a"
+dependencies = [
+ "typenum",
+ "version_check",
+]
+
+[[package]]
+name = "heck"
+version = "0.5.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "2304e00983f87ffb38b55b444b5e3b60a884b5d30c0fca7d82fe33449bbe55ea"
+
+[[package]]
+name = "hex"
+version = "0.4.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "7f24254aa9a54b5c858eaee2f5bccdb46aaf0e486a595ed5fd8f86ba55232a70"
+
+[[package]]
+name = "indoc"
+version = "2.0.6"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "f4c7245a08504955605670dbf141fceab975f15ca21570696aebe9d2e71576bd"
+
+[[package]]
+name = "libc"
+version = "0.2.172"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "d750af042f7ef4f724306de029d18836c26c1765a54a6a3f094cbd23a7267ffa"
+
+[[package]]
+name = "memoffset"
+version = "0.9.1"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "488016bfae457b036d996092f6cb448677611ce4449e970ceaf42695203f218a"
+dependencies = [
+ "autocfg",
+]
+
+[[package]]
+name = "once_cell"
+version = "1.21.3"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "42f5e15c9953c5e4ccceeb2e7382a716482c34515315f7b03532b8b4e8393d2d"
+
+[[package]]
+name = "portable-atomic"
+version = "1.11.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "350e9b48cbc6b0e028b0473b114454c6316e57336ee184ceab6e53f72c178b3e"
+
+[[package]]
+name = "proc-macro2"
+version = "1.0.95"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "02b3e5e68a3a1a02aad3ec490a98007cbc13c37cbe84a3cd7b8e406d76e7f778"
+dependencies = [
+ "unicode-ident",
+]
+
+[[package]]
+name = "pyo3"
+version = "0.24.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "e5203598f366b11a02b13aa20cab591229ff0a89fd121a308a5df751d5fc9219"
+dependencies = [
+ "cfg-if",
+ "indoc",
+ "libc",
+ "memoffset",
+ "once_cell",
+ "portable-atomic",
+ "pyo3-build-config",
+ "pyo3-ffi",
+ "pyo3-macros",
+ "unindent",
+]
+
+[[package]]
+name = "pyo3-build-config"
+version = "0.24.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "99636d423fa2ca130fa5acde3059308006d46f98caac629418e53f7ebb1e9999"
+dependencies = [
+ "once_cell",
+ "target-lexicon",
+]
+
+[[package]]
+name = "pyo3-ffi"
+version = "0.24.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "78f9cf92ba9c409279bc3305b5409d90db2d2c22392d443a87df3a1adad59e33"
+dependencies = [
+ "libc",
+ "pyo3-build-config",
+]
+
+[[package]]
+name = "pyo3-macros"
+version = "0.24.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "0b999cb1a6ce21f9a6b147dcf1be9ffedf02e0043aec74dc390f3007047cecd9"
+dependencies = [
+ "proc-macro2",
+ "pyo3-macros-backend",
+ "quote",
+ "syn",
+]
+
+[[package]]
+name = "pyo3-macros-backend"
+version = "0.24.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "822ece1c7e1012745607d5cf0bcb2874769f0f7cb34c4cde03b9358eb9ef911a"
+dependencies = [
+ "heck",
+ "proc-macro2",
+ "pyo3-build-config",
+ "quote",
+ "syn",
+]
+
+[[package]]
+name = "quote"
+version = "1.0.40"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "1885c039570dc00dcb4ff087a89e185fd56bae234ddc7f056a945bf36467248d"
+dependencies = [
+ "proc-macro2",
+]
+
+[[package]]
+name = "sha2"
+version = "0.10.8"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "793db75ad2bcafc3ffa7c68b215fee268f537982cd901d132f89c6343f3a3dc8"
+dependencies = [
+ "cfg-if",
+ "cpufeatures",
+ "digest",
+]
+
+[[package]]
+name = "syn"
+version = "2.0.101"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "8ce2b7fc941b3a24138a0a7cf8e858bfc6a992e7978a068a5c760deb0ed43caf"
+dependencies = [
+ "proc-macro2",
+ "quote",
+ "unicode-ident",
+]
+
+[[package]]
+name = "target-lexicon"
+version = "0.13.2"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "e502f78cdbb8ba4718f566c418c52bc729126ffd16baee5baa718cf25dd5a69a"
+
+[[package]]
+name = "typenum"
+version = "1.18.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "1dccffe3ce07af9386bfd29e80c0ab1a8205a2fc34e4bcd40364df902cfa8f3f"
+
+[[package]]
+name = "unicode-ident"
+version = "1.0.18"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "5a5f39404a5da50712a4c1eecf25e90dd62b613502b7e925fd4e4d19b5c96512"
+
+[[package]]
+name = "unindent"
+version = "0.2.4"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "7264e107f553ccae879d21fbea1d6724ac785e8c3bfc762137959b5802826ef3"
+
+[[package]]
+name = "version_check"
+version = "0.9.5"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "0b928f33d975fc6ad9f86c8f283853ad26bdd5b10b7f1542aa2fa15e2289105a"

devlacruz_hashlib-0.1.0/Cargo.toml

@@ -0,0 +1,16 @@
+[package]
+name = "devlacruz_hashlib"
+version = "0.1.0"
+edition = "2021"
+description = "Extensión de hashing acelerado con Rust y PyO3"
+license = "MIT"
+repository = "https://github.com/DevLaCruz/devlacruz_hashlib"
+
+[lib]
+name = "devlacruz_hashlib"
+crate-type = ["cdylib"]
+
+[dependencies]
+pyo3 = { version = "0.24.2", features = ["extension-module"] }
+sha2 = "0.10"
+hex = "0.4"

devlacruz_hashlib-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) [year] [fullname]
+
+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.

devlacruz_hashlib-0.1.0/PKG-INFO

@@ -0,0 +1,156 @@
+Metadata-Version: 2.4
+Name: devlacruz_hashlib
+Version: 0.1.0
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.7
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Rust
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Topic :: Security :: Cryptography
+License-File: LICENSE
+Summary: Extensión de hashing SHA-256 acelerado con Rust y PyO3
+Author-email: Alejandro De La Cruz <devlacruz@axtosys.com>
+License: MIT
+Requires-Python: >=3.7, <4.0
+Description-Content-Type: text/markdown; charset=UTF-8; variant=GFM
+Project-URL: Source Code, https://github.com/DevLaCruz/devlacruz_hashlib
+
+# devlacruz_hashlib
+
+High-performance library for SHA-256 hash functions implemented in Rust with PyO3.
+
+[![PyPI version](https://img.shields.io/pypi/v/devlacruz_hashlib.svg)](https://pypi.org/project/devlacruz_hashlib/)
+[![Python versions](https://img.shields.io/pypi/pyversions/devlacruz_hashlib.svg)](https://pypi.org/project/devlacruz_hashlib/)
+
+## Features
+
+- Ultra-fast computation of SHA-256 hashes
+- GIL release during intensive operations
+- Compatible with Python 3.7+
+- Support for hashing integers, strings, and bytes
+- Performance superior to pure Python implementations
+
+## Installation
+
+```bash
+pip install devlacruz_hashlib
+```text
+
+## Basic Usage
+
+```python
+import devlacruz_hashlib
+
+# Hash of an integer (basic version)
+hash1 = devlacruz_hashlib.hash_id_simple(12345)
+print(f"Simple hash of integer: {hash1}")
+
+# Hash of an integer (GIL-releasing version)
+hash2 = devlacruz_hashlib.hash_id(12345)
+print(f"Hash of integer: {hash2}")
+
+# Hash of a string
+hash3 = devlacruz_hashlib.hash_string("Hello world")
+print(f"Hash of string: {hash3}")
+
+# Hash of bytes
+hash4 = devlacruz_hashlib.hash_bytes(b"binary data")
+print(f"Hash of bytes: {hash4}")
+```text
+
+## Performance
+
+This library provides a SHA-256 hash implementation significantly faster than pure Python solutions. Particularly useful for:
+
+- Processing large volumes of data
+- Computing hashes in intensive loops
+- Applications where performance is critical
+
+### Performance Comparison
+
+```python
+import time
+import hashlib
+import devlacruz_hashlib
+
+# Test data
+data = b"x" * 1000000  # ~1MB of data
+
+# Time with Python's hashlib
+start = time.time()
+for _ in range(100):
+    hashlib.sha256(data).hexdigest()
+py_time = time.time() - start
+print(f"Python hashlib: {py_time:.3f} seconds")
+
+# Time with devlacruz_hashlib
+start = time.time()
+for _ in range(100):
+    devlacruz_hashlib.hash_bytes(data)
+rust_time = time.time() - start
+print(f"devlacruz_hashlib: {rust_time:.3f} seconds")
+
+print(f"Performance improvement: {py_time/rust_time:.1f}x faster")
+```text
+
+## Full API
+
+### `hash_id_simple(x: int) → str`
+
+Calculates the SHA-256 hash of an integer. This version does not release Python's GIL.
+
+### `hash_id(x: int) → str`
+
+Calculates the SHA-256 hash of an integer while releasing the GIL. Recommended for parallel processing.
+
+### `hash_string(s: str) → str`
+
+Calculates the SHA-256 hash of a text string. Releases the GIL during processing.
+
+### `hash_bytes(data: bytes) → str`
+
+Calculates the SHA-256 hash of a bytes object. Releases the GIL during processing.
+
+## Technical Considerations
+
+- The module releases the GIL (Global Interpreter Lock) during intensive hash operations, enabling true parallelism in multi-threaded applications.
+- The Rust implementation provides memory and type safety without performance overhead.
+- Compatible with all major platforms: Linux, Windows, and macOS.
+
+## When to Use devlacruz_hashlib vs Standard hashlib
+
+Use devlacruz_hashlib when:
+- Maximum performance is needed for SHA-256 hash operations
+- Working with large volumes of data
+- Performing hash operations in critical loops
+- Utilizing multi-threaded processing where releasing the GIL is advantageous
+
+Use standard `hashlib` when:
+- Other algorithms besides SHA-256 are needed
+- Simplicity and maintainability are more important than performance
+- Avoiding additional dependencies is preferred
+
+## Contributions
+
+Contributions are welcome. To contribute:
+
+1. Fork the repository
+2. Create a branch for your feature (`git checkout -b new-feature`)
+3. Make your changes and commit (`git commit -am 'Add new feature'`)
+4. Push your changes (`git push origin new-feature`)
+5. Create a Pull Request
+
+## License
+
+MIT License - See the LICENSE file for more details.
+
+## Author
+
+Alejandro De La Cruz (devlacruz@axtosys.com)
+

devlacruz_hashlib-0.1.0/README.md

@@ -0,0 +1,132 @@
+# devlacruz_hashlib
+
+High-performance library for SHA-256 hash functions implemented in Rust with PyO3.
+
+[![PyPI version](https://img.shields.io/pypi/v/devlacruz_hashlib.svg)](https://pypi.org/project/devlacruz_hashlib/)
+[![Python versions](https://img.shields.io/pypi/pyversions/devlacruz_hashlib.svg)](https://pypi.org/project/devlacruz_hashlib/)
+
+## Features
+
+- Ultra-fast computation of SHA-256 hashes
+- GIL release during intensive operations
+- Compatible with Python 3.7+
+- Support for hashing integers, strings, and bytes
+- Performance superior to pure Python implementations
+
+## Installation
+
+```bash
+pip install devlacruz_hashlib
+```text
+
+## Basic Usage
+
+```python
+import devlacruz_hashlib
+
+# Hash of an integer (basic version)
+hash1 = devlacruz_hashlib.hash_id_simple(12345)
+print(f"Simple hash of integer: {hash1}")
+
+# Hash of an integer (GIL-releasing version)
+hash2 = devlacruz_hashlib.hash_id(12345)
+print(f"Hash of integer: {hash2}")
+
+# Hash of a string
+hash3 = devlacruz_hashlib.hash_string("Hello world")
+print(f"Hash of string: {hash3}")
+
+# Hash of bytes
+hash4 = devlacruz_hashlib.hash_bytes(b"binary data")
+print(f"Hash of bytes: {hash4}")
+```text
+
+## Performance
+
+This library provides a SHA-256 hash implementation significantly faster than pure Python solutions. Particularly useful for:
+
+- Processing large volumes of data
+- Computing hashes in intensive loops
+- Applications where performance is critical
+
+### Performance Comparison
+
+```python
+import time
+import hashlib
+import devlacruz_hashlib
+
+# Test data
+data = b"x" * 1000000  # ~1MB of data
+
+# Time with Python's hashlib
+start = time.time()
+for _ in range(100):
+    hashlib.sha256(data).hexdigest()
+py_time = time.time() - start
+print(f"Python hashlib: {py_time:.3f} seconds")
+
+# Time with devlacruz_hashlib
+start = time.time()
+for _ in range(100):
+    devlacruz_hashlib.hash_bytes(data)
+rust_time = time.time() - start
+print(f"devlacruz_hashlib: {rust_time:.3f} seconds")
+
+print(f"Performance improvement: {py_time/rust_time:.1f}x faster")
+```text
+
+## Full API
+
+### `hash_id_simple(x: int) → str`
+
+Calculates the SHA-256 hash of an integer. This version does not release Python's GIL.
+
+### `hash_id(x: int) → str`
+
+Calculates the SHA-256 hash of an integer while releasing the GIL. Recommended for parallel processing.
+
+### `hash_string(s: str) → str`
+
+Calculates the SHA-256 hash of a text string. Releases the GIL during processing.
+
+### `hash_bytes(data: bytes) → str`
+
+Calculates the SHA-256 hash of a bytes object. Releases the GIL during processing.
+
+## Technical Considerations
+
+- The module releases the GIL (Global Interpreter Lock) during intensive hash operations, enabling true parallelism in multi-threaded applications.
+- The Rust implementation provides memory and type safety without performance overhead.
+- Compatible with all major platforms: Linux, Windows, and macOS.
+
+## When to Use devlacruz_hashlib vs Standard hashlib
+
+Use devlacruz_hashlib when:
+- Maximum performance is needed for SHA-256 hash operations
+- Working with large volumes of data
+- Performing hash operations in critical loops
+- Utilizing multi-threaded processing where releasing the GIL is advantageous
+
+Use standard `hashlib` when:
+- Other algorithms besides SHA-256 are needed
+- Simplicity and maintainability are more important than performance
+- Avoiding additional dependencies is preferred
+
+## Contributions
+
+Contributions are welcome. To contribute:
+
+1. Fork the repository
+2. Create a branch for your feature (`git checkout -b new-feature`)
+3. Make your changes and commit (`git commit -am 'Add new feature'`)
+4. Push your changes (`git push origin new-feature`)
+5. Create a Pull Request
+
+## License
+
+MIT License - See the LICENSE file for more details.
+
+## Author
+
+Alejandro De La Cruz (devlacruz@axtosys.com)

devlacruz_hashlib-0.1.0/pyproject.toml

@@ -0,0 +1,30 @@
+[build-system]
+requires = ["maturin>=1.0"]
+build-backend = "maturin"
+
+[project]
+name = "devlacruz_hashlib"
+version = "0.1.0"
+description = "Extensión de hashing SHA-256 acelerado con Rust y PyO3"
+authors = [{ name = "Alejandro De La Cruz", email = "devlacruz@axtosys.com" }]
+license = "MIT"
+requires-python = ">=3.7,<4.0"
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.7",
+    "Programming Language :: Python :: 3.8",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Rust",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "Topic :: Security :: Cryptography",
+]
+readme = "README.md"
+
+[tool.maturin]
+bindings = "pyo3"
+strip = true

devlacruz_hashlib-0.1.0/src/lib.rs

@@ -0,0 +1,56 @@
+use hex;
+use pyo3::prelude::*;
+use sha2::{Digest, Sha256};
+
+/// Hash SHA-256 de un entero sin liberar el GIL
+#[pyfunction]
+fn hash_id_simple(x: u32) -> String {
+    let mut hasher = Sha256::new();
+    hasher.update(x.to_be_bytes());
+    hex::encode(hasher.finalize())
+}
+
+/// Hash SHA-256 de un entero, liberando el GIL durante el cálculo
+#[pyfunction]
+fn hash_id(py: Python<'_>, x: u32) -> PyResult<String> {
+    // convertimos a bytes antes de soltar el GIL
+    let bytes = x.to_be_bytes();
+    py.allow_threads(move || {
+        let mut hasher = Sha256::new();
+        hasher.update(bytes);
+        Ok(hex::encode(hasher.finalize()))
+    })
+}
+
+/// Hash SHA-256 de una cadena UTF-8, liberando el GIL
+#[pyfunction]
+fn hash_string(py: Python<'_>, s: &str) -> PyResult<String> {
+    let data = s.as_bytes().to_vec();
+    py.allow_threads(move || {
+        let mut hasher = Sha256::new();
+        hasher.update(&data);
+        Ok(hex::encode(hasher.finalize()))
+    })
+}
+
+/// Hash SHA-256 de cualquier buffer de bytes (`bytes` de Python), liberando el GIL
+#[pyfunction]
+fn hash_bytes(py: Python<'_>, data: &[u8]) -> PyResult<String> {
+    // data ya es &[u8], podemos soltar el GIL directamente
+    let data_vec = data.to_vec(); // Clone data for thread safety
+    py.allow_threads(move || {
+        let mut hasher = Sha256::new();
+        hasher.update(&data_vec);
+        Ok(hex::encode(hasher.finalize()))
+    })
+}
+
+/// Inicialización del módulo Python
+#[pymodule]
+fn myhashlib(py: Python<'_>, m: &Bound<'_, PyModule>) -> PyResult<()> {
+    m.add_function(wrap_pyfunction!(hash_id_simple, m)?)?;
+    m.add_function(wrap_pyfunction!(hash_id, m)?)?;
+    m.add_function(wrap_pyfunction!(hash_string, m)?)?;
+    m.add_function(wrap_pyfunction!(hash_bytes, m)?)?;
+    Ok(())
+}