Merge pull request #79 from openpathsampling/release-0.3

Release 0.3

Author: dwhswenson

.coveragerc

@@ -1,9 +1,9 @@
 [report]
 omit =
-    */paths_cli/tests/*
     */paths_cli/_installed_version.py
     */paths_cli/version.py
 exclude_lines =
     no-cov
     def __repr__
     raise NotImplementedError
+    __name__ == "__main__":

.github/workflows/autorelease-default-env.sh

@@ -1,4 +1,6 @@
-INSTALL_AUTORELEASE="python -m pip install autorelease==0.2.6"
+# Vendored from Autorelease 0.5.1
+# Update by updating Autorelease and running `autorelease vendor actions`
+INSTALL_AUTORELEASE="python -m pip install autorelease==0.5.1"
 if [ -f autorelease-env.sh ]; then
     source autorelease-env.sh
 fi

.github/workflows/autorelease-deploy.yml

@@ -1,10 +1,13 @@
-name: Autorelease
+# Vendored from Autorelease 0.5.1
+# Update by updating Autorelease and running `autorelease vendor actions`
+name: "Autorelease Deploy"
 on:
   release:
     types: [published]
 
 jobs:
   deploy_pypi:
+    if: ${{ github.repository == 'openpathsampling/openpathsampling-cli' }}
     runs-on: ubuntu-latest
     name: "Deploy to PyPI"
     steps:
@@ -17,7 +20,11 @@ jobs:
           if [ -f "autorelease-env.sh" ]; then
             cat autorelease-env.sh >> $GITHUB_ENV
           fi
-          eval $INSTALL_AUTORELEASE
+          if [ -f "./.autorelease/install-autorelease" ]; then
+            source ./.autorelease/install-autorelease
+          else
+            eval $INSTALL_AUTORELEASE
+          fi
         name: "Install autorelease"
       - run: |
           python -m pip install twine wheel

.github/workflows/autorelease-gh-rel.yml

@@ -1,11 +1,15 @@
-name: Autorelease
+# Vendored from Autorelease 0.5.1
+# Update by updating Autorelease and running `autorelease vendor actions`
+name: "Autorelease Release"
 on:
   push:
     branches:
+      # TODO: this should come from yaml conf
       - stable
 
 jobs:
   release-gh:
+    if: ${{ github.repository == 'openpathsampling/openpathsampling-cli' }}
     runs-on: ubuntu-latest
     name: "Cut release"
     steps:
@@ -18,7 +22,11 @@ jobs:
           if [ -f "autorelease-env.sh" ]; then
             cat autorelease-env.sh >> $GITHUB_ENV
           fi
-          eval $INSTALL_AUTORELEASE
+          if [ -f "./.autorelease/install-autorelease" ]; then
+            source ./.autorelease/install-autorelease
+          else
+            eval $INSTALL_AUTORELEASE
+          fi
         name: "Install autorelease"
       - run: |
           VERSION=`python setup.py --version`
@@ -27,3 +35,4 @@ jobs:
           autorelease-release --project $PROJECT --version $VERSION --token $AUTORELEASE_TOKEN
         env:
           AUTORELEASE_TOKEN: ${{ secrets.AUTORELEASE_TOKEN }}
+        name: "Cut release"

.github/workflows/autorelease-prep.yml

@@ -1,7 +1,10 @@
-name: "Autorelease"
+# Vendored from Autorelease 0.5.1
+# Update by updating Autorelease and running `autorelease vendor actions`
+name: "Autorelease testpypi"
 on:
   pull_request:
     branches:
+      # TODO: this should come from yaml conf
       - stable
 
 defaults:
@@ -10,6 +13,7 @@ defaults:
 
 jobs:
   deploy_testpypi:
+    if: ${{ github.repository == 'openpathsampling/openpathsampling-cli' }}
     runs-on: ubuntu-latest
     name: "Deployment test"
     steps:
@@ -22,10 +26,14 @@ jobs:
           if [ -f "autorelease-env.sh" ]; then
             cat autorelease-env.sh >> $GITHUB_ENV
           fi
-          eval $INSTALL_AUTORELEASE
+          if [ -f "./.autorelease/install-autorelease" ]; then
+            source ./.autorelease/install-autorelease
+          else
+            eval $INSTALL_AUTORELEASE
+          fi
         name: "Install autorelease"
       - run: |
-          python -m pip install twine wheel
+          python -m pip install twine wheel setuptools
         name: "Install release tools"
       - run: |
           bump-dev-version
@@ -41,6 +49,7 @@ jobs:
           repository_url: https://test.pypi.org/legacy/
         name: "Deploy to testpypi"
   test_testpypi:
+    if: ${{ github.repository == 'openpathsampling/openpathsampling-cli' }}
     runs-on: ubuntu-latest
     name: "Test deployed"
     needs: deploy_testpypi
@@ -54,7 +63,17 @@ jobs:
           if [ -f "autorelease-env.sh" ]; then
             cat autorelease-env.sh >> $GITHUB_ENV
           fi
-          eval $INSTALL_AUTORELEASE
+          if [ -f "./.autorelease/install-autorelease" ]; then
+            source ./.autorelease/install-autorelease
+          else
+            eval $INSTALL_AUTORELEASE
+          fi
         name: "Install autorelease"
-      - run: test-testpypi
-
+      - name: "Install testpypi version"
+        run: install-testpypi
+      - name: "Test testpypi version"
+        run: |
+          if [ -f "autorelease-env.sh" ]; then
+            cat autorelease-env.sh >> $GITHUB_ENV
+          fi
+          test-testpypi

.github/workflows/test-suite.yml

@@ -24,20 +24,28 @@ jobs:
     strategy:
       matrix:
         CONDA_PY:
-          - 3.9
-          - 3.8
-          - 3.7
-          - 3.6
+          - "3.12"
+          - "3.11"
+          - "3.10"
+        INTEGRATIONS: [""]
+        include:
+          - CONDA_PY: "3.12"
+            INTEGRATIONS: 'all-optionals'
 
     steps:
       - uses: actions/checkout@v2
+        with:
+          fetch-depth: 2
       - uses: actions/setup-python@v2
       - uses: conda-incubator/setup-miniconda@v2
         with:
           auto-update-conda: true
           python-version: ${{ matrix.CONDA_PY }}
       - name: "Install testing tools"
         run: python -m pip install -r ./devtools/tests_require.txt
+      - name: "Install integrations"
+        if: matrix.INTEGRATIONS == 'all-optionals'
+        run: conda install -c conda-forge -y openmm openmmtools mdtraj
       - name: "Install"
         run: |
           conda install pip
@@ -57,8 +65,13 @@ jobs:
           fi
           python autorelease_check.py --branch $BRANCH --even ${EVENT}
       - name: "Unit tests"
+        env:
+          PY_COLORS: "1"
         run: |
           python -c "import paths_cli"
           py.test -vv --cov --cov-report xml:cov.xml
-      - name: "Report coverage"
-        run: bash <(curl -s https://codecov.io/bash)
+      - uses: codecov/codecov-action@v4
+        with:
+          files: ./cov.xml
+        env:
+          CODECOV_TOKEN: ${{ secrets.CODECOV_TOKEN }}

LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2019 David W.H. Swenson
+Copyright (c) 2019-2024 David W.H. Swenson and contributors
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

README.md

@@ -1,4 +1,4 @@
-[![Tests](https://github.com/openpathsampling/openpathsampling-cli/workflows/Tests/badge.svg)](https://github.com/openpathsampling/openpathsampling-cli/actions?query=workflow%3ATests)
+[![Tests](https://github.com/openpathsampling/openpathsampling-cli/actions/workflows/test-suite.yml/badge.svg)](https://github.com/openpathsampling/openpathsampling-cli/actions/workflows/test-suite.yml)
 [![Documentation Status](https://readthedocs.org/projects/openpathsampling-cli/badge/?version=latest)](https://openpathsampling-cli.readthedocs.io/en/latest/?badge=latest)
 [![Coverage Status](https://codecov.io/gh/openpathsampling/openpathsampling-cli/branch/master/graph/badge.svg)](https://codecov.io/gh/openpathsampling/openpathsampling-cli)
 [![Maintainability](https://api.codeclimate.com/v1/badges/0d1ee29e1a05cfcdc01a/maintainability)](https://codeclimate.com/github/openpathsampling/openpathsampling-cli/maintainability)

autorelease-env.sh

@@ -1,2 +1,2 @@
-INSTALL_AUTORELEASE="python -m pip install autorelease==0.2.3 nose sqlalchemy dill"
+INSTALL_AUTORELEASE="python -m pip install autorelease==0.5 nose sqlalchemy dill"
 PACKAGE_IMPORT_NAME=paths_cli

docs/compiling.rst

@@ -0,0 +1,43 @@
+
+Compiling
+=========
+
+Let's start with an overview of terminology.:
+
+* **Compiling**: The process of converting input in a text format,
+  such as YAML or JSON, into OPS objects. Here we're focused on non-Python
+  alternatives to using the standard Python interpreter to compile objects.
+* **Category**: The base category of object to be created (engine, CV,
+  volume, etc.)
+* **Builder**: We will refer to a builder function, which creates an
+  instance of a specific 
+
+Everything is created with plugins. There are two types of plugins used in
+the ``compiling`` subpackage:
+
+* ``InstanceCompilerPlugin``: This is what you'll normally work with. These
+  convert the input text to an instance of a specific OPS object (for
+  example, an ``OpenMMEngine`` or an ``MDTrajFunctionCV``. In general, you
+  do not create subclasses of ``InstanceCompilerPlugin`` -- there are
+  subclasses specialized to engines (``EngineCompilerPlugin``), to CVs
+  (``CVCompilerPlugin``), etc. You create *instances* of those subclasses.
+  You write your builder function, and wrap in with in an instance of an
+  ``InstanceCompilerPlugin``.
+* ``CategoryPlugin``: These manage the plugins associated with a given
+  features.  Contributors will almost never need to create one of these.
+  The only case in which you would need to create one of these is if you're
+  creating a new *category* of object, i.e., something like an engine where
+  users will have multiple options at the command line.
+
+Other useful classes defined in the ``compiling`` subpackage include:
+
+* ``Builder``: The ``Builder`` class is a convenience for creating builder
+  functions. It takes either a callable or a string as input, where a string
+  is treated as a path to an object to import at runtime. It also allows
+  takes parameters ``remapper`` and ``after_build``, which are callables
+  that act on the input dictionary before object creation (``remapper``) and
+  on the created object after object creations (``after_build``).
+* ``CategoryCompiler``: This class manages plugins for a given category, as
+  well as tracking named objects of that type. These are created
+  automatically when plugins are registered; users do not need to create
+  these.