Garrard.GitLab 0.0.7

Garrard.GitLab

Garrard.GitLab is a .NET library that provides operations for working with GitLab projects.

Installation

To install Garrard.GitLab, you can use the NuGet package manager. Run the following command in the Package Manager Console:

Install-Package Garrard.GitLab -Version 0.0.7

Or add the following package reference to your project file:

<PackageReference Include="Garrard.GitLab" Version="0.0.7" />

Or user the dotnet add command:

dotnet add package Garrard.GitLab --version 0.0.7

Usage

Here is an example of how to use Garrard.GitLab in your project:

using Garrard.GitLab;

class Program
{
    static async Task Main(string[] args)
    {
        // Example usage of GitLab.GitOperations, GitLab.FileOperations

        var projectCreation = await GitOperations.CreateGitLabProject("new-project-name", "your-gitlab-pat", "gitlab-domain", projectName =>
            {
                Console.Writeline($" - {projectName} exists, establishing an available project name...");
            });
        
        if (projectCreation.IsFailure)
        {
            Console.Writeline($"{projectCreation.Error}. Exiting...");
            return;
        }
        
        // will use the new name (will have changed if couldn't use the original name)
        newProjectName = projectCreation.Value;
        
        GitOperations.DownloadGitRepository("https://github.com/yourusername/your-repo.git", "/path/to/download/to");
        GitOperations.CloneGitLabProject("https://gitlab.com/yourusername/your-project.git", "/path/to/clone");
        FileOperations.CopyFiles("/path/to/download/to", "/path/to/clone");
        GitOperations.BranchCommitPushChanges("/path/to/clone", "commit message", "branchname");
        FileOperations.RemoveTempFolder("/path/to/download/to"); 
    }
}

Features

• Create a new GitLab project (will create a unique project if your suggeted name exists)
• Download a existing git repository
• Clone GitLab project
• Copy files from cloned repo (or Project) to your new GitLab project folder (excluding the .git/ folder)
• Commit and pushes changes
• Remove temporary folder

Contributing

Contributions are welcome! Please open an issue or submit a pull request on GitHub.

License

This project is licensed under the MIT License. See the LICENSE file for more details.