Initial implementation

Author: cristaloleg

.github/dependabot.yml

@@ -0,0 +1,10 @@
+version: 2
+updates:
+  - package-ecosystem: gomod
+    directory: "/"
+    schedule:
+      interval: daily
+  - package-ecosystem: github-actions
+    directory: "/"
+    schedule:
+      interval: daily

.github/workflows/build.yml

@@ -0,0 +1,23 @@
+name: build
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+  workflow_dispatch:
+    inputs:
+      tag:
+        description: 'Tag to create'
+        required: true
+        default: 'v0.0.0'
+
+# See https://github.com/cristalhq/.github/.github/workflows
+jobs:
+  build:
+    uses: cristalhq/.github/.github/workflows/build.yml@main
+
+  release:
+    if: github.event_name == 'workflow_dispatch'
+    uses: cristalhq/.github/.github/workflows/release.yml@main
+    with:
+      tag: ${{ github.event.input.tag }}

GUIDE.md

@@ -0,0 +1,27 @@
+# Guide for appx
+
+## Basic case
+
+```go
+package main
+
+import (
+	"context"
+	"os"
+
+	"github.com/cristalhq/appx"
+)
+
+func main() {
+	ctx := appx.Context()
+
+	if err := run(ctx, os.Args[1:]); err != nil {
+		panic(err)
+	}
+}
+
+func run(ctx context.Context, args []string) error {
+	// do good things
+	return nil
+}
+```

README.md

@@ -1,2 +1,70 @@
 # appx
-Go library for building applications. Dramatically simple.
+
+[![build-img]][build-url]
+[![pkg-img]][pkg-url]
+[![reportcard-img]][reportcard-url]
+[![coverage-img]][coverage-url]
+[![version-img]][version-url]
+
+Go library for building applications. Dramatically simple. For a CLI tool see [acmd](https://github.com/cristalhq/acmd).
+
+## Features
+
+* Simple API.
+* Dependency-free.
+* Dramatically simple.
+
+See [GUIDE.md](https://github.com/cristalhq/appx/blob/main/GUIDE.md) for more details
+
+## Install
+
+Go version 1.17+
+
+```
+go get github.com/cristalhq/appx
+```
+
+## Example
+
+```go
+import (
+	"context"
+	"os"
+
+	"github.com/cristalhq/appx"
+)
+
+func main() {
+	ctx := appx.Context()
+
+	if err := run(ctx, os.Args[1:]); err != nil {
+		panic(err)
+	}
+}
+
+func run(ctx context.Context, args []string) error {
+	// do good things
+	return nil
+}
+```
+
+Also see examples: [examples_test.go](https://github.com/cristalhq/appx/blob/main/example_test.go).
+
+## Documentation
+
+See [these docs][pkg-url].
+
+## License
+
+[MIT License](LICENSE).
+
+[build-img]: https://github.com/cristalhq/appx/workflows/build/badge.svg
+[build-url]: https://github.com/cristalhq/appx/actions
+[pkg-img]: https://pkg.go.dev/badge/cristalhq/appx
+[pkg-url]: https://pkg.go.dev/github.com/cristalhq/appx
+[reportcard-img]: https://goreportcard.com/badge/cristalhq/appx
+[reportcard-url]: https://goreportcard.com/report/cristalhq/appx
+[coverage-img]: https://codecov.io/gh/cristalhq/appx/branch/main/graph/badge.svg
+[coverage-url]: https://codecov.io/gh/cristalhq/appx
+[version-img]: https://img.shields.io/github/v/release/cristalhq/appx
+[version-url]: https://github.com/cristalhq/appx/releases

appx.go

@@ -0,0 +1,13 @@
+package appx
+
+import (
+	"context"
+	"os/signal"
+	"syscall"
+)
+
+// Context of the application listening SIGINT and SIGTERM signals.
+func Context() context.Context {
+	ctx, _ := signal.NotifyContext(context.Background(), syscall.SIGINT, syscall.SIGTERM)
+	return ctx
+}

example_test.go

@@ -0,0 +1,21 @@
+package appx_test
+
+import (
+	"context"
+	"os"
+
+	"github.com/cristalhq/appx"
+)
+
+func main() {
+	ctx := appx.Context()
+
+	if err := run(ctx, os.Args[1:]); err != nil {
+		panic(err)
+	}
+}
+
+func run(ctx context.Context, args []string) error {
+	// do good things
+	return nil
+}

go.mod

@@ -0,0 +1,3 @@
+module github.com/cristalhq/appx
+
+go 1.17