Ecosyste.ms: Awesome

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

Awesome Lists | Featured Topics | Projects

https://github.com/oleksis/devcontainer-features

Development Container Features
https://github.com/oleksis/devcontainer-features

devcontainer devcontainer-feature playground-cli python-launcher

Last synced: 12 days ago
JSON representation

Development Container Features

Awesome Lists containing this project

README

        

# Development Container Features

'Features' are self-contained units of installation code and development container configuration. Features are designed to install on top of wide range of based container images (**this repository focuses on `ubuntu` based images**).

## Usages

To use a feature from this repository add the corresponding feature to a `devcontainer.json`. Each feature has a `README.md` file autogenerated from the corresponding feature's `devcontainer-feature.json`. The file lists the available options for the feature.

The example below installs the `python-launcher` [Python launcher for Unix](https://python-launcher.app) feature declared in the [src](./src) folder of this repository. See the relevant feature's `README.md` for supported options.

```jsonc
{
"image": "mcr.microsoft.com/devcontainers/base:ubuntu",
"features": {
"ghcr.io/oleksis/devcontainer-features/python-launcher:1": {}
}
}
```

```bash
$ py --help

Python Launcher for Unix 1.0.0
usage: py [launcher-args] [python-args]
...
```

## Repository Structure

```
.
├── README.md
├── src
│ ├── playground-cli
│ │ ├── devcontainer-feature.json
│ │ ├── install.sh
│ │ └── README.md
│ ├── python-launcher
│ │ ├── devcontainer-feature.json
│ │ ├── install.sh
│ │ └── README.md
├── test
│ ├── playground-cli
│ │ └── test.sh
│ ├── python-launcher
│ │ └── test.sh
...
```

## Contributions

This repository accepts improvement and bug fix contributions related to the [current set of maintained features](./src). Raise the PRs!