python-qis 1.1.0__tar.gz → 1.2.1__tar.gz

python_qis-1.2.1/PKG-INFO

@@ -0,0 +1,95 @@
+Metadata-Version: 2.3
+Name: python-qis
+Version: 1.2.1
+Summary: QIS Library for Python. (QIS is Quantum Information Science)
+Author: Vedansh Shetti
+Author-email: Vedansh Shetti <vedansh.shetti@gmail.com>
+Requires-Python: >=3.13
+Description-Content-Type: text/markdown
+
+# python-qis
+
+Small Python utilities for mathematics, quantum information science, cryptography,
+and introductory physics.
+
+## Requirements
+
+- Python 3.13 or newer
+
+## Installation
+
+Install the latest release from PyPI with pip:
+
+```bash
+python -m pip install python-qis
+```
+
+Or add it to a project managed with uv:
+
+```bash
+uv add python-qis
+```
+
+## Quick start
+
+### Cryptography
+
+Hash functions accept bytes and return hexadecimal strings:
+
+```python
+from python_qis.cryptography_tools import blake2, sha3
+
+message = b"hello, QIS world"
+
+print(blake2("b", message))
+print(sha3("256", message))
+```
+
+### Math and quantum states
+
+```python
+from python_qis import general_math, qis_math
+
+print(general_math.add(2, 3, 5))
+print(general_math.pi(12))
+
+state = qis_math.buildVector(1 / 2**0.5, 1 / 2**0.5)
+print(qis_math.is_normalized([value[0] for value in state]))
+```
+
+### Physics constants and standard states
+
+```python
+from python_qis import physics_constants
+from python_qis.physics_tools import BELL_PHI_PLUS, KET_0, KET_1, KET_PLUS
+
+print(physics_constants["SPEED_OF_LIGHT"])
+print(KET_0, KET_1, KET_PLUS, BELL_PHI_PLUS)
+```
+
+## What's included?
+
+- **Math utilities:** arithmetic helpers, factorials, and decimal digits of pi.
+- **Quantum information utilities:** vector construction and normalization checks.
+- **Cryptography utilities:** BLAKE2 and SHA-3 hashing through Python's standard library.
+- **Physics utilities:** selected SI constants and common qubit states.
+
+## Development
+
+Clone the repository and install it in an editable environment:
+
+```bash
+git clone https://github.com/VedanshShetti/python-qis.git
+cd python-qis
+uv sync
+```
+
+Build the package with:
+
+```bash
+uv build
+```
+
+## License
+
+This project is licensed under the terms in [LICENSE](LICENSE).

python_qis-1.2.1/README.md

@@ -0,0 +1,86 @@
+# python-qis
+
+Small Python utilities for mathematics, quantum information science, cryptography,
+and introductory physics.
+
+## Requirements
+
+- Python 3.13 or newer
+
+## Installation
+
+Install the latest release from PyPI with pip:
+
+```bash
+python -m pip install python-qis
+```
+
+Or add it to a project managed with uv:
+
+```bash
+uv add python-qis
+```
+
+## Quick start
+
+### Cryptography
+
+Hash functions accept bytes and return hexadecimal strings:
+
+```python
+from python_qis.cryptography_tools import blake2, sha3
+
+message = b"hello, QIS world"
+
+print(blake2("b", message))
+print(sha3("256", message))
+```
+
+### Math and quantum states
+
+```python
+from python_qis import general_math, qis_math
+
+print(general_math.add(2, 3, 5))
+print(general_math.pi(12))
+
+state = qis_math.buildVector(1 / 2**0.5, 1 / 2**0.5)
+print(qis_math.is_normalized([value[0] for value in state]))
+```
+
+### Physics constants and standard states
+
+```python
+from python_qis import physics_constants
+from python_qis.physics_tools import BELL_PHI_PLUS, KET_0, KET_1, KET_PLUS
+
+print(physics_constants["SPEED_OF_LIGHT"])
+print(KET_0, KET_1, KET_PLUS, BELL_PHI_PLUS)
+```
+
+## What's included?
+
+- **Math utilities:** arithmetic helpers, factorials, and decimal digits of pi.
+- **Quantum information utilities:** vector construction and normalization checks.
+- **Cryptography utilities:** BLAKE2 and SHA-3 hashing through Python's standard library.
+- **Physics utilities:** selected SI constants and common qubit states.
+
+## Development
+
+Clone the repository and install it in an editable environment:
+
+```bash
+git clone https://github.com/VedanshShetti/python-qis.git
+cd python-qis
+uv sync
+```
+
+Build the package with:
+
+```bash
+uv build
+```
+
+## License
+
+This project is licensed under the terms in [LICENSE](LICENSE).

{python_qis-1.1.0 → python_qis-1.2.1}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "python-qis"
-version = "1.1.0"
+version = "1.2.1"
 description = "QIS Library for Python. (QIS is Quantum Information Science)"
 readme = "README.md"
 requires-python = ">=3.13"

{python_qis-1.1.0 → python_qis-1.2.1}/pyproject.toml.orig

@@ -1,6 +1,6 @@
 [project]
 name = "python-qis"
-version = "1.1.0"
+version = "1.2.1"
 description = "QIS Library for Python. (QIS is Quantum Information Science)"
 readme = "README.md"
 authors = [

{python_qis-1.1.0 → python_qis-1.2.1}/src/python_qis/__init__.py

@@ -1,8 +1,8 @@
-import python_qis.math_tools as math_tools
+import python_qis.math.general as general_math
+import python_qis.math.qis as qis_math
 import python_qis.cryptography_tools as cryptography_tools
 import python_qis.physics_tools as physics_tools
 
-maths = math_tools
 physics_constants: dict[str, complex | float] = {
     "H_JOULE_SEC": physics_tools.H_JOULE_SEC,
     "HBAR_JOULE_SEC": physics_tools.HBAR_JOULE_SEC,
@@ -11,4 +11,4 @@ physics_constants: dict[str, complex | float] = {
     "ELEMENTARY_CHARGE": physics_tools.ELEMENTARY_CHARGE
 }
 
-__all__ = ["maths", "cryptography_tools", "physics_constants"] # Export Everything Here
+__all__ = ["qis_math", "general_math", "cryptography_tools", "physics_constants"] # Export Everything Here

python_qis-1.1.0/src/python_qis/math_tools.py → python_qis-1.2.1/src/python_qis/math/general.py

@@ -24,11 +24,3 @@ def factorial(n: int) -> int:
     else: return 1
 def pi(digits: int) -> Decimal: return Decimal(pi_string[0 : len(pi_string) if digits >= len(pi_string) else digits])
 
-def is_normalized(vector: list[complex])-> bool:
-    absList: list[complex] = []
-    for i in vector:
-        absList.append(abs(0 - i))
-    total = 0
-    for i in absList:
-        total+= exponentiation(i, 2)
-    return True if abs(total - 1.0) < 1e-9 else False

python_qis-1.2.1/src/python_qis/math/qis.py

@@ -0,0 +1,16 @@
+from .general import exponentiation
+
+def is_normalized(vector: list[complex])-> bool:
+    absList: list[complex] = []
+    for i in vector:
+        absList.append(abs(0 - i))
+    total = 0
+    for i in absList:
+        total+= exponentiation(i, 2)
+    return True if abs(total - 1.0) < 1e-9 else False
+
+def buildVector(*args: complex)-> list[list[complex]]: 
+    v: list[list[complex]] = []
+    for i in args:
+        v.append([i])
+    return v

{python_qis-1.1.0 → python_qis-1.2.1}/src/python_qis/physics_tools.py

@@ -1,10 +1,5 @@
 import math
-
-def buildVector(*args: complex)-> list[list[complex]]: 
-    v: list[list[complex]] = []
-    for i in args:
-        v.append([i])
-    return v
+from .math.qis import buildVector
 
 # Fundamental Constants (SI Units)
 H_JOULE_SEC = 6.62607015e-34       # Planck constant

python_qis-1.1.0/PKG-INFO

@@ -1,21 +0,0 @@
-Metadata-Version: 2.3
-Name: python-qis
-Version: 1.1.0
-Summary: QIS Library for Python. (QIS is Quantum Information Science)
-Author: Vedansh Shetti
-Author-email: Vedansh Shetti <vedansh.shetti@gmail.com>
-Requires-Python: >=3.13
-Description-Content-Type: text/markdown
-
-# python-qis
-QIS Library for Python. (QIS is Quantum Information Science)
-
-## What do I get?
-- Math Utilities
-- Cryptography Utilities (SHA, SHA_3, BLAKE, MD5 and such)
-- Basic Physics Utilities (I'm working on this, please don't get mad if I mess up something here, we just started 7th grade, Physics is new to me)
-
-## Installation
-`pip install python-qis`
-OR if using `uv`:
-`uv install python-qis`

python_qis-1.1.0/README.md

@@ -1,12 +0,0 @@
-# python-qis
-QIS Library for Python. (QIS is Quantum Information Science)
-
-## What do I get?
-- Math Utilities
-- Cryptography Utilities (SHA, SHA_3, BLAKE, MD5 and such)
-- Basic Physics Utilities (I'm working on this, please don't get mad if I mess up something here, we just started 7th grade, Physics is new to me)
-
-## Installation
-`pip install python-qis`
-OR if using `uv`:
-`uv install python-qis`