wordkers 1.0.0__tar.gz

wordkers-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Wordkers
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

wordkers-1.0.0/PKG-INFO

@@ -0,0 +1,46 @@
+Metadata-Version: 2.4
+Name: wordkers
+Version: 1.0.0
+Summary: Cliente Python de la Wordkers API: PLN del español (silabeo, acentuación, género, flexión, lematización…). Algoritmos + lingüística.
+Author: Wordkers
+License: MIT
+Project-URL: Homepage, https://wordkers.es
+Project-URL: Documentation, https://docs.dhabil.com
+Keywords: spanish,espanol,nlp,linguistics,morphology,syllabification,api,wordkers
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Topic :: Text Processing :: Linguistic
+Classifier: Intended Audience :: Developers
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# wordkers
+
+Cliente Python de la **Wordkers API** — procesamiento del lenguaje **español** mediante endpoints
+simples: silabeo, acentuación, género, flexión (femenino/plural…), lematización y más.
+**Algoritmos + lingüística, frente a estadística + suposición.**
+
+## Instalación
+```bash
+pip install wordkers
+```
+
+## Uso
+```python
+from wordkers import Wordkers
+
+wk = Wordkers("TU_CLAVE")            # tu API key de Wordkers
+
+wk.silabear("murciélago")            # {'silabas': 'mur=cié=la=go', 'n_silabas': 4, 'silaba_tonica': 3}
+wk.feminizar("bueno", categoria="Adjetivos")   # {'femenino': 'buena', ...}
+wk.pluralizar("luz")                 # {'plural': 'luces', ...}
+wk.es_invariable("cantante")         # True
+wk.acentuar("cancion")               # {'acentuada': ...}
+wk.masculinizar("reina")             # {'masculino': 'rey', ...}
+wk.singularizar("luces")             # {'opciones': ['luces', 'luce', 'luz'], ...}
+```
+
+Sin dependencias (solo la librería estándar). Documentación: https://docs.dhabil.com

wordkers-1.0.0/README.md

@@ -0,0 +1,27 @@
+# wordkers
+
+Cliente Python de la **Wordkers API** — procesamiento del lenguaje **español** mediante endpoints
+simples: silabeo, acentuación, género, flexión (femenino/plural…), lematización y más.
+**Algoritmos + lingüística, frente a estadística + suposición.**
+
+## Instalación
+```bash
+pip install wordkers
+```
+
+## Uso
+```python
+from wordkers import Wordkers
+
+wk = Wordkers("TU_CLAVE")            # tu API key de Wordkers
+
+wk.silabear("murciélago")            # {'silabas': 'mur=cié=la=go', 'n_silabas': 4, 'silaba_tonica': 3}
+wk.feminizar("bueno", categoria="Adjetivos")   # {'femenino': 'buena', ...}
+wk.pluralizar("luz")                 # {'plural': 'luces', ...}
+wk.es_invariable("cantante")         # True
+wk.acentuar("cancion")               # {'acentuada': ...}
+wk.masculinizar("reina")             # {'masculino': 'rey', ...}
+wk.singularizar("luces")             # {'opciones': ['luces', 'luce', 'luz'], ...}
+```
+
+Sin dependencias (solo la librería estándar). Documentación: https://docs.dhabil.com

wordkers-1.0.0/pyproject.toml

@@ -0,0 +1,27 @@
+[build-system]
+requires = ["setuptools>=61.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "wordkers"
+version = "1.0.0"
+description = "Cliente Python de la Wordkers API: PLN del español (silabeo, acentuación, género, flexión, lematización…). Algoritmos + lingüística."
+readme = "README.md"
+requires-python = ">=3.7"
+license = { text = "MIT" }
+authors = [{ name = "Wordkers" }]
+keywords = ["spanish", "espanol", "nlp", "linguistics", "morphology", "syllabification", "api", "wordkers"]
+classifiers = [
+  "Programming Language :: Python :: 3",
+  "License :: OSI Approved :: MIT License",
+  "Operating System :: OS Independent",
+  "Topic :: Text Processing :: Linguistic",
+  "Intended Audience :: Developers",
+]
+
+[project.urls]
+Homepage = "https://wordkers.es"
+Documentation = "https://docs.dhabil.com"
+
+[tool.setuptools]
+py-modules = ["wordkers"]

wordkers-1.0.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

wordkers-1.0.0/wordkers.egg-info/PKG-INFO

@@ -0,0 +1,46 @@
+Metadata-Version: 2.4
+Name: wordkers
+Version: 1.0.0
+Summary: Cliente Python de la Wordkers API: PLN del español (silabeo, acentuación, género, flexión, lematización…). Algoritmos + lingüística.
+Author: Wordkers
+License: MIT
+Project-URL: Homepage, https://wordkers.es
+Project-URL: Documentation, https://docs.dhabil.com
+Keywords: spanish,espanol,nlp,linguistics,morphology,syllabification,api,wordkers
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Topic :: Text Processing :: Linguistic
+Classifier: Intended Audience :: Developers
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# wordkers
+
+Cliente Python de la **Wordkers API** — procesamiento del lenguaje **español** mediante endpoints
+simples: silabeo, acentuación, género, flexión (femenino/plural…), lematización y más.
+**Algoritmos + lingüística, frente a estadística + suposición.**
+
+## Instalación
+```bash
+pip install wordkers
+```
+
+## Uso
+```python
+from wordkers import Wordkers
+
+wk = Wordkers("TU_CLAVE")            # tu API key de Wordkers
+
+wk.silabear("murciélago")            # {'silabas': 'mur=cié=la=go', 'n_silabas': 4, 'silaba_tonica': 3}
+wk.feminizar("bueno", categoria="Adjetivos")   # {'femenino': 'buena', ...}
+wk.pluralizar("luz")                 # {'plural': 'luces', ...}
+wk.es_invariable("cantante")         # True
+wk.acentuar("cancion")               # {'acentuada': ...}
+wk.masculinizar("reina")             # {'masculino': 'rey', ...}
+wk.singularizar("luces")             # {'opciones': ['luces', 'luce', 'luz'], ...}
+```
+
+Sin dependencias (solo la librería estándar). Documentación: https://docs.dhabil.com

wordkers-1.0.0/wordkers.egg-info/SOURCES.txt

@@ -0,0 +1,8 @@
+LICENSE
+README.md
+pyproject.toml
+wordkers.py
+wordkers.egg-info/PKG-INFO
+wordkers.egg-info/SOURCES.txt
+wordkers.egg-info/dependency_links.txt
+wordkers.egg-info/top_level.txt

wordkers-1.0.0/wordkers.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

wordkers-1.0.0/wordkers.egg-info/top_level.txt

@@ -0,0 +1 @@
+wordkers

wordkers-1.0.0/wordkers.py

@@ -0,0 +1,88 @@
+# -*- coding: utf-8 -*-
+"""
+wordkers — cliente Python de la API de Wordkers (PLN del español).
+
+Sin dependencias (solo librería estándar). Uso:
+
+    from wordkers import Wordkers
+    wk = Wordkers("TU_CLAVE")
+    wk.silabear("murciélago")      # {'silabas': 'mur=cié=la=go', ...}
+    wk.feminizar("bueno", categoria="Adjetivos")   # {'femenino': 'buena', ...}
+    wk.es_invariable("cantante")   # True
+"""
+import json
+import urllib.parse
+import urllib.request
+import urllib.error
+
+__version__ = "1.0.0"
+
+
+class WordkersError(Exception):
+    """Error de la API (clave inválida, rate-limit, parámetro, etc.)."""
+    def __init__(self, status, message):
+        self.status = status
+        super().__init__(f"[{status}] {message}")
+
+
+class Wordkers:
+    def __init__(self, api_key, base_url="https://api.dhabil.com", timeout=15):
+        self.api_key = api_key
+        self.base_url = base_url.rstrip("/")
+        self.timeout = timeout
+
+    def _get(self, path, **params):
+        params = {k: v for k, v in params.items() if v is not None}
+        url = f"{self.base_url}{path}?{urllib.parse.urlencode(params)}"
+        req = urllib.request.Request(url, headers={
+            "X-API-Key": self.api_key,
+            "User-Agent": f"wordkers-python/{__version__}",
+            "Accept": "application/json",
+        })
+        try:
+            with urllib.request.urlopen(req, timeout=self.timeout) as r:
+                return json.loads(r.read().decode("utf-8"))
+        except urllib.error.HTTPError as e:
+            if e.code == 401:
+                raise WordkersError(401, "Clave de API ausente o inválida.")
+            if e.code == 429:
+                raise WordkersError(429, "Límite de llamadas superado. Reintenta más tarde.")
+            raise WordkersError(e.code, e.read().decode("utf-8", "replace"))
+
+    # --- silabeo y acento ---
+    def silabear(self, palabra):
+        return self._get("/v1/silabear", palabra=palabra)
+
+    def acentuar(self, palabra):
+        return self._get("/v1/acentuar", palabra=palabra)
+
+    # --- género ---
+    def genero(self, palabra):
+        return self._get("/v1/genero", palabra=palabra)
+
+    def es_invariable(self, palabra):
+        return self._get("/v1/es_invariable", palabra=palabra)["es_invariable"]
+
+    # --- flexión ---
+    def feminizar(self, palabra, categoria=None, singular=True):
+        return self._get("/v1/feminizar", palabra=palabra, categoria=categoria,
+                         singular=str(singular).lower())
+
+    def masculinizar(self, palabra, categoria=None, singular=True):
+        return self._get("/v1/masculinizar", palabra=palabra, categoria=categoria,
+                         singular=str(singular).lower())
+
+    def pluralizar(self, palabra):
+        return self._get("/v1/pluralizar", palabra=palabra)
+
+    def singularizar(self, palabra):
+        return self._get("/v1/singularizar", palabra=palabra)
+
+
+if __name__ == "__main__":
+    import os
+    wk = Wordkers(os.environ.get("WORDKERS_KEY", ""))
+    print("silabear:", wk.silabear("murciélago"))
+    print("feminizar:", wk.feminizar("bueno", categoria="Adjetivos"))
+    print("es_invariable(cantante):", wk.es_invariable("cantante"))
+    print("pluralizar(luz):", wk.pluralizar("luz"))