edb-noumea 0.3.3__tar.gz → 0.3.5__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,199 @@
1
+ Metadata-Version: 2.4
2
+ Name: edb-noumea
3
+ Version: 0.3.5
4
+ Summary: Scraper pour la qualité des eaux de baignade à Nouméa.
5
+ Project-URL: Homepage, https://github.com/adriens/edb-noumea
6
+ Project-URL: Repository, https://github.com/adriens/edb-noumea
7
+ Description-Content-Type: text/markdown
8
+ License-File: LICENSE
9
+ Requires-Dist: requests
10
+ Requires-Dist: beautifulsoup4
11
+ Requires-Dist: pandas
12
+ Requires-Dist: lxml
13
+ Requires-Dist: pdfplumber
14
+ Requires-Dist: matplotlib
15
+ Dynamic: license-file
16
+
17
+ [![Built with uv](https://img.shields.io/badge/Built%20with-uv-blueviolet?logo=python&logoColor=white)](https://docs.astral.sh/uv/)
18
+ [![PyPI - Downloads](https://img.shields.io/pypi/dm/edb-noumea)](https://pypistats.org/packages/edb-noumea)
19
+ [![Open in Kaggle](https://img.shields.io/badge/Kaggle-Open%20Notebook-blue?logo=kaggle)](https://www.kaggle.com/code/adriensales/qualit-eaux-de-baignade-noum-a)
20
+ [![Dataset](https://img.shields.io/badge/Kaggle-Dataset-blue?logo=kaggle)](https://www.kaggle.com/datasets/adriensales/qualit-des-eaux-de-baignade-nouma)
21
+ [![Live CSV Data](https://img.shields.io/badge/GitHub-Live%20CSV%20Data-black?logo=github)](https://github.com/adriens/edb-noumea-data)
22
+ [![Go BubbleTea TUI](https://img.shields.io/badge/Go-BubbleTea%20TUI-00ADD8?logo=go)](https://github.com/adriens/edb-noumea-tui)
23
+ [![Site officiel Ville de Nouméa](https://img.shields.io/badge/Nouméa-Site%20officiel%20Ville%20de%20Nouméa-0A74DA)](https://www.noumea.nc/noumea-pratique/salubrite-publique/qualite-eaux-baignade)
24
+
25
+
26
+
27
+ # Qualité des Eaux de Baignade à Nouméa
28
+
29
+ Ce projet Python fournit un outil simple pour scraper les données sur la qualité des eaux de baignade à Nouméa depuis le site officiel de la ville (`noumea.nc`). Il extrait les informations et les présente sous forme de tableau dans le terminal.
30
+
31
+ Il se base sur les données de https://www.noumea.nc/noumea-pratique/salubrite-publique/qualite-eaux-baignade
32
+
33
+ ## Prérequis
34
+
35
+ Avant de commencer, assurez-vous d'avoir installé `uv`, le gestionnaire de paquets et d'environnements virtuels Python.
36
+
37
+
38
+
39
+
40
+ ## Installation
41
+
42
+ Suivez ces étapes pour configurer l'environnement et installer les dépendances.
43
+
44
+ 1. **Accédez au répertoire du projet :**
45
+ ```bash
46
+ cd edb-noumea
47
+ ```
48
+
49
+ 2. **Créez un environnement virtuel avec `uv` :**
50
+ ```bash
51
+ uv venv
52
+ ```
53
+
54
+ 3. **Activez l'environnement virtuel :**
55
+ ```bash
56
+ source .venv/bin/activate
57
+ ```
58
+ *(Sur Windows, utilisez `.venv\Scripts\activate`)*
59
+
60
+ 4. **Installez les dépendances du projet :**
61
+ ```bash
62
+ uv pip install -e .
63
+ ```
64
+ *(L'option `-e .` installe le projet en mode "éditable", ce qui vous permet de modifier le code sans avoir à le réinstaller.)*
65
+
66
+ ## Utilisation
67
+
68
+ Ce package peut être utilisé de deux manières : soit pour obtenir un résumé de l'état des plages, soit pour obtenir les résultats détaillés des derniers prélèvements.
69
+
70
+ ### Obtenir le résumé de l'état sanitaire
71
+
72
+ Pour obtenir le tableau de résumé simple depuis la page web principale, exécutez :
73
+ ```bash
74
+ python -m edb_noumea.main
75
+ ```
76
+
77
+ ### Obtenir les résultats détaillés (depuis PDF)
78
+
79
+ Pour obtenir le tableau détaillé des derniers relevés (extrait automatiquement du dernier fichier PDF disponible), exécutez :
80
+ ```bash
81
+ python -m edb_noumea.details
82
+ ```
83
+
84
+
85
+ ## Générer des graphiques PNG des analyses détaillées
86
+
87
+ Vous pouvez générer automatiquement deux graphiques au format PNG (niveaux d'E. coli et d'Entérocoques par point de prélèvement) à partir des derniers résultats d'analyses, grâce au script fourni.
88
+
89
+ ### Étapes
90
+
91
+ 1. Assurez-vous que l'environnement virtuel est activé et que les dépendances sont installées.
92
+ 2. Exécutez le script suivant depuis le répertoire du projet :
93
+
94
+ ```bash
95
+ source .venv/bin/activate
96
+ /home/adriens/Github/edb-noumea/noumea_water_quality/.venv/bin/python generer_graphique_analyses.py
97
+ ```
98
+
99
+ Deux fichiers PNG seront générés dans le dossier courant :
100
+
101
+
102
+ Vous pouvez ouvrir ces fichiers pour visualiser les résultats détaillés des analyses.
103
+
104
+ ## Utilisation en tant que Bibliothèque
105
+
106
+ Vous pouvez également importer les fonctions dans vos propres scripts Python pour une intégration plus poussée.
107
+
108
+ Installer
109
+
110
+ ### Obtenir le résumé
111
+
112
+ ```python
113
+ # exemple_resume.py
114
+ from edb_noumea.main import get_water_quality
115
+
116
+ df_resume = get_water_quality()
117
+
118
+ if df_resume is not None:
119
+ print("Résumé de l'état des plages :")
120
+ print(df_resume.to_string())
121
+ ```
122
+
123
+ ### Obtenir les résultats détaillés
124
+
125
+ ```python
126
+ # exemple_details.py
127
+ from edb_noumea.details import get_detailed_results
128
+
129
+ df_details = get_detailed_results()
130
+
131
+ if df_details is not None:
132
+ print("Détails des derniers relevés :")
133
+ print(df_details.to_string())
134
+ ```
135
+
136
+ ### Exemple de Visualisation
137
+
138
+ Voici un exemple montrant comment récupérer les données détaillées et créer un graphique simple avec `matplotlib` pour visualiser les niveaux d'E. coli par point de prélèvement.
139
+
140
+ ```python
141
+ # exemple_visualisation.py
142
+ import pandas as pd
143
+ import matplotlib.pyplot as plt
144
+ from edb_noumea.details import get_detailed_results
145
+
146
+ # Obtenir les données détaillées
147
+ df = get_detailed_results()
148
+
149
+ if df is not None and not df.empty:
150
+ print("Création du graphique...")
151
+
152
+ # S'assurer que les données sont triées pour une meilleure lisibilité
153
+ df_sorted = df.sort_values(by='e_coli_npp_100ml', ascending=False)
154
+
155
+ # Créer le graphique à barres horizontales
156
+ plt.figure(figsize=(12, 8))
157
+ plt.barh(df_sorted['point_de_prelevement'], df_sorted['e_coli_npp_100ml'], color='skyblue')
158
+
159
+ # Ajouter les titres et les étiquettes
160
+ plt.xlabel('E. coli (NPP/100ml)')
161
+ plt.ylabel('Point de prélèvement')
162
+ plt.title("Niveaux d'E. coli par Point de Prélèvement")
163
+ plt.gca().invert_yaxis() # Afficher le plus élevé en haut
164
+ plt.tight_layout() # Ajuster le layout pour que tout soit visible
165
+
166
+ # Sauvegarder le graphique dans un fichier
167
+ plt.savefig('ecoli_levels.png')
168
+ print("Graphique sauvegardé sous 'ecoli_levels.png'")
169
+
170
+ # Afficher le graphique
171
+ plt.show()
172
+ else:
173
+ print("Aucune donnée à afficher.")
174
+
175
+ ```
176
+
177
+ *Assurez-vous que votre script est exécuté dans le même environnement virtuel où le package `edb-noumea` a été installé.*
178
+
179
+ ## Sortie Attendue
180
+
181
+ ### Résumé de l'état sanitaire (`main`)
182
+ ```
183
+ 📊 État sanitaire des eaux de baignade à Nouméa 📊
184
+ Plage État sanitaire
185
+ 0 Plage de la baie des Citrons Baignade autorisée
186
+ 1 Plage de la promenade Pierre-Vernier Baignade autorisée
187
+ ...
188
+ ```
189
+
190
+ ### Détails des relevés (`details`)
191
+ ```
192
+ 📋 Voici les détails des derniers relevés :
193
+ Site Point de prélèvement Date Heure E. coli (NPP/100ml) Entérocoques (NPP/100ml)
194
+ 0 PLAGE DE LA BAIE DES CITRONS P18049, Face The Beach House 04/09/2025 07:29 10 20
195
+ 1 PLAGE DE LA BAIE DES CITRONS P18050, Face allée centrale Mirage plaza 04/09/2025 07:33 62 75
196
+ ...
197
+ ```
198
+
199
+
@@ -0,0 +1,199 @@
1
+ Metadata-Version: 2.4
2
+ Name: edb-noumea
3
+ Version: 0.3.5
4
+ Summary: Scraper pour la qualité des eaux de baignade à Nouméa.
5
+ Project-URL: Homepage, https://github.com/adriens/edb-noumea
6
+ Project-URL: Repository, https://github.com/adriens/edb-noumea
7
+ Description-Content-Type: text/markdown
8
+ License-File: LICENSE
9
+ Requires-Dist: requests
10
+ Requires-Dist: beautifulsoup4
11
+ Requires-Dist: pandas
12
+ Requires-Dist: lxml
13
+ Requires-Dist: pdfplumber
14
+ Requires-Dist: matplotlib
15
+ Dynamic: license-file
16
+
17
+ [![Built with uv](https://img.shields.io/badge/Built%20with-uv-blueviolet?logo=python&logoColor=white)](https://docs.astral.sh/uv/)
18
+ [![PyPI - Downloads](https://img.shields.io/pypi/dm/edb-noumea)](https://pypistats.org/packages/edb-noumea)
19
+ [![Open in Kaggle](https://img.shields.io/badge/Kaggle-Open%20Notebook-blue?logo=kaggle)](https://www.kaggle.com/code/adriensales/qualit-eaux-de-baignade-noum-a)
20
+ [![Dataset](https://img.shields.io/badge/Kaggle-Dataset-blue?logo=kaggle)](https://www.kaggle.com/datasets/adriensales/qualit-des-eaux-de-baignade-nouma)
21
+ [![Live CSV Data](https://img.shields.io/badge/GitHub-Live%20CSV%20Data-black?logo=github)](https://github.com/adriens/edb-noumea-data)
22
+ [![Go BubbleTea TUI](https://img.shields.io/badge/Go-BubbleTea%20TUI-00ADD8?logo=go)](https://github.com/adriens/edb-noumea-tui)
23
+ [![Site officiel Ville de Nouméa](https://img.shields.io/badge/Nouméa-Site%20officiel%20Ville%20de%20Nouméa-0A74DA)](https://www.noumea.nc/noumea-pratique/salubrite-publique/qualite-eaux-baignade)
24
+
25
+
26
+
27
+ # Qualité des Eaux de Baignade à Nouméa
28
+
29
+ Ce projet Python fournit un outil simple pour scraper les données sur la qualité des eaux de baignade à Nouméa depuis le site officiel de la ville (`noumea.nc`). Il extrait les informations et les présente sous forme de tableau dans le terminal.
30
+
31
+ Il se base sur les données de https://www.noumea.nc/noumea-pratique/salubrite-publique/qualite-eaux-baignade
32
+
33
+ ## Prérequis
34
+
35
+ Avant de commencer, assurez-vous d'avoir installé `uv`, le gestionnaire de paquets et d'environnements virtuels Python.
36
+
37
+
38
+
39
+
40
+ ## Installation
41
+
42
+ Suivez ces étapes pour configurer l'environnement et installer les dépendances.
43
+
44
+ 1. **Accédez au répertoire du projet :**
45
+ ```bash
46
+ cd edb-noumea
47
+ ```
48
+
49
+ 2. **Créez un environnement virtuel avec `uv` :**
50
+ ```bash
51
+ uv venv
52
+ ```
53
+
54
+ 3. **Activez l'environnement virtuel :**
55
+ ```bash
56
+ source .venv/bin/activate
57
+ ```
58
+ *(Sur Windows, utilisez `.venv\Scripts\activate`)*
59
+
60
+ 4. **Installez les dépendances du projet :**
61
+ ```bash
62
+ uv pip install -e .
63
+ ```
64
+ *(L'option `-e .` installe le projet en mode "éditable", ce qui vous permet de modifier le code sans avoir à le réinstaller.)*
65
+
66
+ ## Utilisation
67
+
68
+ Ce package peut être utilisé de deux manières : soit pour obtenir un résumé de l'état des plages, soit pour obtenir les résultats détaillés des derniers prélèvements.
69
+
70
+ ### Obtenir le résumé de l'état sanitaire
71
+
72
+ Pour obtenir le tableau de résumé simple depuis la page web principale, exécutez :
73
+ ```bash
74
+ python -m edb_noumea.main
75
+ ```
76
+
77
+ ### Obtenir les résultats détaillés (depuis PDF)
78
+
79
+ Pour obtenir le tableau détaillé des derniers relevés (extrait automatiquement du dernier fichier PDF disponible), exécutez :
80
+ ```bash
81
+ python -m edb_noumea.details
82
+ ```
83
+
84
+
85
+ ## Générer des graphiques PNG des analyses détaillées
86
+
87
+ Vous pouvez générer automatiquement deux graphiques au format PNG (niveaux d'E. coli et d'Entérocoques par point de prélèvement) à partir des derniers résultats d'analyses, grâce au script fourni.
88
+
89
+ ### Étapes
90
+
91
+ 1. Assurez-vous que l'environnement virtuel est activé et que les dépendances sont installées.
92
+ 2. Exécutez le script suivant depuis le répertoire du projet :
93
+
94
+ ```bash
95
+ source .venv/bin/activate
96
+ /home/adriens/Github/edb-noumea/noumea_water_quality/.venv/bin/python generer_graphique_analyses.py
97
+ ```
98
+
99
+ Deux fichiers PNG seront générés dans le dossier courant :
100
+
101
+
102
+ Vous pouvez ouvrir ces fichiers pour visualiser les résultats détaillés des analyses.
103
+
104
+ ## Utilisation en tant que Bibliothèque
105
+
106
+ Vous pouvez également importer les fonctions dans vos propres scripts Python pour une intégration plus poussée.
107
+
108
+ Installer
109
+
110
+ ### Obtenir le résumé
111
+
112
+ ```python
113
+ # exemple_resume.py
114
+ from edb_noumea.main import get_water_quality
115
+
116
+ df_resume = get_water_quality()
117
+
118
+ if df_resume is not None:
119
+ print("Résumé de l'état des plages :")
120
+ print(df_resume.to_string())
121
+ ```
122
+
123
+ ### Obtenir les résultats détaillés
124
+
125
+ ```python
126
+ # exemple_details.py
127
+ from edb_noumea.details import get_detailed_results
128
+
129
+ df_details = get_detailed_results()
130
+
131
+ if df_details is not None:
132
+ print("Détails des derniers relevés :")
133
+ print(df_details.to_string())
134
+ ```
135
+
136
+ ### Exemple de Visualisation
137
+
138
+ Voici un exemple montrant comment récupérer les données détaillées et créer un graphique simple avec `matplotlib` pour visualiser les niveaux d'E. coli par point de prélèvement.
139
+
140
+ ```python
141
+ # exemple_visualisation.py
142
+ import pandas as pd
143
+ import matplotlib.pyplot as plt
144
+ from edb_noumea.details import get_detailed_results
145
+
146
+ # Obtenir les données détaillées
147
+ df = get_detailed_results()
148
+
149
+ if df is not None and not df.empty:
150
+ print("Création du graphique...")
151
+
152
+ # S'assurer que les données sont triées pour une meilleure lisibilité
153
+ df_sorted = df.sort_values(by='e_coli_npp_100ml', ascending=False)
154
+
155
+ # Créer le graphique à barres horizontales
156
+ plt.figure(figsize=(12, 8))
157
+ plt.barh(df_sorted['point_de_prelevement'], df_sorted['e_coli_npp_100ml'], color='skyblue')
158
+
159
+ # Ajouter les titres et les étiquettes
160
+ plt.xlabel('E. coli (NPP/100ml)')
161
+ plt.ylabel('Point de prélèvement')
162
+ plt.title("Niveaux d'E. coli par Point de Prélèvement")
163
+ plt.gca().invert_yaxis() # Afficher le plus élevé en haut
164
+ plt.tight_layout() # Ajuster le layout pour que tout soit visible
165
+
166
+ # Sauvegarder le graphique dans un fichier
167
+ plt.savefig('ecoli_levels.png')
168
+ print("Graphique sauvegardé sous 'ecoli_levels.png'")
169
+
170
+ # Afficher le graphique
171
+ plt.show()
172
+ else:
173
+ print("Aucune donnée à afficher.")
174
+
175
+ ```
176
+
177
+ *Assurez-vous que votre script est exécuté dans le même environnement virtuel où le package `edb-noumea` a été installé.*
178
+
179
+ ## Sortie Attendue
180
+
181
+ ### Résumé de l'état sanitaire (`main`)
182
+ ```
183
+ 📊 État sanitaire des eaux de baignade à Nouméa 📊
184
+ Plage État sanitaire
185
+ 0 Plage de la baie des Citrons Baignade autorisée
186
+ 1 Plage de la promenade Pierre-Vernier Baignade autorisée
187
+ ...
188
+ ```
189
+
190
+ ### Détails des relevés (`details`)
191
+ ```
192
+ 📋 Voici les détails des derniers relevés :
193
+ Site Point de prélèvement Date Heure E. coli (NPP/100ml) Entérocoques (NPP/100ml)
194
+ 0 PLAGE DE LA BAIE DES CITRONS P18049, Face The Beach House 04/09/2025 07:29 10 20
195
+ 1 PLAGE DE LA BAIE DES CITRONS P18050, Face allée centrale Mirage plaza 04/09/2025 07:33 62 75
196
+ ...
197
+ ```
198
+
199
+
@@ -1,7 +1,8 @@
1
1
  [project]
2
2
  name = "edb-noumea"
3
- description = "Scraper robuste pour la qualité des eaux de baignade à Nouméa. Ajout export CSV automatique et détection améliorée des colonnes PDF."
4
- version = "0.3.3"
3
+ description = "Scraper pour la qualité des eaux de baignade à Nouméa."
4
+ readme = "README.md"
5
+ version = "0.3.5"
5
6
  dependencies = [
6
7
  "requests",
7
8
  "beautifulsoup4",
edb_noumea-0.3.3/PKG-INFO DELETED
@@ -1,14 +0,0 @@
1
- Metadata-Version: 2.4
2
- Name: edb-noumea
3
- Version: 0.3.3
4
- Summary: Scraper robuste pour la qualité des eaux de baignade à Nouméa. Ajout export CSV automatique et détection améliorée des colonnes PDF.
5
- Project-URL: Homepage, https://github.com/adriens/edb-noumea
6
- Project-URL: Repository, https://github.com/adriens/edb-noumea
7
- License-File: LICENSE
8
- Requires-Dist: requests
9
- Requires-Dist: beautifulsoup4
10
- Requires-Dist: pandas
11
- Requires-Dist: lxml
12
- Requires-Dist: pdfplumber
13
- Requires-Dist: matplotlib
14
- Dynamic: license-file
@@ -1,14 +0,0 @@
1
- Metadata-Version: 2.4
2
- Name: edb-noumea
3
- Version: 0.3.3
4
- Summary: Scraper robuste pour la qualité des eaux de baignade à Nouméa. Ajout export CSV automatique et détection améliorée des colonnes PDF.
5
- Project-URL: Homepage, https://github.com/adriens/edb-noumea
6
- Project-URL: Repository, https://github.com/adriens/edb-noumea
7
- License-File: LICENSE
8
- Requires-Dist: requests
9
- Requires-Dist: beautifulsoup4
10
- Requires-Dist: pandas
11
- Requires-Dist: lxml
12
- Requires-Dist: pdfplumber
13
- Requires-Dist: matplotlib
14
- Dynamic: license-file
File without changes
File without changes
File without changes