🎉 first version of the cli

Author: jfbus

.github/workflows/build.yml

@@ -0,0 +1,40 @@
+name: Build
+
+on:
+  pull_request:
+    branches:
+      - main
+    paths:
+      - "**.go"
+      - "Makefile"
+      - "go.*"
+      - ".github/workflows/build.yml"
+    
+permissions:
+  contents: read
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+    - name: ⬇️ Checkout repository
+      uses: actions/checkout@8e8c483db84b4bee98b60c0593521ed34d9990e8 # v6
+    - name: 🔎 golangci-lint
+      uses: golangci/golangci-lint-action@1e7e51e771db61008b38414a730f564565cf7c20 # v9
+      with:
+        version: v2.7.1
+        args: --timeout=300s
+        only-new-issues: true
+    - name: 📦 Build
+      run: go build -o gli main.go
+  unit:
+    runs-on: [self-hosted, eu-west-2]
+    steps:
+    - name: ⬇️ Checkout repository
+      uses: actions/checkout@8e8c483db84b4bee98b60c0593521ed34d9990e8 # v6
+    - name: 🧪 Test
+      run: go test ./...
+      env:
+        OSC_ACCESS_KEY: ${{ secrets.OSC_ACCESS_KEY }}
+        OSC_SECRET_KEY: ${{ secrets.OSC_SECRET_KEY }}
+        OSC_REGION: "eu-west-2"

.github/workflows/release.yaml

@@ -0,0 +1,38 @@
+name: release
+
+on:
+    push:
+        tags:
+            - "v*"
+
+permissions:
+  contents: write
+
+jobs:
+    goreleaser:
+        environment: release
+        runs-on: ubuntu-latest
+        steps:
+            - name: Checkout
+              uses: actions/checkout@8e8c483db84b4bee98b60c0593521ed34d9990e8 # v6
+
+            - name: Set up Go
+              uses: actions/setup-go@7a3fe6cf4cb3a834922a1244abfce67bcef6a0c5 # v6
+              with:
+                  go-version-file: "./go.mod"
+
+            # - name: Import GPG key
+            #   id: import_gpg
+            #   uses: crazy-max/ghaction-import-gpg@e89d40939c28e39f97cf32126055eeae86ba74ec # v6
+            #   with:
+            #       GPG_PRIVATE_KEY: ${{ secrets.GPG_PRIVATE_KEY }}
+            #       PASSPHRASE: ${{ secrets.PASSPHRASE }}
+
+            - name: Run GoReleaser
+              uses: goreleaser/goreleaser-action@e435ccd777264be153ace6237001ef4d979d3a7a # v6
+              with:
+                version: '~> v2'
+                args: release --clean
+              env:
+                #   GPG_FINGERPRINT: ${{ steps.import_gpg.outputs.fingerprint }}
+                  GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

.gitignore

@@ -0,0 +1,2 @@
+# Added by goreleaser init:
+dist/

.goreleaser.yaml

@@ -0,0 +1,43 @@
+# This is an example .goreleaser.yml file with some sensible defaults.
+# Make sure to check the documentation at https://goreleaser.com
+
+# The lines below are called `modelines`. See `:help modeline`
+# Feel free to remove those if you don't want/need to use them.
+# yaml-language-server: $schema=https://goreleaser.com/static/schema.json
+# vim: set ts=2 sw=2 tw=0 fo=cnqoj
+
+version: 2
+
+before:
+  hooks:
+    # You may remove this if you don't use go modules.
+    - go mod tidy
+    # you may remove this if you don't need go generate
+    - go generate ./...
+
+builds:
+  - env:
+      - CGO_ENABLED=0
+    goos:
+      - linux
+      - windows
+      - darwin
+    ldflags:
+        - "-s -w -X {{ .ModulePath }}/cmd.Version={{.Version}}"
+
+archives:
+  - formats: [binary]
+    # this name template makes the OS and Arch compatible with the results of `uname`.
+    name_template: >-
+      {{ .ProjectName }}_
+      {{- title .Os }}_
+      {{- if eq .Arch "amd64" }}x86_64
+      {{- else if eq .Arch "386" }}i386
+      {{- else }}{{ .Arch }}{{ end }}
+      {{- if .Arm }}v{{ .Arm }}{{ end }}
+
+changelog:
+  use: github-native
+
+release:
+  draft: true

README.md

@@ -1,4 +1,4 @@
-## **< Project Name >**
+## **GLI, An Experimental CLI for Outscale, written in Go**
 
 [![Project Stage](https://docs.outscale.com/fr/userguide/_images/Project-Sandbox-yellow.svg)](https://docs.outscale.com/en/userguide/Open-Source-Projects.html) [![](https://dcbadge.limes.pink/api/server/HUVtY5gT6s?style=flat&theme=default-inverted)](https://discord.gg/HUVtY5gT6s)
 
@@ -32,50 +32,37 @@
 
 ## 🧭 Overview
 
-**< Project Name >** is a <short description of what the project does, e.g., "CLI tool to manage...">.
-
-Key features:
-- <Feature 1>
-- <Feature 2>
-- <Feature 3>
+**CLI** is an experimental CLI for the Outscale APIs, written in Go.
 
 ---
 
 ## ✅ Requirements
 
-- <Dependency 1> (e.g., Rust, Go, Python 3.11+)
-- <Dependency 2> (e.g., Git)
 - Access to the OUTSCALE API (with appropriate credentials)
 
 ---
 
 ## ⚙ Installation
 
-### Option 1: Download from Releases
-
-Download the latest binary from the [Releases page](https://github.com/outscale/<project-name>/releases).
+Download the latest binary from the [Releases page](https://github.com/outscale/gli/releases).
 
-### Option 2: Install from source
+---
 
-```bash
-git clone https://github.com/outscale/<project-name>.git
-cd <project-name>
-<build or install command>
-````
+## 🛠 Configuration
 
-Example (for Go projects):
 
-```bash
-go install github.com/outscale/<project-name>@latest
-```
+The tool expects either environment variables or a configuration file.
 
----
+### Environment variables
 
-## 🛠 Configuration
+The tool will try to read the following environment variables:
+* `OSC_ACCESS_KEY`
+* `OSC_SECRET_KEY`
+* `OSC_REGION`
 
-\<Explain where the credentials or config are stored, e.g.:>
+### Profile file
 
-The tool expects a configuration file at `~/.osc/config.json`.
+If no environment variables are defined, the tool will read `~/.osc/config.json` and look for the `default` profile.
 
 ### Example
 
@@ -89,39 +76,39 @@ The tool expects a configuration file at `~/.osc/config.json`.
 }
 ```
 
-Use the `--profile` flag to select another profile.
+Use `OSC_CONFIG_FILE` to define an alternate config file and `OSC_PROFILE` an alternate profile.
 
 ---
 
 ## 🚀 Usage
 
 ```bash
-<command> [OPTIONS]
+gli <command> <api call>
 ```
 
+### Commands
+
+| Command | Description |
+| ------- | ----------- |
+| `oapi` | Call OAPI |
+| `version` | Display version |
+
 ### Options
 
-| Option             | Description                            |
-| ------------------ | -------------------------------------- |
-| `-f, --flag`       | What this flag does                    |
-| `-c, --count <N>`  | Run N times                            |
-| `--profile <name>` | Use a specific profile from the config |
-| `-v, --version`    | Print version and exit                 |
+| Option             | Description |
+| ------------------ | ----------- |
+| `-v, --verbose`    | Dump HTTP request and response |
+| `-h, --help`       | Help about a command |
 
 ---
 
 ## 💡 Examples
 
-### Basic usage
-
-```bash
-<command>
-```
-
-### With options
+### ReadVms
 
+List all VMs in the `running` state:
 ```bash
-<command> --flag value --profile test
+gli oapi ReadVms --Filters.VmStateNames running
 ```
 
 ### Using `jq` to filter JSON output
@@ -134,9 +121,9 @@ jq '.[] | select(.ResponseStatusCode != 200)' logs.json
 
 ## 📜 License
 
-**< Project Name >** is released under the < License Name > license.
+**<GLI** is released under the BSD 3-Clause license.
 
-© < Year > Outscale SAS
+© 2026 Outscale SAS
 
 See [LICENSE](./LICENSE) for full details.
 
@@ -147,15 +134,3 @@ See [LICENSE](./LICENSE) for full details.
 We welcome contributions!
 
 Please read our [Contributing Guidelines](CONTRIBUTING.md) and [Code of Conduct](CODE_OF_CONDUCT.md) before submitting a pull request.
-
----
-
-### Notes for reuse:
-- Replace all `<...>` placeholders with your content.
-- You can prefill the `Project Stage` badge with values like:
-  - `Project-Incubating-blue.svg`
-  - `Project-Graduated-green.svg`
-- You may include platform-specific instructions (macOS/Linux/Windows) in collapsible `<details>` blocks if needed.
-
->Labels are centrally managed in the outscale/.github repository (labels.yml).
->This repo includes a workflow (.github/workflows/sync-labels.yml) that syncs labels from there.

cmd/oapi.go

@@ -0,0 +1,97 @@
+/*
+Copyright © 2026 NAME HERE <EMAIL ADDRESS>
+*/
+package cmd
+
+import (
+	"context"
+	"encoding/json"
+	"os"
+	"reflect"
+	"strings"
+
+	"github.com/outscale/gli/pkg/debug"
+	"github.com/outscale/gli/pkg/errors"
+	"github.com/outscale/gli/pkg/flags"
+	"github.com/outscale/gli/pkg/sdk"
+	"github.com/outscale/osc-sdk-go/v3/pkg/middleware"
+	"github.com/outscale/osc-sdk-go/v3/pkg/osc"
+	"github.com/outscale/osc-sdk-go/v3/pkg/profile"
+	"github.com/outscale/osc-sdk-go/v3/pkg/utils"
+	"github.com/spf13/cobra"
+)
+
+// oapiCmd represents the oapi command
+var oapiCmd = &cobra.Command{
+	Use:   "oapi",
+	Short: "OAPI calls",
+	Long:  `Send commands to the Outscale API.`,
+}
+
+func init() {
+	rootCmd.AddCommand(oapiCmd)
+
+	c := reflect.TypeOf(&osc.Client{})
+	debug.Println(c.PkgPath(), c.Name())
+	for i := range c.NumMethod() {
+		m := c.Method(i)
+		if m.Type.NumIn() != 4 || m.Type.NumOut() != 2 || strings.HasSuffix(m.Name, "Raw") {
+			continue
+		}
+		cmd := &cobra.Command{
+			Use: m.Name,
+			Run: func(cmd *cobra.Command, args []string) {
+				oapi(cmd)
+			},
+		}
+		arg := m.Type.In(2)
+		flags.FromStruct(cmd.Flags(), arg, "")
+		oapiCmd.AddCommand(cmd)
+	}
+}
+
+func oapi(cmd *cobra.Command) {
+	debug.Println(cmd.Name() + " called")
+
+	p, err := profile.New()
+	if err != nil {
+		errors.ExitErr(err)
+	}
+	var opt middleware.MiddlewareChainOption
+	if verbose, _ := cmd.Flags().GetBool("verbose"); verbose {
+		opt = utils.WithLogging(sdk.VerboseLogger{})
+	} else {
+		opt = utils.WithoutLogging()
+	}
+	cl, err := osc.NewClient(p, opt)
+	if err != nil {
+		errors.ExitErr(err)
+	}
+	clt := reflect.TypeOf(cl)
+	m, _ := clt.MethodByName(cmd.Name())
+	argType := m.Type.In(2)
+	arg := reflect.New(argType)
+	err = flags.ToStruct(cmd.Flags(), arg, "")
+	if err != nil {
+		errors.ExitErr(err)
+	}
+	ctx := context.Background()
+	res := reflect.ValueOf(cl).MethodByName(cmd.Name()).Call([]reflect.Value{
+		reflect.ValueOf(ctx),
+		arg.Elem(),
+	})
+	debug.Println(len(res), "results")
+	if !res[1].IsNil() {
+		err = res[1].Interface().(error)
+		if oerr := osc.AsErrorResponse(err); oerr != nil {
+			enc := json.NewEncoder(os.Stderr)
+			enc.SetIndent("", "  ")
+			_ = enc.Encode(oerr)
+			os.Exit(1)
+		}
+		errors.ExitErr(err)
+	}
+	enc := json.NewEncoder(os.Stdout)
+	enc.SetIndent("", "  ")
+	_ = enc.Encode(res[0].Interface())
+}