Metadata-Version: 2.4
Name: silasyn-uid
Version: 1.0.0
Summary: Official zero-dependency Python client for Silasyn UID Studio Pro with automatic offline fallback.
Author-email: Silasyn <support@silasyn.com>
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.7
Description-Content-Type: text/markdown
License-File: LICENSE.md
Dynamic: license-file

Silasyn UID Studio Pro - Python Client



Official, zero-dependency Python client for generating secure, customizable unique identifiers using the Silasyn UID Studio Pro API.



Features



Zero Dependencies: Built entirely on Python's native standard libraries (urllib, json, uuid, secrets, time). No need to install requests.



Automatic Offline Fallback: If the API endpoint at silasyn.com is unreachable (due to network, firewall, or DNS issues), the client automatically switches to a high-precision local generation engine to guarantee 100% uptime.



Highly Customizable: Supports UUIDv4, UUIDv7 (Time-ordered), NanoID, Hexadecimal, Pure Numeric, and Custom pools with prefixes, suffixes, custom casings, and formatting.



Installation



Install the package from PyPI:



pip install silasyn-uid





Quick Start



from silasyn\_uid import UIDStudio



\# 1. Generate standard UUIDv4

uuids = UIDStudio.uuid4(count=2)

print(uuids)



\# 2. Generate Time-ordered UUIDv7

uuid7s = UIDStudio.uuid7(count=1)

print(uuid7s)



\# 3. Generate NanoIDs with a prefix

nanoids = UIDStudio.nanoid(count=3, length=12, prefix="user\_")

print(nanoids)



\# 4. Generate custom hexadecimal keys

custom\_keys = UIDStudio.custom(pool="ABCDEF1234567890", count=2, length=16, hyphens=True)

print(custom\_keys)





Configuration Parameters



The core generate method accepts the following arguments:



Parameter



Type



Default



Description



format\_type



str



"uuid4"



Options: "uuid4", "uuid7", "nanoid", "hex", "numeric", "custom"



count



int



1



Number of identifiers to generate (Max: 5000)



length



int



21



Overall length of generated string (ignored for UUIDs)



prefix



str



""



Optional string to prepend



suffix



str



""



Optional string to append



hyphens



bool



True



Group characters into blocks separated by hyphens



casing



str



"mixed"



Set character case: "mixed", "lower", "upper"



custom\_pool



str



""



Alphanumeric pool used only when format\_type="custom"



License



Copyright © 2026 Silasyn. All rights reserved.

Distributed under the MIT License. See LICENSE for details.

