pj-utils 0.1.0__tar.gz

pj_utils-0.1.0/PKG-INFO

@@ -0,0 +1,10 @@
+Metadata-Version: 2.4
+Name: pj-utils
+Version: 0.1.0
+Summary: Mes outils Python réutilisables
+Author: Philippe Jeremy
+Requires-Python: >=3.10
+Requires-Dist: sqlalchemy
+Requires-Dist: pymysql
+Requires-Dist: psycopg2-binary
+Requires-Dist: pyodbc

pj_utils-0.1.0/README.md

@@ -0,0 +1,158 @@
+# Utilitaires Python
+
+<p align="center">
+  <b>Une boîte à outils simple et puissante pour automatiser ton quotidien</b><br>
+  File management • Logging avancé • Envoi d'emails
+</p>
+
+<p align="center">
+  <img src="https://img.shields.io/badge/python-3.8+-blue.svg">
+  <img src="https://img.shields.io/badge/status-active-success.svg">
+</p>
+
+---
+
+## ✨ Aperçu
+
+Ce projet regroupe plusieurs classes utilitaires pour simplifier le développement :
+
+* 📁 Gestion intelligente des fichiers
+* 📝 Logging avancé et lisible
+* 📧 Envoi d’emails automatisé
+
+---
+
+## Modules
+
+| Module         | Description                              |
+| -------------- | ---------------------------------------- |
+| 📂 FileManager | Gestion avancée des fichiers et dossiers |
+| 📝 ProLogger   | Logger personnalisable avec couleurs     |
+| 📧 EmailSender | Envoi d’emails avec pièces jointes       |
+
+---
+
+## Instalation
+
+pip install git+https://github.com/philippeJeremy/Utilitaires_package
+
+---
+
+## FileManager
+
+> Simplifie toutes les opérations sur fichiers
+
+### Features
+
+* Création automatique de dossiers
+* Renommage intelligent
+* Copie / déplacement
+* Gestion des conflits (overwrite ou auto rename)
+
+### Exemple
+
+```python
+from utilis import FileManager
+
+fm = FileManager(overwrite=False, auto_rename=True)
+
+fm.ensure_dir("output")
+
+new_file = fm.rename("test.txt", "renamed.txt")
+
+fm.transfer(new_file, "output/", mode="copy")
+```
+
+---
+
+## ProLogger
+
+> Un logger propre, lisible et configurable
+
+### Features
+
+* Console + fichiers
+* Logs colorés 
+* Multi-niveaux (info, warning, error)
+* Facile à intégrer
+
+### Exemple
+
+```python
+from services import ProLogger
+
+logger = ProLogger(
+    name="my_app",
+    log_dir="logs",
+    console=True,
+    colored=True
+).get()
+
+logger.info("App started")
+logger.warning("Watch out")
+logger.error("Boom")
+```
+
+---
+
+## EmailSender
+
+> Envoi d’emails simple et rapide
+
+### Features
+
+* Support Gmail
+* CC / BCC
+* Pièces jointes 📎
+* Connexion sécurisée
+
+### Exemple
+
+```python
+from services import EmailSender
+
+sender = EmailSender(
+    provider="gmail",
+    email="tonemail@gmail.com",
+    password="mot_de_passe_application"
+)
+
+sender.connect()
+
+sender.send_email(
+    to=["a@gmail.com"],
+    cc=["b@gmail.com"],
+    bcc=["c@gmail.com"],
+    subject="Test CC/BCC",
+    content="Hello",
+    attachments=["doc.pdf"]
+)
+
+sender.close()
+```
+
+---
+
+## Sécurité
+
+⚠️ Important :
+
+* Ne jamais utiliser ton mot de passe principal
+* Utilise un **mot de passe d’application**
+* Active le 2FA (authentification à deux facteurs)
+
+---
+
+
+## Support
+
+Si ce projet t’aide :
+
+Laisse une ⭐ sur GitHub
+Partage le projet
+
+---
+
+<p align="center">
+  Fait avec ❤️ en Python
+</p>

pj_utils-0.1.0/pj_utils.egg-info/PKG-INFO

@@ -0,0 +1,10 @@
+Metadata-Version: 2.4
+Name: pj-utils
+Version: 0.1.0
+Summary: Mes outils Python réutilisables
+Author: Philippe Jeremy
+Requires-Python: >=3.10
+Requires-Dist: sqlalchemy
+Requires-Dist: pymysql
+Requires-Dist: psycopg2-binary
+Requires-Dist: pyodbc

pj_utils-0.1.0/pj_utils.egg-info/SOURCES.txt

@@ -0,0 +1,18 @@
+README.md
+pyproject.toml
+pj_utils.egg-info/PKG-INFO
+pj_utils.egg-info/SOURCES.txt
+pj_utils.egg-info/dependency_links.txt
+pj_utils.egg-info/requires.txt
+pj_utils.egg-info/top_level.txt
+utilitaires_package/__init__.py
+utilitaires_package/services/__init__.py
+utilitaires_package/services/config.py
+utilitaires_package/services/email.py
+utilitaires_package/services/formatters.py
+utilitaires_package/services/logger.py
+utilitaires_package/services/sql.py
+utilitaires_package/utils/__init__.py
+utilitaires_package/utils/exceptions.py
+utilitaires_package/utils/file.py
+utilitaires_package/utils/types.py

pj_utils-0.1.0/pj_utils.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

pj_utils-0.1.0/pj_utils.egg-info/requires.txt

@@ -0,0 +1,4 @@
+sqlalchemy
+pymysql
+psycopg2-binary
+pyodbc

pj_utils-0.1.0/pj_utils.egg-info/top_level.txt

@@ -0,0 +1 @@
+utilitaires_package

pj_utils-0.1.0/pyproject.toml

@@ -0,0 +1,21 @@
+[build-system]
+requires = ["setuptools", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "pj-utils"
+version = "0.1.0"
+description = "Mes outils Python réutilisables"
+authors = [{name = "Philippe Jeremy"}]
+requires-python = ">=3.10"
+
+dependencies = [
+    "sqlalchemy",
+    "pymysql",
+    "psycopg2-binary",
+    "pyodbc"
+]
+
+[tool.setuptools.packages.find]
+where = ["."]
+include = ["utilitaires_package*"]

pj_utils-0.1.0/setup.cfg

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

pj_utils-0.1.0/utilitaires_package/__init__.py

@@ -0,0 +1,4 @@
+from utilitaires_package.utils import FileManager
+from utilitaires_package.services import ProLogger
+from utilitaires_package.services import EmailSender
+from utilitaires_package.services import Database

pj_utils-0.1.0/utilitaires_package/services/__init__.py

@@ -0,0 +1,3 @@
+from .logger import ProLogger
+from .email import EmailSender
+from .sql import Database

pj_utils-0.1.0/utilitaires_package/services/config.py

@@ -0,0 +1,2 @@
+DEFAULT_LOG_FORMAT = "%(asctime)s | %(levelname)s | %(name)s | %(message)s"
+DEFAULT_DATE_FORMAT = "%Y-%m-%d %H:%M:%S"

pj_utils-0.1.0/utilitaires_package/services/email.py

@@ -0,0 +1,76 @@
+import os
+import smtplib
+from email.message import EmailMessage
+
+
+class EmailSender:
+    SMTP_CONFIG = {
+        "gmail": ("smtp.gmail.com", 587),
+        "outlook": ("smtp.office365.com", 587),
+        "yahoo": ("smtp.mail.yahoo.com", 587),
+    }
+
+    def __init__(self, provider, email, password):
+        self.smtp_server, self.smtp_port = self.SMTP_CONFIG[provider]
+        self.email_user = email
+        self.email_password = password
+        self.server = None
+
+    def connect(self):
+        self.server = smtplib.SMTP(self.smtp_server, self.smtp_port)
+        self.server.starttls()
+        self.server.login(self.email_user, self.email_password)
+
+    def send_email(self, to, subject, content, attachments=None, cc=None, bcc=None):
+        if self.server is None:
+            raise Exception("❌ Pas connecté au serveur SMTP")
+
+        msg = EmailMessage()
+        msg["From"] = self.email_user
+        msg["To"] = ", ".join(to) if isinstance(to, list) else to
+        msg["Subject"] = subject
+
+        if cc:
+            msg["Cc"] = ", ".join(cc) if isinstance(cc, list) else cc
+
+        msg.set_content(content)
+
+        # Pièces jointes
+        if attachments:
+            for file_path in attachments:
+                with open(file_path, "rb") as f:
+                    file_data = f.read()
+                    file_name = os.path.basename(file_path)
+
+                msg.add_attachment(
+                    file_data,
+                    maintype="application",
+                    subtype="octet-stream",
+                    filename=file_name
+                )
+
+        # IMPORTANT : inclure tous les destinataires pour l'envoi réel
+        recipients = []
+        
+        if isinstance(to, list):
+            recipients.extend(to)
+        else:
+            recipients.append(to)
+
+        if cc:
+            if isinstance(cc, list):
+                recipients.extend(cc)
+            else:
+                recipients.append(cc)
+
+        if bcc:
+            if isinstance(bcc, list):
+                recipients.extend(bcc)
+            else:
+                recipients.append(bcc)
+
+        self.server.send_message(msg, to_addrs=recipients)
+
+    def close(self):
+        if self.server:
+            self.server.quit()

pj_utils-0.1.0/utilitaires_package/services/formatters.py

@@ -0,0 +1,17 @@
+import logging
+
+
+class ColoredFormatter(logging.Formatter):
+    COLORS = {
+        logging.DEBUG: "\033[90m",     # gris
+        logging.INFO: "\033[92m",      # vert
+        logging.WARNING: "\033[93m",   # jaune
+        logging.ERROR: "\033[91m",     # rouge
+        logging.CRITICAL: "\033[95m",  # magenta
+    }
+    RESET = "\033[0m"
+
+    def format(self, record):
+        message = super().format(record)
+        color = self.COLORS.get(record.levelno, self.RESET)
+        return f"{color}{message}{self.RESET}"

pj_utils-0.1.0/utilitaires_package/services/logger.py

@@ -0,0 +1,63 @@
+import logging
+from logging.handlers import TimedRotatingFileHandler
+from pathlib import Path
+from .formatters import ColoredFormatter
+from .config import DEFAULT_LOG_FORMAT, DEFAULT_DATE_FORMAT
+
+
+class ProLogger:
+    def __init__(self, name: str = "prologger", log_dir: str = "logs", level=logging.DEBUG, console: bool = True,
+                 file_logging: bool = True, rotation_days: int = 30, colored: bool = True):
+        self.name = name
+        self.log_dir = Path(log_dir)
+        self.level = level
+        self.console = console
+        self.file_logging = file_logging
+        self.rotation_days = rotation_days
+        self.colored = colored
+
+        self.logger = logging.getLogger(self.name)
+        self.logger.setLevel(self.level)
+
+        self.setup()
+
+    def setup(self):
+        if self.logger.handlers:
+            return
+
+        formatter = logging.Formatter(
+            DEFAULT_LOG_FORMAT,
+            DEFAULT_DATE_FORMAT
+        )
+
+        if self.file_logging:
+            self.log_dir.mkdir(parents=True, exist_ok=True)
+
+            file_handler = TimedRotatingFileHandler(
+                self.log_dir / f"{self.name}.log",
+                when="midnight",
+                interval=1,
+                backupCount=self.rotation_days,
+                encoding="utf-8"
+            )
+
+            file_handler.setFormatter(formatter)
+            self.logger.addHandler(file_handler)
+
+        if self.console:
+            console_handler = logging.StreamHandler()
+
+            if self.colored:
+                console_handler.setFormatter(
+                    ColoredFormatter(
+                        DEFAULT_LOG_FORMAT,
+                        DEFAULT_DATE_FORMAT
+                    )
+                )
+            else:
+                console_handler.setFormatter(formatter)
+
+            self.logger.addHandler(console_handler)
+    
+    def get(self):
+        return self.logger

pj_utils-0.1.0/utilitaires_package/services/sql.py

@@ -0,0 +1,46 @@
+from sqlalchemy import create_engine, text
+
+
+class Database:
+    def __init__(self, db_type, host: str = "localhost", port=None, user=None, password=None, database=None, driver=None):
+        self.db_type = db_type.lower()
+        self.host = host
+        self.port = port
+        self.user = user
+        self.password = password
+        self.database = database
+        self.driver = driver
+
+        self.engine = create_engine(self._build_url())
+
+    def _build_url(self):
+        drivers = {
+            "sqlite": "",
+            "postgres": "postgresql",
+            "mysql": "mysql+pymysql",
+            "sqlserver": "mssql+pyodbc",
+        }
+
+        db = drivers.get(self.db_type)
+        if not db:
+            raise ValueError(f"Type de DB non supporté: {self.db_type}")
+
+        if self.db_type == "sqlite":
+            return f"sqlite:///{self.database}"
+
+        if self.driver:
+            db = f"{self.db_type}+{self.driver}"
+
+        return f"{db}://{self.user}:{self.password}@{self.host}:{self.port}/{self.database}"
+
+    def execute(self, query, params=None):
+        with self.engine.connect() as conn:
+            result = conn.execute(text(query), params or {})
+            conn.commit()
+            return result
+
+    def fetch_all(self, query, params=None):
+        return self.execute(query, params).fetchall()
+
+    def fetch_one(self, query, params=None):
+        return self.execute(query, params).fetchone()

pj_utils-0.1.0/utilitaires_package/utils/__init__.py

@@ -0,0 +1 @@
+from .file import FileManager

pj_utils-0.1.0/utilitaires_package/utils/exceptions.py

@@ -0,0 +1,14 @@
+class FileUtilsError(Exception):
+    """Base exception"""
+
+
+class FileNotFoundError(FileUtilsError):
+    pass
+
+
+class InvalidModeError(FileUtilsError):
+    pass
+
+
+class FileAlreadyExistsError(FileUtilsError):
+    pass

pj_utils-0.1.0/utilitaires_package/utils/file.py

@@ -0,0 +1,73 @@
+from pathlib import Path
+from typing import Union
+import shutil
+import logging
+from .exceptions import FileAlreadyExistsError, InvalidModeError
+from .types import PathLike
+
+
+class FileManager:
+    def __init__(self, overwrite: bool = False, auto_rename: bool = True, logger: logging.Logger | None = None,):
+        self.overwrite = overwrite
+        self.auto_renames = auto_rename
+        self.logger = logger or logging.getLogger(__name__)
+
+    def _resolve_destination(self, destination: Path) -> Path:
+        if not destination.exists():
+            return destination
+
+        if self.overwrite:
+            return destination
+        
+        if not self.auto_rename:
+            raise FileAlreadyExistsError(f"Fichier existe déjà : {destination}") 
+        
+        counter = 1 
+        stem = destination.stem
+        suffix = destination.suffix
+
+        while True:
+            new_name = f"{stem}_{counter}{suffix}"
+            new_path = destination.with_name(new_name)
+
+            if not new_path.exists():
+                return new_path
+
+            counter += 1
+
+    def rename(self, file_path: PathLike, new_name: str) -> Path:
+        source = Path(file_path)
+
+        if not source.is_file():
+            raise FileNotFoundError(f"Fichier introuvable : {source}")
+        
+        destination = self._resolve_destination(source.with_name(new_name))
+
+        source.rename(destination)
+        self.logger.info(f"Renamed: {source} -> {destination}")
+
+        return destination
+    
+    def transfer(self, source_path: PathLike, destination_path: PathLike, mode: str = 'copy') -> Path:
+
+        source = Path(source_path)
+        destination = Path(destination_path)
+
+        if not source.is_file():
+            raise FileNotFoundError(f"Source introuvable : {source}")
+        
+        if destination.exists() and destination.is_dir():
+            destination = destination / source.name
+
+        destination = self._resolve_destination(destination)
+
+        if mode == "move":
+            shutil.move(str(source), str(destination))
+            self.logger.info(f"Moved: {source} -> {destination}")
+        elif mode == "copy":
+            shutil.copy2(source, destination)
+            self.logger.info(f"Copied: {source} -> {destination}")
+        else:
+            raise InvalidModeError(mode)
+        
+        return destination

pj_utils-0.1.0/utilitaires_package/utils/types.py

@@ -0,0 +1,4 @@
+from pathlib import Path
+from typing import Union
+
+PathLike = Union[str, Path]