filecreator 0.1.0__tar.gz

filecreator-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Богдан Полтавский
+
+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.

filecreator-0.1.0/PKG-INFO

@@ -0,0 +1,38 @@
+Metadata-Version: 2.5
+Name: filecreator
+Version: 0.1.0
+Summary: Удобная библиотека для создания файлов разных форматов
+Project-URL: Homepage, https://github.com/bogpolt/filecreator
+Project-URL: Repository, https://github.com/bogpolt/filecreator
+Project-URL: Issues, https://github.com/bogpolt/filecreator/issues
+Author-email: Богдан Полтавский <bogpolt@gmail.com>
+License: MIT
+License-File: LICENSE
+Keywords: create,csv,file,json,txt,utility
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.7
+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: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Utilities
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+
+# filecreator
+
+📄 Удобная библиотека на Python для создания файлов разных форматов.
+Функция `createfile()` сама определяет формат по расширению файла.
+
+**Автор:** Богдан Полтавский (bogpolt@gmail.com)
+
+## Установка
+
+```bash
+pip install filecreator

filecreator-0.1.0/README.md

@@ -0,0 +1,11 @@
+# filecreator
+
+📄 Удобная библиотека на Python для создания файлов разных форматов.
+Функция `createfile()` сама определяет формат по расширению файла.
+
+**Автор:** Богдан Полтавский (bogpolt@gmail.com)
+
+## Установка
+
+```bash
+pip install filecreator

filecreator-0.1.0/filecreator/__init__.py

@@ -0,0 +1,4 @@
+from .createfile import createfile, readfile, deletefile
+
+__version__ = "0.1.0"
+__all__ = ["createfile", "readfile", "deletefile"]

filecreator-0.1.0/filecreator/createfile.py

@@ -0,0 +1,142 @@
+"""
+Универсальный создатель файлов.
+Функция createfile() сама определяет формат по расширению файла.
+"""
+
+import json
+import csv
+from pathlib import Path
+
+__all__ = ["createfile", "readfile", "deletefile"]
+
+
+def createfile(
+    name: str,
+    content=None,
+    encoding: str = "utf-8",
+    append: bool = False,
+    indent: int = 4,
+    delimiter: str = ",",
+    headers: list = None,
+    ensure_ascii: bool = False,
+    overwrite: bool = True,
+    **kwargs
+):
+    """
+    Создаёт файл с автоматическим определением формата по расширению.
+
+    Параметры:
+    ----------
+    name : str
+        Путь к файлу (например: "data/info.json").
+    content : any
+        Содержимое файла:
+          - str  → для .txt, .md, .html, .py и т.д.
+          - dict/list → для .json
+          - list[list] / list[dict] → для .csv
+          - bytes → для бинарных файлов (.bin, .png и т.д.)
+    encoding : str
+        Кодировка для текстовых файлов.
+    append : bool
+        Дописать в конец, а не перезаписывать (для текстовых).
+    indent : int
+        Отступ для JSON.
+    delimiter : str
+        Разделитель для CSV.
+    headers : list
+        Заголовки для CSV (если content — список списков).
+    ensure_ascii : bool
+        Для JSON: экранировать ли не-ASCII символы.
+    overwrite : bool
+        Если False и файл существует — выбросит ошибку.
+
+    Возвращает:
+    -----------
+    Path — путь к созданному файлу.
+    """
+
+    path = Path(name)
+
+    # Проверка на перезапись
+    if path.exists() and not overwrite and not append:
+        raise FileExistsError(f"Файл уже существует: {path}")
+
+    # Создаём родительские папки
+    if path.parent and not path.parent.exists():
+        path.parent.mkdir(parents=True, exist_ok=True)
+
+    ext = path.suffix.lower()
+
+    # === JSON ===
+    if ext == ".json":
+        if content is None:
+            content = {}
+        with open(path, "w", encoding=encoding) as f:
+            json.dump(content, f, indent=indent, ensure_ascii=ensure_ascii)
+        return path
+
+    # === CSV ===
+    if ext == ".csv":
+        mode = "a" if append else "w"
+        with open(path, mode, encoding=encoding, newline="") as f:
+            writer = csv.writer(f, delimiter=delimiter)
+
+            # Если это список словарей
+            if content and isinstance(content, list) and isinstance(content[0], dict):
+                fieldnames = headers or list(content[0].keys())
+                dict_writer = csv.DictWriter(f, fieldnames=fieldnames, delimiter=delimiter)
+                if not append:
+                    dict_writer.writeheader()
+                dict_writer.writerows(content)
+            else:
+                if headers and not append:
+                    writer.writerow(headers)
+                if content:
+                    writer.writerows(content)
+        return path
+
+    # === Бинарные файлы ===
+    if isinstance(content, (bytes, bytearray)):
+        with open(path, "wb") as f:
+            f.write(content)
+        return path
+
+    # === Текстовые (txt, md, html, py, log и т.д.) ===
+    mode = "a" if append else "w"
+    text = "" if content is None else str(content)
+    with open(path, mode, encoding=encoding) as f:
+        f.write(text)
+    return path
+
+
+def readfile(name: str, encoding: str = "utf-8"):
+    """Читает файл, определяя формат по расширению."""
+    path = Path(name)
+    if not path.exists():
+        raise FileNotFoundError(f"Файл не найден: {path}")
+
+    ext = path.suffix.lower()
+
+    if ext == ".json":
+        with open(path, "r", encoding=encoding) as f:
+            return json.load(f)
+
+    if ext == ".csv":
+        with open(path, "r", encoding=encoding, newline="") as f:
+            return list(csv.reader(f))
+
+    try:
+        with open(path, "r", encoding=encoding) as f:
+            return f.read()
+    except UnicodeDecodeError:
+        with open(path, "rb") as f:
+            return f.read()
+
+
+def deletefile(name: str) -> bool:
+    """Удаляет файл. Возвращает True, если удалил."""
+    path = Path(name)
+    if path.exists():
+        path.unlink()
+        return True
+    return False

filecreator-0.1.0/pyproject.toml

@@ -0,0 +1,38 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "filecreator"
+version = "0.1.0"
+authors = [
+  { name = "Богдан Полтавский", email = "bogpolt@gmail.com" },
+]
+description = "Удобная библиотека для создания файлов разных форматов"
+readme = "README.md"
+requires-python = ">=3.7"
+license = { text = "MIT" }
+keywords = ["file", "create", "json", "csv", "txt", "utility"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.7",
+    "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",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+    "Topic :: Utilities",
+]
+
+[project.urls]
+Homepage = "https://github.com/bogpolt/filecreator"
+Repository = "https://github.com/bogpolt/filecreator"
+Issues = "https://github.com/bogpolt/filecreator/issues"
+
+[tool.hatch.build.targets.wheel]
+packages = ["filecreator"]

filecreator-0.1.0/test.py

@@ -0,0 +1,91 @@
+"""
+Простой ручной тест библиотеки filecreator.
+Запуск: python example.py
+"""
+
+from filecreator import createfile, readfile, deletefile
+from pathlib import Path
+
+
+def main():
+    print("=" * 50)
+    print("🧪 Тест библиотеки filecreator")
+    print("=" * 50)
+
+    # --- 1. Текстовый файл ---
+    print("\n1️⃣  Создаём текстовый файл...")
+    p = createfile(name="test_output/hello.txt", content="Привет, мир!")
+    print(f"   ✅ Создан: {p}")
+    print(f"   📖 Прочитан: {readfile(p)}")
+
+    # --- 2. JSON ---
+    print("\n2️⃣  Создаём JSON...")
+    data = {"name": "Богдан", "age": 25, "skills": ["Python", "SQL"]}
+    p = createfile(name="test_output/user.json", content=data)
+    print(f"   ✅ Создан: {p}")
+    print(f"   📖 Прочитан: {readfile(p)}")
+
+    # --- 3. CSV из списка списков ---
+    print("\n3️⃣  Создаём CSV (список списков)...")
+    p = createfile(
+        name="test_output/report.csv",
+        content=[[1, "Яблоко", 100], [2, "Груша", 150]],
+        headers=["id", "название", "цена"],
+    )
+    print(f"   ✅ Создан: {p}")
+    print(f"   📖 Прочитан: {readfile(p)}")
+
+    # --- 4. CSV из списка словарей ---
+    print("\n4️⃣  Создаём CSV (список словарей)...")
+    p = createfile(
+        name="test_output/users.csv",
+        content=[
+            {"id": 1, "name": "Иван", "city": "Москва"},
+            {"id": 2, "name": "Мария", "city": "Питер"},
+        ],
+    )
+    print(f"   ✅ Создан: {p}")
+    print(f"   📖 Прочитан: {readfile(p)}")
+
+    # --- 5. Markdown ---
+    print("\n5️⃣  Создаём Markdown...")
+    p = createfile(name="test_output/readme.md", content="# Заголовок\n\nТекст.")
+    print(f"   ✅ Создан: {p}")
+
+    # --- 6. Бинарный файл ---
+    print("\n6️⃣  Создаём бинарный файл...")
+    p = createfile(name="test_output/blob.bin", content=b"\x00\x01\x02\x03")
+    print(f"   ✅ Создан: {p}")
+    print(f"   📖 Прочитан: {readfile(p)}")
+
+    # --- 7. Дозапись ---
+    print("\n7️⃣  Тестируем дозапись...")
+    createfile(name="test_output/log.txt", content="Строка 1\n")
+    createfile(name="test_output/log.txt", content="Строка 2\n", append=True)
+    print(f"   📖 Содержимое: {readfile('test_output/log.txt')!r}")
+
+    # --- 8. Автосоздание вложенных папок ---
+    print("\n8️⃣  Тестируем создание вложенных папок...")
+    p = createfile(name="test_output/a/b/c/deep.txt", content="Глубоко!")
+    print(f"   ✅ Создан: {p}")
+
+    # --- 9. Ошибка при overwrite=False ---
+    print("\n9️⃣  Тестируем overwrite=False...")
+    try:
+        createfile(name="test_output/hello.txt", content="x", overwrite=False)
+        print("   ❌ Ошибка: должно было выбросить FileExistsError")
+    except FileExistsError as e:
+        print(f"   ✅ Поймали ошибку: {e}")
+
+    # --- 10. Удаление ---
+    print("\n🔟 Тестируем удаление...")
+    ok = deletefile("test_output/hello.txt")
+    print(f"   ✅ Удалено: {ok}, файл существует: {Path('test_output/hello.txt').exists()}")
+
+    print("\n" + "=" * 50)
+    print("✅ Все тесты пройдены!")
+    print("=" * 50)
+
+
+if __name__ == "__main__":
+    main()