[![PyPI version](https://badge.fury.io/py/myads.svg)](https://badge.fury.io/py/myads)
![PyPI - Python Version](https://img.shields.io/pypi/pyversions/myads?logo=python)
# myADS
`myADS` is a simple package to keep track of citations to your (and other
authors) papers.
It both reports the authors current paper citation metrics, and checks for any
new cites to the authors papers since the last time of checking.
Once installed you can always run `myads --help` to see a list of available
commands.
## Installation
The easiest method is to install directly from
[PyPi](https://pypi.org/project/myads/) via:
```bash
pip install myads
```
### From source
To install from source:
* Clone the repository using ``git clone
https://github.com/stuartmcalpine/myADS.git``
* Navigate to the ``myADS`` folder
* Install using `pip install .`
## Getting set up
``myADS`` can keep track of the citations for multiple authors. Two steps
before you get started:
* Initialize the database
* Add your authors you want to track to the database
* Add your ADS API token to the database
### Initialize the database
The database needs a one time initialization. To do this run
```bash
myads initialize
```
which will create a sqlite database at `$HOME/myADS_database.db`.
### Adding a author to the database
Once `myADS` is installed you can add the authors you wish to track using:
```bash
myads author add
```
You will be prompted to enter a first and last name, and an optional ORCID
(however it is recommended you add this for each author when possible).
### Removing a author from the database
You can remove authors from the tracking database using:
```bash
myads author remove <author id>
```
You can get a list of author IDs by typing:
```bash
myads author list
```
### Adding your ADS API token
You must add your [ADS API token](https://ui.adsabs.harvard.edu/help/api/) so
the package can query on your behalf.
To add it run:
```bash
myads token add <YOUR-API-TOKEN-HERE>
```
## Usage
### Citation reporter
If you run `myads report` you will get a report of all your tracked authors
current citations, e.g.,
```bash
Reporting cites for Stuart McAlpine...
+----------------------------------------------------+--------------+---------------+---------------------+
| Title | Citations | Publication | Bibcode |
| | (per year) | Date | |
+====================================================+==============+===============+=====================+
| Galaxy mergers in EAGLE do not induce a | 34 (12.0) | 2020-06-00 | 2020MNRAS.494.5713M |
| significant amount of black hole growth yet do | | | |
| increase the rate of luminous AGN | | | |
+----------------------------------------------------+--------------+---------------+---------------------+
```
### Citation tracker
If you run `myads check` it will tell you any papers that have cited your
tracked authors papers since the last call.
The first time you run this it will create a local database of your citations.
From then on it will update the local database with your new cites and report
the changes, e.g.,
```bash
1 new cite(s) for Galaxy mergers in EAGLE do not induce a significant amount of black hole growth yet do increase the rate of luminous AGN
+----------------------------------------+--------------------------------------+------------+---------------------+
| Title | Authors | Date | Bibcode |
+========================================+======================================+============+=====================+
| The breakBRD Breakdown: Using | ['Kopenhafer, Claire', 'Starkenburg, | 2020-11-01 | 2020ApJ...903..143K |
| IllustrisTNG to Track the Quenching of | Tjitske K.', 'Tonnesen, Stephanie', | | |
| an Observationally Motivated Sample of | 'Tuttle, Sarah'] | | |
| Centrally Star-forming Galaxies | | | |
+----------------------------------------+--------------------------------------+------------+---------------------+
```
Raw data
{
"_id": null,
"home_page": "",
"name": "myads",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.7",
"maintainer_email": "",
"keywords": "nasa-ads,citations,astronomy,ads,python,arxiv",
"author": "",
"author_email": "Stuart McAlpine <stuart.mcalpine@fysik.su.se>",
"download_url": "https://files.pythonhosted.org/packages/26/44/5d89294bf54f81fb95b39183bff6bf84afb5023091a7c5e28e11c9cf799a/myads-1.3.1.tar.gz",
"platform": null,
"description": "[![PyPI version](https://badge.fury.io/py/myads.svg)](https://badge.fury.io/py/myads)\n![PyPI - Python Version](https://img.shields.io/pypi/pyversions/myads?logo=python)\n\n# myADS\n\n`myADS` is a simple package to keep track of citations to your (and other\nauthors) papers.\n\nIt both reports the authors current paper citation metrics, and checks for any\nnew cites to the authors papers since the last time of checking.\n\nOnce installed you can always run `myads --help` to see a list of available\ncommands.\n\n## Installation\n\nThe easiest method is to install directly from\n[PyPi](https://pypi.org/project/myads/) via:\n\n```bash\npip install myads\n```\n\n### From source\n\nTo install from source:\n\n* Clone the repository using ``git clone\n https://github.com/stuartmcalpine/myADS.git``\n* Navigate to the ``myADS`` folder\n* Install using `pip install .`\n\n## Getting set up\n\n``myADS`` can keep track of the citations for multiple authors. Two steps\nbefore you get started:\n\n* Initialize the database\n* Add your authors you want to track to the database\n* Add your ADS API token to the database\n\n### Initialize the database\n\nThe database needs a one time initialization. To do this run\n\n```bash\nmyads initialize\n```\n\nwhich will create a sqlite database at `$HOME/myADS_database.db`.\n\n### Adding a author to the database\n\nOnce `myADS` is installed you can add the authors you wish to track using:\n\n```bash\nmyads author add\n```\n\nYou will be prompted to enter a first and last name, and an optional ORCID\n(however it is recommended you add this for each author when possible).\n\n### Removing a author from the database\n\nYou can remove authors from the tracking database using:\n\n```bash\nmyads author remove <author id>\n```\n\nYou can get a list of author IDs by typing:\n\n```bash\nmyads author list\n```\n\n### Adding your ADS API token\n\nYou must add your [ADS API token](https://ui.adsabs.harvard.edu/help/api/) so\nthe package can query on your behalf. \n\nTo add it run:\n\n```bash\nmyads token add <YOUR-API-TOKEN-HERE>\n```\n\n## Usage\n\n### Citation reporter\n\nIf you run `myads report` you will get a report of all your tracked authors\ncurrent citations, e.g.,\n\n```bash\nReporting cites for Stuart McAlpine...\n+----------------------------------------------------+--------------+---------------+---------------------+\n| Title | Citations | Publication | Bibcode |\n| | (per year) | Date | |\n+====================================================+==============+===============+=====================+\n| Galaxy mergers in EAGLE do not induce a | 34 (12.0) | 2020-06-00 | 2020MNRAS.494.5713M |\n| significant amount of black hole growth yet do | | | |\n| increase the rate of luminous AGN | | | |\n+----------------------------------------------------+--------------+---------------+---------------------+\n```\n\n### Citation tracker\n\nIf you run `myads check` it will tell you any papers that have cited your\ntracked authors papers since the last call. \n\nThe first time you run this it will create a local database of your citations.\nFrom then on it will update the local database with your new cites and report\nthe changes, e.g.,\n\n```bash\n 1 new cite(s) for Galaxy mergers in EAGLE do not induce a significant amount of black hole growth yet do increase the rate of luminous AGN\n+----------------------------------------+--------------------------------------+------------+---------------------+\n| Title | Authors | Date | Bibcode |\n+========================================+======================================+============+=====================+\n| The breakBRD Breakdown: Using | ['Kopenhafer, Claire', 'Starkenburg, | 2020-11-01 | 2020ApJ...903..143K |\n| IllustrisTNG to Track the Quenching of | Tjitske K.', 'Tonnesen, Stephanie', | | |\n| an Observationally Motivated Sample of | 'Tuttle, Sarah'] | | |\n| Centrally Star-forming Galaxies | | | |\n+----------------------------------------+--------------------------------------+------------+---------------------+\n```\n",
"bugtrack_url": null,
"license": "BSD 3-Clause License",
"summary": "Simple ADS API query package and citation tracker",
"version": "1.3.1",
"project_urls": {
"homepage": "https://github.com/stuartmcalpine/myADS",
"repository": "https://github.com/stuartmcalpine/myADS"
},
"split_keywords": [
"nasa-ads",
"citations",
"astronomy",
"ads",
"python",
"arxiv"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "b7f9b7e5113ecb90d9ad27baec6ffb4cd1d6d45ebf465d62da0dc41ec3ddb2d7",
"md5": "6c40434f30c1752603cd458c6a6db2f1",
"sha256": "e14beb0e4182ad0a68e0e86c0f1d77dbec7a7181f5937348b451575b9defcf12"
},
"downloads": -1,
"filename": "myads-1.3.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "6c40434f30c1752603cd458c6a6db2f1",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.7",
"size": 13679,
"upload_time": "2023-12-03T22:24:53",
"upload_time_iso_8601": "2023-12-03T22:24:53.943351Z",
"url": "https://files.pythonhosted.org/packages/b7/f9/b7e5113ecb90d9ad27baec6ffb4cd1d6d45ebf465d62da0dc41ec3ddb2d7/myads-1.3.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "26445d89294bf54f81fb95b39183bff6bf84afb5023091a7c5e28e11c9cf799a",
"md5": "ef54960509397227fdfd5a854be7412e",
"sha256": "1a4c8eb36f8783d2ec722316aa4a546838d2b7a722b51955d40396c128cf5c77"
},
"downloads": -1,
"filename": "myads-1.3.1.tar.gz",
"has_sig": false,
"md5_digest": "ef54960509397227fdfd5a854be7412e",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.7",
"size": 13612,
"upload_time": "2023-12-03T22:24:59",
"upload_time_iso_8601": "2023-12-03T22:24:59.152812Z",
"url": "https://files.pythonhosted.org/packages/26/44/5d89294bf54f81fb95b39183bff6bf84afb5023091a7c5e28e11c9cf799a/myads-1.3.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-12-03 22:24:59",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "stuartmcalpine",
"github_project": "myADS",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "myads"
}