A metadata plugin for fetching Metadata from the Fichub API for the fichub-cli
Project description
fichub-cli-metadata
A metadata plugin for fetching Metadata from the Fichub API for fichub-cli
To report issues upstream for the supported sites, visit https://fichub.net/#contact
To report issues for the plugin, open an issue at https://github.com/fichub-cli-contrib/fichub-cli-metadata/issues
To report issues for the CLI, open an issue at https://github.com/FicHub/fichub-cli/issues
Installation
From pip (Stable, recommended)
pip install -U fichub-cli-metadata
From Github Source (Pre-release, for testing new features by Beta testers)
pip install git+https://github.com/fichub-cli-contrib/fichub-cli-metadata@main
Usage
> fichub_cli metadata
Usage: fichub_cli metadata [OPTIONS] COMMAND [ARGS]...
A metadata plugin for fetching Metadata from the Fichub API for the fichub-cli
Options:
-i, --input TEXT Input: Either an URL or path to a file
--input-db TEXT Use an existing sqlite db
--update-db Self-Update existing db (--input-db required)
--export-db Export the existing db as json (--input-db
required)
-o, --out-dir TEXT Path to the Output directory (default: Current
Directory)
--download-ebook TEXT Download the ebook as well. Specify the format:
epub (default), mobi, pdf or html
--fetch-urls TEXT Get all story urls found from a page. Currently
supports archiveofourown.org only
--force Force update the metadata
-d, --debug Show the log in the console for debugging
--log / --no-log Save the logfile for debugging [default: no-log]
--version / --no-version Display version & quit [default: no-version]
--help Show this message and exit.
Default Configuration
- 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 metadata --help
for more info.
Example
- To fetch metadata using an URL
fichub_cli metadata -i https://archiveofourown.org/works/10916730/chapters/24276864
- To fetch metadata using a file containing URLs
fichub_cli metadata -i urls.txt
- To choose a output directory
fichub_cli metadata -i urls.txt -o "~/Desktop/books"
- To save the metadata in an existing db
fichub_cli metadata -i urls.txt --input-db "urls - 2022-01-29 T000558.sqlite"
- To update an existing db from given input
fichub_cli metadata -i urls.txt --input-db "urls - 2022-01-29 T000558.sqlite" --force
- To self-update an existing db i.e. update each row from the db
fichub_cli metadata --input-db "urls - 2022-01-29 T000558.sqlite" --update-db
- To dump an existing db as a json
fichub_cli metadata --input-db "urls - 2022-01-29 T000558.sqlite" --export-db
- To download the ebook along with the metadata
fichub_cli metadata -i urls.txt --download-ebook epub
- To get all story urls found from a page. Currently supports archiveofourown.org only.
fichub_cli metadata --fetch-urls https://archiveofourown.org/users/flamethrower/
Note: If there are any database schema changes, the CLI will automatically migrate the db. A .pre.migration
sqlite file will be created which would be your original db before any migrations as backup.
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
Built Distribution
Hashes for fichub-cli-metadata-0.3.3.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | e13f796c7dc882fee63022e410e39d0615a8d75c08ed923a1e4f66df9e12e718 |
|
MD5 | 1dde95c692d239fd75418a1c905a4a1f |
|
BLAKE2b-256 | 9751f0c72f9ba8082c797e5249ef952ccbc220ee9d94251cbff1d5e73a014044 |
Hashes for fichub_cli_metadata-0.3.3-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 3abf60229e10a9e7030336a867c9047783f4e8b1638a6919dfbc4181074577e9 |
|
MD5 | 5406536ffa825e18aece5fde0f05468a |
|
BLAKE2b-256 | ab565749f09e7d13574671bbdc12873a4f1417baf89b13e67731a3d37c988a76 |