ff-name-styler 0.1.0__py3-none-any.whl

ff_name_styler/__init__.py

@@ -0,0 +1,140 @@
+"""ff-name-styler: stylish nickname generator for Free Fire.
+
+Turns a plain name into 10 Unicode styles that were verified inside the
+actual Free Fire client, with a character counter that counts the way the
+game counts (12-character nickname limit).
+"""
+
+GAME_LIMIT = 12
+
+
+def _fullwidth(text):
+    out = []
+    for ch in text:
+        n = ord(ch)
+        if 65 <= n <= 90:
+            out.append(chr(0xFF21 + n - 65))
+        elif 97 <= n <= 122:
+            out.append(chr(0xFF41 + n - 97))
+        elif 48 <= n <= 57:
+            out.append(chr(0xFF10 + n - 48))
+        else:
+            out.append(ch)
+    return "".join(out)
+
+
+def _circled(text):
+    out = []
+    for ch in text:
+        n = ord(ch)
+        if 65 <= n <= 90:
+            out.append(chr(0x24B6 + n - 65))
+        elif 97 <= n <= 122:
+            out.append(chr(0x24D0 + n - 97))
+        elif ch == "0":
+            out.append("\u24ea")
+        elif 49 <= n <= 57:
+            out.append(chr(0x2460 + n - 49))
+        else:
+            out.append(ch)
+    return "".join(out)
+
+
+_SMALL_CAPS = {
+    "a": "\u1d00", "b": "\u0299", "c": "\u1d04", "d": "\u1d05",
+    "e": "\u1d07", "f": "\u0493", "g": "\u0262", "h": "\u029c",
+    "i": "\u026a", "j": "\u1d0a", "k": "\u1d0b", "l": "\u029f",
+    "m": "\u1d0d", "n": "\u0274", "o": "\u1d0f", "p": "\u1d18",
+    "q": "\u02a0", "r": "\u1d19", "s": "\ua731", "t": "\u1d1b",
+    "u": "\u1d1c", "v": "\u1d20", "w": "\u1d21", "x": "x",
+    "y": "\u028f", "z": "\u1d22",
+}
+
+
+def _small_caps(text):
+    def conv(ch):
+        low = ch.lower()
+        if "a" <= low <= "z":
+            return _SMALL_CAPS.get(low, ch)
+        return ch
+
+    return "".join(conv(ch) for ch in text)
+
+
+_UPSIDE_DOWN = {
+    "a": "\u0250", "b": "q", "c": "\u0254", "d": "p",
+    "e": "\u01dd", "f": "\u025f", "g": "\u0183", "h": "\u0265",
+    "i": "\u1d09", "j": "\u027e", "k": "\u029e", "l": "l",
+    "m": "\u026f", "n": "u", "o": "o", "p": "d",
+    "q": "b", "r": "\u0279", "s": "s", "t": "\u0287",
+    "u": "n", "v": "\u028c", "w": "\u028d", "x": "x",
+    "y": "\u028e", "z": "z",
+}
+
+
+def _upside_down(text):
+    def conv(ch):
+        low = ch.lower()
+        if "a" <= low <= "z":
+            return _UPSIDE_DOWN.get(low, ch)
+        return ch
+
+    return "".join(conv(ch) for ch in reversed(text))
+
+
+STYLES = {
+    "small_caps": _small_caps,
+    "bubble": _circled,
+    "wide": _fullwidth,
+    "upside_down": _upside_down,
+    "crown": lambda t: "\ua9c1" + t + "\ua9c2",
+    "star": lambda t: "\u2605\u5f61" + t + "\u5f61\u2605",
+    "blade": lambda t: "\u4e42" + t + "\u4e42",
+    "king": lambda t: "\u265b" + t + "\u265b",
+    "brackets": lambda t: "\u300e" + t + "\u300f",
+    "smile": lambda t: "\u30c4" + t + "\u30c4",
+}
+
+
+def style(text, style_name):
+    """Render *text* in the named style (one of STYLES keys)."""
+    try:
+        func = STYLES[style_name]
+    except KeyError:
+        raise ValueError(
+            "unknown style %r (choose from %s)" % (style_name, ", ".join(STYLES))
+        )
+    return func(text)
+
+
+def char_count(text):
+    """Count characters the way Free Fire counts them (Unicode code points)."""
+    return len(text)
+
+
+def fits_game_limit(text):
+    """True if *text* fits Free Fire's 12-character nickname limit."""
+    return len(text) <= GAME_LIMIT
+
+
+def all_styles(text):
+    """Return {style_name: rendered} for every style."""
+    return {name: func(text) for name, func in STYLES.items()}
+
+
+def main(argv=None):
+    import sys
+
+    args = sys.argv[1:] if argv is None else argv
+    if not args:
+        print("usage: python -m ff_name_styler <name>")
+        raise SystemExit(2)
+    name = " ".join(args)
+    for style_name, func in STYLES.items():
+        out = func(name)
+        mark = "OK      " if len(out) <= GAME_LIMIT else "TOO LONG"
+        print("[%s] %-12s %s (%d/12)" % (mark, style_name, out, len(out)))
+
+
+if __name__ == "__main__":
+    main()

ff_name_styler-0.1.0.dist-info/METADATA

@@ -0,0 +1,55 @@
+Metadata-Version: 2.4
+Name: ff-name-styler
+Version: 0.1.0
+Summary: Stylish nickname generator for Free Fire — 10 in-game-tested Unicode styles with a 12-character counter.
+Author: Fin Alen
+License: MIT
+Project-URL: Homepage, https://ffnamegenerator.com/
+Keywords: free-fire,nickname,unicode,styler
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Topic :: Games/Entertainment
+Classifier: Topic :: Text Processing
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+
+# ff-name-styler
+
+Stylish nickname generator for Free Fire — 10 Unicode styles that were
+verified inside the actual Free Fire client, plus a character counter that
+counts the way the game counts (12-character nickname limit).
+
+## Install
+
+```bash
+pip install ff-name-styler
+```
+
+## Use it
+
+```python
+from ff_name_styler import style, all_styles, fits_game_limit
+
+print(style("Ali", "crown"))      # ꧁Ali꧂
+print(style("Ali", "small_caps")) # ᴀʟɪ
+
+for name, out in all_styles("Ali").items():
+    print(name, "->", out, fits_game_limit(out))
+```
+
+Or from the command line:
+
+```bash
+python -m ff_name_styler Ali
+```
+
+## Full tool
+
+For 100+ styles, a symbol crate, and in-game-tested guides, see the free web tool:
+
+https://ffnamegenerator.com/
+
+## License
+
+MIT — not affiliated with Garena.

ff_name_styler-0.1.0.dist-info/RECORD

@@ -0,0 +1,5 @@
+ff_name_styler/__init__.py,sha256=mOn6Fblbt-oCJm5u_KYEIiBS-WPTSovzy88pxSuXiLc,3886
+ff_name_styler-0.1.0.dist-info/METADATA,sha256=7kT5B2yk3M3mn2tCANwNKsl0DuwIP2OezrPGrPZGYHc,1387
+ff_name_styler-0.1.0.dist-info/WHEEL,sha256=a-udL2m4V_6Yn8b-uKzWb12RjRxwwMo6ohYFM24tpaY,91
+ff_name_styler-0.1.0.dist-info/top_level.txt,sha256=SNR87Vv9DyBBG8fI1si0H1lnklnDLrXCujdI4wHgJ7E,15
+ff_name_styler-0.1.0.dist-info/RECORD,,

ff_name_styler-0.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (84.2.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

ff_name_styler-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+ff_name_styler