contexte 0.1.0__py3-none-any.whl

contexte/__init__.py

@@ -0,0 +1,176 @@
+"""contexte : client Python de ContexteTech : charger une fiche (dataset, prompt, contexte…) en une ligne.
+
+    import contexte
+
+    ds = contexte.load("contextetech/anonymisation-rgpd-fr")        # dataset → lignes (dict)
+    p = contexte.load("contextetech/fiche-produit-ecommerce")        # prompt → p.fill(produit=…)
+    c = contexte.load("contextetech/anonymisation-rgpd")             # contexte → c.messages("texte")
+    contexte.search("rgpd", kind="dataset")                          # recherche dans le catalogue
+    contexte.cost("contextetech/anonymisation-rgpd")                 # coût estimé par modèle
+
+Aucune dépendance : seulement la bibliothèque standard. `Dataset.to_hf()` utilise `datasets` s'il est installé.
+"""
+from __future__ import annotations
+
+import json
+import os
+import re
+import urllib.error
+import urllib.parse
+import urllib.request
+
+__version__ = "0.1.0"
+__all__ = ["Client", "Resource", "Dataset", "Prompt", "Context", "load", "get", "search", "cost", "ContexteTechError"]
+
+BASE_URL = os.environ.get("CONTEXTETECH_URL", "https://contextetech.com").rstrip("/")
+
+
+class ContexteTechError(Exception):
+    """Erreur renvoyée par l'API (fiche introuvable, réseau…)."""
+
+
+def _to_id(ref: str) -> str:
+    """« auteur/nom » → identifiant « auteur--nom » ; un identifiant est laissé tel quel."""
+    ref = ref.strip().strip("/")
+    if "/" in ref:
+        author, name = ref.split("/", 1)
+        return f"{author}--{name}"
+    return ref
+
+
+class Resource(dict):
+    """Fiche brute renvoyée par l'API (dictionnaire), avec quelques raccourcis."""
+
+    @property
+    def id(self) -> str:
+        return self["id"]
+
+    @property
+    def kind(self) -> str:
+        return self["kind"]
+
+    @property
+    def name(self) -> str:
+        return self["name"]
+
+    @property
+    def license(self) -> str:
+        return self.get("license", "")
+
+    def __repr__(self) -> str:
+        return f"<{type(self).__name__} {self.get('authorHandle', '')}/{self.get('name', '')}>"
+
+
+class Dataset(Resource):
+    """Dataset : `rows` (liste de dict), itérable, `len()`, `to_hf()`."""
+
+    rows: list
+
+    def __iter__(self):
+        return iter(self.rows)
+
+    def __len__(self) -> int:
+        return len(self.rows)
+
+    def __getitem__(self, key):
+        return self.rows[key] if isinstance(key, (int, slice)) else super().__getitem__(key)
+
+    def to_hf(self):
+        """Dataset `datasets.Dataset` (nécessite `pip install datasets`)."""
+        from datasets import Dataset as HFDataset
+        return HFDataset.from_list(self.rows)
+
+
+class Prompt(Resource):
+    """Prompt à trous {{variable}} : `variables`, `fill(**valeurs)`."""
+
+    @property
+    def template(self) -> str:
+        return self.get("template", "")
+
+    @property
+    def variables(self) -> list[str]:
+        return list(dict.fromkeys(re.findall(r"\{\{\s*([\w-]+)\s*\}\}", self.template)))
+
+    def fill(self, **values) -> str:
+        missing = [v for v in self.variables if v not in values]
+        if missing:
+            raise ValueError(f"Variables manquantes : {', '.join(missing)}")
+        return re.sub(r"\{\{\s*([\w-]+)\s*\}\}", lambda m: str(values[m.group(1)]), self.template)
+
+
+class Context(Resource):
+    """Contexte few-shot : consigne système, exemples, connaissances ; `messages(texte)` pour une API de chat."""
+
+    @property
+    def system(self) -> str:
+        return self.get("system", "")
+
+    @property
+    def examples(self) -> list[dict]:
+        return self.get("examples") or []
+
+    @property
+    def knowledge(self) -> str:
+        return self.get("knowledge", "")
+
+    def system_prompt(self) -> str:
+        """Consigne système complète (consigne + connaissances)."""
+        return self.system + (f"\n\n{self.knowledge}" if self.knowledge else "")
+
+    def messages(self, user_input: str) -> list[dict]:
+        """Messages prêts pour une API de chat : exemples en tours user/assistant, puis votre texte.
+        La consigne système est à passer à part (`system_prompt()`), comme le demandent la plupart des API."""
+        out = []
+        for ex in self.examples:
+            out += [{"role": "user", "content": ex.get("input", "")}, {"role": "assistant", "content": ex.get("output", "")}]
+        return out + [{"role": "user", "content": user_input}]
+
+
+_KINDS = {"dataset": Dataset, "prompt": Prompt, "context": Context}
+
+
+class Client:
+    """Accès à l'API publique de ContexteTech (lecture seule, sans compte)."""
+
+    def __init__(self, base_url: str = BASE_URL, timeout: float = 30):
+        self.base_url = base_url.rstrip("/")
+        self.timeout = timeout
+
+    def _get(self, path: str, raw: bool = False):
+        req = urllib.request.Request(self.base_url + path, headers={"User-Agent": f"contexte-python/{__version__}", "Accept": "application/json"})
+        try:
+            with urllib.request.urlopen(req, timeout=self.timeout) as r:
+                body = r.read().decode("utf-8")
+        except urllib.error.HTTPError as e:
+            raise ContexteTechError(f"{e.code} sur {path}" + (" : fiche introuvable" if e.code == 404 else "")) from None
+        except urllib.error.URLError as e:
+            raise ContexteTechError(f"Réseau : {e.reason}") from None
+        return body if raw else json.loads(body)
+
+    def get(self, ref: str) -> Resource:
+        """Fiche brute (dictionnaire) : « auteur/nom » ou identifiant."""
+        data = self._get(f"/api/resources/{urllib.parse.quote(_to_id(ref))}")
+        return _KINDS.get(data.get("kind"), Resource)(data)
+
+    def load(self, ref: str) -> Resource:
+        """Fiche prête à l'emploi : Dataset (lignes chargées), Prompt, Context ou Resource."""
+        res = self.get(ref)
+        if isinstance(res, Dataset):
+            text = res.get("jsonl") or self._get(f"/api/resources/{urllib.parse.quote(res.id)}/download", raw=True)
+            res.rows = [json.loads(line) for line in text.splitlines() if line.strip()]
+        return res
+
+    def search(self, q: str = "", kind: str = "", lang: str = "", page: int = 1) -> list[Resource]:
+        """Recherche dans le catalogue ; renvoie des fiches résumées (sans le contenu)."""
+        params = {k: v for k, v in {"q": q, "kind": kind, "lang": lang, "page": page}.items() if v}
+        data = self._get("/api/resources?" + urllib.parse.urlencode(params))
+        return [_KINDS.get(it.get("kind"), Resource)(it) for it in data.get("items", [])]
+
+    def cost(self, ref: str) -> dict:
+        """Coût estimé en euros : par modèle d'API (tokens) ou, pour un modèle ouvert, location de GPU."""
+        return self._get(f"/api/resources/{urllib.parse.quote(_to_id(ref))}/cost")
+
+
+_default = Client()
+get, load, search, cost = _default.get, _default.load, _default.search, _default.cost

contexte-0.1.0.dist-info/METADATA

@@ -0,0 +1,54 @@
+Metadata-Version: 2.4
+Name: contexte
+Version: 0.1.0
+Summary: Load ContexteTech resources (datasets, prompts, contexts) in one line of Python.
+Author-email: ContexteTech <coucou@contextetech.com>
+License-Expression: MIT
+Project-URL: Homepage, https://contextetech.com/en/
+Project-URL: Documentation, https://contextetech.com/api/docs
+Keywords: llm,prompts,datasets,fine-tuning,few-shot,contextetech,contexte
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: Intended Audience :: Developers
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Provides-Extra: hf
+Requires-Dist: datasets; extra == "hf"
+Dynamic: license-file
+
+# contexte
+
+Load resources from [ContexteTech](https://contextetech.com/en/) — datasets, prompts, few-shot contexts — in one line of Python. No dependencies.
+
+```bash
+pip install contexte
+```
+
+```python
+import contexte
+
+# Dataset: rows as dicts (JSONL messages)
+ds = contexte.load("contextetech/anonymisation-rgpd-fr")
+print(len(ds), ds[0]["messages"][1]["content"])
+
+# Prompt with {{variables}}
+p = contexte.load("contextetech/fiche-produit-ecommerce")
+print(p.variables)                   # ['produit', 'caracteristiques', 'public']
+text = p.fill(produit="Casque audio", caracteristiques="Bluetooth, 30 h", public="étudiants")
+
+# Few-shot context, ready for any chat API
+c = contexte.load("contextetech/anonymisation-rgpd")
+system = c.system_prompt()
+messages = c.messages("Bonjour, je suis Jean Martin, 06 11 22 33 44.")
+
+# Search and cost
+contexte.search("rgpd", kind="dataset")
+contexte.cost("contextetech/anonymisation-rgpd")     # estimated cost per model, in euros
+```
+
+A resource is referenced as `author/name`, as shown on its page. Read-only, no account needed.
+
+## License
+
+MIT. The ContexteTech name and logos are trademarks and are not covered by this license.

contexte-0.1.0.dist-info/RECORD

@@ -0,0 +1,6 @@
+contexte/__init__.py,sha256=mY0kMEkmE_KAGuIKMs1k0YUqNzljQTREXnMXNunFAbg,6768
+contexte-0.1.0.dist-info/licenses/LICENSE,sha256=8K65Ea34j3rWRhAWv_VLJbCFo965q2n5oTGDZE5LfiM,1082
+contexte-0.1.0.dist-info/METADATA,sha256=RUKJUTanP7k4cyCCA-6tN6_TXyHx2kbvZd_6BiN9NsY,1916
+contexte-0.1.0.dist-info/WHEEL,sha256=YVMoNqKzERt-wjUZwJ33xBGAwnFl-4cqbYkTtWa4itE,91
+contexte-0.1.0.dist-info/top_level.txt,sha256=Mv-esQ7S67YhTVEoU-fq0_9SmCERX66EQyacQI0nWRk,9
+contexte-0.1.0.dist-info/RECORD,,

contexte-0.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (84.0.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

contexte-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 ContexteTech (Tonydevweb)
+
+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.

contexte-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+contexte