add script to set version of all packages in IDOM

Author: rmorshea

VERSION

@@ -0,0 +1 @@
+0.32.0

noxfile.py

@@ -10,7 +10,7 @@
 from nox.sessions import Session
 
 
-HERE = Path(__file__).parent
+ROOT = Path(__file__).parent
 POSARGS_PATTERN = re.compile(r"^(\w+)\[(.+)\]$")
 
 
@@ -39,7 +39,7 @@ def example(session: Session) -> None:
     """Run an example"""
     if not session.posargs:
         print("No example name given. Choose from:")
-        for found_example_file in (HERE / "docs" / "source" / "examples").glob("*.py"):
+        for found_example_file in (ROOT / "docs" / "source" / "examples").glob("*.py"):
             print("-", found_example_file.stem)
         return None
 
@@ -175,6 +175,51 @@ def test_docs(session: Session) -> None:
     session.run("sphinx-build", "-b", "doctest", "docs/source", "docs/build")
 
 
+@nox.session
+def tag(session: Session):
+    try:
+        session.run(
+            "git",
+            "diff",
+            "--cached",
+            "--exit-code",
+            silent=True,
+            external=True,
+        )
+    except Exception:
+        session.error("Cannot create a tag - tROOT are uncommited changes")
+
+    version = (ROOT / "VERSION").read_text().strip()
+    install_requirements_file(session, "make-release")
+    session.run("pysemver", "check", version)
+
+    changelog_file = ROOT / "docs" / "source" / "changelog.rst"
+    for line in changelog_file.read_text().splitlines():
+        if line == version:
+            break
+    else:
+        session.error(f"No changelog entry for {version} in {changelog_file}")
+
+    session.run("git", "tag", version, external=True)
+
+    if "push" in session.posargs:
+        session.run("git", "push", "--tags", external=True)
+
+
+@nox.session
+def update_version(session: Session) -> None:
+    if len(session.posargs) > 1:
+        session.error("To many arguments")
+
+    try:
+        version = session.posargs[0]
+    except IndexError:
+        session.error("No version tag given")
+
+    install_requirements_file(session, "make-release")
+    session.run("python", "scripts/update_versions.py", version)
+
+
 @nox.session(reuse_venv=True)
 def latest_pull_requests(session: Session) -> None:
     """A basic script for outputing changelog info"""
@@ -190,7 +235,7 @@ def latest_closed_issues(session: Session) -> None:
 
 
 def install_requirements_file(session: Session, name: str) -> None:
-    file_path = HERE / "requirements" / (name + ".txt")
+    file_path = ROOT / "requirements" / (name + ".txt")
     assert file_path.exists(), f"requirements file {file_path} does not exist"
     session.install("-r", str(file_path))
 

requirements.txt

@@ -2,6 +2,7 @@
 -r requirements/build-pkg.txt
 -r requirements/check-style.txt
 -r requirements/check-types.txt
+-r requirements/make-release.txt
 -r requirements/pkg-deps.txt
 -r requirements/pkg-extras.txt
 -r requirements/test-env.txt

requirements/make-release.txt

@@ -0,0 +1 @@
+semver >=2, <3

scripts/README.md

@@ -1,3 +1,4 @@
 # Scripts
 
-All scripts should be run from the repository root.
+All scripts should be run from the repository root
+(typically using [`nox`](https://nox.thea.codes/en/stable/)).

scripts/update_versions.py

@@ -0,0 +1,46 @@
+import json
+import sys
+from pathlib import Path
+from typing import List
+
+import semver
+
+
+ROOT = Path("__file__").parent.parent
+VERSION_FILE = ROOT / Path("VERSION")
+PY_PKG_INIT_FILE = ROOT / "src" / "idom" / "__init__.py"
+JS_ROOT_DIR = ROOT / "src" / "client"
+JS_PACKAGE_JSON_FILES = [
+    pkg_dir / "package.json" for pkg_dir in (JS_ROOT_DIR / "packages").iterdir()
+] + [JS_ROOT_DIR / "package.json"]
+
+VERSION_INFO = semver.VersionInfo.parse(VERSION_FILE.read_text().strip())
+
+
+def main(args: List[str]) -> None:
+    version_str = str(VERSION_INFO)
+    update_py_version(version_str)
+    update_js_versions(version_str)
+
+
+def update_py_version(new_version: str) -> None:
+    new_lines = PY_PKG_INIT_FILE.read_text().splitlines()
+    for index, line in enumerate(new_lines):
+        if line.startswith('__version__ = "') and line.endswith('"  # DO NOT MODIFY'):
+            line = f'__version__ = "{new_version}"  # DO NOT MODIFY'
+            new_lines[index] = line
+            break
+    else:
+        raise RuntimeError(f"No __version__ assignment found in {PY_PKG_INIT_FILE}")
+    PY_PKG_INIT_FILE.write_text("\n".join(new_lines) + "\n")
+
+
+def update_js_versions(new_version: str) -> None:
+    for pkg_json_file in JS_PACKAGE_JSON_FILES:
+        pkg_json = json.loads(pkg_json_file.read_text())
+        pkg_json["version"] = new_version
+        pkg_json_file.write_text(json.dumps(pkg_json, indent=2, sort_keys=True) + "\n")
+
+
+if __name__ == "__main__":
+    main(sys.argv)

setup.py

@@ -50,8 +50,6 @@ def list2cmdline(cmd_list):
     "keywords": ["interactive", "widgets", "DOM", "React"],
     "include_package_data": True,
     "zip_safe": False,
-    "setup_requires": ["setuptools_scm"],
-    "use_scm_version": True,
     "classifiers": [
         "Environment :: Web Environment",
         "Framework :: AsyncIO",

src/client/package.json

@@ -1,7 +1,11 @@
 {
-  "workspaces": [
-    "./packages/*"
-  ],
+  "dependencies": {
+    "idom-client-react": "file:packages/idom-client-react"
+  },
+  "devDependencies": {
+    "prettier": "^2.2.1",
+    "snowpack": "^3.5.2"
+  },
   "license": "MIT",
   "repository": {
     "type": "git",
@@ -12,11 +16,8 @@
     "format": "npm --workspaces run format",
     "test": "npm --workspaces test"
   },
-  "devDependencies": {
-    "prettier": "^2.2.1",
-    "snowpack": "^3.5.2"
-  },
-  "dependencies": {
-    "idom-client-react": "file:packages/idom-client-react"
-  }
+  "version": "0.32.0",
+  "workspaces": [
+    "./packages/*"
+  ]
 }

src/client/packages/idom-app-react/package.json

@@ -1,10 +1,17 @@
 {
-  "name": "idom-app-react",
-  "description": "A client application for IDOM implemented in React",
-  "version": "0.1.0",
   "author": "Ryan Morshead",
+  "dependencies": {
+    "idom-client-react": "file:packages/idom-client-react",
+    "react": "^16.13.1",
+    "react-dom": "^16.13.1"
+  },
+  "description": "A client application for IDOM implemented in React",
+  "devDependencies": {
+    "prettier": "^2.2.1"
+  },
   "license": "MIT",
   "main": "src/index.js",
+  "name": "idom-app-react",
   "repository": {
     "type": "git",
     "url": "https://github.com/idom-team/idom"
@@ -13,12 +20,5 @@
     "format": "prettier --write ./src",
     "test": "echo 'no tests'"
   },
-  "devDependencies": {
-    "prettier": "^2.2.1"
-  },
-  "dependencies": {
-    "idom-client-react": "file:packages/idom-client-react",
-    "react": "^16.13.1",
-    "react-dom": "^16.13.1"
-  }
+  "version": "0.32.0"
 }

src/client/packages/idom-client-react/package.json

@@ -1,33 +1,33 @@
 {
-  "name": "idom-client-react",
-  "description": "A client for IDOM implemented in React",
-  "version": "0.10.0",
   "author": "Ryan Morshead",
-  "license": "MIT",
-  "type": "module",
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/idom-team/idom"
-  },
-  "main": "src/index.js",
-  "files": [
-    "src/**/*.js"
-  ],
-  "scripts": {
-    "format": "prettier --write ./src",
-    "test": "uvu tests"
+  "dependencies": {
+    "fast-json-patch": "^3.0.0-1",
+    "htm": "^3.0.3"
   },
+  "description": "A client for IDOM implemented in React",
   "devDependencies": {
     "jsdom": "16.3.0",
     "prettier": "^2.2.1",
     "uvu": "^0.5.1"
   },
-  "dependencies": {
-    "fast-json-patch": "^3.0.0-1",
-    "htm": "^3.0.3"
-  },
+  "files": [
+    "src/**/*.js"
+  ],
+  "license": "MIT",
+  "main": "src/index.js",
+  "name": "idom-client-react",
   "peerDependencies": {
     "react": ">=16",
     "react-dom": ">=16"
-  }
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/idom-team/idom"
+  },
+  "scripts": {
+    "format": "prettier --write ./src",
+    "test": "uvu tests"
+  },
+  "type": "module",
+  "version": "0.32.0"
 }