oclib 0.0.1__py3-none-any.whl

oclib/__init__.py

@@ -0,0 +1,6 @@
+from .io.formatter import format_size
+
+__version__ = "0.0.1"
+__all__ = [
+    "format_size",
+]

oclib/io/formatter.py

@@ -0,0 +1,35 @@
+FORMAT_SIZE_UNITS: tuple[str, ...] = ("B", "KB", "MB", "GB", "TB", "PB", "EB", "ZB", "YB")
+
+
+def format_size(size_input: float | bytes | bytearray | memoryview, precision: int = 1) -> str:
+    """Formátuje velikost v bytech nebo binární objekt do lidsky čitelné podoby.
+
+    Parametry:
+        size_input (int | float | bytes | bytearray | memoryview): Velikost v bytech nebo binární data.
+        precision (int): Počet desetinných míst pro zaokrouhlení.
+
+    Vrací:
+        str: Lidsky čitelný řetězec obsahující formátovanou hodnotu a příslušnou jednotku.
+    """
+
+    if isinstance(size_input, (bytes, bytearray, memoryview)):
+        size_bytes = float(len(size_input))
+    elif isinstance(size_input, (int, float)):
+        size_bytes = float(size_input)
+    else:
+        raise TypeError(f"Detekován typ '{type(size_input).__name__}'. Předat instanci typu int, float, bytes, bytearray nebo memoryview.")
+
+    precision = max(0, precision)
+    size_bytes = max(0.0, size_bytes)
+    
+    unit_index: int = 0
+    size_val: float = size_bytes
+
+    while size_val >= 1024 and unit_index < len(FORMAT_SIZE_UNITS) - 1:
+        size_val /= 1024
+        unit_index += 1
+
+    # U bajtů 'B' nedávají desetinná místa smysl, proto pro jednotku 'B' vynutíme 0 desetinných míst
+    effective_precision = 0 if unit_index == 0 else precision
+
+    return f"{size_val:.{effective_precision}f} {FORMAT_SIZE_UNITS[unit_index]}"

oclib-0.0.1.dist-info/METADATA

@@ -0,0 +1,64 @@
+Metadata-Version: 2.4
+Name: oclib
+Version: 0.0.1
+Summary: A multi-purpose library containing various helper functions and objects designed to accelerate the development of other applications.
+Author-email: Jiří Vik <mimic2300@gmail.com>
+License-Expression: MIT
+Project-URL: Repository, https://gitlab.com/OphiteCorp/pylib
+Keywords: mimic,ophitecorp,library,modules,utility,tools,helpers
+Classifier: Topic :: Utilities
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Development Status :: 4 - Beta
+Classifier: Operating System :: OS Independent
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Information Technology
+Classifier: Natural Language :: Czech
+Classifier: Natural Language :: English
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Typing :: Typed
+Requires-Python: >=3.14
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: rich>=15.0.0
+Dynamic: license-file
+
+<p align="center">
+  <img src="https://gitlab.com/OphiteCorp/pylib/-/raw/main/logo.png" alt="logo" width="50%">
+</p>
+
+**oclib** je univerzální Python knihovna navržená pro maximální urychlení vývoje, eliminaci duplicity kódu a poskytnutí jednotné aplikační logiky napříč různými projekty.
+
+Knihovna sdružuje znovupoužitelné pomocné funkce, sdílené datové modely, pokročilé objekty a konzistentní obslužné utility. Místo opakovaného psaní obdobného kódu v každé aplikaci stačí importovat **oblib** a využívat prověřená řešení pro běžné i složitější úlohy.
+
+<p align="center">
+  <img src="https://gitlab.com/OphiteCorp/pylib/-/raw/main/donate.png" alt="donate" width="200px">
+  <br/>
+  <strong>❤️ <a href="https://www.paypal.com/donate/?hosted_button_id=BGUBNNAMCSHFL" target="_blank">Poděkuj | Donate | Buy me a coffee</a> ❤️</strong>
+</p>
+
+---
+
+## 📦 Instalace
+
+**Je potřeba mít verzi Python 3.14 a vyšší!**
+
+Knihovnu lze nainstalovat přímo z PyPI přes **pip**. Stačí stáhnou **Python install manager** a poté:
+
+```bash
+pip install oclib
+```
+
+Pokud bude potřeba udělat jen aktualizaci tak:
+```bash
+pip install --upgrade --no-cache-dir oclib
+```
+Parametr `--no-cache-dir` je tam proto, aby pip nepodstrčil starší verzi z disku, ale skutečně se stáhla poslední.
+
+---
+
+## 🚀 Moduly
+Kategorie a moduly, které je možné importovat.
+Příklad použití pro první je `from oclib import format_size`. Podobně to bude i u jiných.
+
+#### IO
+- **format_size** - funkce pro formátování velikosti dat (binární standard base 1024). Ideální na zobrazení velikosti souborů nebo datových struktur v aplikacích.

oclib-0.0.1.dist-info/RECORD

@@ -0,0 +1,8 @@
+oclib/__init__.py,sha256=_DgMU8HHIm1X_M2hyKjT0RYhm2WXakJ1Z18QoUXBxGs,94
+oclib/io/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+oclib/io/formatter.py,sha256=5xODu5IIpZoGNGOW8n0eBopXSPVRtWz6TlM-uKnok2I,1446
+oclib-0.0.1.dist-info/licenses/LICENSE,sha256=ewGU6UKUCqOv_fc1OHOlKMTyZw0G-id1xFGIGxvRuy8,1066
+oclib-0.0.1.dist-info/METADATA,sha256=ytHaJ8exTRCHwSa5F27XMO0ipPd7UZUIAo94VMEJU-w,2675
+oclib-0.0.1.dist-info/WHEEL,sha256=YVMoNqKzERt-wjUZwJ33xBGAwnFl-4cqbYkTtWa4itE,91
+oclib-0.0.1.dist-info/top_level.txt,sha256=2MSKu2hGPSlng8lYDgFjJYeQDCQKxLFWHBw0C-WqYRc,6
+oclib-0.0.1.dist-info/RECORD,,

oclib-0.0.1.dist-info/WHEEL

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

oclib-0.0.1.dist-info/licenses/LICENSE

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

oclib-0.0.1.dist-info/top_level.txt

@@ -0,0 +1 @@
+oclib