Archived

This repository has been archived on 2024-04-08. You can view files and clone it, but cannot push or open issues or pull requests.

History

Helder Correia b2e87b8ec2 Merge pull request #2138 from teddylear/lua-package Creating lua package for fmt		2022-04-12 22:29:37 +00:00
..
alpine	Move core actions to a subpackage	2022-03-27 17:33:47 +00:00
aws	Move core actions to a subpackage	2022-03-27 17:33:47 +00:00
bash	Move core actions to a subpackage	2022-03-27 17:33:47 +00:00
cue.mod	Apply Solomon comments	2022-03-18 11:59:11 +01:00
docker	chore: Fix typo	2022-04-08 17:04:44 +08:00
examples	examples: set as vendored to not count in repository stats	2022-03-29 15:56:56 -07:00
git	Move core actions to a subpackage	2022-03-27 17:33:47 +00:00
go	ci: lint markdown files	2022-04-04 15:34:02 -07:00
netlify	ci: Unify keys and add private key for testing purposes	2022-03-30 19:18:32 -03:00
nginx	europa: vendor universe.dagger.io	2022-01-11 18:09:09 -08:00
powershell	Move core actions to a subpackage	2022-03-27 17:33:47 +00:00
python	universe: python: allow custom path to python	2022-04-11 10:54:29 -07:00
x	feat: add lua universe package and stylua command to fmt check	2022-04-12 18:21:22 -04:00
yarn	Move core actions to a subpackage	2022-03-27 17:33:47 +00:00
.gitignore	test: Fix universe tests	2022-03-11 12:41:45 -08:00
bats_helpers.bash	Fix export cache issue	2022-03-31 20:36:50 +02:00
package.json	Fix export cache issue	2022-03-31 20:36:50 +02:00
README.md	docs: Package coding style	2022-04-11 16:07:00 +00:00
secrets_sops.yaml	Implemented universe/aws and universe/aws/cli	2022-02-23 14:36:27 -07:00
yarn.lock	tests: Basic test infrastructure for Europa Universe	2022-01-19 12:39:39 -08:00

README.md

Europa Universe

What is Universe?

The Dagger Universe is a catalog of reusable CUE packages, curated by Dagger but possibly authored by third parties. Most packages in Universe contain reusable actions; some may also contain entire configuration templates.

The import domain for Universe will be universe.dagger.io.

Universe vs other packages

This table compares Dagger core packages, Dagger Universe packages, and the overall CUE package ecosystem.

	Dagger core	Dagger Universe	CUE ecosystem
Import path	`dagger.io`	`universe.dagger.io`	Everything else
Purpose	Access core Dagger features	Safely reuse code from the Dagger community	Reuse any CUE code from anyone
Author	Dagger team	Dagger community, curated by Dagger	Anyone
Release cycle	Released with Dagger engine	Released continuously	No release cycle
Size	Small	Large	Very large
Growth rate	Grows slowly, with engine features	Grows fast, with Dagger community	Grows even faster, with CUE ecosystem

Notable packages

Docker API

Import path: universe.dagger.io/docker

The docker package is a native Cue API for Docker. You can use it to build, run, push and pull Docker containers directly from Cue.

The Dagger container API defines the following types:

#Image: a container image
#Run: run a command in a container
#Push: upload an image to a repository
#Pull: download an image from a repository
#Build: build an image

Examples

Import path: universe.dagger.io/examples

This package contains examples of complete Dagger configurations, including the result of following tutorials in the documentations.

For example, the todoapp example corresponds to the Getting Started tutorial

Coding Style

When contributing, please follow the guidelines from the Package Coding Style.

TODO LIST

Support native language dev in docker.#Run with good DX (Python, Go, Typescript etc.)
Easy file injection API (container.#Image.files ?)
Use file injection instead of inline for #Command.script (to avoid hitting arg character limits)
Organize universe packages in sub-categories?