common

package module
v0.0.0-...-9e9d5c1 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Jul 24, 2020 License: Apache-2.0 Imports: 0 Imported by: 0

README

Kyma common package

This package is a set of Go libraries that implement common use cases found in different Kyma components.

Purpose

With the consolidated structure of the Kyma project, all core components written in Go are stored in a single repository. Although all components have the same programming language as a cornerstone, they are written differently. This makes testing the existing code and making new contributions difficult as each component must be approached in a different way.

This package aims to address this problem by providing a set of libraries that the developers should use rather than introduce new solutions to an already solved problem.

How to add code to this package

To add a new library to this package, it must meet these criteria:

  • It is used by multiple components in Kyma. Do not generalize when it is not necessary as it puts additional overhead in maintenance.
  • It must be well covered with unit tests. Many components may end up depending on the library you add.
  • It must have open source-grade documentation. The library will be widely used and must be easy to use without the need to contact the author.

Naming conventions

If the common package is a Kubernetes client for a custom resource, add a -client suffix to the folder name.

Testing

To ensure that the common package has no bugs, the tests must be executed with these flags:

  • -count 100 - ensures the stability of tests
  • -race - ensures that the code is safe to use in a multi-threaded environment

Documentation

The Go Gopher

There is no documentation for this package.

Directories

Path Synopsis
microfrontend-client
pkg/apis/ui/v1alpha1
Package v1 is the v1 version of the API.
Package v1 is the v1 version of the API.
pkg/client/clientset/versioned
This package has the automatically generated clientset.
This package has the automatically generated clientset.
pkg/client/clientset/versioned/fake
This package has the automatically generated fake clientset.
This package has the automatically generated fake clientset.
pkg/client/clientset/versioned/scheme
This package contains the scheme of the automatically generated clientset.
This package contains the scheme of the automatically generated clientset.
pkg/client/clientset/versioned/typed/ui/v1alpha1
This package has the automatically generated typed clients.
This package has the automatically generated typed clients.
pkg/client/clientset/versioned/typed/ui/v1alpha1/fake
Package fake has the automatically generated clients.
Package fake has the automatically generated clients.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL