Hacktoberfest 2026: le issue che i maintainer hanno segnato per ottobre, aperte e adatte ai principianti. Sfoglia le issue Hacktoberfest

doc: Add explanation of when to use obstore's HttpStore vs obspec-utils AiohttpReadableStore

Aperta
  • Qualcosa non va?
#63 0 commenti 2 reazioni 0 assegnatari Vedi su GitHub

Nessuno ha ancora preso questa issue.

Valutazione

Difficoltà
2/5
Tempo stimato
1-3 ore
Idoneità per principianti
52/100
Tipo di issue
Documentazione
Chiarezza
Abbastanza chiara
Stato di attività
Ferma
Stack tecnologico
python
Ambito
documentation

Direzione di ricerca

Esamina la documentazione esistente e le API di AiohttpReadableStore e HttpStore, usando issue #50 come contesto per i limiti di AiohttpStore. Il lavoro sarà considerato completato quando la documentazione spiegherà chiaramente lo Store preferito, l’eccezione WebDAV, le differenze negli elenchi HTTP e nelle credenziali, nonché la riserva relativa agli attuali miglioramenti di AiohttpStore.

Scritto dal modello di indicizzazione a partire dal testo della issue.

Descrizione

a common question that's worth addressing in the docs. The wisdom Kyle shared is that most times you'd prefer the AiohttpReadableStore unless using something that HttpStore is built for, like WebDAV. The reasoning is that obstore's underlying Rust crate focuses on object store-like backends (e.g., S3, GCS, Azure), but pure HTTP doesn't define the full set of actions of an object store. It's misleading to use HTTPStore for HTTP access, because the HTTP spec doesn't define list whereas HTTPStore (build of object storage) declares that list would be available.

"With aiohttp and obspec and obspec-utils you're able to declare that you're providing only, say, get, get ranges, while not falsely declaring that you're providing list, etc. Also, a generic HTTP client gives you full access to underlying credential methods. HTTPStore doesn't let you add, say, a query string with an API key, because it's not trying to serve as a fully generic HTTP client"

A caveat is that there are still improvements needed for the AiohttpStore (xref #50)

Lingua principale
Python
Stelle
12
Fork
3
Nessuna PR unita negli ultimi 30g

Preparare l'ambiente

Questo progetto non fornisce container di sviluppo, Dockerfile né guida per i contributori, quindi l'ambiente è a tuo carico: parti dal suo README e consulta la nostra guida al primo contributo per i passaggi generali.

Come iniziare

  1. Leggi tutta la issue e poi la guida ai contributi del progetto.
  2. Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
  3. Fai un fork del repository e lavora su un branch.
  4. Apri una pull request che faccia riferimento al numero della issue.

Altre issue di developmentseed/obspec-utils

Tutte le issue di developmentseed/obspec-utils

Issue simili

Altre issue su Python

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.