Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/aamalev/rsjwt
https://github.com/aamalev/rsjwt
jwt python
Last synced: about 1 month ago
JSON representation
- Host: GitHub
- URL: https://github.com/aamalev/rsjwt
- Owner: aamalev
- License: mit
- Created: 2024-11-10T22:35:06.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2025-01-11T21:31:01.000Z (about 1 month ago)
- Last Synced: 2025-01-11T22:27:57.335Z (about 1 month ago)
- Topics: jwt, python
- Language: Python
- Homepage:
- Size: 32.2 KB
- Stars: 6
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.rst
- License: LICENSE
Awesome Lists containing this project
README
rsjwt
=====
.. image:: https://img.shields.io/badge/License-MIT-blue.svg
:target: https://lbesson.mit-license.org/
.. image:: https://img.shields.io/pypi/v/rsjwt.svg
:target: https://pypi.org/project/rsjwt
.. image:: https://img.shields.io/pypi/pyversions/rsjwt.svg
:target: https://pypi.org/project/rsjwt
:alt: Python versions
.. image:: https://readthedocs.org/projects/rsjwt/badge/?version=latest
:target: https://github.com/aamalev/rsjwt#rsjwt
:alt: Documentation Status
.. image:: https://github.com/aamalev/rsjwt/workflows/Tests/badge.svg
:target: https://github.com/aamalev/rsjwt/actions?query=workflow%3ATests
.. image:: https://img.shields.io/pypi/dm/rsjwt.svg
:target: https://pypistats.org/packages/rsjwt
|
.. image:: https://img.shields.io/badge/Rustc-1.80.0-blue?logo=rust
:target: https://www.rust-lang.org/
.. image:: https://img.shields.io/badge/cargo-clippy-blue?logo=rust
:target: https://doc.rust-lang.org/stable/clippy/
.. image:: https://img.shields.io/badge/PyO3-maturin-blue.svg
:target: https://github.com/PyO3/maturin
.. image:: https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json
:target: https://github.com/astral-sh/ruff
:alt: Linter: ruff
.. image:: https://img.shields.io/badge/code%20style-ruff-000000.svg
:target: https://github.com/astral-sh/ruff
:alt: Code style: ruff
.. image:: https://img.shields.io/badge/types-Mypy-blue.svg
:target: https://github.com/python/mypy
:alt: Code style: Mypy
.. image:: https://img.shields.io/badge/%F0%9F%A5%9A-Hatch-4051b5.svg
:alt: Hatch project
:target: https://github.com/pypa/hatch
Python wrapper for:
| `jsonwebtoken `_,
Features
--------
* Encode and decode JWT
* Support HS256, HS384, HS512
* encode datetime.timedelta to float (now + delta)
* encode datetime.datetime with timezone (example datetime.now(timezone.utc))
Install
-------
.. code-block:: shell
pip install rsjwt
Using
-----
.. code-block:: python
from datetime import timedelta
import rsjwt
v = rsjwt.JWT("my-secret")
data = {
"exp": timedelta(hours=8),
"s": "123",
"a": ["123", 123],
"m": {"a": 1},
}
token = v.encode(data)
assert isinstance(token, str)
td = v.decode(token)
assert td["a"] == data["a"]
assert td["s"] == data["s"]
assert td["m"] == data["m"]
assert isinstance(td["exp"], float)
Bench
-----
.. code-block:: bash
% hatch run bench:py
───────────────────────────────────────────────────────────────────────────────── bench.py3.9 ─────────────────────────────────────────────────────────────────────────────────
Python: 3.9.13 (v3.9.13:6de2ca5339, May 17 2022, 11:37:23)
[Clang 13.0.0 (clang-1300.0.29.30)]
Algorithm: HS256
Iterations: 1000000
| package | secs | n |
| ------------ | ------- | ------ |
| rsjwt | 2.2350 | 1.000 |
| pyjwt | 9.4796 | 4.241 |
| authlib | 12.0257 | 5.381 |
| python-jose | 14.7699 | 6.608 |
| jwcrypto | 61.5658 | 27.546 |
──────────────────────────────────────────────────────────────────────────────── bench.py3.13 ─────────────────────────────────────────────────────────────────────────────────
Python: 3.13.0 (main, Oct 7 2024, 05:02:14) [Clang 16.0.0 (clang-1600.0.26.4)]
Algorithm: HS256
Iterations: 1000000
| package | secs | n |
| ------------ | ------- | ------ |
| rsjwt | 2.1902 | 1.000 |
| pyjwt | 6.2054 | 2.833 |
| authlib | 7.2337 | 3.303 |
| jwcrypto | 41.4919 | 18.944 |
Development
-----------
.. code-block:: bash
cargo fmt
cargo clippy
maturin develop
or use hatch envs:
.. code-block:: bash
hatch run fmt
hatch run check
hatch run build
hatch run test