Metadata-Version: 2.1
Name: scholarly_publications
Version: 0.6
Summary: A tool to fetch scholarly publications from Google Scholar by author ID
Home-page: https://github.com/ezefranca/scholarly_publications
Author: Ezequiel França
Author-email: ezequiel.franca@gmail.com
Project-URL: Bug Reports, https://github.com/ezefranca/scholarly_publications/issues
Project-URL: Source, https://github.com/ezefranca/scholarly_publications
Keywords: scholarly publications google scholar fetcher academia
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Education
Classifier: Intended Audience :: Science/Research
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: requests
Requires-Dist: beautifulsoup4

# Scholarly Publications Fetcher  [![PyPI](https://img.shields.io/pypi/v/scholarly_publications?color=blue)](https://pypi.org/project/scholarly_publications)

The `scholarly_publications` package provides an easy-to-use interface for fetching publication data from Google Scholar. It allows users to retrieve detailed information about an author's publications, including titles, publication years, links, and citation counts. This package is designed for academics, researchers, and anyone interested in programmatically analyzing scholarly publication data.

## Installation

To install `scholarly_publications`, use the following pip command in your terminal:

```bash
pip install scholarly_publications
```

## Usage

### Using the CLI (Command Line Interface)

`scholarly_publications` can be easily used via its command-line interface. Here are some examples:

Fetch all publications for a given author ID:
```bash
scholarly_publications <author_id>
```

Fetch a specific number of publications for a given author ID:
```bash
scholarly_publications <author_id> --max=<number_of_publications>
```

Sort results by pubdate/cited:
```bash
scholarly_publications <author_id> --sortby=<pubdate/cited>
```

### Using as a Python Package

You can also use `scholarly_publications` directly in your Python code. Here's how:

```python
from scholarly_publications import fetch_publications

# Fetch all publications for a given author ID
publications = fetch_publications('<author_id>')

# Fetch a specific number of publications for a given author ID
publications = fetch_publications('<author_id>', max_publications=<number_of_publications>)

# Fetch all publications for a given author ID and sort by pubdate/cited
publications = fetch_publications('<author_id>', sortby='<pubdate/cited>')

print(publications)
```

## Contributing

We welcome contributions to `scholarly_publications`! If you have suggestions for improvements, please open an issue or a pull request.

## Status

[![Upload Python Package](https://github.com/ezefranca/scholarly_publications/actions/workflows/workflow.yml/badge.svg)](https://github.com/ezefranca/scholarly_publications/actions/workflows/workflow.yml)


## License

`scholarly_publications` is released under the MIT License. See the LICENSE file for more details.
