A tool for downloading RFCs in high-speed.
Project description
rfcdl
Always keep a copy of your favorite RFCs.
rfcdl lets you download and synchronize RCFs in high-speed.
🚀 Installation
From PyPI
pip install rfcdl
From Source
./setup.py install
Fedora
sudo dnf copr enable eikendev/rfcdl
sudo dnf install python3-rfcdl
📄 Usage
This tool can be used to download a large number of RFC documents in a short period of time. I used it to keep a local mirror of all RFCs on my machines continuously synchronized.
For a quick introduction, let me show how you would use the tool to get started.
This is how you download the RFCs initially.
rfcdl -d ~/download/rfc/
As can be seen above, you have to specify a directory where all RFC documents will be saved in.
Upon the next invocation of rfcdl
, only the RFCs missing in that directory will be downloaded.
This can then be combined with an alias that lets you read the local copy of any RFC. The following command opens the RFC 8032 for me in less.
rfc 8032
Check out my dotfiles to see how this is implemented.
Arguments
If you only want to download a random subset of all RFCs, use the --samples
flag.
This can be used for testing.
For instance, the following will download 20 random RFC documents.
rfcdl -d ~/download/rfc/ --samples 20
Since rfcdl
downloads multiple files in parallel by default, one can specify how many simultaneous downloads are allowed using the --limit
flag.
The following invocation will only download at most ten files in parallel.
rfcdl -d ~/download/rfc/ --limit 10
To explicitly state how many times rfcdl
should download a file upon error, the --retries
flag can be used.
This can be useful in case one expects a bad connection.
This is how you could tell the tool to try to download each file at maximum five times.
rfcdl -d ~/download/rfc/ --retries 5
⚙ Configuration
A configuration file can be saved to ~/.config/rfcdl/config.ini
to avoid specifying the path for each invocation.
Of course, $XDG_CONFIG_HOME
can be set to change your configuration path.
Alternatively, the path to the configuration file can be set via the --config-file
argument.
[GENERAL]
RootDir = ~/download/rfc/
💻 Development
The source code is located on GitHub. To check out the repository, the following command can be used.
git clone https://github.com/eikendev/rfcdl.git
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
File details
Details for the file rfcdl-1.2.9.tar.gz
.
File metadata
- Download URL: rfcdl-1.2.9.tar.gz
- Upload date:
- Size: 9.3 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/4.0.1 CPython/3.10.5
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 41c2bffed9d7a3de15e6ed3ce4977d0add4377e14fb3dbbc72aaaa27cd1753ae |
|
MD5 | 0098c9c0593e6ece61e28350f2b3ae30 |
|
BLAKE2b-256 | d7aeadac88d6837dab75b19e3a49b8c474b34b512b66a87ff6d3ea7a066f9289 |
File details
Details for the file rfcdl-1.2.9-py3-none-any.whl
.
File metadata
- Download URL: rfcdl-1.2.9-py3-none-any.whl
- Upload date:
- Size: 9.4 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/4.0.1 CPython/3.10.5
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 6f240a008aa4c891b4afb82c2a9525211a3ebe22202176cbd2fa43bce68bc4e6 |
|
MD5 | a0da831d072a2e2cf44c7e3b03c59270 |
|
BLAKE2b-256 | bc9d85648148d233595c00e8f1c95447583b801db7c1c85361b3c196bbf5bcfc |