Package: easyflake
EasyFlakeEasyFlake is a Python package for generating 64-bit IDs similar to Snowflake or Sonyflake. It provides a simple way to generate unique and sortable IDs that can be used as primary keys in databases, message queue messages, or other distributed systems.IntroductionIn a distributed system, it can be challenging to generate unique IDs for records that need to be stored or processed across multiple nodes. EasyFlake provides a way to generate IDs that are unique, sortable, and easy to work with.Use CasesHere are some examples of use cases for EasyFlake:User account IDs: Generate unique IDs for user accounts that can be used across multiple servers or databases.Transaction IDs: Generate IDs for financial transactions that need to be processed across multiple systems.Order numbers: Generate unique order numbers that can be sorted by timestamp.InstallationInstall the latest version of EasyFlake using pip:pipinstalleasyflakeUsageTo use EasyFlake, simply create an instance of theEasyFlakeclass, passing in a unique node ID:fromeasyflakeimportEasyFlakeef=EasyFlake(node_id=1)print(ef.get_id())Theget_id()method generates the next ID by the current timestamp. You can customize the number of bits used for the node ID and sequence ID parts, as well as the epoch timestamp and time scale.ef=EasyFlake(node_id=0,node_id_bits=4,sequence_bits=6)print(ef.get_id())The components of the output ID are the sequence value, node ID, and timestamp, in order from the lower bits.Argumentsnode_id(int,NodeIdPool): A unique ID for the current node. This ID should be between 0 and (2 ^ node_id_bits) - 1.node_id_bits(int): The maximum number of bits used to represent the node ID. This argument defaults to 8 / max node ID is 255.sequence_bits(int): The maximum number of bits used to represent the sequence number. This argument defaults to 8 / max sequence number is 255.epoch(float): A timestamp used as a reference when generating the timestamp section of the ID. This argument defaults to 1675859040 (2023-02-08T12:24:00Z).time_scale(int): The number of decimal places used to represent the timestamp. This argument defaults to 3 (milliseconds).APINodeIDPoolThis is a class that manages node IDs in a single-threaded or single-process environment. The default options provided areGrpcNodeIdPoolandFileNodeIdPool.By inheriting fromBaseNodeIdPool, you can also create your own custom node ID management.easyflake.FileNodeIdPoolThis is a file-based node ID management class. Care should be taken in distributed systems, as node IDs are managed by a single file.Argumentsendpoint(str): The path to the file where node IDs are recorded.bits(int): The maximum number of bits for node IDs.easyflake.GrpcNodeIdPoolThis is a gRPC-based node ID management class.
You can start a gRPC server usingeasyflake-cli grpc.However, it's important to note that the gRPC server can become a single point of failure in your system, so proper measures should be taken to ensure its availability.Argumentsendpoint(str): The address of the gRPC server.bits(int): The maximum number of bits for node IDs.Commandeasyflake-cli grpcThis command starts a gRPC server for managing node IDs.Options-p,--port: Specifies the port number of the gRPC server.-d,--daemon: Starts the server in daemon mode (not supported on Windows).--pid-file: Specifies the path to the PID file.ContributingSee thecontributing guide.LicenseThis project is licensed under the MIT License - see theLICENSEfile for details.