Metadata-Version: 2.3
Name: rockervsc
Version: 0.2.1
Summary: A rocker wrapper for launching and attaching vscode to a rocker container
Project-URL: Source, https://github.com/blooop/rockervsc
Project-URL: Home, https://github.com/blooop/rockervsc
Author-email: Austin Gregg-Smith <blooop@gmail.com>
License-Expression: MIT
License-File: LICENSE
Requires-Dist: rockerc>=0.3.0
Provides-Extra: test
Requires-Dist: black<=24.8.0,>=23; extra == 'test'
Requires-Dist: coverage<=7.6.1,>=7.5.4; extra == 'test'
Requires-Dist: hypothesis<=6.112.1,>=6.104.2; extra == 'test'
Requires-Dist: pylint<=3.2.7,>=3.2.5; extra == 'test'
Requires-Dist: pytest-cov<=5.0.0,>=4.1; extra == 'test'
Requires-Dist: pytest<=8.3.3,>=7.4; extra == 'test'
Requires-Dist: ruff<=0.6.5,>=0.5.0; extra == 'test'
Description-Content-Type: text/markdown

# rockervsc

## Continuous Integration Status

[![Ci](https://github.com/blooop/rockervsc/actions/workflows/ci.yml/badge.svg?branch=main)](https://github.com/blooop/rockervsc/actions/workflows/ci.yml?query=branch%3Amain)
[![Codecov](https://codecov.io/gh/blooop/rockervsc/branch/main/graph/badge.svg?token=Y212GW1PG6)](https://codecov.io/gh/blooop/rockervsc)
[![GitHub issues](https://img.shields.io/github/issues/blooop/rockervsc.svg)](https://GitHub.com/blooop/rockervsc/issues/)
[![GitHub pull-requests merged](https://badgen.net/github/merged-prs/blooop/rockervsc)](https://github.com/blooop/rockervsc/pulls?q=is%3Amerged)
[![GitHub release](https://img.shields.io/github/release/blooop/rockervsc.svg)](https://GitHub.com/blooop/rockervsc/releases/)
[![PyPI - Downloads](https://img.shields.io/pypi/dm/rockervsc)](https://pypistats.org/packages/rockervsc)
[![License](https://img.shields.io/github/license/blooop/rockervsc)](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

```
pip install rockervsc
```

## Usage

To run rocker and automatically launch and attach a vscode instance, run this command:

```
rockervsc 
```

You can pass all the normal rocker arguments to rockervsc and it will forward them to rocker, e.g.:

```
rockervsc --x11 --nvidia
```

by default rockervsc calls [rockerc](https://github.com/blooop/rockerc) so instead of passing arguments explicitly you can have a rockerc.yaml file in your workspace

```yaml
image: ubuntu:22.04
args:
  - nvidia
  - x11 
  - user 
  - git 

```

and running:
```bash
rockervsc
```

will launch and attach vscode to the container with nvidia, x11, the current user id and git set up for you.


## 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.  I do most of my development in vscode with the devcontainers extension so this wrapper simplifies that workflow.  I can easily spawn a vscode instance for any project with a rockerc.yaml file and have a near native development experience with all the nice-to-haves that rocker provides but still get the benefit of isolation. 

## Caveats

I'm not sure this is the best way of implementing rockervsc like functionality.  It might be better to implement 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. 
