using System;
using System.Collections.Generic;
using System.Text;

namespace ScrewTurn.Wiki.PluginFramework {

	/// <summary>
	/// Implements useful tools for handling full object names.
	/// </summary>
	public static class NameTools {

		/// <summary>
		/// Gets the full name of a page from the namespace and local name.
		/// </summary>
		/// <param name="nspace">The namespace (<c>null</c> for the root).</param>
		/// <param name="name">The local name.</param>
		/// <returns>The full name.</returns>
		public static string GetFullName(string nspace, string name) {
			return (!string.IsNullOrEmpty(nspace) ? nspace + "." : "") + name;
		}

		/// <summary>
		/// Expands a full name into the namespace and local name.
		/// </summary>
		/// <param name="fullName">The full name to expand.</param>
		/// <param name="nspace">The namespace.</param>
		/// <param name="name">The local name.</param>
		public static void ExpandFullName(string fullName, out string nspace, out string name) {
			if(fullName == null) {
				nspace = null;
				name = null;
			}
			else {
				string[] fields = fullName.Split(new char[] { '.' }, StringSplitOptions.RemoveEmptyEntries);
				if(fields.Length == 0) {
					nspace = null;
					name = null;
				}
				else if(fields.Length == 1) {
					nspace = null;
					name = fields[0];
				}
				else {
					nspace = fields[0];
					name = fields[1];
				}
			}
		}

		/// <summary>
		/// Extracts the namespace from a full name.
		/// </summary>
		/// <param name="fullName">The full name.</param>
		/// <returns>The namespace, or <c>null</c>.</returns>
		public static string GetNamespace(string fullName) {
			string nspace, name;
			ExpandFullName(fullName, out nspace, out name);
			return nspace;
		}

		/// <summary>
		/// Extracts the local name from a full name.
		/// </summary>
		/// <param name="fullName">The full name.</param>
		/// <returns>The local name.</returns>
		public static string GetLocalName(string fullName) {
			string nspace, name;
			ExpandFullName(fullName, out nspace, out name);
			return name;
		}

	}

}