wacli/readme.md

Command line getting from browser

The idea is to transform api methods in command line interface

The default shell command, like:

wacli <tool.dns> <api_methods>

You can also install localy

Binary, if exist

wacli bin <tool.dns>

API

wacli ain <tool.dns>

On your website you will need to use .well-know/wacli.json file:

{
    "api": "<api_url>",
    "bin": {
        "<platform>": [{
            "<architecture>": "<path_for_file" 
        }]
    }
    "settings": {
        // By default using application json, and it doesn't need to be specified
        "contentType": "application/json",
        "aliases": [{
            "alias": "<short_hand>" | ["short_hand","long_hand"], 
            "type": "path" | "method",
            "description": "description of cli command"
            "path": "<path>"
        }],
        "auth": {
            "sheme": "basic" | "bearer" | "oauth2"
            "token": "<name_of_token>" // - bearer
            // oauth2
            "flows": { 
                "implict": {
                    authorizationUrl: "url",
                    scopes: {}
                }
            }
        }
    }
}

Example as:

{
    "api": "https://codeberg.org/api/v1",
    "settings": {
        "aliases": [
            {
                "alias": "i",
                "type": "path",
                "path": "/repos/{owner}/{repo}/issues"
            },
            {
              "alias": "create",
              "type": "method",
              "method": "POST"
            },
            {
              "alias": "tea",
              "type": "bin",
              "bin": "tea"
            }
        ]
    },
    "bin": {
      "linux": [{"x86": "https://dl.gitea.com/tea/main/tea-main-linux-amd64.xz"}]
    }
}

Next REST API - https://codeberg.org/api/v1/repos/{owner}/{repo}/issues method is transform command:

By default - GET request:

wacli codeberg.org repos issues [owner] [repo]

If you need a request other than GET, then add the command

wacli codeberg.org post|delete|put|path repos issues [owner] [repo]

Such requests may require authorization, so you must log in separately:

wacli auth codeberg.org

tokens are stored separately in the database.

Methods can be overridden:

wacli codeberg.org create repos issues [owner] [repo]

By default, all request in clearnet and tor go via https, but i2p - http.

But sometimes you need to specify a specific protocol

pwact bin "git+http://codeberg.org/"

Binaries is install of user directory $HOME/.local/bin, for root user - /usr/local/bin.