| Name | almost-unique-id JSON |
| Version |
0.0.3
JSON |
| download |
| home_page | |
| Summary | Almost Unique IDs |
| upload_time | 2023-07-11 20:17:39 |
| maintainer | |
| docs_url | None |
| author | Avi Schwarzschild |
| requires_python | >=3.7 |
| license | MIT |
| keywords |
run
ids
|
| VCS |
|
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
# almost-unique-id
Get almost unique ID names. This package randomly selects an `adjective-Name` pair from 24,567,933 unique pairs.
These IDs serve much the same pupose as generating a random hex string, that is to get random names for things that are (extrememly) unlikely to overlap. This project was developed alongside several scientific research projects where many trial of an experiment needed to be named distictly. We find that Enlglish languane keys are easier to discuss and remember than some number of digits/letters that might be unpronounceable.
Feel free to use this for any such application. If you have a use for this that you think is worth mentioning in the README, feel free to open a PR and add it so the description.
## Installation
This package is installable with pip:
```
$ pip install almost-unique-id
```
Or, you can install it from source by git cloning it and installing with pip as follows.
```
$ git clone https://github.com/aks2203/almost-unique-id.git
$ cd almost-unique-id
$ pip install -e .
```
## Example
```
from almost_unique_id import generate_id
run_id = generate_id()
```
### Sources:
The names and adjectives are copied from other sources. An effort was made to find a list without explicit content.
The names are copied from this [file](https://www.usna.edu/Users/cs/roche/courses/s15si335/proj1/files.php%3Ff=names.txt.html).
The adjectives are copied from thi [file](https://gist.github.com/hugsy/8910dc78d208e40de42deb29e62df913).
## Development and Contribution
*We believe in open-source community driven software development. Please open issues and pull requests with any questions or improvements you have.*
Raw data
{
"_id": null,
"home_page": "",
"name": "almost-unique-id",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.7",
"maintainer_email": "",
"keywords": "run ids",
"author": "Avi Schwarzschild",
"author_email": "",
"download_url": "https://files.pythonhosted.org/packages/fb/96/9a56def041bbd05f8aaf426c2da58ded7c53bf4e2b529d51ac797c00fbd2/almost_unique_id-0.0.3.tar.gz",
"platform": null,
"description": "# almost-unique-id\nGet almost unique ID names. This package randomly selects an `adjective-Name` pair from 24,567,933 unique pairs. \n\nThese IDs serve much the same pupose as generating a random hex string, that is to get random names for things that are (extrememly) unlikely to overlap. This project was developed alongside several scientific research projects where many trial of an experiment needed to be named distictly. We find that Enlglish languane keys are easier to discuss and remember than some number of digits/letters that might be unpronounceable. \n\nFeel free to use this for any such application. If you have a use for this that you think is worth mentioning in the README, feel free to open a PR and add it so the description.\n\n## Installation\n\nThis package is installable with pip:\n\n```\n$ pip install almost-unique-id\n```\n\nOr, you can install it from source by git cloning it and installing with pip as follows.\n\n```\n$ git clone https://github.com/aks2203/almost-unique-id.git\n$ cd almost-unique-id\n$ pip install -e .\n```\n\n## Example\n\n```\nfrom almost_unique_id import generate_id\n\nrun_id = generate_id()\n```\n\n### Sources:\n\nThe names and adjectives are copied from other sources. An effort was made to find a list without explicit content.\n\nThe names are copied from this [file](https://www.usna.edu/Users/cs/roche/courses/s15si335/proj1/files.php%3Ff=names.txt.html). \n\nThe adjectives are copied from thi [file](https://gist.github.com/hugsy/8910dc78d208e40de42deb29e62df913).\n\n## Development and Contribution\n\n*We believe in open-source community driven software development. Please open issues and pull requests with any questions or improvements you have.*\n\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Almost Unique IDs",
"version": "0.0.3",
"project_urls": null,
"split_keywords": [
"run",
"ids"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "05736d3575c2cd878fa97641dc2d1d5bed0a08a1a741c1469d882b127cfba5ed",
"md5": "fa1e401d0e1333c9317f7c5c16b704fa",
"sha256": "d4b2231da1dd265722ff7ef57475c3b5c0f3d1cea501b2b091da4a5c9f78dd72"
},
"downloads": -1,
"filename": "almost_unique_id-0.0.3-py3-none-any.whl",
"has_sig": false,
"md5_digest": "fa1e401d0e1333c9317f7c5c16b704fa",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.7",
"size": 74380,
"upload_time": "2023-07-11T20:17:38",
"upload_time_iso_8601": "2023-07-11T20:17:38.087303Z",
"url": "https://files.pythonhosted.org/packages/05/73/6d3575c2cd878fa97641dc2d1d5bed0a08a1a741c1469d882b127cfba5ed/almost_unique_id-0.0.3-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "fb969a56def041bbd05f8aaf426c2da58ded7c53bf4e2b529d51ac797c00fbd2",
"md5": "1a15f3abcd6842e3693c5cc94d4a6a1e",
"sha256": "6a23fa12eb88ad3da80efb97d190df021ea1bed0346931f84730ce94a8087394"
},
"downloads": -1,
"filename": "almost_unique_id-0.0.3.tar.gz",
"has_sig": false,
"md5_digest": "1a15f3abcd6842e3693c5cc94d4a6a1e",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.7",
"size": 73714,
"upload_time": "2023-07-11T20:17:39",
"upload_time_iso_8601": "2023-07-11T20:17:39.759464Z",
"url": "https://files.pythonhosted.org/packages/fb/96/9a56def041bbd05f8aaf426c2da58ded7c53bf4e2b529d51ac797c00fbd2/almost_unique_id-0.0.3.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-07-11 20:17:39",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "almost-unique-id"
}
