oclib 0.0.1__tar.gz

oclib-0.0.1/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/PKG-INFO

@@ -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/README.md

@@ -0,0 +1,40 @@
+<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/pyproject.toml

@@ -0,0 +1,53 @@
+[build-system]
+requires = ["setuptools>=61.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "oclib"
+version = "0.0.1"
+description = "A multi-purpose library containing various helper functions and objects designed to accelerate the development of other applications."
+readme = "README.md"
+requires-python = ">=3.14"
+license = "MIT"
+license-files = ["LICENSE"]
+keywords = [
+    "mimic",
+    "ophitecorp",
+    "library",
+    "modules",
+    "utility",
+    "tools",
+    "helpers",
+]
+authors = [
+    { name = "Jiří Vik", email = "mimic2300@gmail.com" }
+]
+
+classifiers = [
+    "Topic :: Utilities",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+    "Development Status :: 4 - Beta",
+    "Operating System :: OS Independent",
+    "Intended Audience :: Developers",
+    "Intended Audience :: Information Technology",
+    "Natural Language :: Czech",
+    "Natural Language :: English",
+    "Programming Language :: Python :: 3.14",
+    "Typing :: Typed",
+]
+
+dependencies = [
+    "rich>=15.0.0"
+]
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.setuptools.package-data]
+oclib = [
+    "static/*",
+    "static/*/**",
+]
+
+[project.urls]
+"Repository" = "https://gitlab.com/OphiteCorp/pylib"

oclib-0.0.1/setup.cfg

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

oclib-0.0.1/src/oclib/__init__.py

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

oclib-0.0.1/src/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/src/oclib.egg-info/PKG-INFO

@@ -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/src/oclib.egg-info/SOURCES.txt

@@ -0,0 +1,11 @@
+LICENSE
+README.md
+pyproject.toml
+src/oclib/__init__.py
+src/oclib.egg-info/PKG-INFO
+src/oclib.egg-info/SOURCES.txt
+src/oclib.egg-info/dependency_links.txt
+src/oclib.egg-info/requires.txt
+src/oclib.egg-info/top_level.txt
+src/oclib/io/__init__.py
+src/oclib/io/formatter.py

oclib-0.0.1/src/oclib.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

oclib-0.0.1/src/oclib.egg-info/requires.txt

@@ -0,0 +1 @@
+rich>=15.0.0

oclib-0.0.1/src/oclib.egg-info/top_level.txt

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