webi installers下载webi installers源代码下载

webi installers

其他源码

1.0.0

下载

网络安装程序

Webi是开发人员安装工具的方式

Webinstall-dev-ogimage-github

没有sudo
没有包装管理器
没有混乱的系统权限
简而言之：没有胡说八道

curl https://webi.sh/webi | sh

该存储库包含Webinstall.dev的主要和社区缩放软件包。

Webi的工作原理

联系人官方版本API下载URL
选择适当的软件包版本和存档格式
安装到$HOME/.local/opt或$HOME/.local/bin ，均适当地安装。
通过$HOME/.config/envman/PATH.env更新PATH
符号链接或复制当前选定版本

从技术上讲：

<package>/releases.js将软件包的释放API转换为通用格式
- （即HTML，CSV，TAB或JSON中的特定JSON格式）
- 常见的释放API在_common/ （即_common/github.js ）中
_webi/bootstrap.sh是一个模板，可为正确的安装程序提供系统信息
- 使用OS，CPU和实用程序信息构造用户代理（即macos ， amd64 ，可以解开tar,zip,xz ）
_webi/template.sh是具有常见功能的基本安装程序模板
- 检查版本
- 下载和解开包装
- 更新路径
- （重新）链接目录
<package>/install.sh可能会为覆盖_webi/template.sh提供功能
回顾：
- curl https://webi.sh/<pkg> => bootstrap-<pkg>.sh
- sh bootstrap-<pkg>.sh => https://webinstall.dev/api/installers/<pkg>@<ver>.sh?formats=zip,tar @<ver>@<ver> sh？
- sh install-<pkg>.sh =>下载，解开，移动，链接，更新路径

理念（适用于Webi的包装作者 /维护者）

应安装到$HOME/.local/opt/<package>-<version>或$HOME/.local/bin
不需要sudo （除了一次性setcap ，等等）
示例：
- 完整的软件包：
  - node.js：https：//github.com/webinstall/packages/tree/master/node
  - Golang：https：//github.com/webinstall/packages/tree/master/golang
  - PostgreSQL：https：//github.com/webinstall/packages/tree/master/postgres
- 单二进制安装程序：
  - 球童：https：//github.com/webinstall/packages/tree/master/caddy
  - ripgrep：https：//github.com/webinstall/packages/tree/master/ripgrep
  - gitea：https：//github.com/webinstall/packages/tree/master/gitea
- 便利脚本：
  - Prettier：https：//github.com/webinstall/packages/tree/master/prettier
  - rust-lang：https：//github.com/webinstall/packages/tree/master/rustlang
  - vim-sensible：https：//github.com/webinstall/packages/tree/master/vim-sensible

创建一个安装程序

一个安装由4个文件中的5个零件组成：

 my-new-package/
  - README.md (package info in frontmatter)
  - releases.js
  - install.sh (POSIX Shell)
  - install.ps1 (PowerShell)

创建描述
获取版本
版本检查（半门）
更新路径

看到以下示例：

https://github.com/webinstall/packages/blob/master/rg/
https://github.com/webinstall/packages/blob/master/golang/

webinstall.dev服务器使用<your-package>/releases.js返回的版本列表来生成具有预先定义的最必要变量和函数的shell脚本。

您只需填写空白即可。

tl; dr

只需创建一个空目录并运行测试，直到获得好结果。

git clone [email protected]:webinstall/webi-installers.git
pushd ./webi-installers/
git submodule update --init
npm clean-install

mkdir -p ./new-package/
node _webi/test.js ./new-package/

1。创建描述

只需从任何现有软件包中复制格式即可。就是这样：

README.md ：

 ---
title : Node.js
homepage : https://nodejs.org
tagline : |
  JavaScript V8 runtime
description : |
  Node.js® is a JavaScript runtime built on Chrome's V8 JavaScript engine
---

``` sh
node -e ' console.log("Hello, World!") '
> Hello, World !
```

1。提取版本

您在此步骤中所做的只是从一种形式的JSON，CSV或TAB或其他形式转换为webi理解的格式。

使用GitHub版本？请参阅ripgrep/releases.js （使用_common/github.js ）
有特殊格式吗？请参阅golang/releases.js或node/releases.js 。

看起来像这样：

releases.js ：

 module . exports = function ( ) {
  return github ( null , owner , repo ) . then ( function ( all ) {
    // if you need to do something special, you can do it here
    // ...
    return all ;
  } ) ;
} ;

2。bash安装程序

您可以设置的变量
您必须定义的功能
便利 /辅助功能

（如果需要的话，可选）您可能定义的bash变量：

 # Define this if the package name is different from the command name (i.e. golang => go)
pkg_cmd_name= " foobar "

# These are used for symlinks, PATH, and test commands
pkg_dst= " $HOME /.local/opt/foobar "
pkg_dst_cmd= " $HOME /.local/opt/foobar/bin/foobar "
# pkg_dst_bin="$(dirname "$pkg_dst_cmd")"

# These are the _real_ locations for the above
pkg_src= " $HOME /.local/opt/foobar-v $WEBI_VERSION "
pkg_src_cmd= " $HOME /.local/opt/foobar-v $WEBI_VERSION /bin/foobar "
# pkg_src_bin="$(dirname "$pkg_src_cmd")"

（必需）一个版本检查功能，该功能剥夺了所有非变换垃圾

 pkg_get_current_version () {
    # foobar-v1.1.7 => 1.1.7
    echo " $( foobar --version | head -n 1 | sed ' s:foobar-v:: ' ) "
}

对于其余功能，您可以从示例中复制/粘贴：

 pkg_format_cmd_version () {}         # Override, pretty prints version

pkg_link                            # Override, replaces webi_link()

pkg_pre_install () {                 # Override, runs any webi_* commands
    webi_check                          # for $HOME/.local/opt tools
    webi_download                       # for things that have a releases.js
    webi_extract                        # for .xz, .tar.*, and .zip files
}

pkg_install () {}                    # Override, usually just needs to rename extracted folder to
                                    # "$HOME/.local/opt/$pkg_cmd_name-v$WEBI_VERSION"

pkg_post_install () {                # Override
    webi_path_add " $pkg_dst_bin "        # should probably update PATH
}

pkg_done_message () {}               # Override, pretty print a success message

脚本API

请参阅webi/template.sh

这些变量将由服务器设置：

WEBI_PKG=example@v1
WEBI_TAG=v1
WEBI_HOST=https://webinstall.dev
WEBI_RELEASES=https://webinstall.dev/api/releases/example@v1 ? os=macos & arch=amd64 & pretty=true
WEBI_CSV=v1.0.2,
WEBI_VERSION=1.0.2
WEBI_MAJOR=1
WEBI_MINOR=0
WEBI_PATCH=2
WEBI_LTS=
WEBI_CHANNEL=stable
WEBI_EXT=tar
WEBI_PKG_URL=https://cdn.example.com/example-macos-amd64.tar.gz
WEBI_PKG_FILE=example-macos-amd64.tar.gz

PKG_NAME=example
PKG_OSES=macos,linux,windows
PKG_ARCHES=amd64,arm64,x86
PKG_FORMATS=zip,xz

WEBI_TMP= ${WEBI_TMP :- " $( mktemp -d -t webinstall-foobar.XXXXXXXX ) " }
WEBI_SINGLE= " "

webi_check              # Checks to see if the selected version is already installed (and re-links if so)
webi_download           # Downloads the selected release to $HOME/Downloads/webi/<package-name>.tar.gz
webi_extract            # Extracts the download to /tmp/<package-name>-<random>/
webi_path_add /new/path # Adds /new/path to PATH for bash, zsh, and fish
webi_pre_install        # Runs webi_check, webi_download, and webi_extract
webi_install            # Moves extracted files from $WEBI_TMP to $pkg_src
webi_link               # replaces any existing symlink with the currently selected version
webi_post_install       # Runs `webi_path_add $pkg_dst_bin`