Issue 377: New build for releasing a new version

Tools/Google.Apis.Release/Wiki/DownloadsPageUpdater.cs

-using System;
-using System.Collections.Generic;
+/*
+Copyright 2013 Google Inc
+
+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.
+*/
+
+using System;
 using System.IO;
-using System.Linq;
-using System.Text;
-using System.Text.RegularExpressions;
-using System.Threading.Tasks;
 
 namespace Google.Apis.Release.Wiki
 {
- /// <summary>Updates the Downloads wiki page. </summary>
+ /// <summary>
+ /// Updates the Downloads wiki page (https://code.google.com/p/google-api-do
 tnet-client/wiki/Downloads).·
+ /// </summary>
 public static class DownloadsPageUpdater
 {
 private const string StableStartTag = "<wiki:comment>GENERATED_STABLE_BE
GIN</wiki:comment>";
 private const string StableEndTag = "<wiki:comment>GENERATED_STABLE_END<
/wiki:comment>";
 
 /// <summary>Updates the Wiki.</summary>
 public static void UpdateWiki(string workingDirectory, string notes, str
ing oldVersion, string newVersion)
 {
- if (notes != null)
- {
- var file = Path.Combine(workingDirectory, "Downloads.wiki");
- string content = File.ReadAllText(file);
+ if (string.IsNullOrEmpty(workingDirectory)) throw new ArgumentNullEx
 ception("workingDirectory");
+ if (string.IsNullOrEmpty(notes)) throw new ArgumentNullException("no
 tes");
+ if (string.IsNullOrEmpty(oldVersion)) throw new ArgumentNullExceptio
 n("oldVersion");
+ if (string.IsNullOrEmpty(newVersion)) throw new ArgumentNullExceptio
 n("newVersion");
 
-// update notes
-var generatedNotes = "{{{" Environment.NewLine notes Envir
onment.NewLine "}}}";
-content = ReplaceInText(content, StableStartTag, StableEndTag, g
eneratedNotes);
 
- // update links
- content = content.Replace(oldVersion, newVersion);
- File.WriteAllText(file, content);
- }
+ var filePath = Path.Combine(workingDirectory, "Downloads.wiki");
+ string content = File.ReadAllText(filePath);
+
+ // update notes. Replace all text from StableStartTag to StableEndTa
 g
+ var generatedNotes = "{{{" Environment.NewLine notes Environme
 nt.NewLine "}}}";
+ content = ReplacePart(content, StableStartTag, StableEndTag, oldText
  => generatedNotes);
+
+ // update links
+ content = content.Replace(oldVersion, newVersion);
+ File.WriteAllText(filePath, content);
 }
 
- private static string ReplaceInText(string source, string startTag, stri
 ng endTag, string newText)
- {
- return ReplaceInText(source, startTag, endTag, old => newText);
- }
-
- private static string ReplaceInText(string source, string startTag, stri
 ng endTag,
+ /// <summary>
+ /// Returns a new string with the content of the source and a new text b
 ased on <c>replaceFunc</c>between·
+ /// <c>startPartTag</c> to <c>endPartTag</c>.
+ /// </summary>
+ /// <param name="source">The source content</param>
+ /// <param name="startPartTag">The start part tag</param>
+ /// <param name="endPartTag">The end part tag</param>
+ /// <param name="replaceFunc">The replacement function from the old text
  to new text</param>
+ private static string ReplacePart(string source, string startPartTag, st
 ring endPartTag,
 Func<string, string> replaceFunc)
 {
- int start = source.IndexOf(startTag);
- if (start < 0)
+ // find the start tag
+ int startIndex = source.IndexOf(startPartTag);
+ if (startIndex < 0)
 {
- throw new ArgumentException("Start Tag not found: " startTag);
+ throw new ArgumentException("Start Tag not found: " startPartT
 ag);
 }
- start = startTag.Length;
+ startIndex = startPartTag.Length;
 
- // Find the end tag.
- int end = source.IndexOf(endTag, start);
- if (end < 0)
+ // find the end tag
+ int endIndex = source.IndexOf(endPartTag, startIndex);
+ if (endIndex < 0)
 {
- throw new ArgumentException("End Tag not found: " endTag);
+ throw new ArgumentException("End Tag not found: " endPartTag);
 }
 
- var oldText = source.Substring(start, end - start).Trim('\r', '\n');
+ var oldText = source.Substring(startIndex, endIndex - startIndex).Tr
 im('\r', '\n');
 var newText = replaceFunc(oldText);
- // Replace the text
- return source.Substring(0, start) Environment.NewLine 
- newText Environment.NewLine source.Substring(end);
+
+ // replace the text
+ return source.Substring(0, startIndex) Environment.NewLine 
+ newText Environment.NewLine source.Substring(endIndex);
 }
 }
 }