[Docs] Automate incrementing of package version for R and non-R version switchers

[asfimport]

Automate the updating of the version numbers in r/pkgdown/assets/versions.json with dev/release/utils-prepare.sh, and add a test confirming the update at dev/release/01-prepare-test.rb.

Reporter: Nicola Crane / @thisisnic
Assignee: Nicola Crane / @thisisnic

Related issues:

• [Docs] Add version dropdown to the pkgdown (R) docs (is related to)

PRs and other links:

• GitHub Pull Request #12212

_{Note: This issue was originally created as ARROW-15366. Please see the migration documentation for further details.}

[asfimport]

Ian Cook / @ianmcook:
Here are code chunks from those two files that I think could be used as an example:

In utils-prepare.sh you'll need to add lines like this:

arrow/dev/release/utils-prepare.sh

Lines 60 to 64 in 9938f70

	sed -i.bak -E -e \
	"s/\"version-string\": \".+\"/\"version-string\": \"${version}\"/" \
	vcpkg.json
	rm -f vcpkg.json.bak
	git add vcpkg.json

But that example just replaces a line in a file, whereas this will need to replace lines and add lines to {}versions.json{}.

In 01-prepare-test.rb you'll need to add lines to test_version_pre_tag and test_version_post_tag like this:

arrow/dev/release/01-prepare-test.rb

Lines 158 to 164 in 9938f70

	{
	path: "cpp/vcpkg.json",
	hunks: [
	["- \"version-string\": \"#{@snapshot_version}\",",
	"+ \"version-string\": \"#{@release_version}\","],
	],
	},

arrow/dev/release/01-prepare-test.rb

Lines 292 to 297 in 9938f70

	path: "cpp/vcpkg.json",
	hunks: [
	["- \"version-string\": \"#{@snapshot_version}\",",
	"+ \"version-string\": \"#{@next_snapshot_version}\","],
	],
	},

[asfimport]

Nicola Crane / @thisisnic:
Thanks @ianmcook , that's super helpful!

[asfimport]

Kouhei Sutou / @kou:
Issue resolved by pull request 12212
#12212