python-qis 1.2.0__tar.gz → 1.2.2__tar.gz

python_qis-1.2.2/PKG-INFO

@@ -0,0 +1,95 @@
+Metadata-Version: 2.3
+Name: python-qis
+Version: 1.2.2
+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.2/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.2.0 → python_qis-1.2.2}/pyproject.toml

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

{python_qis-1.2.0 → python_qis-1.2.2}/pyproject.toml.orig

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

{python_qis-1.2.0 → python_qis-1.2.2}/src/python_qis/__init__.py

@@ -2,8 +2,16 @@ 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
+from typing import Literal
 
-physics_constants: dict[str, complex | float] = {
+physics_constants: dict[
+    Literal[
+        "H_JOULE_SEC",
+        "HBAR_JOULE_SEC",
+        "BOLTZMANN_CONSTANT",
+        "SPEED_OF_LIGHT", 
+        "ELEMENTARY_CHARGE"
+    ], complex | float] = {
     "H_JOULE_SEC": physics_tools.H_JOULE_SEC,
     "HBAR_JOULE_SEC": physics_tools.HBAR_JOULE_SEC,
     "BOLTZMANN_CONSTANT": physics_tools.BOLTZMANN_CONSTANT,

python_qis-1.2.0/PKG-INFO

@@ -1,21 +0,0 @@
-Metadata-Version: 2.3
-Name: python-qis
-Version: 1.2.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.2.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`