dagger-rs/README.md

# dagger-rs

A dagger sdk written in rust for rust.

# Usage

See [dagger-sdk](./crates/dagger-sdk/README.md)

### Status

- [x] dagger cli downloader
- [x] dagger network session
- [x] graphql rust codegen (User API)
  - [x] Scalars
  - [x] Enums
  - [x] Input
  - [x] Objects
- [x] Implement context and querier
  - [x] Marshaller
  - [x] Querier
  - [x] Context
  - [x] Deserializer for nested response (bind)
- [x] Add codegen to hook into querier
- [x] fix build / release cycle
- [x] general api stabilisation
- [x] document usage
- [ ] make async variant

## Architecture

- `.` Root project mainly used for generating the CLI, which in turn is used to
  bootstrap the code generation from `dagger`
- `crates/dagger-core` Contains all base types used during actual usage. This is
  where the primary logic lives in which the user interacts (\*disclaimer: most
  stuff haven't moved in here yet.)
- `crates/dagger-sdk` Contains the actual sdk in which the user interacts,
  `dagger-core` is reexported through this API as well.
- `crates/dagger-codegen` This is the bulk of the work, it takes the input
  graphql and spits out the API in which the user interacts, this is heavily
  inspired by other `dagger-sdk's`. It primarily turns graphql into rust code.
set readme and license 2023-01-27 08:37:19 +01:00			`# dagger-rs`

			`A dagger sdk written in rust for rust.`
with disclaimer 2023-01-27 08:54:43 +01:00
document usage 2023-02-17 18:00:20 +01:00			`# Usage`
with disclaimer 2023-01-27 08:54:43 +01:00
document usage 2023-02-17 18:00:20 +01:00			`See [dagger-sdk](./crates/dagger-sdk/README.md)`
with type filtering 2023-01-28 20:21:19 +01:00
			`### Status`

			`- [x] dagger cli downloader`
			`- [x] dagger network session`
add querier roadmap item 2023-01-30 22:25:40 +01:00			`- [x] graphql rust codegen (User API)`
with status 2023-01-29 22:18:39 +01:00			`- [x] Scalars`
			`- [x] Enums`
			`- [x] Input`
add querier roadmap item 2023-01-30 22:25:40 +01:00			`- [x] Objects`
context and querier done 2023-02-11 14:03:06 +01:00			`- [x] Implement context and querier`
add roadmap items 2023-02-05 19:29:44 +01:00			`- [x] Marshaller`
			`- [x] Querier`
context roadmap item 2023-02-05 23:45:35 +01:00			`- [x] Context`
context and querier done 2023-02-11 14:03:06 +01:00			`- [x] Deserializer for nested response (bind)`
feature/add impl (#6) * format code * with object gen and args * add implementation * add rust generator * reset generated code * add basic output * reset output * add object * add format function * with opts * fix vec * add context to unwrap * fix arguments * with function body * first complete generation: Still missing Vec<Obj> * run full alpine * add roadmap item 2023-02-17 12:33:16 +01:00			`- [x] Add codegen to hook into querier`
feat: clear release-cycle roadmap item 2023-02-19 14:33:34 +01:00			`- [x] fix build / release cycle`
fix: roadmap item api stabilization 2023-02-19 17:52:48 +01:00			`- [x] general api stabilisation`
document usage 2023-02-17 18:00:20 +01:00			`- [x] document usage`
add async roadmap item 2023-02-11 14:13:49 +01:00			`- [ ] make async variant`
add architecture 2023-01-29 22:33:21 +01:00
			`## Architecture`

			- `.` Root project mainly used for generating the CLI, which in turn is used to
			bootstrap the code generation from `dagger`
			- `crates/dagger-core` Contains all base types used during actual usage. This is
			`where the primary logic lives in which the user interacts (\*disclaimer: most`
			`stuff haven't moved in here yet.)`
			- `crates/dagger-sdk` Contains the actual sdk in which the user interacts,
			`dagger-core` is reexported through this API as well.
			- `crates/dagger-codegen` This is the bulk of the work, it takes the input
			`graphql and spits out the API in which the user interacts, this is heavily`
			inspired by other `dagger-sdk's`. It primarily turns graphql into rust code.