summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
Diffstat
-rw-r--r--.gitignore1
-rw-r--r--python-muid.spec436
-rw-r--r--sources1
3 files changed, 438 insertions, 0 deletions
diff --git a/.gitignore b/.gitignore
index e69de29..bf72dc5 100644
--- a/.gitignore
+++ b/.gitignore
@@ -0,0 +1 @@
+/muid-0.5.3.tar.gz
diff --git a/python-muid.spec b/python-muid.spec
new file mode 100644
index 0000000..e71ff70
--- /dev/null
+++ b/python-muid.spec
@@ -0,0 +1,436 @@
+%global _empty_manifest_terminate_build 0
+Name: python-muid
+Version: 0.5.3
+Release: 1
+Summary: Memorable Unique Identifier
+License: MIT
+URL: https://github.com/microprediction/muid
+Source0: https://mirrors.nju.edu.cn/pypi/web/packages/a2/83/50e54e4173fc8dde0d3e645f24e99fb57db0a754d7f1dde1443a4b1a5214/muid-0.5.3.tar.gz
+BuildArch: noarch
+
+Requires: python3-contexttimer
+
+%description
+# muid
+Memorable Unique Identifiers
+
+### Wait you say ... that's an oxymoron
+
+Memorable unique identifiers are a provocative misnomer. Yes, memorability is antithetical
+to uniqueness, and MUIDs might be better termed "hash-memorable" identifiers: identifiers whose
+SHA-256 hashes are in part memorable. There is a cheesy video explanation at https://vimeo.com/397352413
+
+# Start mining now
+
+Just want to mine?
+
+ /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/microprediction/muid/master/examples/mine_from_venv.sh)"
+
+If it fails you might need Python 3
+
+ ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
+ brew install python
+
+# Using the library directly
+
+As per https://muid.readthedocs.io/en/latest/ ...
+
+### Install
+
+ pip install muid
+
+### Hash-memorability
+
+ >>> muid.bhash(b'f601f291896bb66b8a3c3d783077713a')
+ b'56a33411a3ae7cfc95597911708358ad'
+
+Don't see it?
+
+ >>> muid.pretty(b'56a33411a3ae7cfc95597911708358ad',k1=6,k2=5)
+ 'Shammy Llama'
+
+### Create one MUID
+
+ >>> muid.create(difficulty=8, with_report=True)
+ [{'length': 8, 'pretty': 'Thof Clam', 'key': b'79f7faf8d1272b94eaac367972a09f7b', 'hash': b'760fc1a3368216b67a044e3d4da1fd85'}]
+
+### String version of hash
+
+Use shash instead of bhash
+
+ >>> muid.shash('f601f291896bb66b8a3c3d783077713a')
+ 56a33411a3ae7cfc95597911708358ad
+
+### Validation
+
+ >>> muid.animal(b'f601f291896bb66b8a3c3d783077713a')
+ 'Shammy Llama'
+
+ >>> muid.validate(b'f601f291896bb66b8a3c3d783077713a')
+ True
+
+### Mining for multiple MUIDs
+
+Runs forever and produces MUIDs of increasing length.
+
+ >>> muid.mine()
+
+ {'hash': b'56a33411a3ae7cfc95597911708358ad',
+ 'key': b'f601f291896bb66b8a3c3d783077713a',
+ 'length': 11,
+ 'pretty': 'Shammy Llama'}
+
+ {'hash': b'6ea176470adcff53855f04181bca1a1b',
+ 'key': b'fb74baf628d43892020d803614f91f29',
+ 'length': 11,
+ 'pretty': 'Healthy Toad'}
+
+ {'hash': b'a3e76457c0de70a153e82067845f1527',
+ 'key': b'769adf0f307181e4ab2bc4c1b991cdc6',
+ 'length': 11,
+ 'pretty': 'Amethyst Cod'}
+
+Bequeath unwanted MUIDs to a worthy statistician.
+
+# Applications
+
+See the video at https://vimeo.com/397352413 for some motivation.
+
+We hope you have an application that can benefit from one less join.
+
+# Implementation decisions
+
+We welcome thoughtful suggestions at https://github.com/microprediction/muid/issues
+
+### Choice of hash
+
+We truncate the output of hashlib.sha256 For example muid.shash('abe5') is equivalent to
+
+ sha256('abe5'.encode('ascii')).hexdigest()[:32]
+
+### Readable hex
+
+ | Hex | Human| Hex | HUman | Hex | Human |
+ |------|------|-----|---------|------|-------|
+ | 1 |l | 5 | s | 9 | g |
+ | 2 |z | 6 | h | 0 | o |
+ | 3 |m | 7 | t | | |
+ | 4 |y | 8 | x | | |
+
+# Miscellaneous
+
+### Collisions
+
+MUID collision requires approximately the same computational capacity as UUID collision, or more.
+
+Thus unlikely to be an issue.
+
+
+
+
+
+
+
+
+
+
+%package -n python3-muid
+Summary: Memorable Unique Identifier
+Provides: python-muid
+BuildRequires: python3-devel
+BuildRequires: python3-setuptools
+BuildRequires: python3-pip
+%description -n python3-muid
+# muid
+Memorable Unique Identifiers
+
+### Wait you say ... that's an oxymoron
+
+Memorable unique identifiers are a provocative misnomer. Yes, memorability is antithetical
+to uniqueness, and MUIDs might be better termed "hash-memorable" identifiers: identifiers whose
+SHA-256 hashes are in part memorable. There is a cheesy video explanation at https://vimeo.com/397352413
+
+# Start mining now
+
+Just want to mine?
+
+ /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/microprediction/muid/master/examples/mine_from_venv.sh)"
+
+If it fails you might need Python 3
+
+ ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
+ brew install python
+
+# Using the library directly
+
+As per https://muid.readthedocs.io/en/latest/ ...
+
+### Install
+
+ pip install muid
+
+### Hash-memorability
+
+ >>> muid.bhash(b'f601f291896bb66b8a3c3d783077713a')
+ b'56a33411a3ae7cfc95597911708358ad'
+
+Don't see it?
+
+ >>> muid.pretty(b'56a33411a3ae7cfc95597911708358ad',k1=6,k2=5)
+ 'Shammy Llama'
+
+### Create one MUID
+
+ >>> muid.create(difficulty=8, with_report=True)
+ [{'length': 8, 'pretty': 'Thof Clam', 'key': b'79f7faf8d1272b94eaac367972a09f7b', 'hash': b'760fc1a3368216b67a044e3d4da1fd85'}]
+
+### String version of hash
+
+Use shash instead of bhash
+
+ >>> muid.shash('f601f291896bb66b8a3c3d783077713a')
+ 56a33411a3ae7cfc95597911708358ad
+
+### Validation
+
+ >>> muid.animal(b'f601f291896bb66b8a3c3d783077713a')
+ 'Shammy Llama'
+
+ >>> muid.validate(b'f601f291896bb66b8a3c3d783077713a')
+ True
+
+### Mining for multiple MUIDs
+
+Runs forever and produces MUIDs of increasing length.
+
+ >>> muid.mine()
+
+ {'hash': b'56a33411a3ae7cfc95597911708358ad',
+ 'key': b'f601f291896bb66b8a3c3d783077713a',
+ 'length': 11,
+ 'pretty': 'Shammy Llama'}
+
+ {'hash': b'6ea176470adcff53855f04181bca1a1b',
+ 'key': b'fb74baf628d43892020d803614f91f29',
+ 'length': 11,
+ 'pretty': 'Healthy Toad'}
+
+ {'hash': b'a3e76457c0de70a153e82067845f1527',
+ 'key': b'769adf0f307181e4ab2bc4c1b991cdc6',
+ 'length': 11,
+ 'pretty': 'Amethyst Cod'}
+
+Bequeath unwanted MUIDs to a worthy statistician.
+
+# Applications
+
+See the video at https://vimeo.com/397352413 for some motivation.
+
+We hope you have an application that can benefit from one less join.
+
+# Implementation decisions
+
+We welcome thoughtful suggestions at https://github.com/microprediction/muid/issues
+
+### Choice of hash
+
+We truncate the output of hashlib.sha256 For example muid.shash('abe5') is equivalent to
+
+ sha256('abe5'.encode('ascii')).hexdigest()[:32]
+
+### Readable hex
+
+ | Hex | Human| Hex | HUman | Hex | Human |
+ |------|------|-----|---------|------|-------|
+ | 1 |l | 5 | s | 9 | g |
+ | 2 |z | 6 | h | 0 | o |
+ | 3 |m | 7 | t | | |
+ | 4 |y | 8 | x | | |
+
+# Miscellaneous
+
+### Collisions
+
+MUID collision requires approximately the same computational capacity as UUID collision, or more.
+
+Thus unlikely to be an issue.
+
+
+
+
+
+
+
+
+
+
+%package help
+Summary: Development documents and examples for muid
+Provides: python3-muid-doc
+%description help
+# muid
+Memorable Unique Identifiers
+
+### Wait you say ... that's an oxymoron
+
+Memorable unique identifiers are a provocative misnomer. Yes, memorability is antithetical
+to uniqueness, and MUIDs might be better termed "hash-memorable" identifiers: identifiers whose
+SHA-256 hashes are in part memorable. There is a cheesy video explanation at https://vimeo.com/397352413
+
+# Start mining now
+
+Just want to mine?
+
+ /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/microprediction/muid/master/examples/mine_from_venv.sh)"
+
+If it fails you might need Python 3
+
+ ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
+ brew install python
+
+# Using the library directly
+
+As per https://muid.readthedocs.io/en/latest/ ...
+
+### Install
+
+ pip install muid
+
+### Hash-memorability
+
+ >>> muid.bhash(b'f601f291896bb66b8a3c3d783077713a')
+ b'56a33411a3ae7cfc95597911708358ad'
+
+Don't see it?
+
+ >>> muid.pretty(b'56a33411a3ae7cfc95597911708358ad',k1=6,k2=5)
+ 'Shammy Llama'
+
+### Create one MUID
+
+ >>> muid.create(difficulty=8, with_report=True)
+ [{'length': 8, 'pretty': 'Thof Clam', 'key': b'79f7faf8d1272b94eaac367972a09f7b', 'hash': b'760fc1a3368216b67a044e3d4da1fd85'}]
+
+### String version of hash
+
+Use shash instead of bhash
+
+ >>> muid.shash('f601f291896bb66b8a3c3d783077713a')
+ 56a33411a3ae7cfc95597911708358ad
+
+### Validation
+
+ >>> muid.animal(b'f601f291896bb66b8a3c3d783077713a')
+ 'Shammy Llama'
+
+ >>> muid.validate(b'f601f291896bb66b8a3c3d783077713a')
+ True
+
+### Mining for multiple MUIDs
+
+Runs forever and produces MUIDs of increasing length.
+
+ >>> muid.mine()
+
+ {'hash': b'56a33411a3ae7cfc95597911708358ad',
+ 'key': b'f601f291896bb66b8a3c3d783077713a',
+ 'length': 11,
+ 'pretty': 'Shammy Llama'}
+
+ {'hash': b'6ea176470adcff53855f04181bca1a1b',
+ 'key': b'fb74baf628d43892020d803614f91f29',
+ 'length': 11,
+ 'pretty': 'Healthy Toad'}
+
+ {'hash': b'a3e76457c0de70a153e82067845f1527',
+ 'key': b'769adf0f307181e4ab2bc4c1b991cdc6',
+ 'length': 11,
+ 'pretty': 'Amethyst Cod'}
+
+Bequeath unwanted MUIDs to a worthy statistician.
+
+# Applications
+
+See the video at https://vimeo.com/397352413 for some motivation.
+
+We hope you have an application that can benefit from one less join.
+
+# Implementation decisions
+
+We welcome thoughtful suggestions at https://github.com/microprediction/muid/issues
+
+### Choice of hash
+
+We truncate the output of hashlib.sha256 For example muid.shash('abe5') is equivalent to
+
+ sha256('abe5'.encode('ascii')).hexdigest()[:32]
+
+### Readable hex
+
+ | Hex | Human| Hex | HUman | Hex | Human |
+ |------|------|-----|---------|------|-------|
+ | 1 |l | 5 | s | 9 | g |
+ | 2 |z | 6 | h | 0 | o |
+ | 3 |m | 7 | t | | |
+ | 4 |y | 8 | x | | |
+
+# Miscellaneous
+
+### Collisions
+
+MUID collision requires approximately the same computational capacity as UUID collision, or more.
+
+Thus unlikely to be an issue.
+
+
+
+
+
+
+
+
+
+
+%prep
+%autosetup -n muid-0.5.3
+
+%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-muid -f filelist.lst
+%dir %{python3_sitelib}/*
+
+%files help -f doclist.lst
+%{_docdir}/*
+
+%changelog
+* Fri May 05 2023 Python_Bot <Python_Bot@openeuler.org> - 0.5.3-1
+- Package Spec generated
diff --git a/sources b/sources
new file mode 100644
index 0000000..b6eb3de
--- /dev/null
+++ b/sources
@@ -0,0 +1 @@
+79e01d7638355a5d6cf55699c9a50d1a muid-0.5.3.tar.gz
generated by cgit v1.2.3 (git 2.25.1) at 2025-05-16 21:17:00 +0000