generate-qrcode 0.1.1__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -0,0 +1,16 @@
1
+ MIT License
2
+
3
+
4
+ Copyright (c) 2026 ANOIR IBNIYAMINE
5
+
6
+
7
+ Permission is hereby granted, free of charge, to any person obtaining a copy
8
+ of this software and associated documentation files (the "Software"), to deal
9
+ in the Software without restriction, including without limitation the rights
10
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
11
+ copies of the Software, and to permit persons to whom the Software is
12
+ furnished to do so, subject to the following conditions:
13
+
14
+
15
+ The above copyright notice and this permission notice shall be included in
16
+ all copies or substantial portions of the Software.
@@ -0,0 +1,81 @@
1
+ Metadata-Version: 2.4
2
+ Name: generate-qrcode
3
+ Version: 0.1.1
4
+ Summary: Génération d'une colonne qrcode dans un fichier : excel
5
+ Project-URL: Homepage, https://github.com/ibniyamine/mltools
6
+ Project-URL: Repository, https://github.com/ibniyamine/mltools
7
+ Project-URL: Bug Tracker, https://github.com/ibniyamine/mltools/issues
8
+ Author-email: anoir <ibniyamineanoir@gmail.com>
9
+ License: MIT
10
+ License-File: LICENCE
11
+ Keywords: Automatisation,Fichier,QR code,generate
12
+ Classifier: Development Status :: 3 - Alpha
13
+ Classifier: Intended Audience :: Developers
14
+ Classifier: Intended Audience :: Science/Research
15
+ Classifier: License :: OSI Approved :: MIT License
16
+ Classifier: Programming Language :: Python :: 3
17
+ Classifier: Programming Language :: Python :: 3.10
18
+ Classifier: Programming Language :: Python :: 3.11
19
+ Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
20
+ Requires-Python: >=3.10
21
+ Requires-Dist: numpy>=1.24
22
+ Requires-Dist: openpyxl>=3.1.5
23
+ Requires-Dist: pandas>=3.0.0
24
+ Requires-Dist: qrcode>=8.0.0
25
+ Provides-Extra: dev
26
+ Requires-Dist: mypy; extra == 'dev'
27
+ Requires-Dist: pytest-cov; extra == 'dev'
28
+ Requires-Dist: pytest>=7.0; extra == 'dev'
29
+ Requires-Dist: ruff; extra == 'dev'
30
+ Description-Content-Type: text/markdown
31
+
32
+ # Generate QR Code from Table Column 🚀
33
+
34
+ Ce package Python permet de générer automatiquement des codes QR en mémoire vive à partir d'une colonne spécifique d'un fichier **Excel (.xlsx)**et de les insérer directement dans un nouveau fichier Excel, sans stocker d'images temporaires sur votre disque dur.
35
+
36
+ ## 📦 Installation
37
+
38
+ Installez le package directement via `pip` :
39
+
40
+ ```bash
41
+ pip install generate-qrcode
42
+ ```
43
+
44
+ ## 🛠️ Utilisation
45
+
46
+ Pour utiliser l'outil, il vous suffit d'importer la fonction `adcolonneQRcode` depuis le module `generateColumn`.
47
+
48
+ La fonction prend **deux paramètres** :
49
+ 1. Le chemin ou nom du fichier source (`.xlsx` ou `.csv`).
50
+ 2. Le nom exact de la colonne à transformer en codes QR.
51
+
52
+ ### Exemple de code
53
+
54
+ ```python
55
+ from generate-qrcode.generateColumn import adcolonneQRcode
56
+
57
+ # 1. Définir le fichier et la colonne cible
58
+ nom_fichier = "EMPLOYE_TEST_CODEQR.xlsx"
59
+ colonne_cible = "matricule"
60
+
61
+ # 2. Exécuter la fonction
62
+ # La fonction génère et retourne automatiquement le chemin du nouveau fichier créé
63
+ nouveau_fichier = adcolonneQRcode(nom_fichier, colonne_cible)
64
+
65
+ print(f"Traitement terminé ! Vous pouvez ouvrir : {nouveau_fichier}")
66
+ ```
67
+
68
+ ## 🔄 Résultat obtenu
69
+
70
+ Après l'exécution de la fonction :
71
+ * Les données d'origine sont conservées.
72
+ * Une nouvelle colonne nommée **QR_Code** est ajoutée à la fin du tableau.
73
+ * Les codes QR sont insérés directement dans les cellules Excel à la bonne taille (100x100).
74
+ * Le fichier de sortie est enregistré sous le nom `[nom_origine]_avec_qr.xlsx`.
75
+
76
+ ## 📋 Prérequis & Dépendances
77
+
78
+ Le package installe et utilise automatiquement les bibliothèques suivantes :
79
+ * `pandas` (pour la lecture des données)
80
+ * `openpyxl` (pour la génération du fichier Excel enrichi)
81
+ * `qrcode` (pour la création des matrices de codes QR)
@@ -0,0 +1,50 @@
1
+ # Generate QR Code from Table Column 🚀
2
+
3
+ Ce package Python permet de générer automatiquement des codes QR en mémoire vive à partir d'une colonne spécifique d'un fichier **Excel (.xlsx)**et de les insérer directement dans un nouveau fichier Excel, sans stocker d'images temporaires sur votre disque dur.
4
+
5
+ ## 📦 Installation
6
+
7
+ Installez le package directement via `pip` :
8
+
9
+ ```bash
10
+ pip install generate-qrcode
11
+ ```
12
+
13
+ ## 🛠️ Utilisation
14
+
15
+ Pour utiliser l'outil, il vous suffit d'importer la fonction `adcolonneQRcode` depuis le module `generateColumn`.
16
+
17
+ La fonction prend **deux paramètres** :
18
+ 1. Le chemin ou nom du fichier source (`.xlsx` ou `.csv`).
19
+ 2. Le nom exact de la colonne à transformer en codes QR.
20
+
21
+ ### Exemple de code
22
+
23
+ ```python
24
+ from generate-qrcode.generateColumn import adcolonneQRcode
25
+
26
+ # 1. Définir le fichier et la colonne cible
27
+ nom_fichier = "EMPLOYE_TEST_CODEQR.xlsx"
28
+ colonne_cible = "matricule"
29
+
30
+ # 2. Exécuter la fonction
31
+ # La fonction génère et retourne automatiquement le chemin du nouveau fichier créé
32
+ nouveau_fichier = adcolonneQRcode(nom_fichier, colonne_cible)
33
+
34
+ print(f"Traitement terminé ! Vous pouvez ouvrir : {nouveau_fichier}")
35
+ ```
36
+
37
+ ## 🔄 Résultat obtenu
38
+
39
+ Après l'exécution de la fonction :
40
+ * Les données d'origine sont conservées.
41
+ * Une nouvelle colonne nommée **QR_Code** est ajoutée à la fin du tableau.
42
+ * Les codes QR sont insérés directement dans les cellules Excel à la bonne taille (100x100).
43
+ * Le fichier de sortie est enregistré sous le nom `[nom_origine]_avec_qr.xlsx`.
44
+
45
+ ## 📋 Prérequis & Dépendances
46
+
47
+ Le package installe et utilise automatiquement les bibliothèques suivantes :
48
+ * `pandas` (pour la lecture des données)
49
+ * `openpyxl` (pour la génération du fichier Excel enrichi)
50
+ * `qrcode` (pour la création des matrices de codes QR)
@@ -0,0 +1,53 @@
1
+ [build-system]
2
+ requires = ["hatchling"]
3
+ build-backend = "hatchling.build"
4
+
5
+
6
+ [project]
7
+ name = "generate-qrcode" # nom UNIQUE sur PyPI
8
+ version = "0.1.1"
9
+ description = "Génération d'une colonne qrcode dans un fichier : excel"
10
+ readme = "README.md"
11
+ requires-python = ">=3.10"
12
+ license = {text = "MIT"}
13
+ authors = [
14
+ {name = "anoir", email = "ibniyamineanoir@gmail.com"}
15
+ ]
16
+ keywords = ["Automatisation", "generate", "Fichier", "QR code"]
17
+ classifiers = [
18
+ "Development Status :: 3 - Alpha",
19
+ "Intended Audience :: Developers",
20
+ "Intended Audience :: Science/Research",
21
+ "License :: OSI Approved :: MIT License",
22
+ "Programming Language :: Python :: 3",
23
+ "Programming Language :: Python :: 3.10",
24
+ "Programming Language :: Python :: 3.11",
25
+ "Topic :: Scientific/Engineering :: Artificial Intelligence",
26
+ ]
27
+ dependencies = [
28
+ "numpy>=1.24",
29
+ "pandas>=3.0.0", # Version majeure récente pour la manipulation de données
30
+ "qrcode>=8.0.0", # Gère la création des codes QR
31
+ "openpyxl>=3.1.5", # Requis par pandas pour lire/écrire les fichiers Excel (.xlsx)
32
+ ]
33
+
34
+
35
+
36
+ [project.optional-dependencies]
37
+ dev = [
38
+ "pytest>=7.0",
39
+ "pytest-cov",
40
+ "ruff",
41
+ "mypy",
42
+ ]
43
+
44
+
45
+ [project.urls]
46
+ Homepage = "https://github.com/ibniyamine/mltools"
47
+ Repository = "https://github.com/ibniyamine/mltools"
48
+ "Bug Tracker" = "https://github.com/ibniyamine/mltools/issues"
49
+
50
+
51
+ [tool.hatch.build.targets.wheel]
52
+ packages = ["src/generate_qrcode"]
53
+
@@ -0,0 +1,50 @@
1
+ import io # <-- Nouveau : indispensable pour gérer la mémoire vive
2
+ import pandas as pd
3
+ import qrcode
4
+ from openpyxl import Workbook
5
+ from openpyxl.drawing.image import Image
6
+
7
+
8
+ def adcolonneQRcode(fichier_excel, colonne_source):
9
+ try:
10
+ df = pd.read_excel(fichier_excel)
11
+
12
+ # Créer un nouveau fichier Excel avec openpyxl
13
+ wb = Workbook()
14
+ ws = wb.active
15
+
16
+ # Écrire les en-têtes
17
+ for idx, col in enumerate(df.columns, start=1):
18
+ ws.cell(row=1, column=idx, value=col)
19
+ ws.cell(row=1, column=len(df.columns) + 1, value="QR_Code")
20
+
21
+ # Remplir les données + insérer QR codes
22
+ for i, valeur in enumerate(df[colonne_source], start=2):
23
+ # Copier les autres colonnes
24
+ for j, col in enumerate(df.columns, start=1):
25
+ ws.cell(row=i, column=j, value=df.iloc[i - 2, j - 1])
26
+
27
+ # 1. Générer le QR code en mémoire vive
28
+ qr_img = qrcode.make(str(valeur))
29
+
30
+ # 2. Créer un flux tampon en mémoire (comme un fichier virtuel)
31
+ flux_memoire = io.BytesIO()
32
+
33
+ # 3. Sauvegarder l'image dans ce flux plutôt que sur le disque
34
+ qr_img.save(flux_memoire, format="PNG")
35
+
36
+ # 4. Forcer openpyxl à lire l'image depuis la mémoire vive
37
+ img = Image(flux_memoire)
38
+ img.width, img.height = 100, 100
39
+
40
+ # Insérer l'image dans la cellule
41
+ ws.add_image(img, ws.cell(row=i, column=len(df.columns) + 1).coordinate)
42
+ ws.row_dimensions[i].height = 80
43
+
44
+ # Sauvegarder le fichier Excel final sur le disque
45
+ nouveau_fichier = fichier_excel.replace(".xlsx", "_avec_qr.xlsx")
46
+ wb.save(nouveau_fichier)
47
+ return nouveau_fichier
48
+ except Exception as e:
49
+ return f"Erreur : {str(e)}"
50
+
File without changes