octokit.net/Octokit/Models/Request/NewRelease.cs

using System.Diagnostics;
using System.Globalization;

namespace Octokit
{
    /// <summary>
    /// Used to create a new release.
    /// </summary>
    /// <remarks>
    /// API: https://docs.github.com/rest/releases/releases#create-a-release
    /// </remarks>
    [DebuggerDisplay("{DebuggerDisplay,nq}")]
    public class NewRelease
    {
        /// <summary>
        /// Initializes a new instance of the <see cref="NewRelease"/> class.
        /// </summary>
        /// <param name="tagName">Name of the tag to create in the repository for this release.</param>
        public NewRelease(string tagName)
        {
            Ensure.ArgumentNotNullOrEmptyString(tagName, nameof(tagName));
            TagName = tagName;
        }

        /// <summary>
        /// Gets the name of the tag.
        /// </summary>
        /// <value>
        /// The name of the tag.
        /// </value>
        public string TagName { get; private set; }

        /// <summary>
        /// Specifies the commitish value that determines where the Git tag is created from. Can be any branch or
        /// commit SHA. Unused if the Git tag already exists. Default: the repository’s default branch
        /// (usually main).
        /// </summary>
        /// <value>
        /// The target commitish.
        /// </value>
        public string TargetCommitish { get; set; }

        /// <summary>
        /// Gets or sets the name of the release.
        /// </summary>
        /// <value>
        /// The name.
        /// </value>
        public string Name { get; set; }

        /// <summary>
        /// Gets or sets the text describing the contents of the tag.
        /// </summary>
        /// <value>
        /// The body.
        /// </value>
        public string Body { get; set; }

        /// <summary>
        /// Gets or sets a value indicating whether this <see cref="NewRelease"/> is a draft (unpublished).
        /// Default: false
        /// </summary>
        /// <value>
        ///   <c>true</c> if draft; otherwise, <c>false</c>.
        /// </value>
        public bool Draft { get; set; }

        /// <summary>
        /// Gets or sets a value indicating whether this <see cref="NewRelease"/> is prerelease.
        /// </summary>
        /// <value>
        ///   <c>true</c> if prerelease; otherwise, <c>false</c>.
        /// </value>
        public bool Prerelease { get; set; }

        /// <summary>
        /// If specified, a discussion of the specified category is created and linked to the release.
        /// The value must be a category that already exists in the repository.
        /// <value>
        /// The discussion category name.
        /// </value>
        /// </summary>
        public string DiscussionCategoryName { get; set; }

        /// <summary>
        /// Gets or sets a value indicating whether to automatically generate the name and body for this release.
        /// If <see cref="Name">name</see> is specified, the specified name will be used; otherwise, a name will
        /// be automatically generated. If <see cref="Body">body</see> is specified, the body will be pre-pended to the
        /// automatically generated notes.
        /// </summary>
        /// <value>
        ///   <c>true</c> to generate release notes; otherwise, <c>false</c>.
        /// </value>
        public bool GenerateReleaseNotes { get; set; }

        /// <summary>
        /// Specifies whether this release should be set as the latest release for the repository.
        /// Drafts and prereleases cannot be set as latest. Defaults to true for newly published releases.
        /// </summary>
        /// <value>
        ///   <c>True</c> set release as latest;
        ///   <c>Legacy</c> specifies that the latest release should be determined based on the release creation date and higher semantic version.
        /// </value>
        public MakeLatestQualifier? MakeLatest { get; set; }

        internal string DebuggerDisplay
        {
            get
            {
                return string.Format(CultureInfo.InvariantCulture, "Name: {0} TagName: {1}", Name, TagName);
            }
        }
    }
}