Metadata-Version: 2.3
Name: dl-sh-source
Version: 0.2
Summary: Download articles from Sci Hub given the article's DOI.
Project-URL: Homepage, https://codeberg.org/hyperreal/dl-sh-source
Project-URL: Issues, https://codeberg.org/hyperreal/dl-sh-source/issues
Author-email: Jeffrey Serio <hyperreal@fedoraproject.org>
Classifier: License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Requires-Python: >=3.10
Requires-Dist: beautifulsoup4>=4.12.3
Requires-Dist: requests>=2.32.3
Description-Content-Type: text/markdown

# dl-sh-source

This program downloads an article from Sci-Hub to the current working directory.

## Installation

``` shell
pipx install dl-sh-source --include-deps
```

## Usage

Use the original article's digital object identifier (DOI) for the ARTICLE_NAME argument. Use a working Sci-Hub proxy as the SCIHUB_URL argument. For example, if the article's DOI URL is `10.1192/bjp.173.6.519`, and the Sci-Hub proxy you want to use is `https://sci-hub.st`, then the entire command would look like the following:

``` shell
cd ~/downloads
dl-sh-source "https://sci-hub.st" "10.1192/bjp.173.6.519"

Output:
--> /home/jas/downloads/paykel1998.pdf
```

However, if the article cannot be found on Sci-Hub, you'll get the following message:

``` shell
Output:
:(
Unfortunately, Sci-Hub doesn't have the requested document: 10.1192/bjp.173.6.519
```

> Note: make sure to use quotes around the Sci-Hub URL and DOI in the arguments to `dl-sh-source`.
