Create IPIP: UnixFS and Gateway support for explicit MIME/Content-Type
Nessuno ha ancora preso questa issue.
Valutazione
- Difficoltà
- 5/5
- Tempo stimato
- Più di una settimana
- Idoneità per principianti
- 25/100
- Tipo di issue
- Funzionalità
- Chiarezza
- Da chiarire
- Stato di attività
- Tranquilla
- Ambito
- api, backend-api-design, networking
Direzione di ricerca
Inizia dal lavoro sulle specifiche UnixFS tracciato in #331, quindi esamina la specifica del gateway referenziata e il gestore del gateway di Kubo in core/corehttp/gateway_handler_unixfs_file.go. Il lavoro è completato quando un IPIP definisce l’archiviazione MIME canonica e il comportamento del gateway, con un’implementazione di riferimento di Kubo che copra ipfs add e le risposte del gateway.
Scritto dal modello di indicizzazione a partire dal testo della issue.
Descrizione
This is a placeholder issue for creating IPIP to add support for storing explicit MIME/Content-Type in UnixFS DAG itself, like we already do for opt-in mode and mtime, and acting on its presence on Gateways.
There is alrernative approach to allow stating explicit content-type header via _headers file (similar to recently shipped _redirects) – some notes in https://github.com/ipfs/specs/issues/257
Context
UnixFSv2 never happened, but ability to explicitly specify Content-Type was one of my asks: https://github.com/ipld/legacy-unixfs-v2/issues/11
Years later, we still guess Content-Type on gateways.
While it is fine for most of the time, but we should provide users with ability to explicitly set media type at the time of data onboarding.
Since 2018 we made some related development: we've added opt-in support for mode and mtime attributes. ~2020 (https://github.com/ipfs/specs/issues/217#issuecomment-582369839). Support for mode and mtime was implemented in JS-IPFS a while ago, Kubo still has PR open (https://github.com/ipfs/go-unixfs/pull/117).
Initial idea (details to be fleshed out in IPIP) is to introduce optional mtype similar way.
This is alternative to introducing _headers file mentioned in https://github.com/ipfs/specs/issues/257.
Ref.
- old discussions https://github.com/ipfs/kubo/issues/2164
- Media Type registry at IANA: https://www.iana.org/assignments/media-types/media-types.xhtml
- IETF RFC about Media Types https://www.rfc-editor.org/rfc/rfc2046.html
- Some examples how the same CID can be returned with different
Content-Type: https://github.com/ipfs/in-web-browsers/issues/152 - Kubo Gateway guessing
Content-Typebased on filename and magic bytes: https://github.com/ipfs/kubo/blob/v0.17.0-rc2/core/corehttp/gateway_handler_unixfs_file.go#L55-L87- Gateway support for overriding filename: https://github.com/ipfs/specs/blob/main/http-gateways/PATH_GATEWAY.md#filename-request-query-parameter
- IPFS users leverage this for adjusting Content-Type when
/ipfs/cidis requested without any filename, but with built-in support for explicit content type we could make it "just work".
- IPFS users leverage this for adjusting Content-Type when
- Gateway support for overriding filename: https://github.com/ipfs/specs/blob/main/http-gateways/PATH_GATEWAY.md#filename-request-query-parameter
TODO
- wait until UnixFS specs land (#331)
- create IPIP against UnixFS specs that
- defines canonical way of storing explicit MIME (content/media type) in UnixFS root dag-pb blocks.
- modifies Gateway spec to disable mime-sniffing and use sanitized (ASCII-only) value from dag-pb in
Content-Typeheader
- Create reference implementation in Kubo
- adds optional
--content-typetoipfs add - skip sniffing and set
Content-Typeheader on gateway, if present
- adds optional
- Lingua principale
- HTML
- Stelle
- 1.2k
- Fork
- 250
- Metriche di merge delle PR
- 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
- Leggi tutta la issue e poi la guida ai contributi del progetto.
- Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
- Fai un fork del repository e lavora su un branch.
- Apri una pull request che faccia riferimento al numero della issue.
Altre issue di ipfs/specs
-
Simplify Spec StatusesApertaneed/triage
Difficoltà 2/5 1-3 ore Idoneità per principianti 68/100
-
need/triage
Difficoltà 5/5 Più di una settimana Idoneità per principianti 30/100
-
dnslink:// URIsApertaneed/triage
Difficoltà 5/5 Più di una settimana Idoneità per principianti 30/100
-
Difficoltà 5/5 Più di una settimana Idoneità per principianti 35/100
-
need/triage
Difficoltà 3/5 1-2 giorni Idoneità per principianti 55/100
Issue simili
-
bug cross-seed ready-for-human
Difficoltà 2/5 1-3 ore Idoneità per principianti 70/100
I maintainer di solito rispondono entro 1 giorno
-
Difficoltà 2/5 1-3 ore Idoneità per principianti 68/100
ElectronicWave/Elemental#265 ·
I maintainer di solito rispondono entro 1 giorno
-
Waiting start: the fixed 503 body says another instance holds the lease when that may not be soAperta
Difficoltà 1/5 Meno di un'ora Idoneità per principianti 70/100
Judgment-Pack/judgment-pack-gateway#474 ·
I maintainer di solito rispondono entro 1 giorno
-
feature needs-triage
Difficoltà 2/5 1-3 ore Idoneità per principianti 78/100
BoardGamesEmpire/board-games-empire-backend#1306 ·
I maintainer di solito rispondono entro 1 giorno
-
Difficoltà 2/5 1-3 ore Idoneità per principianti 80/100