Generate public API layer
Personne n'a encore pris cette issue.
Évaluation
- Difficulté
- 5/5
- Temps estimé
- Plus d'une semaine
- Accessibilité débutants
- 35/100
- Type d'issue
- Fonctionnalité
- Clarté
- À clarifier
- Activité
- Calme
- Stack technique
- python
- Domaine
- api, developer-experience
Piste de recherche
Commencez par examiner la mécanique de génération créée pour #30 et les interfaces exposées via wit_world.imports. Évaluez dans quelle mesure les interfaces générées par componentize-py sont ergonomiques en tant qu’API publique directe, notamment pour déterminer si elles nécessitent un wrapper préservant la compatibilité. Le travail est terminé lorsqu’une décision sur la structure des modules publics et l’approche de génération a été prise et documentée.
Rédigé par le modèle d'indexation à partir du texte de l'issue.
Description
Strawman:
Generate a top-level module within fastly_compute for each of the interfaces in wit_world.imports. Import the whole contents of the latter in the former, and the former becomes our public API.
If we want to expose the componentize-py-generated stuff directly to the public, we can. If we change our minds in a backward-compatible way, we can replace an item in, say, fastly_compute.acl with a nicer one of the same name, hiding the wit_world one behind it. Even class comparisons using isinstance() should continue to work, since all the customer ever got ahold of as a comparand was the public import path.
The machinery made for #30 can handle the generation fairly easily.
But: how ergonomic is the straight wit_world stuff? Are we going to want to paper over all of it anyway? I have not yet looked it over with that in mind.
- Langage dominant
- Python
- Étoiles
- 5
- Forks
- 1
- Métriques de merge des PR
- Aucune PR mergée en 30 j
Préparer son environnement
- Aucun Dockerfile ni fichier Docker Compose
- Aucun modèle de pull request
- Lire le guide de contribution
Par où commencer
- Lisez l'issue en entier, puis le guide de contribution du projet.
- Signalez en commentaire que vous la prenez — cela évite que deux personnes fassent le même travail.
- Forkez le dépôt et travaillez sur une branche.
- Ouvrez une pull request qui référence le numéro de l'issue.
Autres issues de fastly/compute-sdk-python
-
Difficulté 2/5 1-3 heures Accessibilité débutants 75/100
fastly/compute-sdk-python#116 ·
-
Difficulté 4/5 3-5 jours Accessibilité débutants 35/100
fastly/compute-sdk-python#98 ·
-
Difficulté 5/5 Plus d'une semaine Accessibilité débutants 35/100
fastly/compute-sdk-python#74 ·
-
Add HTTP Downstream Metadata APIOuverte
Difficulté 5/5 Plus d'une semaine Accessibilité débutants 35/100
fastly/compute-sdk-python#61 ·
-
Set up Sphinx Documentation InfrastructurePeut-être à nouveau libre @erikrose l’a pris il y a 187 jours, et aucune pull request n’est ouverte. Ouverte
fastly/compute-sdk-python#60 · 1 personne assignée ·
Toutes les issues de fastly/compute-sdk-python
Issues similaires
-
enhancement from-review
Difficulté 2/5 1-3 heures Accessibilité débutants 78/100
khuisman/mcp-gee-sweet#1010 ·
Les mainteneurs répondent en général sous 1 jour
-
bug confirmed issue
Difficulté 2/5 1-3 heures Accessibilité débutants 72/100
open-webui/open-webui#32333 · 2 commentaires ·
Les mainteneurs répondent en général sous 1 jour
-
Difficulté 2/5 1-3 heures Accessibilité débutants 68/100
ll7/robot_sf_ll7#10368 ·
Les mainteneurs répondent en général sous 1 jour
-
Difficulté 2/5 1-3 heures Accessibilité débutants 62/100
-
mcp: a write that loses its answer is reported as "cannot reach", although it may have landedOuverte
Difficulté 2/5 1-3 heures Accessibilité débutants 68/100
flop-labs/technocore-chat#982 ·
Les mainteneurs répondent en général sous 1 jour