silkroad 0.0.4

A full-featured registry server for Cargo.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105

# SilkRoad(skrd)

## Introduction

A ~~full-featured~~ registry server for Cargo. 

## Status

[WIP] Most features have not been implemented yet.

## RoadMap

- [ ] Serve an index repository and all crates
    - [x] HTTP server
        - [x] The Dumb Protocol
        - [x] The Smart Protocol(except git-receive-pack)
        - [ ] HTTPS
    - [ ] Git server
    - [ ] No dependency on `git`
    - [ ] Registry Web API (Login, Publish and so on)
        - [ ] Login
        - [ ] Publish
        - [ ] Yank & Unyank
        - [ ] Owners
- [ ] Mirroring
    - [x] Index clone and sync
    - [x] Crates download
    - [x] Parallel download
    - [ ] Timer
- [ ] Server Migration
    - [ ] Package
    - [ ] Unpackage
- [ ] Homepage (An Angular based SPA?)

## Dependencies

* Git 2+

## Usage

### Installation

```
$ cargo install silkroad
```

### Create a mirror

This command will create a mirror of `source` in the `path` directory.
```
$ skrd mirror <path> [source]
```
Examples:

```
$ skrd mirror mymirror https://mirrors.ustc.edu.cn/crates.io-index
```
```
$ skrd mirror official #default source = https://github.com/rust-lang/crates.io-index
```

### Update a mirror

```
$ skrd update <path>
```
Example:
```
$ skrd update mymirror
```
```
$ skrd update # in mymirror
```

### Serve

```
$ skrd serve <path>
```
Example:
```
$ skrd serve mymirror
```
```
$ skrd serve # in mymirror
```

## References

* Documents
    * [Git - Transfer Protocols](https://git-scm.com/book/en/v2/Git-Internals-Transfer-Protocols)
    * [Registries - The Cargo Book](https://doc.rust-lang.org/cargo/reference/registries.html)
* Projects
    * [rust-lang/crates.io-index](https://github.com/rust-lang/crates.io-index) Crates.io index.
    * [rust-lang/crates.io](https://github.com/rust-lang/crates.io) Source code for crates.io.
    * [rust-lang/cargo](https://github.com/rust-lang/cargo) The Rust package manager.
    * [AaronO/go-git-http](https://github.com/AaronO/go-git-http) A Smart Git Http server library in Go (golang).
    * [samrat/rug](https://github.com/samrat/rug) A implementation of Jit.
    * [tennix/crates-mirror](https://github.com/tennix/crates-mirror) Download all crates on Rust official crates site and keep sync with it.
    * [rustcc/lernaean](https://github.com/rustcc/lernaean) 一个面向中文社区的crates.io镜像.
    * [mcorbin/meuse](https://github.com/mcorbin/meuse) A Rust private registry written in Clojure.  
    
## License

SilkRoad is under the MIT license. See the [LICENSE](./LICENSE) file for details.