py-sensor-things 0.1.1__tar.gz

py_sensor_things-0.1.1/LICENSE

@@ -0,0 +1,227 @@
+
+# CONTRAT DE LICENCE DE LOGICIEL LIBRE CeCILL-C
+
+## Avertissement
+
+Ce contrat est une licence de logiciel libre issue d'une concertation entre ses auteurs afin que le respect de deux grands principes préside à sa rédaction:
+
+    d'une part, le respect des principes de diffusion des logiciels libres: accès au code source, droits étendus conférés aux utilisateurs,
+    d'autre part, la désignation d'un droit applicable, le droit français, auquel elle est conforme, tant au regard du droit de la responsabilité civile que du droit de la propriété intellectuelle et de la protection qu'il offre aux auteurs et titulaires des droits patrimoniaux sur un logiciel.
+
+Les auteurs de la licence CeCILL-C1 sont:
+
+Commissariat à l'Energie Atomique - CEA, établissement public de recherche à caractère scientifique, technique et industriel, dont le siège est situé 25 rue Leblanc, immeuble Le Ponant D, 75015 Paris.
+
+Centre National de la Recherche Scientifique - CNRS, établissement public à caractère scientifique et technologique, dont le siège est situé 3 rue Michel-Ange, 75794 Paris cedex 16.
+
+Institut National de Recherche en Informatique et en Automatique - INRIA, établissement public à caractère scientifique et technologique, dont le siège est situé Domaine de Voluceau, Rocquencourt, BP 105, 78153 Le Chesnay cedex.
+
+## Préambule
+
+Ce contrat est une licence de logiciel libre dont l'objectif est de conférer aux utilisateurs la liberté de modifier et de réutiliser le logiciel régi par cette licence.
+
+L'exercice de cette liberté est assorti d'une obligation de remettre à la disposition de la communauté les modifications apportées au code source du logiciel afin de contribuer à son évolution.
+
+L'accessibilité au code source et les droits de copie, de modification et de redistribution qui découlent de ce contrat ont pour contrepartie de n'offrir aux utilisateurs qu'une garantie limitée et de ne faire peser sur l'auteur du logiciel, le titulaire des droits patrimoniaux et les concédants successifs qu'une responsabilité restreinte.
+
+A cet égard l'attention de l'utilisateur est attirée sur les risques associés au chargement, à l'utilisation, à la modification et/ou au développement et à la reproduction du logiciel par l'utilisateur étant donné sa spécificité de logiciel libre, qui peut le rendre complexe à manipuler et qui le réserve donc à des développeurs ou des professionnels avertis possédant des connaissances informatiques approfondies. Les utilisateurs sont donc invités à charger et tester l'adéquation du logiciel à leurs besoins dans des conditions permettant d'assurer la sécurité de leurs systèmes et/ou de leurs données et, plus généralement, à l'utiliser et l'exploiter dans les mêmes conditions de sécurité. Ce contrat peut être reproduit et diffusé librement, sous réserve de le conserver en l'état, sans ajout ni suppression de clauses.
+
+Ce contrat est susceptible de s'appliquer à tout logiciel dont le titulaire des droits patrimoniaux décide de soumettre l'exploitation aux dispositions qu'il contient.
+
+## Article 1 - DEFINITIONS
+
+Dans ce contrat, les termes suivants, lorsqu'ils seront écrits avec une lettre capitale, auront la signification suivante:
+
+Contrat: désigne le présent contrat de licence, ses éventuelles versions postérieures et annexes.
+
+Logiciel: désigne le logiciel sous sa forme de Code Objet et/ou de Code Source et le cas échéant sa documentation, dans leur état au moment de l'acceptation du Contrat par le Licencié.
+
+Logiciel Initial: désigne le Logiciel sous sa forme de Code Source et éventuellement de Code Objet et le cas échéant sa documentation, dans leur état au moment de leur première diffusion sous les termes du Contrat.
+
+Logiciel Modifié: désigne le Logiciel modifié par au moins une Contribution Intégrée.
+
+Code Source: désigne l'ensemble des instructions et des lignes de programme du Logiciel et auquel l'accès est nécessaire en vue de modifier le Logiciel.
+
+Code Objet: désigne les fichiers binaires issus de la compilation du Code Source.
+
+Titulaire: désigne le ou les détenteurs des droits patrimoniaux d'auteur sur le Logiciel Initial.
+
+Licencié: désigne le ou les utilisateurs du Logiciel ayant accepté le Contrat.
+
+Contributeur: désigne le Licencié auteur d'au moins une Contribution Intégrée.
+
+Concédant: désigne le Titulaire ou toute personne physique ou morale distribuant le Logiciel sous le Contrat.
+
+Contribution Intégrée: désigne l'ensemble des modifications, corrections, traductions, adaptations et/ou nouvelles fonctionnalités intégrées dans le Code Source par tout Contributeur.
+
+Module Lié: désigne un ensemble de fichiers sources y compris leur documentation qui, sans modification du Code Source, permet de réaliser des fonctionnalités ou services supplémentaires à ceux fournis par le Logiciel.
+
+Logiciel Dérivé: désigne toute combinaison du Logiciel, modifié ou non, et d'un Module Lié.
+
+Parties: désigne collectivement le Licencié et le Concédant.
+
+Ces termes s'entendent au singulier comme au pluriel.
+
+## Article 2 - OBJET
+
+Le Contrat a pour objet la concession par le Concédant au Licencié d'une licence non exclusive, cessible et mondiale du Logiciel telle que définie ci-après à l'article 5 pour toute la durée de protection des droits portant sur ce Logiciel.
+
+## Article 3 - ACCEPTATION
+
+3.1 L'acceptation par le Licencié des termes du Contrat est réputée acquise du fait du premier des faits suivants:
+
+    (i) le chargement du Logiciel par tout moyen notamment par téléchargement à partir d'un serveur distant ou par chargement à partir d'un support physique;
+    (ii) le premier exercice par le Licencié de l'un quelconque des droits concédés par le Contrat.
+
+3.2 Un exemplaire du Contrat, contenant notamment un avertissement relatif aux spécificités du Logiciel, à la restriction de garantie et à la limitation à un usage par des utilisateurs expérimentés a été mis à disposition du Licencié préalablement à son acceptation telle que définie à l'article 3.1 ci dessus et le Licencié reconnaît en avoir pris connaissance.
+
+## Article 4 - ENTREE EN VIGUEUR ET DUREE
+4.1 ENTREE EN VIGUEUR
+
+Le Contrat entre en vigueur à la date de son acceptation par le Licencié telle que définie en 3.1.
+4.2 DUREE
+
+Le Contrat produira ses effets pendant toute la durée légale de protection des droits patrimoniaux portant sur le Logiciel.
+
+## Article 5 - ETENDUE DES DROITS CONCEDES
+
+Le Concédant concède au Licencié, qui accepte, les droits suivants sur le Logiciel pour toutes destinations et pour la durée du Contrat dans les conditions ci-après détaillées.
+
+Par ailleurs, si le Concédant détient ou venait à détenir un ou plusieurs brevets d'invention protégeant tout ou partie des fonctionnalités du Logiciel ou de ses composants, il s'engage à ne pas opposer les éventuels droits conférés par ces brevets aux Licenciés successifs qui utiliseraient, exploiteraient ou modifieraient le Logiciel. En cas de cession de ces brevets, le Concédant s'engage à faire reprendre les obligations du présent alinéa aux cessionnaires.
+5.1 DROIT D'UTILISATION
+
+Le Licencié est autorisé à utiliser le Logiciel, sans restriction quant aux domaines d'application, étant ci-après précisé que cela comporte:
+
+    la reproduction permanente ou provisoire du Logiciel en tout ou partie par tout moyen et sous toute forme.
+
+    le chargement, l'affichage, l'exécution, ou le stockage du Logiciel sur tout support.
+
+    la possibilité d'en observer, d'en étudier, ou d'en tester le fonctionnement afin de déterminer les idées et principes qui sont à la base de n'importe quel élément de ce Logiciel; et ceci, lorsque le Licencié effectue toute opération de chargement, d'affichage, d'exécution, de transmission ou de stockage du Logiciel qu'il est en droit d'effectuer en vertu du Contrat.
+
+5.2 DROIT DE MODIFICATION
+
+Le droit de modification comporte le droit de traduire, d'adapter, d'arranger ou d'apporter toute autre modification au Logiciel et le droit de reproduire le logiciel en résultant. Il comprend en particulier le droit de créer un Logiciel Dérivé.
+
+Le Licencié est autorisé à apporter toute modification au Logiciel sous réserve de mentionner, de façon explicite, son nom en tant qu'auteur de cette modification et la date de création de celle-ci.
+5.3 DROIT DE DISTRIBUTION
+
+Le droit de distribution comporte notamment le droit de diffuser, de transmettre et de communiquer le Logiciel au public sur tout support et par tout moyen ainsi que le droit de mettre sur le marché à titre onéreux ou gratuit, un ou des exemplaires du Logiciel par tout procédé.
+
+Le Licencié est autorisé à distribuer des copies du Logiciel, modifié ou non, à des tiers dans les conditions ci-après détaillées.
+5.3.1 DISTRIBUTION DU LOGICIEL SANS MODIFICATION
+
+Le Licencié est autorisé à distribuer des copies conformes du Logiciel, sous forme de Code Source ou de Code Objet, à condition que cette distribution respecte les dispositions du Contrat dans leur totalité et soit accompagnée:
+
+    d'un exemplaire du Contrat,
+
+    d'un avertissement relatif à la restriction de garantie et de responsabilité du Concédant telle que prévue aux articles 8 et 9,
+
+et que, dans le cas où seul le Code Objet du Logiciel est redistribué, le Licencié permette un accès effectif au Code Source complet du Logiciel pendant au moins toute la durée de sa distribution du Logiciel, étant entendu que le coût additionnel d'acquisition du Code Source ne devra pas excéder le simple coût de transfert des données.
+5.3.2 DISTRIBUTION DU LOGICIEL MODIFIE
+
+Lorsque le Licencié apporte une Contribution Intégrée au Logiciel, les conditions de distribution du Logiciel Modifié en résultant sont alors soumises à l'intégralité des dispositions du Contrat.
+
+Le Licencié est autorisé à distribuer le Logiciel Modifié sous forme de code source ou de code objet, à condition que cette distribution respecte les dispositions du Contrat dans leur totalité et soit accompagnée:
+
+    d'un exemplaire du Contrat,
+
+    d'un avertissement relatif à la restriction de garantie et de responsabilité du Concédant telle que prévue aux articles 8 et 9,
+
+et que, dans le cas où seul le code objet du Logiciel Modifié est redistribué, le Licencié permette un accès effectif à son code source complet pendant au moins toute la durée de sa distribution du Logiciel Modifié, étant entendu que le coût additionnel d'acquisition du code source ne devra pas excéder le simple coût de transfert des données.
+5.3.3 DISTRIBUTION DU LOGICIEL DERIVE
+
+Lorsque le Licencié crée un Logiciel Dérivé, ce Logiciel Dérivé peut être distribué sous un contrat de licence autre que le présent Contrat à condition de respecter les obligations de mention des droits sur le Logiciel telles que définies à l'article 6.4. Dans le cas où la création du Logiciel Dérivé a nécessité une modification du Code Source le licencié s'engage à ce que:
+
+    le Logiciel Modifié correspondant à cette modification soit régi par le présent Contrat,
+    les Contributions Intégrées dont le Logiciel Modifié résulte soient clairement identifiées et documentées,
+    le Licencié permette un accès effectif au code source du Logiciel Modifié, pendant au moins toute la durée de la distribution du Logiciel Dérivé, de telle sorte que ces modifications puissent être reprises dans une version ultérieure du Logiciel, étant entendu que le coût additionnel d'acquisition du code source du Logiciel Modifié ne devra pas excéder le simple coût du transfert des données.
+
+5.3.4 COMPATIBILITE AVEC LA LICENCE CeCILL
+
+Lorsqu'un Logiciel Modifié contient une Contribution Intégrée soumise au contrat de licence CeCILL, ou lorsqu'un Logiciel Dérivé contient un Module Lié soumis au contrat de licence CeCILL, les stipulations prévues au troisième item de l'article 6.4 sont facultatives.
+
+## Article 6 - PROPRIETE INTELLECTUELLE
+6.1 SUR LE LOGICIEL INITIAL
+
+Le Titulaire est détenteur des droits patrimoniaux sur le Logiciel Initial. Toute utilisation du Logiciel Initial est soumise au respect des conditions dans lesquelles le Titulaire a choisi de diffuser son oeuvre et nul autre n'a la faculté de modifier les conditions de diffusion de ce Logiciel Initial.
+
+Le Titulaire s'engage à ce que le Logiciel Initial reste au moins régi par le Contrat et ce, pour la durée visée à l'article 4.2.
+6.2 SUR LES CONTRIBUTIONS INTEGREES
+
+Le Licencié qui a développé une Contribution Intégrée est titulaire sur celle-ci des droits de propriété intellectuelle dans les conditions définies par la législation applicable.
+6.3 SUR LES MODULES LIES
+
+Le Licencié qui a développé un Module Lié est titulaire sur celui-ci des droits de propriété intellectuelle dans les conditions définies par la législation applicable et reste libre du choix du contrat régissant sa diffusion dans les conditions définies à l'article 5.3.3.
+6.4 MENTIONS DES DROITS
+
+Le Licencié s'engage expressément:
+
+    à ne pas supprimer ou modifier de quelque manière que ce soit les mentions de propriété intellectuelle apposées sur le Logiciel;
+
+    à reproduire à l'identique lesdites mentions de propriété intellectuelle sur les copies du Logiciel modifié ou non;
+    à faire en sorte que l'utilisation du Logiciel, ses mentions de propriété intellectuelle et le fait qu'il est régi par le Contrat soient indiqués dans un texte facilement accessible notamment depuis l'interface de tout Logiciel Dérivé.
+
+Le Licencié s'engage à ne pas porter atteinte, directement ou indirectement, aux droits de propriété intellectuelle du Titulaire et/ou des Contributeurs sur le Logiciel et à prendre, le cas échéant, à l'égard de son personnel toutes les mesures nécessaires pour assurer le respect des dits droits de propriété intellectuelle du Titulaire et/ou des Contributeurs.
+
+## Article 7 - SERVICES ASSOCIES
+
+7.1 Le Contrat n'oblige en aucun cas le Concédant à la réalisation de prestations d'assistance technique ou de maintenance du Logiciel.
+
+Cependant le Concédant reste libre de proposer ce type de services. Les termes et conditions d'une telle assistance technique et/ou d'une telle maintenance seront alors déterminés dans un acte séparé. Ces actes de maintenance et/ou assistance technique n'engageront que la seule responsabilité du Concédant qui les propose.
+
+7.2 De même, tout Concédant est libre de proposer, sous sa seule responsabilité, à ses licenciés une garantie, qui n'engagera que lui, lors de la redistribution du Logiciel et/ou du Logiciel Modifié et ce, dans les conditions qu'il souhaite. Cette garantie et les modalités financières de son application feront l'objet d'un acte séparé entre le Concédant et le Licencié.
+
+## Article 8 - RESPONSABILITE
+
+8.1 Sous réserve des dispositions de l'article 8.2, le Licencié a la faculté, sous réserve de prouver la faute du Concédant concerné, de solliciter la réparation du préjudice direct qu'il subirait du fait du Logiciel et dont il apportera la preuve.
+
+8.2 La responsabilité du Concédant est limitée aux engagements pris en application du Contrat et ne saurait être engagée en raison notamment: (i) des dommages dus à l'inexécution, totale ou partielle, de ses obligations par le Licencié, (ii) des dommages directs ou indirects découlant de l'utilisation ou des performances du Logiciel subis par le Licencié et (iii) plus généralement d'un quelconque dommage indirect. En particulier, les Parties conviennent expressément que tout préjudice financier ou commercial (par exemple perte de données, perte de bénéfices, perte d'exploitation, perte de clientèle ou de commandes, manque à gagner, trouble commercial quelconque) ou toute action dirigée contre le Licencié par un tiers, constitue un dommage indirect et n'ouvre pas droit à réparation par le Concédant.
+
+## Article 9 - GARANTIE
+
+9.1 Le Licencié reconnaît que l'état actuel des connaissances scientifiques et techniques au moment de la mise en circulation du Logiciel ne permet pas d'en tester et d'en vérifier toutes les utilisations ni de détecter l'existence d'éventuels défauts. L'attention du Licencié a été attirée sur ce point sur les risques associés au chargement, à l'utilisation, la modification et/ou au développement et à la reproduction du Logiciel qui sont réservés à des utilisateurs avertis.
+
+Il relève de la responsabilité du Licencié de contrôler, par tous moyens, l'adéquation du produit à ses besoins, son bon fonctionnement et de s'assurer qu'il ne causera pas de dommages aux personnes et aux biens.
+
+9.2 Le Concédant déclare de bonne foi être en droit de concéder l'ensemble des droits attachés au Logiciel (comprenant notamment les droits visés à l'article 5).
+
+9.3 Le Licencié reconnaît que le Logiciel est fourni "en l'état" par le Concédant sans autre garantie, expresse ou tacite, que celle prévue à l'article 9.2 et notamment sans aucune garantie sur sa valeur commerciale, son caractère sécurisé, innovant ou pertinent.
+
+En particulier, le Concédant ne garantit pas que le Logiciel est exempt d'erreur, qu'il fonctionnera sans interruption, qu'il sera compatible avec l'équipement du Licencié et sa configuration logicielle ni qu'il remplira les besoins du Licencié.
+
+9.4 Le Concédant ne garantit pas, de manière expresse ou tacite, que le Logiciel ne porte pas atteinte à un quelconque droit de propriété intellectuelle d'un tiers portant sur un brevet, un logiciel ou sur tout autre droit de propriété. Ainsi, le Concédant exclut toute garantie au profit du Licencié contre les actions en contrefaçon qui pourraient être diligentées au titre de l'utilisation, de la modification, et de la redistribution du Logiciel. Néanmoins, si de telles actions sont exercées contre le Licencié, le Concédant lui apportera son aide technique et juridique pour sa défense. Cette aide technique et juridique est déterminée au cas par cas entre le Concédant concerné et le Licencié dans le cadre d'un protocole d'accord. Le Concédant dégage toute responsabilité quant à l'utilisation de la dénomination du Logiciel par le Licencié. Aucune garantie n'est apportée quant à l'existence de droits antérieurs sur le nom du Logiciel et sur l'existence d'une marque.
+
+## Article 10 - RESILIATION
+
+10.1 En cas de manquement par le Licencié aux obligations mises à sa charge par le Contrat, le Concédant pourra résilier de plein droit le Contrat trente (30) jours après notification adressée au Licencié et restée sans effet.
+
+10.2 Le Licencié dont le Contrat est résilié n'est plus autorisé à utiliser, modifier ou distribuer le Logiciel. Cependant, toutes les licences qu'il aura concédées antérieurement à la résiliation du Contrat resteront valides sous réserve qu'elles aient été effectuées en conformité avec le Contrat.
+
+## Article 11 - DISPOSITIONS DIVERSES
+11.1 CAUSE EXTERIEURE
+
+Aucune des Parties ne sera responsable d'un retard ou d'une défaillance d'exécution du Contrat qui serait dû à un cas de force majeure, un cas fortuit ou une cause extérieure, telle que, notamment, le mauvais fonctionnement ou les interruptions du réseau électrique ou de télécommunication, la paralysie du réseau liée à une attaque informatique, l'intervention des autorités gouvernementales, les catastrophes naturelles, les dégâts des eaux, les tremblements de terre, le feu, les explosions, les grèves et les conflits sociaux, l'état de guerre...
+
+11.2 Le fait, par l'une ou l'autre des Parties, d'omettre en une ou plusieurs occasions de se prévaloir d'une ou plusieurs dispositions du Contrat, ne pourra en aucun cas impliquer renonciation par la Partie intéressée à s'en prévaloir ultérieurement.
+
+11.3 Le Contrat annule et remplace toute convention antérieure, écrite ou orale, entre les Parties sur le même objet et constitue l'accord entier entre les Parties sur cet objet. Aucune addition ou modification aux termes du Contrat n'aura d'effet à l'égard des Parties à moins d'être faite par écrit et signée par leurs représentants dûment habilités.
+
+11.4 Dans l'hypothèse où une ou plusieurs des dispositions du Contrat s'avèrerait contraire à une loi ou à un texte applicable, existants ou futurs, cette loi ou ce texte prévaudrait, et les Parties feraient les amendements nécessaires pour se conformer à cette loi ou à ce texte. Toutes les autres dispositions resteront en vigueur. De même, la nullité, pour quelque raison que ce soit, d'une des dispositions du Contrat ne saurait entraîner la nullité de l'ensemble du Contrat.
+11.5 LANGUE
+
+Le Contrat est rédigé en langue française et en langue anglaise, ces deux versions faisant également foi.
+## Article 12 - NOUVELLES VERSIONS DU CONTRAT
+
+12.1 Toute personne est autorisée à copier et distribuer des copies de ce Contrat.
+
+12.2 Afin d'en préserver la cohérence, le texte du Contrat est protégé et ne peut être modifié que par les auteurs de la licence, lesquels se réservent le droit de publier périodiquement des mises à jour ou de nouvelles versions du Contrat, qui posséderont chacune un numéro distinct. Ces versions ultérieures seront susceptibles de prendre en compte de nouvelles problématiques rencontrées par les logiciels libres.
+
+12.3 Tout Logiciel diffusé sous une version donnée du Contrat ne pourra faire l'objet d'une diffusion ultérieure que sous la même version du Contrat ou une version postérieure.
+## Article 13 - LOI APPLICABLE ET COMPETENCE TERRITORIALE
+
+13.1 Le Contrat est régi par la loi française. Les Parties conviennent de tenter de régler à l'amiable les différends ou litiges qui viendraient à se produire par suite ou à l'occasion du Contrat.
+
+13.2 A défaut d'accord amiable dans un délai de deux (2) mois à compter de leur survenance et sauf situation relevant d'une procédure d'urgence, les différends ou litiges seront portés par la Partie la plus diligente devant les Tribunaux compétents de Paris.
+
+1 CeCILL est pour Ce(a) C(nrs) I(nria) L(ogiciel) L(ibre)
+Version 1.0 du 2006-09-05.

py_sensor_things-0.1.1/PKG-INFO

@@ -0,0 +1,103 @@
+Metadata-Version: 2.4
+Name: py-sensor-things
+Version: 0.1.1
+Summary: Python packages for Sensor Thing API with request `https` 
+Author-email: Tberg <theo.berguig@free.fr>
+License-Expression: BSD-3-Clause AND CC-BY-NC-4.0
+Classifier: Development Status :: 3 - Alpha
+Classifier: Topic :: System :: Monitoring
+Classifier: Topic :: Scientific/Engineering :: GIS
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Requires-Python: >=3.12
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# Python POC implementing standard for STA OGC API for real python
+
+[![License: CC BY-NC 4.0](https://img.shields.io/badge/License-CC_BY--NC_4.0-lightgrey.svg?style=for-the-badge)](https://creativecommons.org/licenses/by-nc/4.0/)
+![Python](https://img.shields.io/badge/python-3670A0?style=for-the-badge&logo=python&logoColor=ffdd54)
+[![Static Badge OGC WPS](https://img.shields.io/badge/OGC-STApi-lightgreen?style=for-the-badge)](https://www.ogc.org/standards/sensorthings/)
+
+## Constate
+
+This programme is an interface like : 
+
+~~~
+┌───────────────┐    ┌...........┐    ┌───────────────┐
+│ Client Python │──────▶  HTTP  ─────▶│ Serveur   STA │
+└───────────────┘    └...........┘    └───────────────┘
+       ▲                                    │
+       └────────────────────────────────────┘
+                Give back data
+~~~
+
+## Usage: 
+
+~~~python
+from py_sta.model_sta import ModelSTA
+
+url_sta = "http://.../v1.1/"
+
+service = ModelSTA(url_sta)
+# return pure dict object
+model = (
+        service.observations()
+        .top(5)
+        .count()
+        .expand("FeatureOfInterest($select=@iot.id,name,feature)")
+        .order_by("phenomenonTime asc")
+        .execute()
+       )
+
+result = [elem for elem in model["value"] ]
+df_data = pandas.DataFrame(result)[["@iot.id","phenomenonTime","result"]]
+# out 
+   @iot.id        phenomenonTime  result
+0    47091  2025-02-09T15:10:00Z   515.0
+1    47203  2025-02-09T15:10:00Z  1941.0
+2    47092  2025-02-09T15:20:00Z   516.0
+3    47204  2025-02-09T15:20:00Z  1950.0
+4    47093  2025-02-09T15:30:00Z   516.0
+~~~
+
+
+### Print info 
+
+~~~py
+>>> service.info()
+╭──────────────────────────────────────────────────────────────────────────────────────────────────────╮
+🌐 URL: https://data.geoscience.fr/api/stapi/surfacewater/insitu/v1.1/
+      📅 Date min: 2025-02-09 15:10:00
+
+      📅 Date max: 2025-08-11 15:15:00
+╰──────────────────────────────────────────────────────────────────────────────────────────────────────╯
+
+                            Route:
+╭─────────────────────┬──────────────────────────────────────────────╮
+│ Name                │ endpoint                                     │
+├─────────────────────┼──────────────────────────────────────────────┤
+│ Datastreams         │ surfacewater/insitu/v1.1/Datastreams         │
+│ FeaturesOfInterest  │ surfacewater/insitu/v1.1/FeaturesOfInterest  │
+│ HistoricalLocations │ surfacewater/insitu/v1.1/HistoricalLocations │
+│ Locations           │ surfacewater/insitu/v1.1/Locations           │
+│ Observations        │ surfacewater/insitu/v1.1/Observations        │
+│ ObservedProperties  │ surfacewater/insitu/v1.1/ObservedProperties  │
+│ Sensors             │ surfacewater/insitu/v1.1/Sensors             │
+│ Things              │ surfacewater/insitu/v1.1/Things              │
+╰─────────────────────┴──────────────────────────────────────────────╯
+~~~
+
+## Next step
+
+- [ ] TODO
+
+# Credit 
+
+> [!IMPORTANT] 
+> Auteur : **Théo BERGUIG**
+>
+> No commercial, using code, contribute of code for projet **AND add cite this project**.
+>
+> **Date** : <ins>05/06/2026</ins>

py_sensor_things-0.1.1/Readme.md

@@ -0,0 +1,87 @@
+# Python POC implementing standard for STA OGC API for real python
+
+[![License: CC BY-NC 4.0](https://img.shields.io/badge/License-CC_BY--NC_4.0-lightgrey.svg?style=for-the-badge)](https://creativecommons.org/licenses/by-nc/4.0/)
+![Python](https://img.shields.io/badge/python-3670A0?style=for-the-badge&logo=python&logoColor=ffdd54)
+[![Static Badge OGC WPS](https://img.shields.io/badge/OGC-STApi-lightgreen?style=for-the-badge)](https://www.ogc.org/standards/sensorthings/)
+
+## Constate
+
+This programme is an interface like : 
+
+~~~
+┌───────────────┐    ┌...........┐    ┌───────────────┐
+│ Client Python │──────▶  HTTP  ─────▶│ Serveur   STA │
+└───────────────┘    └...........┘    └───────────────┘
+       ▲                                    │
+       └────────────────────────────────────┘
+                Give back data
+~~~
+
+## Usage: 
+
+~~~python
+from py_sta.model_sta import ModelSTA
+
+url_sta = "http://.../v1.1/"
+
+service = ModelSTA(url_sta)
+# return pure dict object
+model = (
+        service.observations()
+        .top(5)
+        .count()
+        .expand("FeatureOfInterest($select=@iot.id,name,feature)")
+        .order_by("phenomenonTime asc")
+        .execute()
+       )
+
+result = [elem for elem in model["value"] ]
+df_data = pandas.DataFrame(result)[["@iot.id","phenomenonTime","result"]]
+# out 
+   @iot.id        phenomenonTime  result
+0    47091  2025-02-09T15:10:00Z   515.0
+1    47203  2025-02-09T15:10:00Z  1941.0
+2    47092  2025-02-09T15:20:00Z   516.0
+3    47204  2025-02-09T15:20:00Z  1950.0
+4    47093  2025-02-09T15:30:00Z   516.0
+~~~
+
+
+### Print info 
+
+~~~py
+>>> service.info()
+╭──────────────────────────────────────────────────────────────────────────────────────────────────────╮
+🌐 URL: https://data.geoscience.fr/api/stapi/surfacewater/insitu/v1.1/
+      📅 Date min: 2025-02-09 15:10:00
+
+      📅 Date max: 2025-08-11 15:15:00
+╰──────────────────────────────────────────────────────────────────────────────────────────────────────╯
+
+                            Route:
+╭─────────────────────┬──────────────────────────────────────────────╮
+│ Name                │ endpoint                                     │
+├─────────────────────┼──────────────────────────────────────────────┤
+│ Datastreams         │ surfacewater/insitu/v1.1/Datastreams         │
+│ FeaturesOfInterest  │ surfacewater/insitu/v1.1/FeaturesOfInterest  │
+│ HistoricalLocations │ surfacewater/insitu/v1.1/HistoricalLocations │
+│ Locations           │ surfacewater/insitu/v1.1/Locations           │
+│ Observations        │ surfacewater/insitu/v1.1/Observations        │
+│ ObservedProperties  │ surfacewater/insitu/v1.1/ObservedProperties  │
+│ Sensors             │ surfacewater/insitu/v1.1/Sensors             │
+│ Things              │ surfacewater/insitu/v1.1/Things              │
+╰─────────────────────┴──────────────────────────────────────────────╯
+~~~
+
+## Next step
+
+- [ ] TODO
+
+# Credit 
+
+> [!IMPORTANT] 
+> Auteur : **Théo BERGUIG**
+>
+> No commercial, using code, contribute of code for projet **AND add cite this project**.
+>
+> **Date** : <ins>05/06/2026</ins>

py_sensor_things-0.1.1/pyproject.toml

@@ -0,0 +1,35 @@
+[build-system]
+requires = ["setuptools>=77.0.3"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "py-sensor-things"
+version = "0.1.1"
+authors = [
+  { name="Tberg", email="theo.berguig@free.fr" },
+]
+description = "Python packages for Sensor Thing API with request `https` "
+readme = "Readme.md"
+requires-python = ">=3.12"
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Topic :: System :: Monitoring",
+    "Topic :: Scientific/Engineering :: GIS",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+]
+license = "BSD-3-Clause and CC-BY-NC-4.0"
+license-files = ["LICENSE"]
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.pytest.ini_options]
+addopts = "--cov=monmodule --cov-report=term-missing"
+
+[tool.coverage.report]
+show_missing = true
+
+[tool.coverage.run]
+branch = true
+command_line = "-m unittest discover -s tests/"

py_sensor_things-0.1.1/setup.cfg

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

py_sensor_things-0.1.1/src/py_sensor_things.egg-info/PKG-INFO

@@ -0,0 +1,103 @@
+Metadata-Version: 2.4
+Name: py-sensor-things
+Version: 0.1.1
+Summary: Python packages for Sensor Thing API with request `https` 
+Author-email: Tberg <theo.berguig@free.fr>
+License-Expression: BSD-3-Clause AND CC-BY-NC-4.0
+Classifier: Development Status :: 3 - Alpha
+Classifier: Topic :: System :: Monitoring
+Classifier: Topic :: Scientific/Engineering :: GIS
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Requires-Python: >=3.12
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# Python POC implementing standard for STA OGC API for real python
+
+[![License: CC BY-NC 4.0](https://img.shields.io/badge/License-CC_BY--NC_4.0-lightgrey.svg?style=for-the-badge)](https://creativecommons.org/licenses/by-nc/4.0/)
+![Python](https://img.shields.io/badge/python-3670A0?style=for-the-badge&logo=python&logoColor=ffdd54)
+[![Static Badge OGC WPS](https://img.shields.io/badge/OGC-STApi-lightgreen?style=for-the-badge)](https://www.ogc.org/standards/sensorthings/)
+
+## Constate
+
+This programme is an interface like : 
+
+~~~
+┌───────────────┐    ┌...........┐    ┌───────────────┐
+│ Client Python │──────▶  HTTP  ─────▶│ Serveur   STA │
+└───────────────┘    └...........┘    └───────────────┘
+       ▲                                    │
+       └────────────────────────────────────┘
+                Give back data
+~~~
+
+## Usage: 
+
+~~~python
+from py_sta.model_sta import ModelSTA
+
+url_sta = "http://.../v1.1/"
+
+service = ModelSTA(url_sta)
+# return pure dict object
+model = (
+        service.observations()
+        .top(5)
+        .count()
+        .expand("FeatureOfInterest($select=@iot.id,name,feature)")
+        .order_by("phenomenonTime asc")
+        .execute()
+       )
+
+result = [elem for elem in model["value"] ]
+df_data = pandas.DataFrame(result)[["@iot.id","phenomenonTime","result"]]
+# out 
+   @iot.id        phenomenonTime  result
+0    47091  2025-02-09T15:10:00Z   515.0
+1    47203  2025-02-09T15:10:00Z  1941.0
+2    47092  2025-02-09T15:20:00Z   516.0
+3    47204  2025-02-09T15:20:00Z  1950.0
+4    47093  2025-02-09T15:30:00Z   516.0
+~~~
+
+
+### Print info 
+
+~~~py
+>>> service.info()
+╭──────────────────────────────────────────────────────────────────────────────────────────────────────╮
+🌐 URL: https://data.geoscience.fr/api/stapi/surfacewater/insitu/v1.1/
+      📅 Date min: 2025-02-09 15:10:00
+
+      📅 Date max: 2025-08-11 15:15:00
+╰──────────────────────────────────────────────────────────────────────────────────────────────────────╯
+
+                            Route:
+╭─────────────────────┬──────────────────────────────────────────────╮
+│ Name                │ endpoint                                     │
+├─────────────────────┼──────────────────────────────────────────────┤
+│ Datastreams         │ surfacewater/insitu/v1.1/Datastreams         │
+│ FeaturesOfInterest  │ surfacewater/insitu/v1.1/FeaturesOfInterest  │
+│ HistoricalLocations │ surfacewater/insitu/v1.1/HistoricalLocations │
+│ Locations           │ surfacewater/insitu/v1.1/Locations           │
+│ Observations        │ surfacewater/insitu/v1.1/Observations        │
+│ ObservedProperties  │ surfacewater/insitu/v1.1/ObservedProperties  │
+│ Sensors             │ surfacewater/insitu/v1.1/Sensors             │
+│ Things              │ surfacewater/insitu/v1.1/Things              │
+╰─────────────────────┴──────────────────────────────────────────────╯
+~~~
+
+## Next step
+
+- [ ] TODO
+
+# Credit 
+
+> [!IMPORTANT] 
+> Auteur : **Théo BERGUIG**
+>
+> No commercial, using code, contribute of code for projet **AND add cite this project**.
+>
+> **Date** : <ins>05/06/2026</ins>

py_sensor_things-0.1.1/src/py_sensor_things.egg-info/SOURCES.txt

@@ -0,0 +1,11 @@
+LICENSE
+Readme.md
+pyproject.toml
+src/py_sensor_things.egg-info/PKG-INFO
+src/py_sensor_things.egg-info/SOURCES.txt
+src/py_sensor_things.egg-info/dependency_links.txt
+src/py_sensor_things.egg-info/top_level.txt
+src/py_sta/__init__.py
+src/py_sta/model_sta.py
+src/py_sta/pp.py
+test/test_model_sta.py

py_sensor_things-0.1.1/src/py_sensor_things.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

py_sensor_things-0.1.1/src/py_sensor_things.egg-info/top_level.txt

@@ -0,0 +1 @@
+py_sta

py_sensor_things-0.1.1/src/py_sta/model_sta.py

@@ -0,0 +1,210 @@
+import requests
+import json
+import pandas as pad
+import datetime
+from . import pp 
+
+class ModelSTA:
+    def __init__(self, url_sta):
+        self.url = url_sta
+        self.date_min = self._get_date_min()
+        self.date_max = self._get_date_max()
+        self._server_routes, self._server_settings = self._build_setting()
+        self._query_params = {}
+        self._entity_name = None
+        self.data_object = None
+        # self._key_word = {"$top":None,"$skip":None,"$count":,"$orderBy":None,"$select":None,"$filter":None,"$expand":None}
+        # self._operation = {"eq":"==","ne":"!=","gt":">","ge":">=","lt":"<","le":"<=","and":"and","or":"or","not":"not"}
+
+    def info(self):
+        pp.display_info(self.url,self.date_min,self.date_max)
+        pp.afficher_tableau_route(self._server_routes)
+
+    def things(self):
+        self._entity_name = "Things"
+        return self
+
+    def locations(self):
+        self._entity_name = "Locations"
+        return self
+
+    def sensors(self):
+        self._entity_name = "Sensors"
+        return self
+
+    def datastreams(self):
+        self._entity_name = "Datastreams"
+        return self
+
+    def observed_propertys(self):
+        self._entity_name = "ObservedPropertys"
+        return self
+
+    def observations(self):
+        self._entity_name = "Observations"
+        return self
+
+    def feature_of_interests(self):
+        self._entity_name = "FeatureOfInterests"
+        return self
+
+    def historical_locations(self):
+        self._entity_name = "HistoricalLocations"
+        return self
+
+    def _build_setting(self):
+        try:
+            # Effectuer la requête HTTP
+            req = requests.get(self.url)
+            req.raise_for_status()  # Lève une exception si le statut HTTP est une erreur (4xx, 5xx)
+            # Convertir la réponse en dictionnaire Python
+            dict_obj = req.json()
+            # Vérifier la structure attendue
+            if isinstance(dict_obj, dict) and set(dict_obj.keys()) == {
+                "value",
+                "serverSettings",
+            }:
+                route = {}
+                # construit un dictionnaire par "name"
+                # Things ==> $base_url$/v1.1/Things
+                for k in dict_obj["value"]:
+                    route[k["name"]] = k["url"]
+                return route, dict_obj["serverSettings"]
+            else:
+                raise ValueError(
+                    "La réponse ne contient pas les clés attendues ('value' et 'serverSettings')."
+                )
+
+        except requests.exceptions.RequestException as e:
+            print(f"Erreur {req.codes} lors de la requête HTTP : {e}")
+            return None, None  # ou lever une exception personnalisée
+        except json.JSONDecodeError as e:
+            print(f"Erreur de décodage JSON : {e}")
+            return None, None
+        except ValueError as e:
+            print(f"Erreur de validation des données : {e}")
+            return None, None
+
+    # enddef
+
+    def top(self, n) -> "ModelSTA":
+        self._query_params["$top"] = str(n)
+        return self
+
+    def count(self):
+        self._query_params["$count"] = str(True)
+        return self
+
+    def order_by(self, *fields):
+        self._query_params["$orderBy"] = ",".join(fields)
+        return self
+
+    def select(self, *fields):
+        self._query_params["$select"] = ",".join(fields)
+        return self
+
+    def filter(self, param):
+        self._query_params["$select"] = str(param)
+        return self
+
+    def expand(self, *fields):
+        self._query_params["$expand"] = ",".join(fields)
+        return self
+
+    def _construct_query(self) -> str:
+        """conatnate string element
+        self._query_params
+        like
+        >>> "?$top=12&$count=True&$skip=5&$select=@iot.id,name&$orderBy='phenomenonTime desc"
+
+        Returns
+        -------
+        str
+            query construction returned
+        """
+        tmp = ""
+        for param in self._query_params:
+            tmp += f"{param}={self._query_params[param]}&"
+        tmp = tmp[:-1]
+        return "?" + tmp
+
+    # end
+    def _build_query_url(self):
+        if not self._entity_name or self._entity_name == None:
+            raise ValueError("Aucune entité nommée spécifiée. ex : /Thing ")
+        if not self._query_params:
+            raise ValueError("Aucune requête definie")
+
+        # construct query url
+        query = self._construct_query()
+        # TODO : create validate query
+        # all url have a slash /
+        return self.url + self._entity_name + query
+
+    # end
+    def execute(self) -> dict:
+        """execute
+
+        Returns
+        -------
+        dict
+            Give data json form Request HTTP
+
+        """        
+        try:
+            req = requests.get(self._build_query_url())
+            req.raise_for_status()
+            self.data_object = req.json()
+            return self.data_object
+        except Exception as e:
+            raise e
+
+    # end
+    def to_pandas(self):
+        return pad.DataFrame(self.data_object)
+
+    def get_one_things(slef, id):
+        try:
+            req = requests.get(slef._server_routes["Things"] + f"({id})")
+            req.raise_for_status()
+            return req.json()
+        except requests.exceptions.RequestException as e:
+            print(f"Erreur lors de la requête HTTP verifier la requête : {e}")
+            return None
+        except json.JSONDecodeError as e:
+            print(f"Erreur de décodage JSON : {e}")
+            return None
+        except Exception as e:
+            print(f"Erreur : {e}")
+
+    # enddef
+
+    def _get_date_min(self):
+        min_date = json.loads(
+            requests.get(
+                self.url + "Observations?$top=1&$orderby=phenomenonTime%20asc"
+            ).content
+        )["value"][0]["phenomenonTime"]
+        return datetime.datetime.strptime(min_date, "%Y-%m-%dT%H:%M:%SZ")
+
+    # end
+
+    def _get_date_max(self):
+        max_date = json.loads(
+            requests.get(
+                self.url + "Observations?$top=1&$orderby=phenomenonTime%20desc"
+            ).content
+        )["value"][0]["phenomenonTime"]
+        return datetime.datetime.strptime(max_date, "%Y-%m-%dT%H:%M:%SZ")
+    # end
+
+    # ---- geter ----
+    @property
+    def get_routes(self):
+        return self._server_routes
+    # enddef
+
+    @property
+    def get_server_settings(self):
+        return self._server_settings
+    # enddef

py_sensor_things-0.1.1/src/py_sta/pp.py

@@ -0,0 +1,29 @@
+from rich.table import Table
+from rich.console import Console
+from rich import box
+
+# Initialiser la console Rich (une seule fois)
+console = Console()
+
+def afficher_tableau_route(obj_json):
+    titre="Route"
+    colonne_titre="endpoint"
+    console.print(f"\n[bold cyan]{titre}:[/bold cyan]",justify="center")
+    table = Table(box=box.ROUNDED,show_header=True, header_style="bold light_green")
+    table.add_column("Name", style="dim")
+    table.add_column(colonne_titre)
+
+    for element in list(obj_json.keys()):
+        table.add_row(str(element), ""+"/".join(str(obj_json[element]).split("/")[5:]))
+    console.print(table)
+
+
+def display_info(url,date_min,date_max):
+    console.print(
+        f"╭──────────────────────────────────────────────────────────────────────────────────────────────────────╮"
+        f"      🌐 URL: [bold]{url}[/bold]\n"
+        f"      📅 Date min: [green]{str(date_min)}[/green]\n\n"
+        f"      📅 Date max: [rgb(240,180,70)]{str(date_max)}[/rgb(240,180,70)]\n"
+        f"╰──────────────────────────────────────────────────────────────────────────────────────────────────────╯"
+
+    )

py_sensor_things-0.1.1/test/test_model_sta.py

@@ -0,0 +1,139 @@
+import pytest
+import requests
+import json
+import datetime
+from py_sta.model_sta import ModelSTA
+
+
+# =========================================================
+#               Fix data
+# =========================================================
+@pytest.fixture
+def url_valide():
+    return "https://data.geoscience.fr/api/stapi/surfacewater/insitu/v1.1/"
+
+
+@pytest.fixture
+def url_unvalide():
+    return "http:/data.geoscience.fr/api/stapi/surfacewater/insitu"
+
+
+@pytest.fixture
+def model_init(url_valide):
+    return ModelSTA(url_valide)
+
+
+@pytest.fixture
+def json_data_1():
+    with open("test/data_test_req_1.json") as f:
+        return json.load(f)
+
+
+@pytest.fixture
+def json_ont_thing():
+    with open("test/data_test_one_things.json") as f:
+        return json.load(f)
+
+
+@pytest.fixture
+def json_data_expend():
+    with open("test/data_test_query_expend.json") as f:
+        return json.load(f)
+
+
+# =========================================================
+#               TEST
+# =========================================================
+
+
+def test_init(url_valide):
+    model = ModelSTA(url_valide)
+    assert isinstance(model, ModelSTA)
+
+
+def test_entity_len(model_init):
+    assert len(model_init._server_routes) == 8
+
+
+def test_entity_name(model_init):
+    for k in model_init._server_routes:
+        match k:
+            case "Things":
+                assert model_init.things()._entity_name == k
+            case "Locations":
+                assert model_init.locations()._entity_name == k
+            case "Sensors":
+                assert model_init.sensors()._entity_name == k
+            case "Datastreams":
+                assert model_init.datastreams()._entity_name == k
+            case "ObservedPropertys":
+                assert model_init.observed_propertys()._entity_name == k
+            case "Observations":
+                assert model_init.observations()._entity_name == k
+            case "FeatureOfInterests":
+                assert model_init.feature_of_interests()._entity_name == k
+            case "HistoricalLocations":
+                assert model_init.historical_locations()._entity_name == k
+
+
+def test_query(url_valide, json_data_1):
+    model = ModelSTA(url_valide)
+    req = model.observations().top(3).order_by("phenomenonTime desc").execute()
+    assert req == json_data_1
+
+
+def test_one_thing(url_valide, json_ont_thing):
+    model = ModelSTA(url_valide)
+    one_thing = model.get_one_things(1)
+    assert one_thing == json_ont_thing
+
+
+def test_data_min(url_valide):
+    model = ModelSTA(url_valide)
+    min_data = model._get_date_min()
+    assert min_data == datetime.datetime(2025, 2, 9, 15, 10) and isinstance(
+        min_data, datetime.datetime
+    )
+
+
+def test_data(url_valide):
+    model = ModelSTA(url_valide)
+    min_data = model._get_date_min()
+    max_date = model._get_date_max()
+    assert min_data < max_date
+
+
+def test_property_route(model_init):
+    assert model_init.get_routes == model_init._server_routes
+
+
+def test_property_setting(model_init):
+    assert model_init.get_server_settings == model_init._server_settings
+
+
+def test_query_expand(model_init, json_data_expend):
+    model = (
+        model_init.observations()
+        .top(5)
+        .count()
+        .expand("FeatureOfInterest($select=@iot.id,name,feature)")
+        .order_by("phenomenonTime asc")
+        .execute()
+    )
+    assert model == json_data_expend
+
+
+# =========== Unvalide ===========
+
+
+def test_error_init(url_unvalide):
+    with pytest.raises(requests.exceptions.InvalidURL):
+        ModelSTA(url_unvalide)
+
+
+def test_error_one_thing(url_valide):
+    model = ModelSTA(url_valide)
+    assert model.get_one_things(-11) == None
+
+# def test_error_build_setting(url_unvalide):
+#     model = ModelSTA(url_unvalide)