dev(tools): set new version setting logic on top of dev-tools

Move real version to VERSION file for docs and script version bumping

VERSION

@@ -0,0 +1,1 b''
+5.3.0
  No newline at end of file

docs/source/conf.py

@@ -7,8 +7,20 b''
 # https://www.sphinx-doc.org/en/master/usage/configuration.html#project-information
 import datetime
 
+
+def _get_version():
+    with open("../../VERSION") as f:
+        return f.read().strip()
+
+
 now = datetime.datetime.today()
 
+# The full project version, used as the replacement for |release| and e.g. in the HTML templates.
+# For example, for the Python documentation, this may be something like 2.6.0rc1.
+# If you don’t need the separation provided between version and release, just set them both to the same value.
+release = _get_version()
+
+
 project = 'RhodeCode rcstack'
 copyright = f'2010-{now.year}, RhodeCode Inc.'
 author = 'RhodeCode Inc.'
@@ -17,7 +29,10 b" author = 'RhodeCode Inc.'"
 # https://www.sphinx-doc.org/en/master/usage/configuration.html#general-configuration
 
 extensions = [
-    'sphinx_rtd_theme'
+    'sphinx.ext.autodoc',
+    'sphinx.ext.intersphinx',
+    'sphinx.ext.todo',
+    'sphinx.ext.imgmath'
 ]
 
 templates_path = ['_templates']
@@ -31,9 +46,19 b" pygments_style = 'sphinx'"
 
 # https://github.com/pradyunsg/furo/tree/main/src/furo/theme/furo
 html_theme = 'furo'
+
+# Add any paths that contain custom static files (such as style sheets) here,
+# relative to this directory. They are copied after the builtin static files,
+# so a file named "default.css" will overwrite the builtin "default.css".
 html_static_path = ['_static']
+
+# If not '', a 'Last updated on:' timestamp is inserted at every page bottom,
+# using the given strftime format.
 html_last_updated_fmt = ' %H:%m %b %d, %Y'
+
+# If true, "Created using Sphinx" is shown in the HTML footer. Default is True.
 html_show_sphinx = False
+
 html_extra_path = ['extra']
 
 

scripts/dev-tools/dev-tools

@@ -44,6 +44,7 b' dev_tools_usage() {'
   printf "  %s   clears docker images and system cache, full cleanup. Be cautious !\n" "prune-all         "
   printf "  %s   pull latest image of bashly\n" "cli-generate-pull "
   printf "  %s   print out help about bashly\n" "cli-generate-help "
+  printf "  %s   set the version for rcstack\n" "stack-cli-version "
   printf "  %s   run a ./rcstack generation script\n" "stack-cli-generate"
   printf "  %s   run a ./dev-tools generation script\n" "dev-cli-generate  "
   echo
@@ -370,6 +371,43 b' dev_tools_cli_generate_help_usage() {'
 }
 
 # :command.usage
+dev_tools_stack_cli_version_usage() {
+  if [[ -n $long_usage ]]; then
+    printf "dev-tools stack-cli-version - set the version for rcstack\n"
+    echo
+
+  else
+    printf "dev-tools stack-cli-version - set the version for rcstack\n"
+    echo
+
+  fi
+
+  printf "%s\n" "Usage:"
+  printf "  dev-tools stack-cli-version VERSION\n"
+  printf "  dev-tools stack-cli-version --help | -h\n"
+  echo
+
+  # :command.long_usage
+  if [[ -n $long_usage ]]; then
+    printf "%s\n" "Options:"
+
+    # :command.usage_fixed_flags
+    printf "  %s\n" "--help, -h"
+    printf "    Show this help\n"
+    echo
+
+    # :command.usage_args
+    printf "%s\n" "Arguments:"
+
+    # :argument.usage
+    printf "  %s\n" "VERSION"
+    printf "    Version to set e.g '5.0.0'\n"
+    echo
+
+  fi
+}
+
+# :command.usage
 dev_tools_stack_cli_generate_usage() {
   if [[ -n $long_usage ]]; then
     printf "dev-tools stack-cli-generate - run a ./rcstack generation script\n"
@@ -664,6 +702,21 b' dev_tools_cli_generate_help_command() {'
 }
 
 # :command.function
+dev_tools_stack_cli_version_command() {
+  # src/stack_cli_version_command.sh
+  version=${args[version]}
+  version_file=$(pwd)/VERSION
+  yaml_file=$(pwd)/scripts/rcstack/src/bashly.yml
+
+  echo "Setting $version to $version_file"
+  echo -n $version > $version_file
+
+  echo "Setting $version to $yaml_file"
+  sed -i -E "s/version:.+/version: $version/" $yaml_file
+
+}
+
+# :command.function
 dev_tools_stack_cli_generate_command() {
   # src/stack_cli_generate_command.sh
   one_time=${args[--one-time]}
@@ -796,6 +849,13 b' parse_requirements() {'
       shift $#
       ;;
 
+    stack-cli-version)
+      action="stack-cli-version"
+      shift
+      dev_tools_stack_cli_version_parse_requirements "$@"
+      shift $#
+      ;;
+
     stack-cli-generate)
       action="stack-cli-generate"
       shift
@@ -1287,6 +1347,62 b' dev_tools_cli_generate_help_parse_requirements() {'
 }
 
 # :command.parse_requirements
+dev_tools_stack_cli_version_parse_requirements() {
+  # :command.fixed_flags_filter
+  while [[ $# -gt 0 ]]; do
+    case "${1:-}" in
+      --help | -h)
+        long_usage=yes
+        dev_tools_stack_cli_version_usage
+        exit
+        ;;
+
+      *)
+        break
+        ;;
+
+    esac
+  done
+
+  # :command.command_filter
+  action="stack-cli-version"
+
+  # :command.parse_requirements_while
+  while [[ $# -gt 0 ]]; do
+    key="$1"
+    case "$key" in
+
+      -?*)
+        printf "invalid option: %s\n" "$key" >&2
+        exit 1
+        ;;
+
+      *)
+        # :command.parse_requirements_case
+        # :command.parse_requirements_case_simple
+        if [[ -z ${args['version']+x} ]]; then
+
+          args['version']=$1
+          shift
+        else
+          printf "invalid argument: %s\n" "$key" >&2
+          exit 1
+        fi
+
+        ;;
+
+    esac
+  done
+
+  # :command.required_args_filter
+  if [[ -z ${args['version']+x} ]]; then
+    printf "missing required argument: VERSION\nusage: dev-tools stack-cli-version VERSION\n" >&2
+    exit 1
+  fi
+
+}
+
+# :command.parse_requirements
 dev_tools_stack_cli_generate_parse_requirements() {
   # :command.fixed_flags_filter
   while [[ $# -gt 0 ]]; do
@@ -1419,6 +1535,7 b' run() {'
     "prune-all") dev_tools_prune_all_command ;;
     "cli-generate-pull") dev_tools_cli_generate_pull_command ;;
     "cli-generate-help") dev_tools_cli_generate_help_command ;;
+    "stack-cli-version") dev_tools_stack_cli_version_command ;;
     "stack-cli-generate") dev_tools_stack_cli_generate_command ;;
     "dev-cli-generate") dev_tools_dev_cli_generate_command ;;
   esac