Increase build number

Table of Contents

• Overview
• Features
• Getting Started
  • Prerequisites
  • Installation
    • Clone the repo
• Usage
  • Notes
• Contributing
• Bug / Issue Reporting
• License
• Contact
• Acknowledgments

Overview

Increase build number in Visual studio project file.

Features

• Automatic Build Number Increment: Automatically increments the build number in the <VersionPrefix> element of your .csproj file.
• Version Validation: Ensures the version follows the Major.Minor.Build format (e.g., 0.1.0) before incrementing.
• Default Path Handling: Automatically determines the project file path if not explicitly provided.
• Error Handling: Provides detailed error messages for missing or invalid project files and version formats.
• Git Integration: Automatically stages and commits the updated project file with a descriptive commit message.
• Customizable Parameters: Allows specifying the project file path and organization name as parameters.

Getting Started

Prerequisites

• Dotnet 9.0 or later

Installation

Clone the repo

git clone https://github.com/TirsvadCLI/PS.IncreaseBuildNumberVSProject.git

Usage

To use this tool to increase the build number in your Visual Studio project file, follow these steps:

1. Ensure the Project File is Configured
   Make sure your .csproj file contains the following line in the <PropertyGroup> section:

   <PropertyGroup>
     <VersionPrefix>0.1.0</VersionPrefix>
   </PropertyGroup>

2. Run the Tool
   Execute the tool to automatically increment the build number. Use the following command:

   dotnet run --project <PathToYourProjectFile>
   

   Replace <PathToYourProjectFile> with the path to your .csproj file.

3. Verify the Changes
   Open your .csproj file and confirm that the build number has been incremented in the VersionPrefix or Version property.

Notes

• Ensure you have .NET 9.0 or later installed.
• The tool modifies the project file directly, so it's recommended to commit your changes before running the tool to avoid accidental data loss.

Contributing

Contributions are what make the open-source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'Add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

Bug / Issue Reporting

If you encounter a bug or have an issue to report, please follow these steps:

1. Go to the Issues Page
   Navigate to the GitHub Issues page.

2. Click "New Issue"
   Click the green "New Issue" button to create a new issue.

3. Provide Details

• Title: Write a concise and descriptive title for the issue.
• Description: Include the following details:
  • Steps to reproduce the issue.
  • Expected behavior.
  • Actual behavior.
  • Environment details (e.g., OS, .NET version, etc.).
• Attachments: Add screenshots, logs, or any other relevant files if applicable.

4. Submit the Issue
   Once all details are filled in, click "Submit new issue" to report it.

License

Distributed under the GPL-3.0 License.

Contact

Jens Tirsvad Nielsen - LinkedIn

Acknowledgments