From 29d94dd0b28f69055d760827fe7c1cb4b1dad653 Mon Sep 17 00:00:00 2001
From: "Addisu Z. Taddese" <addisu@openrobotics.org>
Date: Wed, 30 Jul 2025 15:38:22 -0500
Subject: [PATCH] Add script for creating milestones on all Gazebo libraries

Signed-off-by: Addisu Z. Taddese <addisu@openrobotics.org>
---
 release-collection/milestones/README.md       | 28 +++++++
 .../milestones/create_milestones.bash         | 74 +++++++++++++++++++
 .../milestones/jetty_release.json             |  6 ++
 3 files changed, 108 insertions(+)
 create mode 100644 release-collection/milestones/README.md
 create mode 100755 release-collection/milestones/create_milestones.bash
 create mode 100644 release-collection/milestones/jetty_release.json

diff --git a/release-collection/milestones/README.md b/release-collection/milestones/README.md
new file mode 100644
index 000000000..14a39f2b9
--- /dev/null
+++ b/release-collection/milestones/README.md
@@ -0,0 +1,28 @@
+# README
+
+This directory contains tools and data to create milestones on all Gazebo
+libraries as it is not currently possible to share a milestone between different
+Github repositories. Instead, we create a milestone with the same name on all
+the repos and use queries like
+[`milestone:"Jetty Release"`](https://github.com/search?q=org%3Agazebosim+milestone%3A%22Jetty+Release%22&type=pullrequests)
+to filter pull request/issues. This is typically done during preparation for the
+release of a collection (e.g. Gazebo Jetty).
+
+Usage:
+
+1. Install and configure the Github CLI tool [`gh`](https://cli.github.com/).
+   Ensure you have write permission on all the Gazebo library repos.
+
+1. Create a `json` file with the following format replacing `<collection>` and
+   `<due date>`.
+
+```json
+{
+  "title": "<collection> Release",
+  "state": "open",
+  "description": "Track pull requests that are meant to go into the release. Note that this also includes pull requests that get merged into older branches and get forward merged.",
+  "due_on": "<due date>"
+}
+```
+
+1. Run `create_milestones.bash` with the file created above as an argument.
diff --git a/release-collection/milestones/create_milestones.bash b/release-collection/milestones/create_milestones.bash
new file mode 100755
index 000000000..81a1d1ae8
--- /dev/null
+++ b/release-collection/milestones/create_milestones.bash
@@ -0,0 +1,74 @@
+#!/usr/bin/env bash
+# Copyright (C) 2025 Open Source Robotics Foundation
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+
+# This script creates milestones in each Gazebo library and ros_gz. You'll
+# need the `gh` Github CLI tool installed and configured properly with an
+# account that has write permissions on all the repos specified below.
+#
+# Usage:
+# ./create_milestones.bash milestone_description.json
+#
+# where milestone_description.json is json file that contains the title,
+# description and due date of the milestone
+# Example:
+#
+# {
+#   "title": "Jetty Release"
+#   "state": "open",
+#   "description": "Track pull requests that are meant to go into the release. Note that this also includes pull requests that get merged into older branches and get forward merged."
+#   "due_on": "2025-09-29T23:59:59Z"
+# }
+#
+#
+if [[ $# -lt 1 ]]; then
+  echo "./create_milestones.bash FILE.json"
+  exit 1
+fi
+
+if [[ ! -f $1 ]]; then
+  echo "File \"$1\" does not exist"
+  exit 1
+fi
+
+repos="
+gz-cmake
+gz-common
+gz-fuel-tools
+gz-gui
+gz-launch
+gz-math
+gz-msgs
+gz-physics
+gz-plugin
+gz-rendering
+gz-sensors
+gz-sim
+gz-tools
+gz-transport
+gz-utils
+sdformat
+ros_gz
+"
+
+for repo in $repos; do
+  echo "Creating milestone on gazebosim/$repo"
+  result=$(cat $1 | gh api  --jq ".html_url" --method POST repos/gazebosim/$repo/milestones --input - 2>&1)
+  retval=$?
+  echo "  url: $result"
+  if [[ retval -ne 0 ]]; then
+    exit 1
+  fi
+done
diff --git a/release-collection/milestones/jetty_release.json b/release-collection/milestones/jetty_release.json
new file mode 100644
index 000000000..a49804215
--- /dev/null
+++ b/release-collection/milestones/jetty_release.json
@@ -0,0 +1,6 @@
+{
+  "title": "Jetty Release",
+  "state": "open",
+  "description": "Track pull requests that are meant to go into the release. Note that this also includes pull requests that get merged into older branches and get forward merged.",
+  "due_on": "2025-09-29T23:59:59Z"
+}