Giter Club home page Giter Club logo

rfcdl's Introduction

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

rfcdl's People

Contributors

eikendev avatar

Stargazers

 avatar  avatar

Watchers

 avatar  avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.