A CLI for the fichub.net API
Project description
fichub-cli
A CLI for the fichub.net API
To report issues upstream for the supported sites, visit https://fichub.net/#contact
To report issues for the CLI, open an issue at https://github.com/FicHub/fichub-cli/issues
Installation
From pip (Recommended)
pip install -U fichub-cli
From Github Source (Pre-release, for testing new features by Beta testers)
pip install git+https://github.com/FicHub/fichub-cli@main
Usage
> fichub_cli
Usage: fichub_cli [OPTIONS] COMMAND [ARGS]...
A CLI for the fichub.net API
To report issues upstream for supported sites, visit
https://fichub.net/#contact
To report issues for the CLI, open an issue at
https://github.com/FicHub/fichub-cli/issues
Failed downloads will be saved in the `err.log` file in the current
directory
Options:
-u, --url TEXT The url of the fanfiction enclosed within quotes
-i, --infile TEXT Path to a file to read URLs from
-l, --list-url TEXT Enter a comma separated list of urls to download,
enclosed within quotes
-v, --verbose Show fic stats
-o, --out-dir TEXT Path to the Output directory for files (default:
Current Directory)
--format TEXT Download Format: epub (default), mobi, pdf or html
[default: epub]
--force Force overwrite of an existing file
-ss, --supported-sites List of supported sites
-d, --debug Show the log in the console for debugging
--changelog Save the changelog file
--debug-log Save the logfile for debugging
--version Display version & quit
--help Show this message and exit.
Default Configuration
- The fanfiction will be downloaded in epub format. To change it, use
-f
followed by the format. - The fanfiction will be downloaded in the current directory. To change it, use
-o
followed by the path to the directory. - Failed downloads will be saved in the
err.log
file in the current directory.
Check fichub_cli --help
for more info.
Example
- To download using an URL
fichub_cli -u https://archiveofourown.org/works/10916730/chapters/24276864
- To download using a file containing URLs
fichub_cli -i urls.txt
- To download using a comma separated list of URLs
fichub_cli -l "https://www.fanfiction.net/s/11191235/1/Harry-Potter-and-the-Prince-of-Slytherin,https://www.fanfiction.net/s/13720575/1/A-Cadmean-Victory-Remastered"
- To generate a changelog of the download
fichub_cli -i urls.txt --changelog
NOTE
--out-dir
or -o
can be used in all the above commands to select an output directory.
Plugin Support
Read the wiki for more info.
Helper Scripts
Helper scripts can be found here. They can add small functionalities to the CLI without needing to create full-fledged plugins.
Links
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
fichub-cli-0.7.1.tar.gz
(15.1 kB
view hashes)
Built Distribution
fichub_cli-0.7.1-py3-none-any.whl
(17.6 kB
view hashes)
Close
Hashes for fichub_cli-0.7.1-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 2d00aa933b74d64e533401f746cba6fa500dc919fa3eab35d9e2513ab8ffbb20 |
|
MD5 | 4bb063bcf09f43505d61bf011b8dc125 |
|
BLAKE2b-256 | 338cc996d8503964fd296be3d67f6cbf20d60972ebc18e1743e0f8134c31c0d1 |