# Scholarly Publications Fetcher [](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
[](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.
Raw data
{
"_id": null,
"home_page": "https://github.com/ezefranca/scholarly_publications",
"name": "scholarly-publications",
"maintainer": null,
"docs_url": null,
"requires_python": null,
"maintainer_email": null,
"keywords": "scholarly publications google scholar fetcher academia",
"author": "Ezequiel Fran\u00e7a",
"author_email": "ezequiel.franca@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/ef/66/17acfc3e248f20cbb4c85785e3f30e76b97be20e916d74e975406eb3324f/scholarly_publications-0.6.tar.gz",
"platform": null,
"description": "# Scholarly Publications Fetcher [](https://pypi.org/project/scholarly_publications)\n\nThe `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.\n\n## Installation\n\nTo install `scholarly_publications`, use the following pip command in your terminal:\n\n```bash\npip install scholarly_publications\n```\n\n## Usage\n\n### Using the CLI (Command Line Interface)\n\n`scholarly_publications` can be easily used via its command-line interface. Here are some examples:\n\nFetch all publications for a given author ID:\n```bash\nscholarly_publications <author_id>\n```\n\nFetch a specific number of publications for a given author ID:\n```bash\nscholarly_publications <author_id> --max=<number_of_publications>\n```\n\nSort results by pubdate/cited:\n```bash\nscholarly_publications <author_id> --sortby=<pubdate/cited>\n```\n\n### Using as a Python Package\n\nYou can also use `scholarly_publications` directly in your Python code. Here's how:\n\n```python\nfrom scholarly_publications import fetch_publications\n\n# Fetch all publications for a given author ID\npublications = fetch_publications('<author_id>')\n\n# Fetch a specific number of publications for a given author ID\npublications = fetch_publications('<author_id>', max_publications=<number_of_publications>)\n\n# Fetch all publications for a given author ID and sort by pubdate/cited\npublications = fetch_publications('<author_id>', sortby='<pubdate/cited>')\n\nprint(publications)\n```\n\n## Contributing\n\nWe welcome contributions to `scholarly_publications`! If you have suggestions for improvements, please open an issue or a pull request.\n\n## Status\n\n[](https://github.com/ezefranca/scholarly_publications/actions/workflows/workflow.yml)\n\n\n## License\n\n`scholarly_publications` is released under the MIT License. See the LICENSE file for more details.\n",
"bugtrack_url": null,
"license": null,
"summary": "A tool to fetch scholarly publications from Google Scholar by author ID",
"version": "0.6",
"project_urls": {
"Bug Reports": "https://github.com/ezefranca/scholarly_publications/issues",
"Homepage": "https://github.com/ezefranca/scholarly_publications",
"Source": "https://github.com/ezefranca/scholarly_publications"
},
"split_keywords": [
"scholarly",
"publications",
"google",
"scholar",
"fetcher",
"academia"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "7804a4af23ae93a48e85a3b2db9db0a09be93f7d9c074b2e9fd002eb98926dbc",
"md5": "23f684a03e919729148b13065db0a998",
"sha256": "0eb7121af5035f0d6b597b83a64765b4d32ef143abe85e9135b0eafcb35a8088"
},
"downloads": -1,
"filename": "scholarly_publications-0.6-py3-none-any.whl",
"has_sig": false,
"md5_digest": "23f684a03e919729148b13065db0a998",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 5415,
"upload_time": "2024-04-11T09:43:38",
"upload_time_iso_8601": "2024-04-11T09:43:38.455830Z",
"url": "https://files.pythonhosted.org/packages/78/04/a4af23ae93a48e85a3b2db9db0a09be93f7d9c074b2e9fd002eb98926dbc/scholarly_publications-0.6-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "ef6617acfc3e248f20cbb4c85785e3f30e76b97be20e916d74e975406eb3324f",
"md5": "21cdbe149e2c25d1757e090660a05a16",
"sha256": "14f05e876902250b5aec7c2b9374ad0a06c36baa1e2fabd7b526552b75202c22"
},
"downloads": -1,
"filename": "scholarly_publications-0.6.tar.gz",
"has_sig": false,
"md5_digest": "21cdbe149e2c25d1757e090660a05a16",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 4899,
"upload_time": "2024-04-11T09:43:39",
"upload_time_iso_8601": "2024-04-11T09:43:39.475179Z",
"url": "https://files.pythonhosted.org/packages/ef/66/17acfc3e248f20cbb4c85785e3f30e76b97be20e916d74e975406eb3324f/scholarly_publications-0.6.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-04-11 09:43:39",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "ezefranca",
"github_project": "scholarly_publications",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "scholarly-publications"
}
JSON
