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.2.tar.gz (487.4 kB view details)

Uploaded Source

Built Distribution

autoreviewer-0.0.2-py3-none-any.whl (480.5 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: autoreviewer-0.0.2.tar.gz
  • Upload date:
  • Size: 487.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.2.tar.gz
Algorithm Hash digest
SHA256 70bfdcac02611f6cb5737ba6fcc42c91809a717ed3fbc3a0dec4a1dbb858b0a8
MD5 7537154419995fde0a089490d4021f82
BLAKE2b-256 ea4a3ce0ba0a72c4f7ec966ad70ab0e573376ef551553e3c128d26958521e463

See more details on using hashes here.

Provenance

File details

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

File metadata

  • Download URL: autoreviewer-0.0.2-py3-none-any.whl
  • Upload date:
  • Size: 480.5 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.2-py3-none-any.whl
Algorithm Hash digest
SHA256 3c4aa9fa0a2f0da8ef15e36d45de3a98d41232ef47e2f29637a7e5fb5c2fc8ac
MD5 a17929c32c652ea81753458322c3989e
BLAKE2b-256 d9bdd7b4482b3ee707022f00cf117959e18a7b8ffe5f22d0b7ae4cc232c4489b

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