# hustmirror-cli

**Repository Path**: jingfelix/hustmirror-cli

## Basic Information

- **Project Name**: hustmirror-cli
- **Description**: hustmirror-cli 帮助快速换源
- **Primary Language**: Shell
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 5
- **Created**: 2023-09-06
- **Last Updated**: 2023-12-16

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# hustmirror-cli

## Introduction

`httpmirror` is a CLI posix shell script to replace softwares'
registry mirror.

## Usage
```
curl -s https://mirrors.hust.college/get | sh -s -- autodeploy
```

## Build
Use `GNU make` to process all files and generate them
into a single executable bash.
```shell
make
```

output script will be placed in `./output/hustmirror-cli`

## Test
```shell
make test
```

## Contract

### Styles
- Syntax of scripts is supposed to POSIX shell compatible.
- Use 4 character tab indent.
- We suppose that user only install `GNU coreutils` or `busybox`.
    So prerequisite check is supposed to be made when use other
    utils like `gcc` or `make`.

### Directories
- src: scripts would packaging into output scripts.
    - src/mirrors: scripts subject to mirror script contract.
    - src/main.sh.template: template shell file.
    - src/checkfile.sh: check file.
- scripts: store scripts used for packaging.

### Template
Template file supports following directives:
- `@include file`: include other files.
- `@var(shell code)`: get a string from build process.
- `@mirrors`: include all processed mirror scripts.

### Mirror script contract
All files in mirror should implement following functions.
- `check`: (optional) check if target machine is satisfied to replace mirror.
- `install`: install mirror.
- `is_deployed`: (optional) check whether is deployed.
- `can_recover`: (optional) check whether can be recovered.
- `uninstall`: (optional) recover installation.