slugread 0.1.0__py3-none-any.whl

slugread/__init__.py

@@ -0,0 +1,48 @@
+"""Tiny text helpers: slugify, truncate, word_count, reading_time."""
+
+import math
+import re
+import unicodedata
+
+__all__ = ["slugify", "truncate", "word_count", "reading_time"]
+__version__ = "0.1.0"
+
+_MARKS = re.compile("[\u0300-\u036f]")
+_NON_ALNUM = re.compile("[^a-z0-9]+")
+# Letters NFD can't split into base + accent: ß æ ø œ đ ł.
+_TRANSLIT = str.maketrans(
+    {"ß": "ss", "æ": "ae", "ø": "o", "œ": "oe", "đ": "d", "ł": "l"}
+)
+# Same whitespace set as Rust's char::is_whitespace, so all languages split identically.
+_WS = re.compile("[\t-\r \x85\xa0\u1680\u2000-\u200a\u2028\u2029\u202f\u205f\u3000]+")
+_CJK = re.compile(
+    "[\u3040-\u30ff\u3400-\u4dbf\u4e00-\u9fff\uf900-\ufaff\U00020000-\U0002ffff]"
+)
+
+
+def slugify(text: str) -> str:
+    """Lowercase, strip accents (ß→ss, æ→ae, ø→o, œ→oe, đ→d, ł→l), turn every run
+    of non [a-z0-9] into '-', trim '-'."""
+    text = _MARKS.sub("", unicodedata.normalize("NFD", text.lower())).translate(_TRANSLIT)
+    return _NON_ALNUM.sub("-", text).strip("-")
+
+
+def truncate(text: str, n: int) -> str:
+    """Cut to n characters and append an ellipsis if anything was cut."""
+    if n < 0:
+        raise ValueError("n must be >= 0")
+    return text[:n] + "\u2026" if len(text) > n else text
+
+
+def word_count(text: str) -> int:
+    """Count words; each CJK character (Han, Hiragana, Katakana) counts as one."""
+    cjk = len(_CJK.findall(text))
+    rest = _WS.split(_CJK.sub(" ", text))
+    return cjk + sum(any(c.isalnum() for c in w) for w in rest)
+
+
+def reading_time(text: str, wpm: int = 200) -> int:
+    """Minutes to read text at wpm words per minute, rounded up."""
+    if wpm <= 0:
+        raise ValueError("wpm must be > 0")
+    return math.ceil(word_count(text) / wpm)

slugread-0.1.0.dist-info/METADATA

@@ -0,0 +1,37 @@
+Metadata-Version: 2.5
+Name: slugread
+Version: 0.1.0
+Summary: Tiny zero-dependency text helpers: slugify, truncate, word_count, reading_time.
+Project-URL: Source, https://github.com/VinsOrl/_alg/tree/main/homework/slugread
+Author: VinsOrl
+License-Expression: MIT
+License-File: LICENSE
+Keywords: reading-time,slug,slugify,truncate,word-count
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Text Processing
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+
+# slugread
+
+Tiny zero-dependency text helpers. Same behavior in Python, JavaScript and Rust.
+
+```bash
+pip install slugread
+```
+
+```python
+from slugread import slugify, truncate, word_count, reading_time
+
+slugify("Crème Brûlée!")        # 'creme-brulee'
+truncate("Hello world", 5)      # 'Hello…'
+word_count("我爱Rust和Python")   # 5  (each CJK character is one word)
+reading_time("one two three", 2) # 2  (minutes, rounded up; default wpm=200)
+```
+
+- `slugify` keeps only `a-z0-9` after stripping accents (`ß`→`ss`, `æ`→`ae`, `ø`→`o`, `œ`→`oe`, `đ`→`d`, `ł`→`l`); other characters become `-`.
+- `truncate` counts Unicode code points; `n` must be `>= 0`.
+- `reading_time` needs `wpm > 0`.
+
+MIT license.

slugread-0.1.0.dist-info/RECORD

@@ -0,0 +1,5 @@
+slugread/__init__.py,sha256=0Zh7mZO-4l9pJ0I-Y0xiojVqxpxvFvP5IEe_w-4CD9I,1757
+slugread-0.1.0.dist-info/METADATA,sha256=utwZ7a4M2gk_zR5VfkMJRXb-XrV6nUfGn88fREzC8ac,1264
+slugread-0.1.0.dist-info/WHEEL,sha256=2iZrJkDIkeDh0k9SikKMqFuRP-ua6mb4Ir1AsER4BEw,87
+slugread-0.1.0.dist-info/licenses/LICENSE,sha256=l3ylGIkEY2vV3PzTZcvtaL1utu8ZrQiaJ1bTN625ghE,1064
+slugread-0.1.0.dist-info/RECORD,,

slugread-0.1.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.33.0
+Root-Is-Purelib: true
+Tag: py3-none-any

slugread-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 VinsOrl
+
+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.