Skip to main content

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.

Build status  Development status  License  Python version  Version  Downloads 

🚀 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


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

rfcdl-1.2.9.tar.gz (9.3 kB view details)

Uploaded Source

Built Distribution

rfcdl-1.2.9-py3-none-any.whl (9.4 kB view details)

Uploaded Python 3

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

Hashes for rfcdl-1.2.9.tar.gz
Algorithm Hash digest
SHA256 41c2bffed9d7a3de15e6ed3ce4977d0add4377e14fb3dbbc72aaaa27cd1753ae
MD5 0098c9c0593e6ece61e28350f2b3ae30
BLAKE2b-256 d7aeadac88d6837dab75b19e3a49b8c474b34b512b66a87ff6d3ea7a066f9289

See more details on using hashes here.

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

Hashes for rfcdl-1.2.9-py3-none-any.whl
Algorithm Hash digest
SHA256 6f240a008aa4c891b4afb82c2a9525211a3ebe22202176cbd2fa43bce68bc4e6
MD5 a0da831d072a2e2cf44c7e3b03c59270
BLAKE2b-256 bc9d85648148d233595c00e8f1c95447583b801db7c1c85361b3c196bbf5bcfc

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page