Merge pull request #56 from man-group/release-0.3.0

0.3.0 with some quality of life improvements

Author: jonbannister

.circleci/config.yml

@@ -20,10 +20,20 @@ defaults: &defaults
     - run:
         name: Version checks
         command: |
-            grep -q $VERSION notebooker/_version.py || (echo "ERROR: Version number not found in notebooker/_version.py: $VERSION"; exit 1)
+            grep -q $VERSION notebooker/version.py || (echo "ERROR: Version number not found in notebooker/_version.py: $VERSION"; exit 1)
             grep -q $VERSION CHANGELOG.md || (echo "ERROR: Version number not found in CHANGES.md: $VERSION"; exit 1)
             grep -q $VERSION docs/conf.py || (echo "ERROR: Version number not found in docs/source/conf.py: $VERSION"; exit 1)
             grep -q $VERSION notebooker/web/static/package.json || (echo "ERROR: Version number not found in package.json: $VERSION"; exit 1)
+    - run:
+        name: Output useful stuff
+        command: |
+          echo $VERSION > "$CIRCLE_ARTIFACTS/version.txt"
+          # Find the lines of the changelog between releases, escape double quotes, delete empty lines
+          sed -n '{ /------/= }' CHANGELOG.md \
+              | head -n 2 \
+              | xargs -n 2 bash -c 'sed -n "s/\"/\\\\\"/g;`expr $0 + 1`,`expr $1 - 2`p" CHANGELOG.md' \
+              | sed '/^$/d' \
+              > "$CIRCLE_ARTIFACTS/changes.md"
     - run:
         name: Install MongoDB
         command: |
@@ -136,10 +146,6 @@ defaults: &defaults
           python setup.py sdist
           mkdir -p "$CIRCLE_ARTIFACTS/dist"
           cp -r ./dist/* "$CIRCLE_ARTIFACTS/dist"
-    - run:
-        name: Upload to PyPI
-        command: |
-          echo $VERSION > "$CIRCLE_ARTIFACTS/version.txt"
     - run:
         name: Upload to PyPI
         command: |
@@ -162,6 +168,7 @@ defaults: &defaults
         root: /tmp/circleci-artifacts
         paths:
           - ./*/version.txt
+          - ./*/changes.md
           - ./*/dist/*
 version: 2
 jobs:
@@ -170,7 +177,7 @@ jobs:
       PYTHON_VERSION: "3_6"
       CIRCLE_ARTIFACTS: /tmp/circleci-artifacts/3_6
       CIRCLE_TEST_REPORTS: /tmp/circleci-test-results/3_6
-      VERSION: 0.2.1
+      VERSION: 0.3.0
       PANDOC_RELEASES_URL: https://github.com/jgm/pandoc/releases
       YARN_STATIC_DIR: notebooker/web/static/
       IMAGE_NAME: mangroup/notebooker
@@ -182,7 +189,7 @@ jobs:
     environment:
       CIRCLE_ARTIFACTS: /tmp/circleci-artifacts/3_7
       CIRCLE_TEST_REPORTS: /tmp/circleci-test-results/3_7
-      VERSION: 0.2.1
+      VERSION: 0.3.0
       PANDOC_RELEASES_URL: https://github.com/jgm/pandoc/releases
       YARN_STATIC_DIR: notebooker/web/static/
       IMAGE_NAME: mangroup/notebooker
@@ -200,7 +207,15 @@ jobs:
           name: "Publish release on GitHub"
           command: |
             VERSION=$(cat /tmp/circleci-artifacts/3_6/version.txt)
-            ghr -t ${GITHUB_TOKEN} -u ${CIRCLE_PROJECT_USERNAME} -r ${CIRCLE_PROJECT_REPONAME} -c ${CIRCLE_SHA1} -soft ${VERSION} /tmp/circleci-artifacts/3_6/dist
+            CHANGES=$(cat /tmp/circleci-artifacts/3_6/changes.md)
+            ghr -t ${GITHUB_TOKEN} \
+                -u ${CIRCLE_PROJECT_USERNAME} \
+                -r ${CIRCLE_PROJECT_REPONAME} \
+                -c ${CIRCLE_SHA1} \
+                -n ${VERSION} \
+                -b "${CHANGES}" \
+                -soft \
+                ${VERSION} /tmp/circleci-artifacts/3_6/dist
 workflows:
   version: 2
   build_all:

CHANGELOG.md

@@ -1,3 +1,12 @@
+0.3.0 (2021-10-05)
+------------------
+
+* Major feature: scheduling natively within Notebooker
+    * See [the docs](https://notebooker.readthedocs.io/en/latest/webapp/webapp.html#scheduling-a-report) for more info.
+* Bugfix: Newer versions of uuid now work properly with Notebooker
+* Improvement: See the version number in the Notebooker GUI and with a /core/version GET call.
+
+
 0.2.1 (2021-02-11) 
 ------------------
 

CONTRIBUTING.md

@@ -18,7 +18,7 @@ Do also make sure to run the webapp and make sure you haven't broken anything.
 
 # Releasing a new version
 When releasing a new version, please increment the version number in:
-* `notebooker/_version.py`
+* `notebooker/version.py`
 * `.circleci/config.yml`
 * `docs/config.yml`
 * `notebooker/web/static/package.json`

docs/conf.py

@@ -23,7 +23,7 @@
 author = "Man Group Quant Tech"
 
 # The full version, including alpha/beta/rc tags
-release = "0.2.1"
+release = "0.3.0"
 
 
 # -- General configuration ---------------------------------------------------

notebooker/__init__.py

@@ -1,3 +1,3 @@
-from ._version import __version__
+from .version import __version__
 
 __import__("pkg_resources").declare_namespace(__name__)

notebooker/_entrypoints.py

@@ -4,7 +4,7 @@
 import click
 
 from notebooker import notebook_templates_example
-from notebooker._version import __version__
+from notebooker.version import __version__
 from notebooker.constants import DEFAULT_SERIALIZER
 from notebooker.execute_notebook import execute_notebook_entrypoint
 from notebooker.serialization import SERIALIZER_TO_CLI_OPTIONS

notebooker/_version.py

@@ -0,0 +1 @@
+__version__ = "0.3.0"

notebooker/version.py

@@ -1,5 +1,6 @@
 from flask import Blueprint, jsonify, request
 
+import notebooker.version
 from notebooker.utils.results import get_all_available_results_json
 from notebooker.web.utils import get_serializer, get_all_possible_templates, all_templates_flattened
 
@@ -53,3 +54,13 @@ def all_possible_templates_flattened():
     :returns: A JSON which is a list of all possible templates with their full names.
     """
     return jsonify({"result": all_templates_flattened()})
+
+
+@core_bp.route("/core/version")
+def get_version_no():
+    """
+    Core function which returns the Notebooker version number.
+
+    :returns: A JSON mapping from "version" to the string repr of the version number.
+    """
+    return jsonify({"version": notebooker.version.__version__})

notebooker/web/routes/core.py

@@ -1,4 +1,14 @@
 $(document).ready(() => {
+    $.ajax({
+        url: '/core/version',
+        success: (result) => {
+            $('#versionTitle').text("v" + result.version);
+            $('#versionTitle').show();
+        },
+        error: () => {
+            $('#versionTitle').hide();
+        },
+    });
     // Check auth is enabled on our host
     $.ajax({
         url: '/oauth/health',