Generate public API layer
Dieses Issue hat noch niemand übernommen.
Bewertung
- Schwierigkeit
- 5/5
- Geschätzter Aufwand
- Über eine Woche
- Anfängerfreundlichkeit
- 35/100
- Issue-Typ
- Feature
- Klarheit
- Muss geklärt werden
- Aktivitätsstatus
- Ruhig
- Tech-Stack
- python
- Bereich
- api, developer-experience
Rechercherichtung
Beginne mit der Überprüfung der für #30 erstellten Generierungsmechanismen und der über wit_world.imports bereitgestellten Schnittstellen. Beurteile, wie ergonomisch die von componentize-py generierten Schnittstellen als direkte öffentliche API sind, einschließlich der Frage, ob sie einen kompatibilitätserhaltenden Wrapper benötigen. Als erledigt gilt die Aufgabe, wenn eine Entscheidung über die öffentliche Modulstruktur und den Generierungsansatz getroffen und dokumentiert wurde.
Vom Indexierungsmodell aus dem Issue-Text verfasst.
Beschreibung
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.
- Vorherrschende Sprache
- Python
- Sterne
- 5
- Forks
- 1
- PR-Merge-Kennzahlen
- Keine gemergten PRs in 30 T.
Entwicklungsumgebung
- Kein Dockerfile und keine Docker-Compose-Datei
- Keine Pull-Request-Vorlage
- Beitragsleitfaden lesen
Erste Schritte
- Lesen Sie das ganze Issue und danach den Beitragsleitfaden des Projekts.
- Schreiben Sie ins Issue, dass Sie es übernehmen — das erspart doppelte Arbeit.
- Forken Sie das Repository und arbeiten Sie in einem Branch.
- Öffnen Sie einen Pull Request, der die Issue-Nummer nennt.
Mehr aus fastly/compute-sdk-python
-
Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 75/100
fastly/compute-sdk-python#116 ·
-
Schwierigkeit 4/5 3-5 Tage Anfängerfreundlichkeit 35/100
fastly/compute-sdk-python#98 ·
-
Schwierigkeit 5/5 Über eine Woche Anfängerfreundlichkeit 35/100
fastly/compute-sdk-python#74 ·
-
Schwierigkeit 5/5 Über eine Woche Anfängerfreundlichkeit 35/100
fastly/compute-sdk-python#61 ·
-
Set up Sphinx Documentation InfrastructureEvtl. wieder frei @erikrose hat das vor 185 Tagen übernommen, und es ist kein Pull Request offen. Offen
fastly/compute-sdk-python#60 · 1 zugewiesene Person ·
Alle Issues in fastly/compute-sdk-python
Ähnliche Issues
-
bug
Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 72/100
awslabs/visual-asset-management-system#414 ·
Maintainer antworten meist innerhalb von 1 Tag
-
bug v1 v2
Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 75/100
modelcontextprotocol/python-sdk#3670 · 1 Kommentar ·
Maintainer antworten meist innerhalb von 1 Tag
-
Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 82/100
aicell-lab/bioengine#232 ·
Maintainer antworten meist innerhalb von 1 Tag
-
Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 74/100
modelscope/evalscope#1836 ·
Maintainer antworten meist innerhalb von 1 Tag
-
Schwierigkeit 2/5 1-3 Stunden Anfängerfreundlichkeit 72/100