Migrate oras Go libraries to libs-go/

.github/dependabot.yml

@@ -0,0 +1,7 @@
+version: 2
+
+updates:
+  - package-ecosystem: "gomod"
+    directory: "libs-go"
+    schedule:
+      interval: "daily"

.github/workflows/build-libs-go.yml

@@ -0,0 +1,24 @@
+name: build-libs-go
+
+on:
+  push:
+    branches: main
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v2
+      - name: setup go environment
+        uses: actions/setup-go@v1
+        with:
+          go-version: '1.15.7'
+      - name: run unit tests
+        run: cd libs-go/ && make test
+      - name: upload coverage report
+        uses: actions/upload-artifact@master
+        with:
+          name: artifacts-libs-go-coverage-report-${{ github.sha }}
+          path: libs-go/.cover/
+        if: always()

.github/workflows/build-pr-libs-go.yml

@@ -0,0 +1,25 @@
+name: build-pr-libs-go
+
+on:
+  pull_request:
+    branches:
+      - main
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v2
+      - name: setup go environment
+        uses: actions/setup-go@v1
+        with:
+          go-version: '1.15.7'
+      - name: run unit tests
+        run: cd libs-go/ && make test
+      - name: upload coverage report
+        uses: actions/upload-artifact@master
+        with:
+          name: artifacts-libs-go-coverage-report-${{ github.sha }}
+          path: libs-go/.cover/
+        if: always()

.gitignore

@@ -0,0 +1,2 @@
+.idea/
+.vscode/

libs-go/.gitignore

@@ -0,0 +1,26 @@
+# Binaries for programs and plugins
+*.exe
+*.exe~
+*.dll
+*.so
+*.dylib
+
+# Test binary, build with `go test -c`
+*.test
+
+# Output of the go coverage tool, specifically when used with LiteIDE
+*.out
+
+# VS Code
+.vscode
+debug
+
+# Jetbrains
+.idea
+
+# Custom
+.cover/
+.test/
+hello.txt
+*.tar.gz
+vendor/

libs-go/Makefile

@@ -0,0 +1,25 @@
+.PHONY: test
+test: vendor check-encoding
+	./scripts/test.sh
+
+.PHONY: covhtml
+covhtml:
+	open .cover/coverage.html
+
+.PHONY: clean
+clean:
+	git status --ignored --short | grep '^!! ' | sed 's/!! //' | xargs rm -rf
+
+.PHONY: check-encoding
+check-encoding:
+	! find pkg examples -name "*.go" -type f -exec file "{}" ";" | grep CRLF
+	! find scripts -name "*.sh" -type f -exec file "{}" ";" | grep CRLF
+
+.PHONY: fix-encoding
+fix-encoding:
+	find pkg examples -type f -name "*.go" -exec sed -i -e "s/\r//g" {} +
+	find scripts -type f -name "*.sh" -exec sed -i -e "s/\r//g" {} +
+
+.PHONY: vendor
+vendor:
+	GO111MODULE=on go mod vendor

libs-go/README.md

@@ -0,0 +1,57 @@
+# OCI Artifacts Go Libraries
+
+[![GitHub Actions status](https://github.com/bloodorangeio/artifacts/workflows/build-libs-go/badge.svg)](https://github.com/bloodorangeio/artifacts/actions?query=workflow%3Abuild-libs-go)
+
+## Example Usage
+
+[Source](examples/simple_push_pull.go)
+
+```go
+package main
+
+import (
+	"context"
+	"fmt"
+
+	"github.com/opencontainers/artifacts/libs-go/pkg/artifacts"
+	"github.com/opencontainers/artifacts/libs-go/pkg/content"
+
+	"github.com/containerd/containerd/remotes/docker"
+	ocispec "github.com/opencontainers/image-spec/specs-go/v1"
+)
+
+func check(e error) {
+	if e != nil {
+		panic(e)
+	}
+}
+
+func main() {
+	ref := "localhost:5000/artifacts:test"
+	fileName := "hello.txt"
+	fileContent := []byte("Hello World!\n")
+	customMediaType := "my.custom.media.type"
+
+	ctx := context.Background()
+	resolver := docker.NewResolver(docker.ResolverOptions{})
+
+	// Push file(s) w custom mediatype to registry
+	memoryStore := content.NewMemoryStore()
+	desc := memoryStore.Add(fileName, customMediaType, fileContent)
+	pushContents := []ocispec.Descriptor{desc}
+	fmt.Printf("Pushing %s to %s...\n", fileName, ref)
+	desc, err := artifacts.Push(ctx, resolver, ref, memoryStore, pushContents)
+	check(err)
+	fmt.Printf("Pushed to %s with digest %s\n", ref, desc.Digest)
+
+	// Pull file(s) from registry and save to disk
+	fmt.Printf("Pulling from %s and saving to %s...\n", ref, fileName)
+	fileStore := content.NewFileStore("")
+	defer fileStore.Close()
+	allowedMediaTypes := []string{customMediaType}
+	desc, _, err = artifacts.Pull(ctx, resolver, ref, fileStore, artifacts.WithAllowedMediaTypes(allowedMediaTypes))
+	check(err)
+	fmt.Printf("Pulled from %s with digest %s\n", ref, desc.Digest)
+	fmt.Printf("Try running 'cat %s'\n", fileName)
+}
+```

libs-go/examples/simple_push_pull.go

@@ -0,0 +1,47 @@
+package main
+
+import (
+	"context"
+	"fmt"
+
+	"github.com/opencontainers/artifacts/libs-go/pkg/artifacts"
+	"github.com/opencontainers/artifacts/libs-go/pkg/content"
+
+	"github.com/containerd/containerd/remotes/docker"
+	ocispec "github.com/opencontainers/image-spec/specs-go/v1"
+)
+
+func check(e error) {
+	if e != nil {
+		panic(e)
+	}
+}
+
+func main() {
+	ref := "localhost:5000/artifacts:test"
+	fileName := "hello.txt"
+	fileContent := []byte("Hello World!\n")
+	customMediaType := "my.custom.media.type"
+
+	ctx := context.Background()
+	resolver := docker.NewResolver(docker.ResolverOptions{})
+
+	// Push file(s) w custom mediatype to registry
+	memoryStore := content.NewMemoryStore()
+	desc := memoryStore.Add(fileName, customMediaType, fileContent)
+	pushContents := []ocispec.Descriptor{desc}
+	fmt.Printf("Pushing %s to %s...\n", fileName, ref)
+	desc, err := artifacts.Push(ctx, resolver, ref, memoryStore, pushContents)
+	check(err)
+	fmt.Printf("Pushed to %s with digest %s\n", ref, desc.Digest)
+
+	// Pull file(s) from registry and save to disk
+	fmt.Printf("Pulling from %s and saving to %s...\n", ref, fileName)
+	fileStore := content.NewFileStore("")
+	defer fileStore.Close()
+	allowedMediaTypes := []string{customMediaType}
+	desc, _, err = artifacts.Pull(ctx, resolver, ref, fileStore, artifacts.WithAllowedMediaTypes(allowedMediaTypes))
+	check(err)
+	fmt.Printf("Pulled from %s with digest %s\n", ref, desc.Digest)
+	fmt.Printf("Try running 'cat %s'\n", fileName)
+}

libs-go/go.mod

@@ -0,0 +1,38 @@
+module github.com/opencontainers/artifacts/libs-go
+
+go 1.15
+
+replace (
+	// WARNING! Do NOT replace these without also replacing their lines in the `require` stanza below.
+	// These `replace` stanzas are IGNORED when this is imported as a library
+	github.com/docker/distribution => github.com/docker/distribution v0.0.0-20191216044856-a8371794149d
+	github.com/docker/docker => github.com/moby/moby v17.12.0-ce-rc1.0.20200618181300-9dc6525e6118+incompatible
+)
+
+require (
+	github.com/Azure/go-ansiterm v0.0.0-20170929234023-d6e3b3328b78 // indirect
+	github.com/Microsoft/go-winio v0.4.16 // indirect
+	github.com/Microsoft/hcsshim v0.8.14 // indirect
+	github.com/containerd/containerd v1.4.3
+	github.com/containerd/continuity v0.0.0-20210208174643-50096c924a4e // indirect
+	github.com/docker/cli v20.10.3+incompatible
+	github.com/docker/distribution v0.0.0-20191216044856-a8371794149d
+	github.com/docker/docker v17.12.0-ce-rc1.0.20200618181300-9dc6525e6118+incompatible
+	github.com/docker/docker-credential-helpers v0.6.3 // indirect
+	github.com/docker/go-connections v0.4.0 // indirect
+	github.com/gogo/protobuf v1.3.2 // indirect
+	github.com/google/go-cmp v0.5.4 // indirect
+	github.com/morikuni/aec v1.0.0 // indirect
+	github.com/opencontainers/go-digest v1.0.0
+	github.com/opencontainers/image-spec v1.0.0
+	github.com/opencontainers/runc v0.1.1 // indirect
+	github.com/phayes/freeport v0.0.0-20180830031419-95f893ade6f2
+	github.com/pkg/errors v0.9.1
+	github.com/sirupsen/logrus v1.7.0
+	github.com/stretchr/testify v1.5.1
+	golang.org/x/crypto v0.0.0-20200622213623-75b288015ac9
+	golang.org/x/sync v0.0.0-20201020160332-67f06af15bc9
+	golang.org/x/sys v0.0.0-20210124154548-22da62e12c0c // indirect
+	google.golang.org/grpc v1.35.0 // indirect
+	gotest.tools/v3 v3.0.3 // indirect
+)