https://github.com/earthcubeingeo/citationhelper
Utility for determining all packages imported in a project to cite software properly.
https://github.com/earthcubeingeo/citationhelper
s
Last synced: 3 months ago
JSON representation
Utility for determining all packages imported in a project to cite software properly.
- Host: GitHub
- URL: https://github.com/earthcubeingeo/citationhelper
- Owner: EarthCubeInGeo
- License: gpl-3.0
- Created: 2020-05-26T23:42:44.000Z (about 6 years ago)
- Default Branch: master
- Last Pushed: 2021-07-06T16:25:52.000Z (almost 5 years ago)
- Last Synced: 2026-01-05T08:34:36.705Z (5 months ago)
- Topics: s
- Language: Python
- Size: 59.6 KB
- Stars: 2
- Watchers: 4
- Forks: 0
- Open Issues: 3
-
Metadata Files:
- Readme: README.rst
- License: LICENSE
- Citation: citationhelper/__init__.py
Awesome Lists containing this project
README
citationhelper
==============
This is a utility that generates a list of all packages imported into python scripts (\*.py) in a given list of directories. It is intended to be used to help keep track of community software used in research projects so that the packages can be properly cited in publications. The utility works by first walking the named directories and identifying \*.py files, then searching these files for import statements.
Installation
************
citationhelper can be installed via pip
pip install citationhelper
Alternatively, citationhelper can be installed from github
pip install git+https://github.com/EarthCubeInGeo/citationhelper.git
After installing, set the environment variable CITEHELP_REFFILE if you want to use a custom JSON library of full citations. The utility will work without this, but it can only generate a list of package names with no citation information.
export CITEHELP_REFFILE=filename
Usage
*****
Run citationhelper with the `citehelp` command followed by a list of the directories to search for import statements and print a report to the screen.
citehelp project_directory
**WARNING**: This tool was developed to assist researchers in keeping track of software packages, but it is HIGHLY recommended users review the list of packages produced.