Skip to main content

Automate scientific software review

Project description

AutoReviewer

Tests PyPI PyPI - Python Version PyPI - License Documentation Status Codecov status Cookiecutter template from @cthoyt Code style: black Contributor Covenant

Scientists often do the same bad stuff. Automate giving feedback during peer review for Python packages.

Goals:

  1. Given a GitHub repository, automate finding common issues such as
    • No setup.py/setup.cfg/pyproject.toml
    • No zenodo archive linked from the README
    • Non-standard code layout (src/ or bust)
    • Files contain hard-coded file paths
    • No documentation (search README for link to readthedocs)
    • Package name doesn't match github repository name
    • No reproducible installation instructions (i.e., does the README contain pip)
    • Uses conda for installation
    • Code does not have consistent style (i.e., there's no configuration for black)
    • pyroma doesn't pass 10/10
    • missing LICENSE file
    • missing CITATION.cff file
  2. Automate sending issues to the repository instructing how to do these things
    • Use deterministic titles for all issues to avoid duplicates / make idempotent
    • Create and edit "epic" issue that links others

Example Reviews:

Want to collaborate? What do you expect out of Python packages? Let me know in the comments. I envision this being sort of modular so people can contribute their own checks.

Desired interface:

Run on the command line with:

$ autoreviewer https://github.com/rs-costa/sbml2hyb

J. Chem. Inf. Analysis

There's a submodule autoreviewer.jcheminf that has utilities for scraping the paper list from the Journal of Cheminformatics, getting their ePub files, extracting GitHub references from the availability statements, running autoreview on each, then making the following summary with python -m autoreviewer.jcheminf.

🚀 Installation

The most recent release can be installed from PyPI with:

$ pip install autoreviewer

The most recent code and data can be installed directly from GitHub with:

$ pip install git+https://github.com/cthoyt/autoreviewer.git

You'll also need to make sure pandoc is installed. The best way to do this is brew install pandoc on macOS.

👐 Contributing

Contributions, whether filing an issue, making a pull request, or forking, are appreciated. See CONTRIBUTING.md for more information on getting involved.

👋 Attribution

⚖️ License

The code in this package is licensed under the MIT License.

🍪 Cookiecutter

This package was created with @audreyfeldroy's cookiecutter package using @cthoyt's cookiecutter-snekpack template.

🛠️ For Developers

See developer instructions

The final section of the README is for if you want to get involved by making a code contribution.

Development Installation

To install in development mode, use the following:

$ git clone git+https://github.com/cthoyt/autoreviewer.git
$ cd autoreviewer
$ pip install -e .

🥼 Testing

After cloning the repository and installing tox with pip install tox, the unit tests in the tests/ folder can be run reproducibly with:

$ tox

Additionally, these tests are automatically re-run with each commit in a GitHub Action.

📖 Building the Documentation

The documentation can be built locally using the following:

$ git clone git+https://github.com/cthoyt/autoreviewer.git
$ cd autoreviewer
$ tox -e docs
$ open docs/build/html/index.html

The documentation automatically installs the package as well as the docs extra specified in the setup.cfg. sphinx plugins like texext can be added there. Additionally, they need to be added to the extensions list in docs/source/conf.py.

📦 Making a Release

After installing the package in development mode and installing tox with pip install tox, the commands for making a new release are contained within the finish environment in tox.ini. Run the following from the shell:

$ tox -e finish

This script does the following:

  1. Uses Bump2Version to switch the version number in the setup.cfg, src/autoreviewer/version.py, and docs/source/conf.py to not have the -dev suffix
  2. Packages the code in both a tar archive and a wheel using build
  3. Uploads to PyPI using twine. Be sure to have a .pypirc file configured to avoid the need for manual input at this step
  4. Push to GitHub. You'll need to make a release going with the commit where the version was bumped.
  5. Bump the version to the next patch. If you made big changes and want to bump the version by minor, you can use tox -e bumpversion minor after.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

autoreviewer-0.0.4.tar.gz (316.4 kB view details)

Uploaded Source

Built Distribution

autoreviewer-0.0.4-py3-none-any.whl (480.7 kB view details)

Uploaded Python 3

File details

Details for the file autoreviewer-0.0.4.tar.gz.

File metadata

  • Download URL: autoreviewer-0.0.4.tar.gz
  • Upload date:
  • Size: 316.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.11.6

File hashes

Hashes for autoreviewer-0.0.4.tar.gz
Algorithm Hash digest
SHA256 1d8ebcefad46ec4628c6a08551358d42f8644d3219a6bb9f1d0c8025539c1e2b
MD5 9c99320d891354f20ab65321cb9b9868
BLAKE2b-256 025ca81ee3b6ce098052c6a484ab277ac83bbc79a4a521f6f74e8ea986674e9c

See more details on using hashes here.

Provenance

File details

Details for the file autoreviewer-0.0.4-py3-none-any.whl.

File metadata

  • Download URL: autoreviewer-0.0.4-py3-none-any.whl
  • Upload date:
  • Size: 480.7 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.11.6

File hashes

Hashes for autoreviewer-0.0.4-py3-none-any.whl
Algorithm Hash digest
SHA256 32d890f16a3b69d2799a03c1cffdb646eb0922efec8f826fa71639bd141de53e
MD5 0839755e75dfcbea6c9617ae76b5881b
BLAKE2b-256 d58c2def90b39af6398095325a8d3a2e3281129a2c1b6f1b7ef2ef6137a2d67c

See more details on using hashes here.

Provenance

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page