chxlibrary 0.1.0__tar.gz

chxlibrary-0.1.0/LICENSE

@@ -0,0 +1,201 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   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
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   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.

chxlibrary-0.1.0/PKG-INFO

@@ -0,0 +1,129 @@
+Metadata-Version: 2.4
+Name: chxlibrary
+Version: 0.1.0
+Summary: Utilidades prácticas para Python: texto, números, fechas, archivos y funciones creativas.
+Author: programador777lolxddd-dot
+License: Apache-2.0
+Project-URL: Homepage, https://github.com/programador777lolxddd-dot/CHXlibrary
+Project-URL: Repository, https://github.com/programador777lolxddd-dot/CHXlibrary
+Project-URL: Issues, https://github.com/programador777lolxddd-dot/CHXlibrary/issues
+Keywords: python,utilidades,strings,números,fechas,archivos
+Classifier: Development Status :: 3 - 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.8
+Classifier: Programming Language :: Python :: 3.9
+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 :: Python Modules
+Classifier: Topic :: Utilities
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0; extra == "dev"
+Requires-Dist: build>=1.0; extra == "dev"
+Requires-Dist: ruff>=0.4; extra == "dev"
+Dynamic: license-file
+
+# CHXLibrary
+
+**CHXLibrary** es una pequeña colección de utilidades para Python, en español y sin dependencias externas de ejecución. Incluye funciones para trabajar con texto, números, fechas, archivos y herramientas creativas.
+
+- **Distribución en PyPI:** `chxlibrary`
+- **Módulo de importación:** `chrotrixurum`
+- **Versión actual del proyecto:** `0.1.0`
+- **Python:** 3.8 o superior
+- **Licencia:** Apache-2.0
+
+## Instalación
+
+Cuando la publicación esté disponible en PyPI:
+
+```bash
+python -m pip install chxlibrary
+```
+
+Para desarrollar desde este repositorio:
+
+```bash
+git clone https://github.com/programador777lolxddd-dot/CHXlibrary.git
+cd CHXlibrary
+python -m pip install -e ".[dev]"
+```
+
+## Inicio rápido
+
+```python
+import chrotrixurum as chx
+
+print(chx.slugify("Hola Mundo Ñandú!"))  # hola-mundo-nandu
+print(chx.snake_case("HolaMundoCruel"))  # hola_mundo_cruel
+print(chx.clamp(15, 0, 10))              # 10
+print(chx.is_prime(97))                  # True
+print(list(chx.fibonacci(6)))            # [0, 1, 1, 2, 3, 5]
+print(chx.human_size(1536))              # 1.5 KB
+print(chx.is_weekend())                  # True o False según la fecha actual
+```
+
+## Funciones disponibles
+
+### Texto
+- `slugify(text)`: convierte texto en un slug para URLs y elimina acentos.
+- `snake_case(text)`: convierte texto a `snake_case`.
+- `camel_case(text)`: convierte texto a `CamelCase`.
+- `truncate(text, length, suffix="…")`: limita la longitud de un texto.
+- `is_palindrome(text, ignore_case=True)`: comprueba si un texto es palíndromo.
+
+### Números
+- `clamp(value, lo, hi)`: limita un valor a un rango.
+- `lerp(a, b, t)`: interpolación lineal con `t` limitado entre 0 y 1.
+- `is_prime(n)`: comprueba si un entero es primo.
+- `fibonacci(n)`: genera los primeros `n` números de Fibonacci.
+- `percent(part, whole, decimals=1)`: devuelve un porcentaje formateado.
+
+### Fechas y tiempo
+- `humanize_delta(delta)`: expresa una diferencia temporal en español.
+- `days_between(a, b)`: calcula los días absolutos entre dos fechas.
+- `is_weekend(d=None)`: comprueba si una fecha es sábado o domingo.
+
+### Archivos
+- `human_size(bytes_)`: convierte bytes a una unidad legible.
+- `read_lines_safe(path)`: lee un archivo UTF-8 línea por línea.
+- `ensure_dir(path)`: crea un directorio y sus padres si hacen falta.
+
+### Herramientas creativas
+- `divine(question, seed=None)`: genera una respuesta aleatoria reproducible con semilla.
+- `sigil(text, length=12)`: genera un símbolo textual reproducible.
+- `palindrome_magic(text)`: devuelve un análisis lúdico de una frase.
+
+## Ejecutar la demostración
+
+```bash
+python -m chrotrixurum
+```
+
+También puedes usar el comando instalado:
+
+```bash
+chrotrixurum
+```
+
+## Pruebas
+
+```bash
+python -m pip install -e ".[dev]"
+python -m pytest
+```
+
+## Licencia
+
+Este proyecto se distribuye bajo la licencia **Apache License 2.0**. Consulta el archivo [LICENSE](LICENSE) para ver el texto completo.
+
+## Autor y contribuciones
+
+Creado por [programador777lolxddd-dot](https://github.com/programador777lolxddd-dot). Las sugerencias y reportes de errores se pueden enviar en [Issues](https://github.com/programador777lolxddd-dot/CHXlibrary/issues).

chxlibrary-0.1.0/README.md

@@ -0,0 +1,97 @@
+# CHXLibrary
+
+**CHXLibrary** es una pequeña colección de utilidades para Python, en español y sin dependencias externas de ejecución. Incluye funciones para trabajar con texto, números, fechas, archivos y herramientas creativas.
+
+- **Distribución en PyPI:** `chxlibrary`
+- **Módulo de importación:** `chrotrixurum`
+- **Versión actual del proyecto:** `0.1.0`
+- **Python:** 3.8 o superior
+- **Licencia:** Apache-2.0
+
+## Instalación
+
+Cuando la publicación esté disponible en PyPI:
+
+```bash
+python -m pip install chxlibrary
+```
+
+Para desarrollar desde este repositorio:
+
+```bash
+git clone https://github.com/programador777lolxddd-dot/CHXlibrary.git
+cd CHXlibrary
+python -m pip install -e ".[dev]"
+```
+
+## Inicio rápido
+
+```python
+import chrotrixurum as chx
+
+print(chx.slugify("Hola Mundo Ñandú!"))  # hola-mundo-nandu
+print(chx.snake_case("HolaMundoCruel"))  # hola_mundo_cruel
+print(chx.clamp(15, 0, 10))              # 10
+print(chx.is_prime(97))                  # True
+print(list(chx.fibonacci(6)))            # [0, 1, 1, 2, 3, 5]
+print(chx.human_size(1536))              # 1.5 KB
+print(chx.is_weekend())                  # True o False según la fecha actual
+```
+
+## Funciones disponibles
+
+### Texto
+- `slugify(text)`: convierte texto en un slug para URLs y elimina acentos.
+- `snake_case(text)`: convierte texto a `snake_case`.
+- `camel_case(text)`: convierte texto a `CamelCase`.
+- `truncate(text, length, suffix="…")`: limita la longitud de un texto.
+- `is_palindrome(text, ignore_case=True)`: comprueba si un texto es palíndromo.
+
+### Números
+- `clamp(value, lo, hi)`: limita un valor a un rango.
+- `lerp(a, b, t)`: interpolación lineal con `t` limitado entre 0 y 1.
+- `is_prime(n)`: comprueba si un entero es primo.
+- `fibonacci(n)`: genera los primeros `n` números de Fibonacci.
+- `percent(part, whole, decimals=1)`: devuelve un porcentaje formateado.
+
+### Fechas y tiempo
+- `humanize_delta(delta)`: expresa una diferencia temporal en español.
+- `days_between(a, b)`: calcula los días absolutos entre dos fechas.
+- `is_weekend(d=None)`: comprueba si una fecha es sábado o domingo.
+
+### Archivos
+- `human_size(bytes_)`: convierte bytes a una unidad legible.
+- `read_lines_safe(path)`: lee un archivo UTF-8 línea por línea.
+- `ensure_dir(path)`: crea un directorio y sus padres si hacen falta.
+
+### Herramientas creativas
+- `divine(question, seed=None)`: genera una respuesta aleatoria reproducible con semilla.
+- `sigil(text, length=12)`: genera un símbolo textual reproducible.
+- `palindrome_magic(text)`: devuelve un análisis lúdico de una frase.
+
+## Ejecutar la demostración
+
+```bash
+python -m chrotrixurum
+```
+
+También puedes usar el comando instalado:
+
+```bash
+chrotrixurum
+```
+
+## Pruebas
+
+```bash
+python -m pip install -e ".[dev]"
+python -m pytest
+```
+
+## Licencia
+
+Este proyecto se distribuye bajo la licencia **Apache License 2.0**. Consulta el archivo [LICENSE](LICENSE) para ver el texto completo.
+
+## Autor y contribuciones
+
+Creado por [programador777lolxddd-dot](https://github.com/programador777lolxddd-dot). Las sugerencias y reportes de errores se pueden enviar en [Issues](https://github.com/programador777lolxddd-dot/CHXlibrary/issues).

chxlibrary-0.1.0/chrotrixurum.py

@@ -0,0 +1,268 @@
+#!/usr/bin/env python3
+"""
+CHXLibrary — utilidades prácticas para Python.
+
+Uso como librería:
+    >>> import chrotrixurum as chx
+    >>> chx.slugify("Hola Mundo Ñandú")
+    'hola-mundo-nandu'
+
+Uso como script:
+    $ python -m chrotrixurum
+"""
+
+from __future__ import annotations
+
+import hashlib
+import random
+import re
+import unicodedata
+from datetime import date, datetime, timedelta
+from pathlib import Path
+from typing import Iterator, Union
+
+__version__ = "0.1.0"
+__all__ = [
+    "slugify", "snake_case", "camel_case", "truncate", "is_palindrome",
+    "clamp", "lerp", "is_prime", "fibonacci", "percent",
+    "humanize_delta", "days_between", "is_weekend",
+    "human_size", "read_lines_safe", "ensure_dir",
+    "divine", "sigil", "palindrome_magic", "main", "__version__",
+]
+
+
+# ---------------------------------------------------------------------
+# Strings
+# ---------------------------------------------------------------------
+def _strip_accents(text: str) -> str:
+    return "".join(
+        char for char in unicodedata.normalize("NFD", text)
+        if unicodedata.category(char) != "Mn"
+    )
+
+
+def slugify(text: str) -> str:
+    """Convierte texto en un slug apto para URLs."""
+    text = _strip_accents(text).lower()
+    text = re.sub(r"[^a-z0-9]+", "-", text)
+    return text.strip("-")
+
+
+def snake_case(text: str) -> str:
+    """Convierte CamelCase o texto libre a snake_case."""
+    text = re.sub(r"(.)([A-Z][a-z]+)", r"\1_\2", text)
+    text = re.sub(r"([a-z0-9])([A-Z])", r"\1_\2", text)
+    return re.sub(r"[\s\-]+", "_", text).lower().strip("_")
+
+
+def camel_case(text: str) -> str:
+    """Convierte texto separado por espacios, guiones o guiones bajos a CamelCase."""
+    parts = re.split(r"[_\-\s]+", text.strip())
+    return "".join(part.capitalize() for part in parts if part)
+
+
+def truncate(text: str, length: int, suffix: str = "…") -> str:
+    """Limita un texto a *length* caracteres, incluyendo el sufijo."""
+    if length < 0:
+        raise ValueError("length no puede ser negativo")
+    if length == 0:
+        return ""
+    if len(text) <= length:
+        return text
+    if length <= len(suffix):
+        return suffix[:length]
+    return text[: length - len(suffix)] + suffix
+
+
+def is_palindrome(text: str, ignore_case: bool = True) -> bool:
+    """Comprueba si un texto es palíndromo, ignorando espacios y signos."""
+    clean = re.sub(r"[^a-zA-Z0-9]", "", _strip_accents(text))
+    if ignore_case:
+        clean = clean.lower()
+    return clean == clean[::-1]
+
+
+# ---------------------------------------------------------------------
+# Numbers
+# ---------------------------------------------------------------------
+def clamp(value: float, lo: float, hi: float) -> float:
+    """Limita *value* al rango [lo, hi]. Si el rango está invertido, lo corrige."""
+    if lo > hi:
+        lo, hi = hi, lo
+    return max(lo, min(hi, value))
+
+
+def lerp(a: float, b: float, t: float) -> float:
+    """Interpola linealmente entre *a* y *b*, limitando *t* al rango [0, 1]."""
+    return a + (b - a) * clamp(t, 0.0, 1.0)
+
+
+def is_prime(n: int) -> bool:
+    """Devuelve True si *n* es un número primo."""
+    if n < 2:
+        return False
+    if n in (2, 3):
+        return True
+    if n % 2 == 0 or n % 3 == 0:
+        return False
+    divisor = 5
+    while divisor * divisor <= n:
+        if n % divisor == 0 or n % (divisor + 2) == 0:
+            return False
+        divisor += 6
+    return True
+
+
+def fibonacci(n: int) -> Iterator[int]:
+    """Genera los primeros *n* números de Fibonacci."""
+    if n < 0:
+        raise ValueError("n no puede ser negativo")
+    a, b = 0, 1
+    for _ in range(n):
+        yield a
+        a, b = b, a + b
+
+
+def percent(part: float, whole: float, decimals: int = 1) -> str:
+    """Devuelve *part* como porcentaje de *whole*, formateado como texto."""
+    if decimals < 0:
+        raise ValueError("decimals no puede ser negativo")
+    if whole == 0:
+        return "0%"
+    return f"{part / whole * 100:.{decimals}f}%"
+
+
+# ---------------------------------------------------------------------
+# Dates
+# ---------------------------------------------------------------------
+def humanize_delta(delta: timedelta) -> str:
+    """Convierte una diferencia temporal en una frase en español.
+
+    Una diferencia positiva se interpreta como tiempo futuro; una negativa,
+    como tiempo pasado.
+    """
+    total_seconds = delta.total_seconds()
+    seconds = int(abs(total_seconds))
+    future = total_seconds >= 0
+    units = [
+        ("año", 365 * 24 * 3600), ("mes", 30 * 24 * 3600),
+        ("día", 24 * 3600), ("hora", 3600), ("minuto", 60),
+        ("segundo", 1),
+    ]
+    for name, unit_seconds in units:
+        if seconds >= unit_seconds:
+            count = seconds // unit_seconds
+            plural = "s" if count != 1 else ""
+            label = f"{count} {name}{plural}"
+            return f"{'dentro de' if future else 'hace'} {label}"
+    return "ahora mismo"
+
+
+def days_between(a: date, b: date) -> int:
+    """Devuelve el número absoluto de días entre dos fechas."""
+    return abs((b - a).days)
+
+
+def is_weekend(d: Union[date, datetime, None] = None) -> bool:
+    """Comprueba si una fecha es sábado o domingo; por defecto usa hoy."""
+    d = d or date.today()
+    return d.weekday() >= 5
+
+
+# ---------------------------------------------------------------------
+# Files
+# ---------------------------------------------------------------------
+def human_size(bytes_: int) -> str:
+    """Convierte una cantidad de bytes a una unidad legible."""
+    if bytes_ < 0:
+        raise ValueError("bytes_ no puede ser negativo")
+    units = ["B", "KB", "MB", "GB", "TB", "PB"]
+    size = float(bytes_)
+    for unit in units:
+        if size < 1024 or unit == units[-1]:
+            return f"{size:.1f} {unit}"
+        size /= 1024
+    return f"{size:.1f} PB"
+
+
+def read_lines_safe(path: Union[str, Path]) -> Iterator[str]:
+    """Lee un archivo UTF-8 línea por línea, reemplazando bytes inválidos."""
+    with Path(path).open("r", encoding="utf-8", errors="replace") as file:
+        for line in file:
+            yield line.rstrip("\r\n")
+
+
+def ensure_dir(path: Union[str, Path]) -> Path:
+    """Crea un directorio y sus padres si no existen, y devuelve su ruta."""
+    directory = Path(path)
+    directory.mkdir(parents=True, exist_ok=True)
+    return directory
+
+
+# ---------------------------------------------------------------------
+# Creative utilities
+# ---------------------------------------------------------------------
+_SIGILS = "⛧⛥✧✦✩✶✷✸❂☽☾♆♇♄♅⛤"
+
+
+def divine(question: str, seed: Union[int, None] = None) -> str:
+    """Genera una respuesta creativa; con la misma semilla es reproducible."""
+    rng = random.Random(seed if seed is not None else question)
+    answers = [
+        "sí, sin duda.", "es posible.", "los astros guardan silencio.",
+        "no cuentes con ello.", "sí, pero con esfuerzo.",
+        "pregunta de nuevo más tarde.", "definitivamente no.",
+        "las señales apuntan a que sí.",
+    ]
+    return f"Los astros susurran: {rng.choice(answers)}"
+
+
+def sigil(text: str, length: int = 12) -> str:
+    """Genera un sigilo reproducible a partir de un texto."""
+    if length < 0:
+        raise ValueError("length no puede ser negativo")
+    digest = hashlib.sha256(text.encode("utf-8")).digest()
+    rng = random.Random(digest)
+    return "".join(rng.choice(_SIGILS) for _ in range(length))
+
+
+def palindrome_magic(text: str) -> dict:
+    """Devuelve un análisis lúdico de una frase y su posible palíndromo."""
+    clean = re.sub(r"[^a-zA-Z0-9]", "", _strip_accents(text)).lower()
+    is_pal = clean == clean[::-1]
+    if is_pal:
+        verdict = f"{sigil(text)} Los ecos se repiten. Karma elevado."
+    else:
+        verdict = f"{sigil(text)} Los ecos se dispersan. Karma terrenal."
+    return {
+        "texto": text,
+        "limpio": clean,
+        "es_palindromo": is_pal,
+        "longitud": len(clean),
+        "karma": "elevado" if is_pal else "terrenal",
+        "veredicto": verdict,
+    }
+
+
+def main() -> None:
+    """Ejecuta una demostración breve de las funciones principales."""
+    print(f"CHXLibrary v{__version__}\n")
+    print("slugify :", slugify("Hola Mundo Ñandú!"))
+    print("snake   :", snake_case("HolaMundoCruel"))
+    print("camel   :", camel_case("hola mundo cruel"))
+    print("truncate:", truncate("Chrotrixurum eterno", 10))
+    print("palindr :", is_palindrome("Anita lava la tina"))
+    print("clamp   :", clamp(15, 0, 10))
+    print("lerp    :", lerp(0, 10, 0.5))
+    print("primo97 :", is_prime(97))
+    print("fib(6)  :", list(fibonacci(6)))
+    print("percent :", percent(1, 4))
+    print("size    :", human_size(1536))
+    print("delta   :", humanize_delta(timedelta(hours=3, minutes=20)))
+    print("weekend :", is_weekend(date(2024, 1, 6)))
+    print("divine  :", divine("¿Aprobaré el examen?"))
+    print("sigil   :", sigil("chxlibrary"))
+
+
+if __name__ == "__main__":
+    main()

chxlibrary-0.1.0/chxlibrary.egg-info/PKG-INFO

@@ -0,0 +1,129 @@
+Metadata-Version: 2.4
+Name: chxlibrary
+Version: 0.1.0
+Summary: Utilidades prácticas para Python: texto, números, fechas, archivos y funciones creativas.
+Author: programador777lolxddd-dot
+License: Apache-2.0
+Project-URL: Homepage, https://github.com/programador777lolxddd-dot/CHXlibrary
+Project-URL: Repository, https://github.com/programador777lolxddd-dot/CHXlibrary
+Project-URL: Issues, https://github.com/programador777lolxddd-dot/CHXlibrary/issues
+Keywords: python,utilidades,strings,números,fechas,archivos
+Classifier: Development Status :: 3 - 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.8
+Classifier: Programming Language :: Python :: 3.9
+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 :: Python Modules
+Classifier: Topic :: Utilities
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0; extra == "dev"
+Requires-Dist: build>=1.0; extra == "dev"
+Requires-Dist: ruff>=0.4; extra == "dev"
+Dynamic: license-file
+
+# CHXLibrary
+
+**CHXLibrary** es una pequeña colección de utilidades para Python, en español y sin dependencias externas de ejecución. Incluye funciones para trabajar con texto, números, fechas, archivos y herramientas creativas.
+
+- **Distribución en PyPI:** `chxlibrary`
+- **Módulo de importación:** `chrotrixurum`
+- **Versión actual del proyecto:** `0.1.0`
+- **Python:** 3.8 o superior
+- **Licencia:** Apache-2.0
+
+## Instalación
+
+Cuando la publicación esté disponible en PyPI:
+
+```bash
+python -m pip install chxlibrary
+```
+
+Para desarrollar desde este repositorio:
+
+```bash
+git clone https://github.com/programador777lolxddd-dot/CHXlibrary.git
+cd CHXlibrary
+python -m pip install -e ".[dev]"
+```
+
+## Inicio rápido
+
+```python
+import chrotrixurum as chx
+
+print(chx.slugify("Hola Mundo Ñandú!"))  # hola-mundo-nandu
+print(chx.snake_case("HolaMundoCruel"))  # hola_mundo_cruel
+print(chx.clamp(15, 0, 10))              # 10
+print(chx.is_prime(97))                  # True
+print(list(chx.fibonacci(6)))            # [0, 1, 1, 2, 3, 5]
+print(chx.human_size(1536))              # 1.5 KB
+print(chx.is_weekend())                  # True o False según la fecha actual
+```
+
+## Funciones disponibles
+
+### Texto
+- `slugify(text)`: convierte texto en un slug para URLs y elimina acentos.
+- `snake_case(text)`: convierte texto a `snake_case`.
+- `camel_case(text)`: convierte texto a `CamelCase`.
+- `truncate(text, length, suffix="…")`: limita la longitud de un texto.
+- `is_palindrome(text, ignore_case=True)`: comprueba si un texto es palíndromo.
+
+### Números
+- `clamp(value, lo, hi)`: limita un valor a un rango.
+- `lerp(a, b, t)`: interpolación lineal con `t` limitado entre 0 y 1.
+- `is_prime(n)`: comprueba si un entero es primo.
+- `fibonacci(n)`: genera los primeros `n` números de Fibonacci.
+- `percent(part, whole, decimals=1)`: devuelve un porcentaje formateado.
+
+### Fechas y tiempo
+- `humanize_delta(delta)`: expresa una diferencia temporal en español.
+- `days_between(a, b)`: calcula los días absolutos entre dos fechas.
+- `is_weekend(d=None)`: comprueba si una fecha es sábado o domingo.
+
+### Archivos
+- `human_size(bytes_)`: convierte bytes a una unidad legible.
+- `read_lines_safe(path)`: lee un archivo UTF-8 línea por línea.
+- `ensure_dir(path)`: crea un directorio y sus padres si hacen falta.
+
+### Herramientas creativas
+- `divine(question, seed=None)`: genera una respuesta aleatoria reproducible con semilla.
+- `sigil(text, length=12)`: genera un símbolo textual reproducible.
+- `palindrome_magic(text)`: devuelve un análisis lúdico de una frase.
+
+## Ejecutar la demostración
+
+```bash
+python -m chrotrixurum
+```
+
+También puedes usar el comando instalado:
+
+```bash
+chrotrixurum
+```
+
+## Pruebas
+
+```bash
+python -m pip install -e ".[dev]"
+python -m pytest
+```
+
+## Licencia
+
+Este proyecto se distribuye bajo la licencia **Apache License 2.0**. Consulta el archivo [LICENSE](LICENSE) para ver el texto completo.
+
+## Autor y contribuciones
+
+Creado por [programador777lolxddd-dot](https://github.com/programador777lolxddd-dot). Las sugerencias y reportes de errores se pueden enviar en [Issues](https://github.com/programador777lolxddd-dot/CHXlibrary/issues).

chxlibrary-0.1.0/chxlibrary.egg-info/SOURCES.txt

@@ -0,0 +1,11 @@
+LICENSE
+README.md
+chrotrixurum.py
+pyproject.toml
+chxlibrary.egg-info/PKG-INFO
+chxlibrary.egg-info/SOURCES.txt
+chxlibrary.egg-info/dependency_links.txt
+chxlibrary.egg-info/entry_points.txt
+chxlibrary.egg-info/requires.txt
+chxlibrary.egg-info/top_level.txt
+tests/test_chrotrixurum.py

chxlibrary-0.1.0/chxlibrary.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

chxlibrary-0.1.0/chxlibrary.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+chrotrixurum = chrotrixurum:main

chxlibrary-0.1.0/chxlibrary.egg-info/requires.txt

@@ -0,0 +1,5 @@
+
+[dev]
+pytest>=7.0
+build>=1.0
+ruff>=0.4

chxlibrary-0.1.0/chxlibrary.egg-info/top_level.txt

@@ -0,0 +1 @@
+chrotrixurum

chxlibrary-0.1.0/pyproject.toml

@@ -0,0 +1,53 @@
+[build-system]
+requires = ["setuptools>=68", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "chxlibrary"
+version = "0.1.0"
+description = "Utilidades prácticas para Python: texto, números, fechas, archivos y funciones creativas."
+readme = "README.md"
+requires-python = ">=3.8"
+license = { text = "Apache-2.0" }
+authors = [
+    { name = "programador777lolxddd-dot" },
+]
+keywords = ["python", "utilidades", "strings", "números", "fechas", "archivos"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: Apache Software License",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.8",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+    "Topic :: Utilities",
+]
+
+[project.urls]
+Homepage = "https://github.com/programador777lolxddd-dot/CHXlibrary"
+Repository = "https://github.com/programador777lolxddd-dot/CHXlibrary"
+Issues = "https://github.com/programador777lolxddd-dot/CHXlibrary/issues"
+
+[project.optional-dependencies]
+dev = ["pytest>=7.0", "build>=1.0", "ruff>=0.4"]
+
+[project.scripts]
+chrotrixurum = "chrotrixurum:main"
+
+[tool.setuptools]
+py-modules = ["chrotrixurum"]
+
+[tool.ruff]
+line-length = 88
+target-version = "py38"
+
+[tool.pytest.ini_options]
+minversion = "7.0"
+addopts = "-ra"
+testpaths = ["tests"]

chxlibrary-0.1.0/setup.cfg

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

chxlibrary-0.1.0/tests/test_chrotrixurum.py

@@ -0,0 +1,82 @@
+from datetime import date, datetime, timedelta
+
+import pytest
+
+import chrotrixurum as chx
+
+
+def test_slugify_handles_accents_and_punctuation():
+    assert chx.slugify("¡Hola Mundo Ñandú!") == "hola-mundo-nandu"
+
+
+def test_case_conversions():
+    assert chx.snake_case("HolaMundoCruel") == "hola_mundo_cruel"
+    assert chx.camel_case("hola mundo_cruel") == "HolaMundoCruel"
+
+
+def test_truncate_includes_suffix_in_limit():
+    assert chx.truncate("Chrotrixurum eterno", 10) == "Chrotrixu…"
+    assert chx.truncate("corto", 10) == "corto"
+    assert chx.truncate("texto", 0) == ""
+    with pytest.raises(ValueError):
+        chx.truncate("texto", -1)
+
+
+def test_palindrome_ignores_spaces_and_punctuation():
+    assert chx.is_palindrome("Anita lava la tina")
+    assert not chx.is_palindrome("Python")
+
+
+def test_number_helpers():
+    assert chx.clamp(15, 0, 10) == 10
+    assert chx.clamp(5, 10, 0) == 5
+    assert chx.lerp(0, 10, 0.5) == 5
+    assert chx.is_prime(97)
+    assert not chx.is_prime(1)
+    assert list(chx.fibonacci(6)) == [0, 1, 1, 2, 3, 5]
+    with pytest.raises(ValueError):
+        list(chx.fibonacci(-1))
+
+
+def test_percent():
+    assert chx.percent(1, 4) == "25.0%"
+    assert chx.percent(1, 0) == "0%"
+    with pytest.raises(ValueError):
+        chx.percent(1, 4, decimals=-1)
+
+
+def test_dates():
+    assert chx.days_between(date(2024, 1, 1), date(2024, 1, 10)) == 9
+    assert chx.is_weekend(date(2024, 1, 6))
+    assert not chx.is_weekend(date(2024, 1, 8))
+    assert chx.humanize_delta(timedelta(hours=3)) == "dentro de 3 horas"
+    assert chx.humanize_delta(timedelta(hours=-3)) == "hace 3 horas"
+    assert chx.humanize_delta(timedelta(seconds=0)) == "ahora mismo"
+
+
+def test_file_helpers(tmp_path):
+    assert chx.human_size(1536) == "1.5 KB"
+    with pytest.raises(ValueError):
+        chx.human_size(-1)
+
+    path = tmp_path / "nested" / "example.txt"
+    chx.ensure_dir(path.parent)
+    path.write_text("uno\ndos\n", encoding="utf-8")
+    assert list(chx.read_lines_safe(path)) == ["uno", "dos"]
+    assert chx.ensure_dir(path.parent) == path.parent
+
+
+def test_creative_helpers_are_reproducible():
+    assert chx.divine("pregunta", seed=42) == chx.divine("pregunta", seed=42)
+    assert chx.sigil("texto", 8) == chx.sigil("texto", 8)
+    assert len(chx.sigil("texto", 8)) == 8
+    with pytest.raises(ValueError):
+        chx.sigil("texto", -1)
+    result = chx.palindrome_magic("Anita lava la tina")
+    assert result["es_palindromo"] is True
+    assert result["karma"] == "elevado"
+
+
+def test_version_and_cli_entrypoint_exist():
+    assert chx.__version__ == "0.1.0"
+    assert callable(chx.main)