sniptools 0.1.0__tar.gz

sniptools-0.1.0/.gitattributes

@@ -0,0 +1,5 @@
+* text=auto eol=lf
+*.svg text eol=lf
+*.png binary
+
+*.ps1 text eol=crlf

sniptools-0.1.0/.gitignore

@@ -0,0 +1,48 @@
+# === Local files and directories ===
+.local
+
+# === Environment variables ===
+.env
+.env*
+*.env
+
+# === virtual environment ===
+.venv/
+
+# === Cache ===
+**/__pycache__
+cache
+.pytest_cache/
+.ruff_cache/
+
+# === Jetbrains ===
+.idea/
+
+# === Byte-compiled / optimized / DLL files ===
+*.py[cod]
+*$py.class
+
+# === Distribution / packaging ===
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# === Unit test / coverage reports ===
+htmlcov/
+.tox/
+.coverage

sniptools-0.1.0/LICENSE.md

@@ -0,0 +1,188 @@
+**Copyright 2026 Micha Grandel**
+
+Licensed under the **Apache License**, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+  http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+
+---
+
+*Full license text:*
+
+Apache License
+==============
+
+_Version 2.0, January 2004_  
+_&lt;<http://www.apache.org/licenses/>&gt;_
+
+### Terms and Conditions for use, reproduction, and distribution
+
+#### 1. Definitions
+
+***“License”*** shall mean the terms and conditions for use, reproduction, and
+distribution as defined by Sections 1 through 9 of this document.
+
+***“Licensor”*** shall mean the copyright owner or entity authorized by
+the copyright owner that is granting the License.
+
+***“Legal Entity”*** shall mean the union of the acting entity and all other
+entities that control, are controlled by, or are under common control with that
+entity. For the purposes of this definition, “control” means **(i)** the power,
+direct or indirect, to cause the direction or management of such entity,
+whether by contract or otherwise, or **(ii)** ownership of fifty percent (50%)
+or more of the outstanding shares, or **(iii)** beneficial ownership of such entity.
+
+***“You”*** (or “Your”) shall mean an individual or Legal Entity exercising
+permissions granted by this License.
+
+***“Source”*** form shall mean the preferred form for making modifications,
+including but not limited to software source code, documentation source, and
+configuration files.
+
+***“Object”*** form shall mean any form resulting from mechanical transformation
+or translation of a Source form, including but not limited to compiled object code,
+generated documentation, and conversions to other media types.
+
+***“Work”*** shall mean the work of authorship, whether in Source or Object form,
+made available under the License, as indicated by a copyright notice that is
+included in or attached to the work (an example is provided in the Appendix below).
+
+***“Derivative Works”*** shall mean any work, whether in Source or Object form,
+that is based on (or derived from) the Work and for which the editorial revisions,
+annotations, elaborations, or other modifications represent, as a whole, an
+original work of authorship. For the purposes of this License, Derivative Works
+shall not include works that remain separable from, or merely link (or bind by
+name) to the interfaces of, the Work and Derivative Works thereof.
+
+***“Contribution”*** shall mean any work of authorship, including the original
+version of the Work and any modifications or additions to that Work or
+Derivative Works thereof, that is intentionally submitted to Licensor for
+inclusion in the Work by the copyright owner or by an individual or Legal Entity
+authorized to submit on behalf of the copyright owner. For the purposes of this
+definition, “submitted” means any form of electronic, verbal, or
+written communication sent to the Licensor or its representatives, including
+but not limited to communication on electronic mailing lists,
+source code control systems, and issue tracking systems that are managed by, or
+on behalf of, the Licensor for the purpose of discussing and improving the Work,
+but excluding communication that is conspicuously marked or otherwise designated
+in writing by the copyright owner as “Not a Contribution.”
+
+***“Contributor”*** shall mean Licensor and any individual or Legal Entity
+on behalf of whom a Contribution has been received by Licensor and subsequently
+incorporated within the Work.
+
+#### 2. Grant of Copyright License
+
+Subject to the terms and conditions of this License, each Contributor hereby
+grants to You a perpetual, worldwide, non-exclusive, no-charge, royalty-free,
+irrevocable copyright license to reproduce, prepare Derivative Works of,
+publicly display, publicly perform, sublicense, and distribute the Work and such
+Derivative Works in Source or Object form.
+
+#### 3. Grant of Patent License
+
+Subject to the terms and conditions of this License, each Contributor hereby
+grants to You a perpetual, worldwide, non-exclusive, no-charge, royalty-free,
+irrevocable (except as stated in this section) patent license to make, have
+made, use, offer to sell, sell, import, and otherwise transfer the Work, where
+such license applies only to those patent claims licensable by such Contributor
+that are necessarily infringed by their Contribution(s) alone or by combination
+of their Contribution(s) with the Work to which such Contribution(s) was
+submitted. If You institute patent litigation against any entity (including a
+cross-claim or counterclaim in a lawsuit) alleging that the Work or a
+Contribution incorporated within the Work constitutes direct or contributory
+patent infringement, then any patent licenses granted to You under this License
+for that Work shall terminate as of the date such litigation is filed.
+
+#### 4. Redistribution
+
+You may reproduce and distribute copies of the Work or Derivative Works thereof
+in any medium, with or without modifications, and in Source or Object form,
+provided that You meet the following conditions:
+
+* **(a)** You must give any other recipients of the Work or Derivative Works
+a copy of this License; and
+* **(b)** You must cause any modified files to carry prominent notices stating
+that You changed the files; and
+* **(c)** You must retain, in the Source form of any Derivative Works that You
+distribute, all copyright, patent, trademark, and attribution notices from
+the Source form of the Work, excluding those notices that do not pertain to
+any part of the Derivative Works; and
+* **(d)** If the Work includes a “NOTICE” text file as part of its distribution,
+then any Derivative Works that You distribute must include a readable copy of the
+attribution notices contained within such NOTICE file, excluding those notices
+that do not pertain to any part of the Derivative Works, in at least one of the
+following places: within a NOTICE text file distributed as part of the
+Derivative Works; within the Source form or documentation, if provided along
+with the Derivative Works; or, within a display generated by the Derivative
+Works, if and wherever such third-party notices normally appear. The contents of
+the NOTICE file are for informational purposes only and do not modify the
+License. You may add Your own attribution notices within Derivative Works that
+You distribute, alongside or as an addendum to the NOTICE text from the Work,
+provided that such additional attribution notices cannot be construed as
+modifying the License.
+
+You may add Your own copyright statement to Your modifications and may provide
+additional or different license terms and conditions for use, reproduction, or
+distribution of Your modifications, or for any such Derivative Works as a whole,
+provided Your use, reproduction, and distribution of the Work otherwise complies
+with the conditions stated in this License.
+
+#### 5. Submission of Contributions
+
+Unless You explicitly state otherwise, any Contribution intentionally submitted
+for inclusion in the Work by You to the Licensor shall be under the terms and
+conditions of this License, without any additional terms or conditions.
+Notwithstanding the above, nothing herein shall supersede or modify the terms of
+any separate license agreement you may have executed with Licensor regarding
+such Contributions.
+
+#### 6. Trademarks
+
+This License does not grant permission to use the trade names, trademarks,
+service marks, or product names of the Licensor, except as required for
+reasonable and customary use in describing the origin of the Work and
+reproducing the content of the NOTICE file.
+
+#### 7. Disclaimer of Warranty
+
+Unless required by applicable law or agreed to in writing, Licensor provides the
+Work (and each Contributor provides its Contributions) on an “AS IS” BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied,
+including, without limitation, any warranties or conditions of TITLE,
+NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A PARTICULAR PURPOSE. You are
+solely responsible for determining the appropriateness of using or
+redistributing the Work and assume any risks associated with Your exercise of
+permissions under this License.
+
+#### 8. Limitation of Liability
+
+In no event and under no legal theory, whether in tort (including negligence),
+contract, or otherwise, unless required by applicable law (such as deliberate
+and grossly negligent acts) or agreed to in writing, shall any Contributor be
+liable to You for damages, including any direct, indirect, special, incidental,
+or consequential damages of any character arising as a result of this License or
+out of the use or inability to use the Work (including but not limited to
+damages for loss of goodwill, work stoppage, computer failure or malfunction, or
+any and all other commercial damages or losses), even if such Contributor has
+been advised of the possibility of such damages.
+
+#### 9. Accepting Warranty or Additional Liability
+
+While redistributing the Work or Derivative Works thereof, You may choose to
+offer, and charge a fee for, acceptance of support, warranty, indemnity, or
+other liability obligations and/or rights consistent with this License. However,
+in accepting such obligations, You may act only on Your own behalf and on Your
+sole responsibility, not on behalf of any other Contributor, and only if You
+agree to indemnify, defend, and hold each Contributor harmless for any liability
+incurred by, or claims asserted against, such Contributor by reason of your
+accepting any such warranty or additional liability.
+
+*END OF TERMS AND CONDITIONS*

sniptools-0.1.0/PKG-INFO

@@ -0,0 +1,234 @@
+Metadata-Version: 2.5
+Name: sniptools
+Version: 0.1.0
+Summary: A collection of useful tools for developers.
+Author-email: Micha Grandel <michagrandel@proton.me>
+License: **Copyright 2026 Micha Grandel**
+        
+        Licensed under the **Apache License**, Version 2.0 (the "License");
+        you may not use this file except in compliance with the License.
+        You may obtain a copy of the License at
+        
+          http://www.apache.org/licenses/LICENSE-2.0
+        
+        Unless required by applicable law or agreed to in writing, software
+        distributed under the License is distributed on an "AS IS" BASIS,
+        WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+        See the License for the specific language governing permissions and
+        limitations under the License.
+        
+        ---
+        
+        *Full license text:*
+        
+        Apache License
+        ==============
+        
+        _Version 2.0, January 2004_  
+        _&lt;<http://www.apache.org/licenses/>&gt;_
+        
+        ### Terms and Conditions for use, reproduction, and distribution
+        
+        #### 1. Definitions
+        
+        ***“License”*** shall mean the terms and conditions for use, reproduction, and
+        distribution as defined by Sections 1 through 9 of this document.
+        
+        ***“Licensor”*** shall mean the copyright owner or entity authorized by
+        the copyright owner that is granting the License.
+        
+        ***“Legal Entity”*** shall mean the union of the acting entity and all other
+        entities that control, are controlled by, or are under common control with that
+        entity. For the purposes of this definition, “control” means **(i)** the power,
+        direct or indirect, to cause the direction or management of such entity,
+        whether by contract or otherwise, or **(ii)** ownership of fifty percent (50%)
+        or more of the outstanding shares, or **(iii)** beneficial ownership of such entity.
+        
+        ***“You”*** (or “Your”) shall mean an individual or Legal Entity exercising
+        permissions granted by this License.
+        
+        ***“Source”*** form shall mean the preferred form for making modifications,
+        including but not limited to software source code, documentation source, and
+        configuration files.
+        
+        ***“Object”*** form shall mean any form resulting from mechanical transformation
+        or translation of a Source form, including but not limited to compiled object code,
+        generated documentation, and conversions to other media types.
+        
+        ***“Work”*** shall mean the work of authorship, whether in Source or Object form,
+        made available under the License, as indicated by a copyright notice that is
+        included in or attached to the work (an example is provided in the Appendix below).
+        
+        ***“Derivative Works”*** shall mean any work, whether in Source or Object form,
+        that is based on (or derived from) the Work and for which the editorial revisions,
+        annotations, elaborations, or other modifications represent, as a whole, an
+        original work of authorship. For the purposes of this License, Derivative Works
+        shall not include works that remain separable from, or merely link (or bind by
+        name) to the interfaces of, the Work and Derivative Works thereof.
+        
+        ***“Contribution”*** shall mean any work of authorship, including the original
+        version of the Work and any modifications or additions to that Work or
+        Derivative Works thereof, that is intentionally submitted to Licensor for
+        inclusion in the Work by the copyright owner or by an individual or Legal Entity
+        authorized to submit on behalf of the copyright owner. For the purposes of this
+        definition, “submitted” means any form of electronic, verbal, or
+        written communication sent to the Licensor or its representatives, including
+        but not limited to communication on electronic mailing lists,
+        source code control systems, and issue tracking systems that are managed by, or
+        on behalf of, the Licensor for the purpose of discussing and improving the Work,
+        but excluding communication that is conspicuously marked or otherwise designated
+        in writing by the copyright owner as “Not a Contribution.”
+        
+        ***“Contributor”*** shall mean Licensor and any individual or Legal Entity
+        on behalf of whom a Contribution has been received by Licensor and subsequently
+        incorporated within the Work.
+        
+        #### 2. Grant of Copyright License
+        
+        Subject to the terms and conditions of this License, each Contributor hereby
+        grants to You a perpetual, worldwide, non-exclusive, no-charge, royalty-free,
+        irrevocable copyright license to reproduce, prepare Derivative Works of,
+        publicly display, publicly perform, sublicense, and distribute the Work and such
+        Derivative Works in Source or Object form.
+        
+        #### 3. Grant of Patent License
+        
+        Subject to the terms and conditions of this License, each Contributor hereby
+        grants to You a perpetual, worldwide, non-exclusive, no-charge, royalty-free,
+        irrevocable (except as stated in this section) patent license to make, have
+        made, use, offer to sell, sell, import, and otherwise transfer the Work, where
+        such license applies only to those patent claims licensable by such Contributor
+        that are necessarily infringed by their Contribution(s) alone or by combination
+        of their Contribution(s) with the Work to which such Contribution(s) was
+        submitted. If You institute patent litigation against any entity (including a
+        cross-claim or counterclaim in a lawsuit) alleging that the Work or a
+        Contribution incorporated within the Work constitutes direct or contributory
+        patent infringement, then any patent licenses granted to You under this License
+        for that Work shall terminate as of the date such litigation is filed.
+        
+        #### 4. Redistribution
+        
+        You may reproduce and distribute copies of the Work or Derivative Works thereof
+        in any medium, with or without modifications, and in Source or Object form,
+        provided that You meet the following conditions:
+        
+        * **(a)** You must give any other recipients of the Work or Derivative Works
+        a copy of this License; and
+        * **(b)** You must cause any modified files to carry prominent notices stating
+        that You changed the files; and
+        * **(c)** You must retain, in the Source form of any Derivative Works that You
+        distribute, all copyright, patent, trademark, and attribution notices from
+        the Source form of the Work, excluding those notices that do not pertain to
+        any part of the Derivative Works; and
+        * **(d)** If the Work includes a “NOTICE” text file as part of its distribution,
+        then any Derivative Works that You distribute must include a readable copy of the
+        attribution notices contained within such NOTICE file, excluding those notices
+        that do not pertain to any part of the Derivative Works, in at least one of the
+        following places: within a NOTICE text file distributed as part of the
+        Derivative Works; within the Source form or documentation, if provided along
+        with the Derivative Works; or, within a display generated by the Derivative
+        Works, if and wherever such third-party notices normally appear. The contents of
+        the NOTICE file are for informational purposes only and do not modify the
+        License. You may add Your own attribution notices within Derivative Works that
+        You distribute, alongside or as an addendum to the NOTICE text from the Work,
+        provided that such additional attribution notices cannot be construed as
+        modifying the License.
+        
+        You may add Your own copyright statement to Your modifications and may provide
+        additional or different license terms and conditions for use, reproduction, or
+        distribution of Your modifications, or for any such Derivative Works as a whole,
+        provided Your use, reproduction, and distribution of the Work otherwise complies
+        with the conditions stated in this License.
+        
+        #### 5. Submission of Contributions
+        
+        Unless You explicitly state otherwise, any Contribution intentionally submitted
+        for inclusion in the Work by You to the Licensor shall be under the terms and
+        conditions of this License, without any additional terms or conditions.
+        Notwithstanding the above, nothing herein shall supersede or modify the terms of
+        any separate license agreement you may have executed with Licensor regarding
+        such Contributions.
+        
+        #### 6. Trademarks
+        
+        This License does not grant permission to use the trade names, trademarks,
+        service marks, or product names of the Licensor, except as required for
+        reasonable and customary use in describing the origin of the Work and
+        reproducing the content of the NOTICE file.
+        
+        #### 7. Disclaimer of Warranty
+        
+        Unless required by applicable law or agreed to in writing, Licensor provides the
+        Work (and each Contributor provides its Contributions) on an “AS IS” BASIS,
+        WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied,
+        including, without limitation, any warranties or conditions of TITLE,
+        NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A PARTICULAR PURPOSE. You are
+        solely responsible for determining the appropriateness of using or
+        redistributing the Work and assume any risks associated with Your exercise of
+        permissions under this License.
+        
+        #### 8. Limitation of Liability
+        
+        In no event and under no legal theory, whether in tort (including negligence),
+        contract, or otherwise, unless required by applicable law (such as deliberate
+        and grossly negligent acts) or agreed to in writing, shall any Contributor be
+        liable to You for damages, including any direct, indirect, special, incidental,
+        or consequential damages of any character arising as a result of this License or
+        out of the use or inability to use the Work (including but not limited to
+        damages for loss of goodwill, work stoppage, computer failure or malfunction, or
+        any and all other commercial damages or losses), even if such Contributor has
+        been advised of the possibility of such damages.
+        
+        #### 9. Accepting Warranty or Additional Liability
+        
+        While redistributing the Work or Derivative Works thereof, You may choose to
+        offer, and charge a fee for, acceptance of support, warranty, indemnity, or
+        other liability obligations and/or rights consistent with this License. However,
+        in accepting such obligations, You may act only on Your own behalf and on Your
+        sole responsibility, not on behalf of any other Contributor, and only if You
+        agree to indemnify, defend, and hold each Contributor harmless for any liability
+        incurred by, or claims asserted against, such Contributor by reason of your
+        accepting any such warranty or additional liability.
+        
+        *END OF TERMS AND CONDITIONS*
+License-File: LICENSE.md
+Classifier: Development Status :: 2 - Pre-Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Libraries
+Requires-Python: >=3.13
+Description-Content-Type: text/markdown
+
+# SnipTools
+
+A collection of small utility tools.
+
+## Emoji Renamer
+
+Rename Unicode-named SVG emoji files to descriptive names and sort them into category folders.
+
+### Requirements
+
+- Python 3.13 or later
+
+### Usage
+
+```bash
+python emoji_renamer.py path/to/svg-folder
+```
+
+The tool processes SVG files in the specified folder (not its subfolders), renames them using Unicode emoji descriptions, and moves them into category folders such as `people_body` and `symbols`. Files without recognized Unicode code points and files that would overwrite an existing file are skipped.
+
+This changes files in place. Keep a backup if you need to preserve the original filenames.
+
+### Tests
+
+```bash
+python -m unittest discover -s tests
+```

sniptools-0.1.0/README.md

@@ -0,0 +1,27 @@
+# SnipTools
+
+A collection of small utility tools.
+
+## Emoji Renamer
+
+Rename Unicode-named SVG emoji files to descriptive names and sort them into category folders.
+
+### Requirements
+
+- Python 3.13 or later
+
+### Usage
+
+```bash
+python emoji_renamer.py path/to/svg-folder
+```
+
+The tool processes SVG files in the specified folder (not its subfolders), renames them using Unicode emoji descriptions, and moves them into category folders such as `people_body` and `symbols`. Files without recognized Unicode code points and files that would overwrite an existing file are skipped.
+
+This changes files in place. Keep a backup if you need to preserve the original filenames.
+
+### Tests
+
+```bash
+python -m unittest discover -s tests
+```

sniptools-0.1.0/pyproject.toml

@@ -0,0 +1,31 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "sniptools"
+version = "0.1.0"
+authors = [
+    { name = "Micha Grandel", email = "michagrandel@proton.me" },
+]
+description = "A collection of useful tools for developers."
+readme = "README.md"
+license = { file = "LICENSE.md" }
+requires-python = ">=3.13"
+dependencies = []
+classifiers = [
+    "Development Status :: 2 - Pre-Alpha",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: Apache Software License",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Software Development :: Libraries",
+]
+
+
+[project.scripts]
+rename-emoji = "sniptools.emoji.rename:main"

sniptools-0.1.0/src/sniptools/__init__.py

@@ -0,0 +1,3 @@
+# SPDX-FileCopyrightText: 2026 Micha Grandel
+#
+# SPDX-License-Identifier: Apache-2.0

sniptools-0.1.0/src/sniptools/emoji/__init__.py

@@ -0,0 +1,3 @@
+# SPDX-FileCopyrightText: 2026 Micha Grandel
+#
+# SPDX-License-Identifier: Apache-2.0

sniptools-0.1.0/src/sniptools/emoji/rename.py

@@ -0,0 +1,414 @@
+# SPDX-FileCopyrightText: 2026 Micha Grandel
+#
+# SPDX-License-Identifier: Apache-2.0
+
+from __future__ import annotations
+
+import argparse
+import re
+import sys
+import unicodedata
+from pathlib import Path
+from typing import Iterable
+
+SKIN_TONE_MODIFIERS = {
+    "1f3fb": "light_skin_tone",
+    "1f3fc": "medium_light_skin_tone",
+    "1f3fd": "medium_skin_tone",
+    "1f3fe": "medium_dark_skin_tone",
+    "1f3ff": "dark_skin_tone",
+}
+
+IGNORED_CODEPOINTS = {0x200D, 0xFE0F, 0x20E3}
+SPECIAL_EMOJI_DESCRIPTIONS = {
+    (0x2764, 0x1F525): "heart_with_fire",
+}
+SPECIAL_EMOJI_CATEGORIES = {
+    (0x2764,): "symbols",
+    (0x2764, 0x1F525): "symbols",
+}
+
+CATEGORY_KEYWORDS = {
+    "smileys_emotion": {
+        "FACE",
+        "SMILE",
+        "SMILING",
+        "GRIN",
+        "WINK",
+        "KISS",
+        "LOVE",
+        "HUG",
+        "THINK",
+        "CRY",
+        "SAD",
+        "ANGRY",
+        "SCREAM",
+        "TONGUE",
+        "SWEAT",
+        "DIZZY",
+        "SHOCK",
+        "SLEEP",
+        "ZANY",
+        "MELT",
+        "HUSH",
+        "PENSIVE",
+        "FROWN",
+        "TEARS",
+        "RAGE",
+        "DEVIL",
+        "ANGUISH",
+    },
+    "people_body": {
+        "HAND",
+        "PERSON",
+        "MAN",
+        "WOMAN",
+        "FAMILY",
+        "BABY",
+        "CHILD",
+        "OLDER",
+        "ELDER",
+        "BODY",
+        "LEG",
+        "ARM",
+        "FOOT",
+        "FINGER",
+        "NOSE",
+        "MOUTH",
+        "EAR",
+        "EYE",
+        "BRAIN",
+        "HUMAN",
+        "PEOPLE",
+    },
+    "food_drink": {
+        "FOOD",
+        "DRINK",
+        "BREAD",
+        "BURGER",
+        "PIZZA",
+        "PASTA",
+        "SUSHI",
+        "ICE",
+        "CAKE",
+        "COOKIE",
+        "CHOCOLATE",
+        "CUP",
+        "TEA",
+        "COFFEE",
+        "BEER",
+        "WINE",
+        "BOWL",
+        "SPOON",
+        "FORK",
+        "KNIFE",
+        "SANDWICH",
+        "DUMPLING",
+        "TACO",
+        "BURRITO",
+        "BENTO",
+        "CROISSANT",
+    },
+    "animals_nature": {
+        "ANIMAL",
+        "BIRD",
+        "CAT",
+        "DOG",
+        "PENGUIN",
+        "BUNNY",
+        "FOX",
+        "BEAR",
+        "PANDA",
+        "TIGER",
+        "LION",
+        "COW",
+        "PIG",
+        "FROG",
+        "MONKEY",
+        "MOUSE",
+        "RABBIT",
+        "FISH",
+        "WHALE",
+        "DOLPHIN",
+        "UNICORN",
+        "CHICKEN",
+        "DUCK",
+        "EAGLE",
+        "OWL",
+        "BEE",
+        "BUG",
+        "SPIDER",
+        "CLOUD",
+        "SUN",
+        "MOON",
+        "STAR",
+        "TREE",
+        "FLOWER",
+        "LEAF",
+        "MUSHROOM",
+        "MOUNTAIN",
+        "WAVE",
+        "ROCK",
+        "DESERT",
+        "OCEAN",
+    },
+    "travel_places": {
+        "CAR",
+        "TRUCK",
+        "BUS",
+        "TAXI",
+        "AUTO",
+        "AIRPLANE",
+        "ROCKET",
+        "SHIP",
+        "BOAT",
+        "BICYCLE",
+        "MOTORCYCLE",
+        "SCOOTER",
+        "TRAIN",
+        "STATION",
+        "TENT",
+        "BUILDING",
+        "HOUSE",
+        "HOTEL",
+        "ROAD",
+        "MAP",
+        "PARK",
+        "BEACH",
+        "ISLAND",
+        "CITY",
+        "TOWER",
+        "BRIDGE",
+    },
+    "activities": {
+        "SPORT",
+        "GAME",
+        "BALL",
+        "TROPHY",
+        "MEDAL",
+        "GUITAR",
+        "DRUM",
+        "MUSICAL",
+        "MARTIAL",
+        "FISHING",
+        "BOWLING",
+        "GOLF",
+        "SKI",
+        "SURF",
+        "RACING",
+        "RUGBY",
+        "BASKETBALL",
+        "CHESS",
+    },
+    "objects": {
+        "BAG",
+        "WATCH",
+        "PHONE",
+        "KEYBOARD",
+        "LAPTOP",
+        "MOUSE",
+        "COMPUTER",
+        "CAMERA",
+        "BOOK",
+        "PEN",
+        "PENCIL",
+        "SCISSORS",
+        "LOCK",
+        "KEY",
+        "HAMMER",
+        "TRUCK",
+        "BALLOON",
+        "GIFT",
+        "RIBBON",
+        "PRESENT",
+        "DART",
+        "BOW",
+        "ARROW",
+        "MEDICINE",
+        "MAGNET",
+        "MIRROR",
+        "FIRE",
+    },
+    "symbols": {
+        "HEART",
+        "SPARKLES",
+        "CROSS",
+        "CHECK",
+        "QUESTION",
+        "EXCLAMATION",
+        "PLUS",
+        "MINUS",
+        "ASTERISK",
+        "SIGN",
+        "SYMBOL",
+        "TICKET",
+        "MUSIC",
+        "NUMBER",
+        "BUTTON",
+        "LABEL",
+        "CURRENCY",
+        "PIN",
+        "JOKER",
+        "TOP",
+        "FLAG",
+    },
+}
+
+
+def rename_svg_files(folder_path: str | Path) -> int:
+    folder = Path(folder_path)
+    if not folder.exists():
+        raise FileNotFoundError(f"Folder does not exist: {folder}")
+    if not folder.is_dir():
+        raise NotADirectoryError(f"Not a directory: {folder}")
+
+    renamed_count = 0
+    svg_files = sorted(
+        path for path in folder.iterdir() if path.is_file() and path.suffix.lower() == ".svg"
+    )
+
+    for source_path in svg_files:
+        try:
+            codepoints = _parse_codepoints(source_path.stem)
+            new_name = f"{_get_emoji_description(codepoints)}.svg"
+            category = _get_category(codepoints)
+        except ValueError as exc:
+            print(f"Skipping {source_path.name}: {exc}", file=sys.stderr)
+            continue
+
+        if source_path.name == new_name:
+            pass
+        else:
+            target_path = source_path.with_name(new_name)
+            if target_path.exists() and target_path != source_path:
+                print(f"Skipping {source_path.name}: target already exists ({target_path.name})", file=sys.stderr)
+                continue
+            source_path.rename(target_path)
+            source_path = target_path
+            renamed_count += 1
+
+        category_dir = folder / category
+        category_dir.mkdir(exist_ok=True)
+        destination_path = category_dir / source_path.name
+        if destination_path.exists() and destination_path != source_path:
+            print(f"Skipping {source_path.name}: target already exists ({destination_path.name})", file=sys.stderr)
+            continue
+        if source_path.parent != category_dir:
+            source_path.rename(destination_path)
+
+    return renamed_count
+
+
+def _parse_codepoints(file_name: str) -> list[int]:
+    stem = Path(file_name).stem
+    if stem.startswith("emoji_"):
+        stem = stem[len("emoji_") :]
+
+    parts = stem.split("_")
+    codepoints: list[int] = []
+    found_unicode_token = False
+    for part in parts:
+        if not part:
+            continue
+        if part.startswith("u"):
+            part = part[1:]
+            found_unicode_token = True
+        else:
+            if not re.fullmatch(r"[0-9a-fA-F]+", part):
+                continue
+        try:
+            codepoints.append(int(part, 16))
+        except ValueError:
+            raise ValueError(f"Unsupported emoji token: {part}") from None
+
+    if not found_unicode_token:
+        raise ValueError("No unicode token found in file name")
+    return codepoints
+
+
+def _get_emoji_description(codepoints: Iterable[int]) -> str:
+    codepoint_list = list(codepoints)
+    if not codepoint_list:
+        raise ValueError("No emoji codepoints found")
+
+    if codepoint_list[-1] in {0x1F3FB, 0x1F3FC, 0x1F3FD, 0x1F3FE, 0x1F3FF}:
+        modifier_codepoint = codepoint_list.pop()
+        modifier_name = SKIN_TONE_MODIFIERS.get(f"{modifier_codepoint:04x}")
+        if modifier_name is None:
+            raise ValueError(f"Unsupported skin tone modifier {modifier_codepoint:#x}")
+    else:
+        modifier_name = None
+
+    normalized_codepoints = tuple(
+        codepoint for codepoint in codepoint_list if codepoint not in IGNORED_CODEPOINTS
+    )
+    if normalized_codepoints in SPECIAL_EMOJI_DESCRIPTIONS:
+        description = SPECIAL_EMOJI_DESCRIPTIONS[normalized_codepoints]
+    else:
+        names: list[str] = []
+        for codepoint in normalized_codepoints:
+            try:
+                names.append(unicodedata.name(chr(codepoint)))
+            except ValueError:
+                continue
+        if not names:
+            raise ValueError(f"No Unicode name found for code point {codepoint_list[0]:#x}")
+        description = _slugify(" ".join(names))
+
+    if modifier_name:
+        description = f"{description}_{modifier_name}"
+    return description
+
+
+def _slugify(value: str) -> str:
+    return re.sub(r"[^a-z0-9]+", "_", value.lower()).strip("_")
+
+
+def _get_category(codepoints: Iterable[int]) -> str:
+    codepoint_list = list(codepoints)
+    if not codepoint_list:
+        raise ValueError("No emoji codepoints found")
+
+    if codepoint_list[-1] in {0x1F3FB, 0x1F3FC, 0x1F3FD, 0x1F3FE, 0x1F3FF}:
+        codepoint_list = codepoint_list[:-1]
+
+    significant_codepoints = [
+        codepoint for codepoint in codepoint_list if codepoint not in IGNORED_CODEPOINTS
+    ]
+
+    if any(0x1F1E6 <= codepoint <= 0x1F1FF for codepoint in significant_codepoints):
+        return "flags"
+
+    normalized_codepoints = tuple(codepoint for codepoint in significant_codepoints if codepoint not in IGNORED_CODEPOINTS)
+    if normalized_codepoints in SPECIAL_EMOJI_CATEGORIES:
+        return SPECIAL_EMOJI_CATEGORIES[normalized_codepoints]
+
+    for category, keywords in CATEGORY_KEYWORDS.items():
+        for codepoint in significant_codepoints:
+            try:
+                name = unicodedata.name(chr(codepoint)).upper()
+            except ValueError:
+                continue
+            if any(keyword in name for keyword in keywords):
+                return category
+
+    if any(0x2600 <= codepoint <= 0x27BF for codepoint in significant_codepoints):
+        return "symbols"
+    if any(0x1F300 <= codepoint <= 0x1FAFF for codepoint in significant_codepoints):
+        return "symbols"
+
+    raise ValueError("No category found for emoji")
+
+def main() -> int:
+    parser = argparse.ArgumentParser(description="Rename SVG emoji files to descriptive names.")
+    parser.add_argument("folder", help="Folder containing SVG emoji files")
+    args = parser.parse_args()
+
+    try:
+        renamed_count = rename_svg_files(args.folder)
+    except (FileNotFoundError, NotADirectoryError, ValueError) as exc:
+        print(str(exc), file=sys.stderr)
+        return 1
+
+    print(f"Renamed {renamed_count} files.")
+    return 0