diff options
Diffstat (limited to 'python-svix-ksuid.spec')
| -rw-r--r-- | python-svix-ksuid.spec | 618 |
1 files changed, 618 insertions, 0 deletions
diff --git a/python-svix-ksuid.spec b/python-svix-ksuid.spec new file mode 100644 index 0000000..3ab690a --- /dev/null +++ b/python-svix-ksuid.spec @@ -0,0 +1,618 @@ +%global _empty_manifest_terminate_build 0 +Name: python-svix-ksuid +Version: 0.6.1 +Release: 1 +Summary: A pure-Python KSUID implementation +License: MIT +URL: https://github.com/svixhq/python-ksuid/ +Source0: https://mirrors.aliyun.com/pypi/web/packages/e7/7b/9f3db39a461ed0444df568d5aa4d45751d578f59eb5f2ea33d84809da53d/svix-ksuid-0.6.1.tar.gz +BuildArch: noarch + + +%description +<h1 align="center"> + <a href="https://www.svix.com"> + <img width="120" src="https://avatars.githubusercontent.com/u/80175132?s=200&v=4" /> + <p align="center">Svix - Webhooks as a service</p> + </a> +</h1> + +# Svix-KSUID (Python) + + + + +[](https://pypi.python.org/pypi/svix-ksuid/) +[](https://www.svix.com/slack/) + +This library is inspired by [Segment's KSUID](https://segment.com/blog/a-brief-history-of-the-uuid/) implementation: +https://github.com/segmentio/ksuid + +For the Rust version, please check out https://github.com/svix/rust-ksuid + +## What is a ksuid? + +A ksuid is a K sorted UID. In other words, a KSUID also stores a date component, so that ksuids can be approximately +sorted based on the time they were created. + +Read more [here](https://segment.com/blog/a-brief-history-of-the-uuid/). + +## Usage + +``` +pip install svix-ksuid +``` + +```python +from ksuid import Ksuid + +ksuid = Ksuid() +``` + +### Higher timestamp accuracy mode + +Ksuids have a 1 second accuracy which is not sufficient for all use-cases. That's why this library exposes a higher accuracy mode which supports accuracy of up to 4ms. + +It's fully compatible with normal ksuids, in fact, it outputs valid ksuids. The difference is that it sacrifices one byte of the random payload in favor of this accuracy. + +The code too is fully compatible: + +``` +pip install svix-ksuid +``` + +```python +from ksuid import KsuidMs + +ksuid = KsuidMs() +``` + +## Examples + +### Default ksuid + +Generate a ksuid without passing a specific datetime + +```python +In [1]: from ksuid import Ksuid + +In [2]: ksuid = Ksuid() + +In [3]: f"Base62: {ksuid}" +Out[3]: 'Base62: 1srOrx2ZWZBpBUvZwXKQmoEYga2' + +In [4]: f"Bytes: {bytes(ksuid)}" +Out[4]: "Bytes: b'\\r5\\xc43\\xe1\\x93>7\\xf2up\\x87c\\xad\\xc7tZ\\xf5\\xe7\\xf2'" + +In [5]: f"Datetime: {ksuid.datetime}" +Out[5]: 'Datetime: 2021-05-21 14:04:03' + +In [6]: f"Timestamp: {ksuid.timestamp}" +Out[6]: 'Timestamp: 1621627443' + +In [7]: f"Payload: {ksuid.payload}" +Out[7]: "Payload: b'\\xe1\\x93>7\\xf2up\\x87c\\xad\\xc7tZ\\xf5\\xe7\\xf2'" +``` + +### ksuid from datetime + +```python +In [1]: datetime = datetime(year=2021, month=5, day=19, hour=1, minute=1, second=1, microsecond=1) + +In [2]: datetime +Out[2]: datetime.datetime(2021, 5, 19, 1, 1, 1, 1) + +In [3]: ksuid = Ksuid(datetime) + +In [4]: ksuid.datetime +Out[4]: datetime.datetime(2021, 5, 19, 1, 1, 1) + +In [5]: ksuid.timestamp +Out[5]: 1621407661 +``` + +### ksuid from base62 + +```python +In [1]: ksuid = Ksuid() + +In [2]: ksuid.timestamp +Out[2]: 1621634852 + +In [3]: f"Base62: {ksuid}" +Out[3]: 'Base62: 1srdszO8Xy2cR6CnARnvxCfRmK4' + +In [4]: ksuid_from_base62 = Ksuid.from_base62("1srdszO8Xy2cR6CnARnvxCfRmK4") + +In [5]: ksuid_from_base62.timestamp +Out[5]: 1621634852 +``` + +### ksuid from bytes + +```python +In [1]: ksuid = Ksuid() + +In [2]: ksuid_from_bytes = ksuid.from_bytes(bytes(ksuid)) + +In [3]: f"ksuid: {ksuid}, ksuid_from_bytes: {ksuid_from_bytes}" +Out[3]: 'ksuid: 1sreAHoz6myPhXghsOdVBoec3Vr, ksuid_from_bytes: 1sreAHoz6myPhXghsOdVBoec3Vr' + +In [4]: ksuid == ksuid_from_bytes +Out[4]: True +``` + +### Compare ksuid(s) + +```python +In [1]: ksuid_1 = Ksuid() + +In [2]: ksuid_2 = Ksuid.from_bytes(bytes(ksuid_1)) + +In [3]: f"ksuid_1: {ksuid_1}, ksuid_2: {ksuid_2}" +Out[3]: 'ksuid_1: 1sreAHoz6myPhXghsOdVBoec3Vr, ksuid_2: 1sreAHoz6myPhXghsOdVBoec3Vr' + +In [4]: ksuid_1 == ksuid_2 +Out[4]: True + +In [5]: ksuid_1 +Out[5]: 1tM9eRSTrHIrrH5SMEW24rtvIOF + +In [6]: ksuid_2 +Out[6]: 1tM9eRSTrHIrrH5SMEW24rtvIOF +``` + + +### Order of ksuid(s) + +```python +In [1]: ksuid_1 = Ksuid() + +In [2]: ksuid_1.timestamp +Out[2]: 1621963256 + +In [3]: ksuid_2 = Ksuid() + +In [4]: ksuid_2.timestamp +Out[4]: 1621963266 + +In [5]: ksuid_1 < ksuid_2 +Out[5]: True + +In [6]: ksuid_1 <= ksuid_2 +Out[6]: True + +In [7]: ksuid_1 >= ksuid_2 +Out[7]: False + +In [8]: ksuid_1 > ksuid_2 +Out[8]: False +``` + +### License + +ksuid source code is available under an MIT [License](./LICENSE). + + +%package -n python3-svix-ksuid +Summary: A pure-Python KSUID implementation +Provides: python-svix-ksuid +BuildRequires: python3-devel +BuildRequires: python3-setuptools +BuildRequires: python3-pip +%description -n python3-svix-ksuid +<h1 align="center"> + <a href="https://www.svix.com"> + <img width="120" src="https://avatars.githubusercontent.com/u/80175132?s=200&v=4" /> + <p align="center">Svix - Webhooks as a service</p> + </a> +</h1> + +# Svix-KSUID (Python) + + + + +[](https://pypi.python.org/pypi/svix-ksuid/) +[](https://www.svix.com/slack/) + +This library is inspired by [Segment's KSUID](https://segment.com/blog/a-brief-history-of-the-uuid/) implementation: +https://github.com/segmentio/ksuid + +For the Rust version, please check out https://github.com/svix/rust-ksuid + +## What is a ksuid? + +A ksuid is a K sorted UID. In other words, a KSUID also stores a date component, so that ksuids can be approximately +sorted based on the time they were created. + +Read more [here](https://segment.com/blog/a-brief-history-of-the-uuid/). + +## Usage + +``` +pip install svix-ksuid +``` + +```python +from ksuid import Ksuid + +ksuid = Ksuid() +``` + +### Higher timestamp accuracy mode + +Ksuids have a 1 second accuracy which is not sufficient for all use-cases. That's why this library exposes a higher accuracy mode which supports accuracy of up to 4ms. + +It's fully compatible with normal ksuids, in fact, it outputs valid ksuids. The difference is that it sacrifices one byte of the random payload in favor of this accuracy. + +The code too is fully compatible: + +``` +pip install svix-ksuid +``` + +```python +from ksuid import KsuidMs + +ksuid = KsuidMs() +``` + +## Examples + +### Default ksuid + +Generate a ksuid without passing a specific datetime + +```python +In [1]: from ksuid import Ksuid + +In [2]: ksuid = Ksuid() + +In [3]: f"Base62: {ksuid}" +Out[3]: 'Base62: 1srOrx2ZWZBpBUvZwXKQmoEYga2' + +In [4]: f"Bytes: {bytes(ksuid)}" +Out[4]: "Bytes: b'\\r5\\xc43\\xe1\\x93>7\\xf2up\\x87c\\xad\\xc7tZ\\xf5\\xe7\\xf2'" + +In [5]: f"Datetime: {ksuid.datetime}" +Out[5]: 'Datetime: 2021-05-21 14:04:03' + +In [6]: f"Timestamp: {ksuid.timestamp}" +Out[6]: 'Timestamp: 1621627443' + +In [7]: f"Payload: {ksuid.payload}" +Out[7]: "Payload: b'\\xe1\\x93>7\\xf2up\\x87c\\xad\\xc7tZ\\xf5\\xe7\\xf2'" +``` + +### ksuid from datetime + +```python +In [1]: datetime = datetime(year=2021, month=5, day=19, hour=1, minute=1, second=1, microsecond=1) + +In [2]: datetime +Out[2]: datetime.datetime(2021, 5, 19, 1, 1, 1, 1) + +In [3]: ksuid = Ksuid(datetime) + +In [4]: ksuid.datetime +Out[4]: datetime.datetime(2021, 5, 19, 1, 1, 1) + +In [5]: ksuid.timestamp +Out[5]: 1621407661 +``` + +### ksuid from base62 + +```python +In [1]: ksuid = Ksuid() + +In [2]: ksuid.timestamp +Out[2]: 1621634852 + +In [3]: f"Base62: {ksuid}" +Out[3]: 'Base62: 1srdszO8Xy2cR6CnARnvxCfRmK4' + +In [4]: ksuid_from_base62 = Ksuid.from_base62("1srdszO8Xy2cR6CnARnvxCfRmK4") + +In [5]: ksuid_from_base62.timestamp +Out[5]: 1621634852 +``` + +### ksuid from bytes + +```python +In [1]: ksuid = Ksuid() + +In [2]: ksuid_from_bytes = ksuid.from_bytes(bytes(ksuid)) + +In [3]: f"ksuid: {ksuid}, ksuid_from_bytes: {ksuid_from_bytes}" +Out[3]: 'ksuid: 1sreAHoz6myPhXghsOdVBoec3Vr, ksuid_from_bytes: 1sreAHoz6myPhXghsOdVBoec3Vr' + +In [4]: ksuid == ksuid_from_bytes +Out[4]: True +``` + +### Compare ksuid(s) + +```python +In [1]: ksuid_1 = Ksuid() + +In [2]: ksuid_2 = Ksuid.from_bytes(bytes(ksuid_1)) + +In [3]: f"ksuid_1: {ksuid_1}, ksuid_2: {ksuid_2}" +Out[3]: 'ksuid_1: 1sreAHoz6myPhXghsOdVBoec3Vr, ksuid_2: 1sreAHoz6myPhXghsOdVBoec3Vr' + +In [4]: ksuid_1 == ksuid_2 +Out[4]: True + +In [5]: ksuid_1 +Out[5]: 1tM9eRSTrHIrrH5SMEW24rtvIOF + +In [6]: ksuid_2 +Out[6]: 1tM9eRSTrHIrrH5SMEW24rtvIOF +``` + + +### Order of ksuid(s) + +```python +In [1]: ksuid_1 = Ksuid() + +In [2]: ksuid_1.timestamp +Out[2]: 1621963256 + +In [3]: ksuid_2 = Ksuid() + +In [4]: ksuid_2.timestamp +Out[4]: 1621963266 + +In [5]: ksuid_1 < ksuid_2 +Out[5]: True + +In [6]: ksuid_1 <= ksuid_2 +Out[6]: True + +In [7]: ksuid_1 >= ksuid_2 +Out[7]: False + +In [8]: ksuid_1 > ksuid_2 +Out[8]: False +``` + +### License + +ksuid source code is available under an MIT [License](./LICENSE). + + +%package help +Summary: Development documents and examples for svix-ksuid +Provides: python3-svix-ksuid-doc +%description help +<h1 align="center"> + <a href="https://www.svix.com"> + <img width="120" src="https://avatars.githubusercontent.com/u/80175132?s=200&v=4" /> + <p align="center">Svix - Webhooks as a service</p> + </a> +</h1> + +# Svix-KSUID (Python) + + + + +[](https://pypi.python.org/pypi/svix-ksuid/) +[](https://www.svix.com/slack/) + +This library is inspired by [Segment's KSUID](https://segment.com/blog/a-brief-history-of-the-uuid/) implementation: +https://github.com/segmentio/ksuid + +For the Rust version, please check out https://github.com/svix/rust-ksuid + +## What is a ksuid? + +A ksuid is a K sorted UID. In other words, a KSUID also stores a date component, so that ksuids can be approximately +sorted based on the time they were created. + +Read more [here](https://segment.com/blog/a-brief-history-of-the-uuid/). + +## Usage + +``` +pip install svix-ksuid +``` + +```python +from ksuid import Ksuid + +ksuid = Ksuid() +``` + +### Higher timestamp accuracy mode + +Ksuids have a 1 second accuracy which is not sufficient for all use-cases. That's why this library exposes a higher accuracy mode which supports accuracy of up to 4ms. + +It's fully compatible with normal ksuids, in fact, it outputs valid ksuids. The difference is that it sacrifices one byte of the random payload in favor of this accuracy. + +The code too is fully compatible: + +``` +pip install svix-ksuid +``` + +```python +from ksuid import KsuidMs + +ksuid = KsuidMs() +``` + +## Examples + +### Default ksuid + +Generate a ksuid without passing a specific datetime + +```python +In [1]: from ksuid import Ksuid + +In [2]: ksuid = Ksuid() + +In [3]: f"Base62: {ksuid}" +Out[3]: 'Base62: 1srOrx2ZWZBpBUvZwXKQmoEYga2' + +In [4]: f"Bytes: {bytes(ksuid)}" +Out[4]: "Bytes: b'\\r5\\xc43\\xe1\\x93>7\\xf2up\\x87c\\xad\\xc7tZ\\xf5\\xe7\\xf2'" + +In [5]: f"Datetime: {ksuid.datetime}" +Out[5]: 'Datetime: 2021-05-21 14:04:03' + +In [6]: f"Timestamp: {ksuid.timestamp}" +Out[6]: 'Timestamp: 1621627443' + +In [7]: f"Payload: {ksuid.payload}" +Out[7]: "Payload: b'\\xe1\\x93>7\\xf2up\\x87c\\xad\\xc7tZ\\xf5\\xe7\\xf2'" +``` + +### ksuid from datetime + +```python +In [1]: datetime = datetime(year=2021, month=5, day=19, hour=1, minute=1, second=1, microsecond=1) + +In [2]: datetime +Out[2]: datetime.datetime(2021, 5, 19, 1, 1, 1, 1) + +In [3]: ksuid = Ksuid(datetime) + +In [4]: ksuid.datetime +Out[4]: datetime.datetime(2021, 5, 19, 1, 1, 1) + +In [5]: ksuid.timestamp +Out[5]: 1621407661 +``` + +### ksuid from base62 + +```python +In [1]: ksuid = Ksuid() + +In [2]: ksuid.timestamp +Out[2]: 1621634852 + +In [3]: f"Base62: {ksuid}" +Out[3]: 'Base62: 1srdszO8Xy2cR6CnARnvxCfRmK4' + +In [4]: ksuid_from_base62 = Ksuid.from_base62("1srdszO8Xy2cR6CnARnvxCfRmK4") + +In [5]: ksuid_from_base62.timestamp +Out[5]: 1621634852 +``` + +### ksuid from bytes + +```python +In [1]: ksuid = Ksuid() + +In [2]: ksuid_from_bytes = ksuid.from_bytes(bytes(ksuid)) + +In [3]: f"ksuid: {ksuid}, ksuid_from_bytes: {ksuid_from_bytes}" +Out[3]: 'ksuid: 1sreAHoz6myPhXghsOdVBoec3Vr, ksuid_from_bytes: 1sreAHoz6myPhXghsOdVBoec3Vr' + +In [4]: ksuid == ksuid_from_bytes +Out[4]: True +``` + +### Compare ksuid(s) + +```python +In [1]: ksuid_1 = Ksuid() + +In [2]: ksuid_2 = Ksuid.from_bytes(bytes(ksuid_1)) + +In [3]: f"ksuid_1: {ksuid_1}, ksuid_2: {ksuid_2}" +Out[3]: 'ksuid_1: 1sreAHoz6myPhXghsOdVBoec3Vr, ksuid_2: 1sreAHoz6myPhXghsOdVBoec3Vr' + +In [4]: ksuid_1 == ksuid_2 +Out[4]: True + +In [5]: ksuid_1 +Out[5]: 1tM9eRSTrHIrrH5SMEW24rtvIOF + +In [6]: ksuid_2 +Out[6]: 1tM9eRSTrHIrrH5SMEW24rtvIOF +``` + + +### Order of ksuid(s) + +```python +In [1]: ksuid_1 = Ksuid() + +In [2]: ksuid_1.timestamp +Out[2]: 1621963256 + +In [3]: ksuid_2 = Ksuid() + +In [4]: ksuid_2.timestamp +Out[4]: 1621963266 + +In [5]: ksuid_1 < ksuid_2 +Out[5]: True + +In [6]: ksuid_1 <= ksuid_2 +Out[6]: True + +In [7]: ksuid_1 >= ksuid_2 +Out[7]: False + +In [8]: ksuid_1 > ksuid_2 +Out[8]: False +``` + +### License + +ksuid source code is available under an MIT [License](./LICENSE). + + +%prep +%autosetup -n svix-ksuid-0.6.1 + +%build +%py3_build + +%install +%py3_install +install -d -m755 %{buildroot}/%{_pkgdocdir} +if [ -d doc ]; then cp -arf doc %{buildroot}/%{_pkgdocdir}; fi +if [ -d docs ]; then cp -arf docs %{buildroot}/%{_pkgdocdir}; fi +if [ -d example ]; then cp -arf example %{buildroot}/%{_pkgdocdir}; fi +if [ -d examples ]; then cp -arf examples %{buildroot}/%{_pkgdocdir}; fi +pushd %{buildroot} +if [ -d usr/lib ]; then + find usr/lib -type f -printf "\"/%h/%f\"\n" >> filelist.lst +fi +if [ -d usr/lib64 ]; then + find usr/lib64 -type f -printf "\"/%h/%f\"\n" >> filelist.lst +fi +if [ -d usr/bin ]; then + find usr/bin -type f -printf "\"/%h/%f\"\n" >> filelist.lst +fi +if [ -d usr/sbin ]; then + find usr/sbin -type f -printf "\"/%h/%f\"\n" >> filelist.lst +fi +touch doclist.lst +if [ -d usr/share/man ]; then + find usr/share/man -type f -printf "\"/%h/%f.gz\"\n" >> doclist.lst +fi +popd +mv %{buildroot}/filelist.lst . +mv %{buildroot}/doclist.lst . + +%files -n python3-svix-ksuid -f filelist.lst +%dir %{python3_sitelib}/* + +%files help -f doclist.lst +%{_docdir}/* + +%changelog +* Fri Jun 09 2023 Python_Bot <Python_Bot@openeuler.org> - 0.6.1-1 +- Package Spec generated |