dynasty 1.2.0

Dynasty reader's CLI downloader
Documentation 
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
106
107
108
109
110
111
112

# dynasty

[![Crates.io version](https://img.shields.io/crates/v/dynasty?style=for-the-badge)](https://crates.io/crates/dynasty)
[![Crates.io recent downloads](https://img.shields.io/crates/dr/dynasty?style=for-the-badge)](https://crates.io/crates/dynasty)
[![GitHub Workflow Status (Release)](https://img.shields.io/github/workflow/status/Aynh/dynasty/Release?style=for-the-badge)](https://github.com/Aynh/dynasty/actions/workflows/release.yaml)
[![GitHub Workflow Status (API Check)](https://img.shields.io/github/workflow/status/Aynh/dynasty/API%20Check?label=API%20CHECK&style=for-the-badge)](https://github.com/Aynh/dynasty/actions/workflows/api-check.yaml)
[![GitHub last commit](https://img.shields.io/github/last-commit/Aynh/dynasty?style=for-the-badge)](https://github.com/Aynh/dynasty/commit/HEAD)

A simple [Dynasty Reader](dynasty-scans.com/)'s CLI downloader, written in Rust.

## Installation

1. Github releases

Download the [release](https://github.com/Aynh/dynasty/releases) and then put it in your path or anywhere you want.

### Variants

There are currently 2 variants available in GitHub release.

- dynasty-cli

  The default, full-featured binary, just download this if you don't know which to pick.

- dynasty-cli-no-archive

  The binary without archive functionality (which means smaller size), this binary won't have `--archive` and `--keep-archived` flags.

2. Cargo

You need to have Rust toolchain [installed](https://www.rust-lang.org/tools/install) if you want to install using Cargo.

```bash
cargo install dynasty
```

Or if you don't need archive functionality.

```bash
cargo install dynasty --no-default-features
```

> Cargo will put the binary, `dynasty-cli` at your [installation root](https://doc.rust-lang.org/cargo/commands/cargo-install.html#description) (typically at `$HOME/.cargo/bin`).

## Usage

This is the `--help` for [`v1.2.0`](https://github.com/Aynh/dynasty/tree/v1.2.0).

```
dynasty 1.2.0
Aynh <aynlazur@gmail.com>
Dynasty reader's CLI downloader

USAGE:
    dynasty-cli [OPTIONS] <URL>...

ARGS:
    <URL>...    URL(s) to be downloaded

OPTIONS:
    -a, --archive <ARCHIVE_KIND>
            Archive the downloaded chapter(s) as <ARCHIVE_KIND> [possible values: cbz, zip, pdf]

    -A, --keep-archived
            Whether to keep archived images

    -d, --dir <DIR>
            Where to save the downloaded chapter(s).

    -h, --help
            Print help information

    -j, --max-concurrent-request <NUM>
            The maximum number of concurrently running requests [default: 4]

    -k, --max-retry <NUM>
            The maximum number of request retries [default: 4]

    -V, --version
            Print version information
```

### Examples

1. Download _Hino-san no Baka_ with 12 concurrent fetch.

```bash
dynasty-cli https://dynasty-scans.com/series/hino_san_no_baka -j 12
```

3. Using proxy (http, https, or socks) is possible through environment variable (see [reqwest proxies](https://docs.rs/reqwest/0.11.12/reqwest/index.html#proxies)).

```bash
HTTPS_PROXY=socks5://127.0.0.1:1080 dynasty-cli https://dynasty-scans.com/chapters/kitanai_kimi_ga_ichiban_kawaii_ch26
```

## License

Licensed under either of

- Apache License, Version 2.0
  ([LICENSE-APACHE](LICENSE-APACHE) or http://www.apache.org/licenses/LICENSE-2.0)
- MIT license
  ([LICENSE-MIT](LICENSE-MIT) or http://opensource.org/licenses/MIT)

at your option.

## Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted
for inclusion in the work by you, as defined in the Apache-2.0 license, shall be
dual licensed as above, without any additional terms or conditions.