X-Git-Url: https://git.josue.xyz/?a=blobdiff_plain;f=README.md;h=99a6a7cebe073747adf4a6203bbf9aea9b2550ce;hb=40e4c9325e021fb3fed07ab73d69046facf7c0dc;hp=b894ee3f59cc855f7daec00de90238d2c10cdc69;hpb=7d7f035a4177e3c40f9209ecb05a1e4dc9c161b4;p=webi-installers%2F.git diff --git a/README.md b/README.md index b894ee3..99a6a7c 100644 --- a/README.md +++ b/README.md @@ -1,6 +1,11 @@ -# @webinstall/packages +# [webi-installers](https://github.com/webinstall/webi-installers) -> WebInstall is how developers install their tools +> [webi](https://webinstall.dev) is how developers install their tools + +- no `sudo` +- no package manager +- no messing with system permissions +- in short: no nonsense ```bash curl https://webinstall.dev/webi | bash @@ -9,37 +14,18 @@ curl https://webinstall.dev/webi | bash This repository contains the primary and community-submitted packages for [webinstall.dev](https://webinstall.dev). -# Installer Guidelines - -- Should install to `$HOME/.local/opt/-` or `$HOME/.local/bin` -- Should not need `sudo` (except perhaps for a one-time `setcap`, etc) -- Examples: - - Full Packages: - - Node.js: - - Golang: - - PostgreSQL: - - Single-Binary Installers: - - Caddy: - - Ripgrep: - - Gitea: - - Convenience Scripts: - - Prettier: - - Rust-lang: - - Rust-lang: - - -# How it works +# How webi works - Contacts official release APIs for download URLs - Selects the appropriate package version and archive format -- Installs to `$HOME/.local/` +- Installs to `$HOME/.local/opt` or `$HOME/.local/bin`, as appropriate. - Updates `PATH` via `$HOME/.config/envman/PATH.env` - Symlinks or copies current selected version More technically: 1. `/releases.js` transforms the package's release API into a common - formatt + format - (i.e. HTML, CSV, TAB, or JSON into a specific JSON format) - common release APIs are in `_common/` (i.e. `_common/github.js`) 2. `_webi/bootstrap.sh` is a template that exchanges system information for a @@ -58,6 +44,25 @@ More technically: `https://webinstall.dev/api/installers/@.sh?formats=zip,tar` - `bash install-.sh` => download, unpack, move, link, update PATH +# Philosophy (for package authors / maintainers publishing with webi) + +- Should install to `$HOME/.local/opt/-` or `$HOME/.local/bin` +- Should not need `sudo` (except perhaps for a one-time `setcap`, etc) +- Examples: + - Full Packages: + - Node.js: + - Golang: + - PostgreSQL: + - Single-Binary Installers: + - Caddy: + - Ripgrep: + - Gitea: + - Convenience Scripts: + - Prettier: + - Rust-lang: + - vim-sensible: + + ## Creating an Installer An install consists of 5 parts in 4 files: