DockerCLI/vendor/k8s.io/utils
Christopher Crone e4d3c360b2 Bump Compose on Kubernetes
Signed-off-by: Christopher Crone <christopher.crone@docker.com>
2019-10-30 22:08:14 +01:00
..
buffer bump kubernetes to v1.14.0 2019-03-29 09:20:28 +00:00
integer bump kubernetes to v1.14.0 2019-03-29 09:20:28 +00:00
trace Bump Compose on Kubernetes 2019-10-30 22:08:14 +01:00
LICENSE bump kubernetes to v1.14.0 2019-03-29 09:20:28 +00:00
README.md Bump Compose on Kubernetes 2019-10-30 22:08:14 +01:00
go.mod Bump Compose on Kubernetes 2019-10-30 22:08:14 +01:00

README.md

Utils

Build Status GoDoc

A set of Go libraries that provide low-level, kubernetes-independent packages supplementing the Go standard libs.

Purpose

As Kubernetes grows and spins functionality out of its core and into cooperating repositories like apiserver, kubectl, kubeadm, etc., the need arises for leaf repositories to house shared code and avoid cycles in repository relationships.

This repository is intended to hold shared utilities with no Kubernetes dependence that may be of interest to any Go project. See these instructions for moving an existing package to this repository.

Criteria for adding code here

  • Used by multiple Kubernetes repositories.

  • Full unit test coverage.

  • Go tools compliant (go get, go test, etc.).

  • Complex enough to be worth vendoring, rather than copying.

  • Stable, or backward compatible, API.

  • No dependence on any Kubernetes repository.

Libraries

  • Exec provides an interface for os/exec. It makes it easier to mock and replace in tests, especially with the FakeExec struct.

  • Temp provides an interface to create temporary directories. It also provides a FakeDir implementation to replace in tests.

  • Clock provides an interface for time-based operations. It allows mocking time for testing.

  • Pointer provides some functions for pointer-based operations.

  • Io provides interfaces for working with file IO. Currently it provides functionality for consistently reading a file.

  • NSEnter provides interfaces for executing and interacting with processes running within a namespace.

Contributing

Please see CONTRIBUTING.md for instructions on how to contribute.