Metadata-Version: 2.1
Name: getarticle-dev
Version: 0.0.4
Summary: A package based on SciHub and Google             Scholar that can download articles given DOI,             website address or keywords.
Home-page: https://github.com/HTian1997/getarticle
Author: Hao Tian
Author-email: htian1997@gmail.com
License: MIT
Platform: UNKNOWN
Description-Content-Type: text/markdown
Requires-Dist: requests
Requires-Dist: appscript
Requires-Dist: argparse

# getarticle [![Python](https://img.shields.io/badge/Python-3%2B-blue.svg)](https://www.python.org)

## Description 

`getarticle` is a package based on SciHub and Google Scholar that can download articles given DOI, website address or keywords.

## Install

Using `pip` to install:

```
# for latest version (recommended)
pip install git+https://github.com/HTian1997/getarticle.git

# for last release
pip install getarticle
```


## Features & Usage

`getarticle` can be imported in Python or used as command line. 

**To use in command line**:

```
usage: getarticle [-h] -i INPUT [-o OUTPUT]

getarticle CLI

optional arguments:
  -h, --help            show this help message and exit
  -i INPUT, --input INPUT
                        article DOI or website
  -o OUTPUT, --output OUTPUT
                        download direction
```

Downloaded to the current direction by default. 

Example:

```
getarticle -i 10.1126/science.abc7424 -o /Users/haotian/Desktop
```

`getarticle` can also download article of the current webpage (only supported in MacOS Safari). 

```
usage: article [-h] [-o OUTPUT]

getarticle CLI for Safari

optional arguments:
  -h, --help            show this help message and exit
  -o OUTPUT, --output OUTPUT
                        download direction
```

Example:

```
# current Safari webpage: https://science.sciencemag.org/content/early/2020/06/15/science.abc7424.abstract

article
```

**To use in Python**:

0. Initialization

```python3
from getarticle import GetArticle

ga = GetArticle()
```

1. Download a single article given DOI or website address. 

```python3
ga.input_article("10.1126/science.abc7424")
ga.download()
```

Notes: 
- Once downloaded, all stored articles will be cleared;
- For `download` function, `direction` argument is the current direction by default;
- Downloaded article is named as either "article title.pdf" if successfull or "year-month-day-hour-minute-second.pdf".

2. Download multiple articles.

```python3
ga.input_article("https://www.nature.com/articles/s41594-020-0468-7#article-info")
ga.input_article("10.1038/s41893-020-0581-y")
ga.download()
```

Notes: 
- Repeatedly using `article` function can save multiple articles. 
- `getarticle` will not save & download duplicate articles;

3. Download related articles given keywords. Keywords can be article names, research fields or author names. (This feature is under development.)

```python3
ga.search("Deep Dive into Machine Learning Models for Protein Engineering")
ga.search("SARS, Computation", num_of_page=2)
ga.search("Roberta Croce")
ga.download()
```

Notes: 
- `num_of_page` is the corresponding number of page in Google Scholar. 
- `num_of_page` is 1 by default. 

4. Show currently stored articles / delete article by index. 

```python3
ga.cur_articles()

ga.remove_article()
```


## License

MIT


