diff --git a/cmd/boxo-migrate/internal/config.go b/cmd/boxo-migrate/internal/config.go index a377ec687..767d86002 100644 --- a/cmd/boxo-migrate/internal/config.go +++ b/cmd/boxo-migrate/internal/config.go @@ -39,7 +39,10 @@ var DefaultConfig = Config{ "github.com/ipfs/go-ipfs-routing": "github.com/ipfs/boxo/routing", "github.com/ipfs/go-ipfs-exchange-interface": "github.com/ipfs/boxo/exchange", "github.com/ipfs/go-merkledag": "github.com/ipfs/boxo/ipld/merkledag", - "github.com/ipld/go-car": "github.com/ipfs/boxo/ipld/car", + // By default, users can/should keep using ipld/go-car. + // Updating ipld/go-car was useful for other repos that are also maintained by Boxo maintainers like Kubo + // More info is in https://github.com/ipfs/boxo/issues/218 + // "github.com/ipld/go-car": "github.com/ipfs/boxo/ipld/car", // Pre Boxo rename "github.com/ipfs/go-libipfs/gateway": "github.com/ipfs/boxo/gateway", diff --git a/ipld/car/README.md b/ipld/car/README.md index b91dcf148..62dd779ba 100644 --- a/ipld/car/README.md +++ b/ipld/car/README.md @@ -1,9 +1,18 @@ -go-car (go!) -================== +# ❗ About CAR libraries written in go +As of 202303, this is a copy of [`ipld/go-car`](github.com/ipld/go-car). +`ipld/go-car` is a full-featured car library that is actively maintained. +Boxo has smaller car needs and will be will be refactored and thinned out in the future. +Boxo can't depend on `ipld/go-car` because it would cause `ipld/go-car` to have dependency on Boxo, +and `ipld/go-car` maintainers want to be able to develop indepdently. -[![](https://img.shields.io/badge/made%20by-Protocol%20Labs-blue.svg?style=flat-square)](https://protocol.ai) -[![Go Reference](https://pkg.go.dev/badge/github.com/boxo/ipld/car.svg)](https://pkg.go.dev/github.com/boxo/ipld/car) +***A user can always use `ipld/go-car` in conjuection with `boxo/ipld/car`.*** +Please use `ipld/go-car` as needed! +More details and discussion are [here](https://github.com/ipfs/boxo/issues/218). + +--- + +# About this module > Work with car (Content addressed ARchive) files! This is a Golang implementation of the [CAR specifications](https://ipld.io/specs/transport/car/), both [CARv1](https://ipld.io/specs/transport/car/carv1/) and [CARv2](https://ipld.io/specs/transport/car/carv2/). @@ -16,11 +25,6 @@ As a format, there are two major module versions: Most users should use v2, especially for new software, since the v2 API transparently supports both CAR formats. -# **Unstable** - -This package will be refactored and thinned out soon. You can find an -implementation that supports indexes and go-ipld-prime there at [`ipld/go-car`](github.com/ipld/go-car). - ## Usage / Installation This repository provides a `car` binary that can be used for creating, extracting, and working with car files.