snowflake2
Based on falcondai and fenhl's Python snowflake tool, but with documentation and simliarities to Discord.
Installation instructions
Installation is easy. Just read the docs below then run this command:
pip install snowflake2==0.1.1
Docs
make_snowflake
This is a function to generate a snowflake.
This function does not return an integer snowflake - it returns a string.
Paramters are listed below.
Here's an example if you want to look at it after reading the below docs:
make_snowflake(time.time(), 0, 0, 0)
timestamp_ms
This is an epoch time paramter. You can get one by running time.time().
Basically, an oversimplified description of the way a snowflake works is by looking at a "twepoch", then subtracting a normal epoch from it (but there are other factors in it, as detailed in the rest of this documentation). That is why you need a timestamp_ms.
Note that the default twepoch is 1639853814 here, but Twitter's is 1288834974657
Discord has some information on this as well. 
worker_id
This can be used internally to keep track of the worker for each snowflake, inspired by Discord's snowflake system.
process_id
This can be used internally to keep track of the process for each snowflake, inspired by Discord's snowflake system.
Discord's documentation shown in worker_id also applies here.
increment_id
This can be used to keep track of 12-bit increments for every generated ID on the aforementioned process.
snowflakeToTime
Converts a snowflake to a Python datetime.
Takes a snowflake ID argument only and converts it to a datetime.
Example:
snowflakeToTime(make_snowflake(time.time(), 0, 0, 0))
12 Aug 14, 2022
12 Aug 14, 2022
12 Oct 27, 2022
1 Feb 1, 2022
2 Feb 16, 2022
5 Jun 28, 2022
107 Oct 28, 2022
11 Mar 24, 2021
85 Dec 22, 2022
1 Oct 25, 2021
884 Dec 25, 2022
351 Jan 03, 2023
2 Jan 06, 2022
8 Nov 27, 2022
230 Dec 18, 2022
2 Mar 08, 2022
1 Jan 23, 2022
3 Dec 03, 2022
16 Nov 12, 2022
11 Oct 09, 2022
6 Oct 21, 2022
14 Nov 24, 2022
3 Jun 23, 2022
1 Feb 18, 2022
3 Jun 06, 2022
25 Aug 16, 2022
1 Nov 18, 2021
4.4k Jan 09, 2023