Merge pull request #889 from GoogleCloudPlatform/v0.6.0

Merge release v0.6.0 into main

Author: douglasjacobsen

.coveragerc

@@ -28,7 +28,7 @@
 # - N814: camelcase imported as constant
 #
 [flake8]
-ignore = E129,E221,E241,E272,E731,W503,W504,F999,N801,N813,N814,F403,F405
+ignore = E129,E203,E221,E241,E272,E731,W503,W504,F999,N801,N813,N814,F403,F405
 max-line-length = 99
 
 per-file-ignores =

.flake8

@@ -8,7 +8,7 @@
 # dependents. So we add exceptions for checks related to undefined names.
 #
 # Note that we also add *per-line* exemptions for certain patterns in the
-# `ramble flake8` command.  This is where F403 for `from ramble import *`
+# `ramble style` command.  This is where F403 for `from ramble import *`
 # is added (because we *only* allow that wildcard).
 #
 # See .flake8 for regular exceptions.
@@ -20,5 +20,5 @@
 # - F821: undefined name `name`
 #
 [flake8]
-ignore = E129,E221,E241,E272,E731,E501,W503,W504,W605,F405,F821,F999,N801,N813,N814
+ignore = E129,E203,E221,E241,E272,E731,E501,W503,W504,W605,F405,F821,F999,N801,N813,N814
 max-line-length = 79

.flake8_applications

@@ -0,0 +1,43 @@
+# Workflow for deploying a single redirect page to GitHub Pages
+name: gh-pages deploy
+
+on:
+  # Runs on pushes targeting the default branch
+  push:
+    branches: ["develop"]
+
+  # Allows you to run this workflow manually from the Actions tab
+  workflow_dispatch:
+
+# Sets permissions of the GITHUB_TOKEN to allow deployment to GitHub Pages
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+# Allow only one concurrent deployment, skipping runs queued between the run in-progress and latest queued.
+# However, do NOT cancel in-progress runs as we want to allow these production deployments to complete.
+concurrency:
+  group: "pages"
+  cancel-in-progress: false
+
+jobs:
+  # Single deploy job since we're just deploying
+  deploy:
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+      - name: Setup Pages
+        uses: actions/configure-pages@v5
+      - name: Upload artifact
+        uses: actions/upload-pages-artifact@v3
+        with:
+          # Only deploy the redirect directory
+          path: './lib/ramble/docs/_gh_pages_redirect'
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4

.github/workflows/gh-pages-deploy.yaml

@@ -1,12 +1,21 @@
 repos:
 - repo: local
   hooks:
-  - id: flake8
-    name: flake8
-    entry: share/ramble/qa/run-flake8-tests
+  - id: style
+    name: style
+    entry: share/ramble/qa/run-style-tests
     language: system
   - id: short-unit-tests
     name: short-unit-tests
     entry: share/ramble/qa/run-unit-tests
     language: system
-    stages: [push]
+    stages: [pre-push]
+
+- repo: https://github.com/asottile/pyupgrade
+  rev: v3.17.0
+  hooks:
+  - id: pyupgrade
+    name: python-old-syntax-check
+    args: [--py36-plus]
+    files: (lib/ramble/ramble/|var/ramble/repos/).*\.py$
+

.github/workflows/sphinx.yml

@@ -0,0 +1,14 @@
+version: 2
+
+build:
+  os: "ubuntu-22.04"
+  tools:
+    python: "3.12"
+
+sphinx:
+  configuration: lib/ramble/docs/conf.py
+  fail_on_warning: false
+
+python:
+  install:
+    - requirements: lib/ramble/docs/requirements.txt

.pre-commit-config.yaml

@@ -187,7 +187,7 @@
       same "printed page" as the copyright notice for easier
       identification within third-party archives.
 
-   Copyright 2022-2024 The Ramble Authors.
+   Copyright 2022-2025 The Ramble Authors.
 
    Licensed under the Apache License, Version 2.0 (the "License");
    you may not use this file except in compliance with the License.

.readthedocs.yaml

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2022-2023 Google LLC, Ramble Project Developers.
+Copyright (c) 2022-2025 Google LLC, Ramble Project Developers.
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

LICENSE-APACHE

@@ -1,6 +1,7 @@
-Ramble is a multi-platform experimentation framework to increase exploration
-productivity and improve reproducibility. Ramble is capable of driving software
-installation, acquire input files, configure experiments, and extract results.
+Ramble is a multi-platform experimentation framework that increases exploration
+productivity and improves reproducibility. Ramble is capable of driving
+software installation, acquiring input files, configuring experiments, and
+extracting results.
 It works on Linux, macOS, and many supercomputers.
 
 Ramble can be used to configure a variety of experiments for applications.
@@ -14,9 +15,11 @@ Python, and Ramble’s dependencies are installed as per the dependency section
 below.
 Then:
 
-    $ git clone -c feature.manyFiles=true https://github.com/GoogleCloudPlatform/ramble.git
-    $ cd ramble/bin
-    $ ./ramble workspace create -d test_workspace -c ../examples/basic_hostname_config.yaml
+    git clone -c feature.manyFiles=true https://github.com/GoogleCloudPlatform/ramble.git
+    python3 -m venv ramble/env
+    . ramble/env/bin/activate
+    pip install -r ramble/requirements.txt
+    ./ramble/bin/ramble workspace create -d test_workspace -c ramble/examples/basic_hostname_config.yaml
 
 Dependencies
 ------------
@@ -25,22 +28,27 @@ Ramble’s python dependencies can be installed using the included requirements.
 
 e.g.
 
-    $ pip install -r requirements.txt
+    pip install -r requirements.txt
 
 We recommend Python >= 3.7 for Ramble, but a best effort attempt is made to
 support Python 3.6 as it is used by older operating systems such as Centos7.
 Specifically, you might need to update `pip` and downgrade `protobuf` when
 using Python 3.6.
 
-Outside of these requirements, ramble requires an existing installation of
-spack for some application definition. See
-[Spack’s documentation](https://github.com/spack/spack#-spack) to install Spack.
+Outside of these requirements, Ramble requires package managers to be
+configured if they will be used as part of the experiments Ramble creates.
+
+Although package manager support is not required to use Ramble, some
+experiments are more easily accomplished by allowing Ramble to drive the
+package manager execution. To allow this, package managers generally need to be
+installed indepednently from Ramble. For more information on this, see
+[Ramble's supported package managers](https://ramble.readthedocs.io/en/latest/package_managers.html).
 
 Documentation
 ----------------
 
 Ramble’s documentation can be viewed at
-[https://googlecloudplatform.github.io/ramble/](https://googlecloudplatform.github.io/ramble/).
+[https://ramble.readthedocs.io/](https://ramble.readthedocs.io/).
 
 For help with Ramble’s commands, run `ramble help` or `ramble help --all`.
 
@@ -63,6 +71,14 @@ Resources:
 
 Contributing
 ------------------------
+When developing features for Ramble, it can be helpful to install the
+development requirements instead of the user requirements:
+
+e.g.
+
+    pip install -r requirements-dev.txt
+
+
 Contributing to Ramble is relatively easy.  Just send us a
 [pull request](https://help.github.com/articles/using-pull-requests/).
 When you send your request, make ``develop`` the destination branch on the