Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/naqvis/containerregistry.cr

Crystal library for working with container registries.
https://github.com/naqvis/containerregistry.cr

container-registries container-registry crystal crystal-lang crystal-language

Last synced: 11 days ago
JSON representation

Crystal library for working with container registries.

Awesome Lists containing this project

README

        

[![Build Status](https://travis-ci.org/naqvis/containerregistry.cr.svg?branch=master)](https://travis-ci.org/naqvis/containerregistry.cr)
[![GitHub release](https://img.shields.io/github/release/naqvis/containerregistry.cr.svg)](https://github.com/naqvis/containerregistry.cr/releases)
[![Docs](https://img.shields.io/badge/docs-available-brightgreen.svg)](https://naqvis.github.io/containerregistry.cr/)

# Crystal - Container Registry Shard

`containerregistry.cr` shard is a library for working with container registries. It's largely based on the [Go library of the same name](https://github.com/google/go-containerregistry).

The following diagram shows the main types that this library handles.
![OCI image representation](images/ociimage.jpeg)

## Installation

1. Add the dependency to your `shard.yml`:

```yaml
dependencies:
containerregistry:
github: naqvis/containerregistry.cr
```

2. Run `shards install`

## Usage

```crystal
require "containerregistry"
```
Refer to [`opal`](https://github.com/naqvis/opal) for CLI and usage

## Development

To run all tests:

```
crystal spec
```

## Contributing

1. Fork it ()
2. Create your feature branch (`git checkout -b my-new-feature`)
3. Commit your changes (`git commit -am 'Add some feature'`)
4. Push to the branch (`git push origin my-new-feature`)
5. Create a new Pull Request

## Contributors

- [Ali Naqvi](https://github.com/naqvis) - creator and maintainer