Metadata-Version: 2.4
Name: rockerc
Version: 0.11.0
Summary: A tool to parse rockerc.yaml files and pass on the arguments onto rocker
Project-URL: Source, https://github.com/blooop/rockerc
Project-URL: Home, https://github.com/blooop/rockerc
Author-email: Austin Gregg-Smith <blooop@gmail.com>
License-Expression: MIT
License-File: LICENSE
Requires-Dist: deps-rocker>=0.14
Requires-Dist: off-your-rocker>=0.1.0
Requires-Dist: pyyaml>=5
Requires-Dist: rocker>=0.2.19
Provides-Extra: extensions
Requires-Dist: ghrocker==0.0.10; extra == 'extensions'
Requires-Dist: groot-rocker==0.4.1; extra == 'extensions'
Provides-Extra: test
Requires-Dist: coverage<=7.10.7,>=7.5.4; extra == 'test'
Requires-Dist: hypothesis<=6.140.2,>=6.104.2; extra == 'test'
Requires-Dist: pre-commit<=4.2.0; extra == 'test'
Requires-Dist: pylint<=3.3.8,>=3.2.5; extra == 'test'
Requires-Dist: pytest-cov<=7.0.0,>=4.1; extra == 'test'
Requires-Dist: pytest<=8.4.2,>=7.4; extra == 'test'
Requires-Dist: ruff<=0.13.2,>=0.5.0; extra == 'test'
Description-Content-Type: text/markdown

# rockerc

## Continuous Integration Status

[![Ci](https://github.com/blooop/rockerc/actions/workflows/ci.yml/badge.svg?branch=main)](https://github.com/blooop/rockerc/actions/workflows/ci.yml?query=branch%3Amain)
[![Codecov](https://codecov.io/gh/blooop/rockerc/branch/main/graph/badge.svg?token=Y212GW1PG6)](https://codecov.io/gh/blooop/rockerc)
[![GitHub issues](https://img.shields.io/github/issues/blooop/rockerc.svg)](https://GitHub.com/blooop/rockerc/issues/)
[![GitHub pull-requests merged](https://badgen.net/github/merged-prs/blooop/rockerc)](https://github.com/blooop/rockerc/pulls?q=is%3Amerged)
[![GitHub release](https://img.shields.io/github/release/blooop/rockerc.svg)](https://GitHub.com/blooop/rockerc/releases/)
[![PyPI - Downloads](https://img.shields.io/pypi/dm/rockerc)](https://pypistats.org/packages/rockerc)
[![License](https://img.shields.io/github/license/blooop/rockerc)](https://opensource.org/license/mit/)
[![Python](https://img.shields.io/badge/python-3.8%20%7C%203.9%20%7C%203.10%20%7C%203.11%20%7C%203.12-blue)](https://www.python.org/downloads/)
[![Pixi Badge](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/prefix-dev/pixi/main/assets/badge/v0.json)](https://pixi.sh)

## Installation

### Recommended Method:

Install [pipx](https://pypa.github.io/pipx/) (if not already installed):

```
sudo apt install pipx
pipx ensurepath
```

Then install rockerc and its dependencies globally with:

```
pipx install --include-deps rockerc
```

to develop run
```
pipx install --include-deps . --force
```

This will ensure that `rockerc` and `rocker` commands are available on your PATH.

## Usage

navigate to a directory with a `rockerc.yaml` file and run:
```
rockerc
```

This will search recursively for rockerc.yaml and pass those arguments to rocker

### VS Code Integration

For automatic VS Code integration, use `rockervsc` instead:
```
rockervsc
```

`rockervsc` functions the same as `rockerc` but will automatically launch and attach VS Code to the created container. This provides seamless development environment setup with VS Code running inside your rocker container.

## Motivation

[Rocker](https://github.com/osrf/rocker) is an alternative to docker-compose that makes it easier to run containers with access to features of the local environment and add extra capabilities to existing docker images.  However rocker has many configurable options and it can get hard to read or reuse those arguments.  This is a naive wrapper that read a rockerc.yaml file and passes them to rocker.  There are currently [no plans](https://github.com/osrf/rocker/issues/148) to integrate docker-compose like functionality directly into rocker so I made this as a proof of concept to see what the ergonomics of it would be like. 

## Caveats

I'm not sure this is the best way of implementing rockerc like functionality.  It might be better to implemented it as a rocker extension, or in rocker itself.  This was just the simplest way to get started. I may explore those other options in more detail in the future. 


# rocker.yaml configuration

You need to pass either a docker image, or a relative path to a dockerfile

rockerc.yaml
```yaml
image: ubuntu:22.04
```

or

```yaml
dockerfile: Dockerfile
```

will look for the dockerfile relative to the rockerc.yaml file
