filecreator 0.1.0__py3-none-any.whl

filecreator/__init__.py

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

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.dist-info/METADATA

@@ -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.dist-info/RECORD

@@ -0,0 +1,6 @@
+filecreator/__init__.py,sha256=SSusK8cQ5uymLuhv-QRMc13an76sqOHnIEM77jKbiCc,133
+filecreator/createfile.py,sha256=ffpMU1aBCSsRs3yGBDjMHBJfaWjpXdVn6FxECaLqJuQ,4819
+filecreator-0.1.0.dist-info/METADATA,sha256=krZPKihagH1-qvtYL01n-K8wx3VYmns7DaCw02ORnfY,1584
+filecreator-0.1.0.dist-info/WHEEL,sha256=W3fkpkm7-wf9vBI5Z-7s0eWkeM-spu78I8Neb98DeEg,87
+filecreator-0.1.0.dist-info/licenses/LICENSE,sha256=tzYrZ02p-YXP-h-LoabrkXuF29p5yjeVSDcfE6zD8c8,1109
+filecreator-0.1.0.dist-info/RECORD,,

filecreator-0.1.0.dist-info/WHEEL

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

filecreator-0.1.0.dist-info/licenses/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.