added readme
This commit is contained in:
parent
75c2f209c4
commit
ca7716a353
99
README.md
Normal file
99
README.md
Normal file
@ -0,0 +1,99 @@
|
|||||||
|
# DrillSergeant
|
||||||
|
|
||||||
|
Get a tally of contributors' commits.
|
||||||
|
|
||||||
|
Written by Wyatt J. Miller, copyright 2022
|
||||||
|
|
||||||
|
Licensed by the Mozilla Public License v2.0 (see [LICENSE](./LICENSE.md))
|
||||||
|
|
||||||
|
###### Table of Contents
|
||||||
|
|
||||||
|
- [Overview](#overview)
|
||||||
|
- [Installation](#installation)
|
||||||
|
- [Release](#release)
|
||||||
|
- [Source](#source)
|
||||||
|
- [Prerequisites](#prerequisites)
|
||||||
|
- [Prepare](#prepare)
|
||||||
|
- [Build](#build)
|
||||||
|
- [Known Issues](#known-issues)
|
||||||
|
- [Next Steps/Contributing](#next-steps)
|
||||||
|
- [Troubleshooting](#troubleshooting)
|
||||||
|
- [Attribution](#attribution)
|
||||||
|
|
||||||
|
## Overview
|
||||||
|
|
||||||
|
When I was in university, I wanted a program that would tally up my git commits in a certain project that I'm working on. Based on search engine ninja skills, I couldn't find a program that did this. I decided to scratch my own itch.
|
||||||
|
|
||||||
|
I present DrillSergeant, where you can get a tally of the contributors' commits in a certain project. Additionally, you can filter by branch to get commits by branch.
|
||||||
|
|
||||||
|
## Usage
|
||||||
|
|
||||||
|
Please see the wiki for information.
|
||||||
|
|
||||||
|
## Installation
|
||||||
|
|
||||||
|
There's are two forms of installation: releases and building from sources. This readme goes through both.
|
||||||
|
|
||||||
|
### Releases
|
||||||
|
|
||||||
|
You may get releases from the [releases page](https://scm.wyattjmiller.com/wymiller/DrillSergeant/releases). This is the recommended way to start using DrillSergeant.
|
||||||
|
|
||||||
|
There will be three separate downloads: Windows (x86 64-bit), Linux (x86 64-bit), and Linux (ARM 64-bit), dubbed win64, linux64, and linuxaarch64 respectively.
|
||||||
|
|
||||||
|
Once downloaded and extracted, you can move it to your `$PATH`.
|
||||||
|
|
||||||
|
If you do not have any of these platforms, read on to source installation as that's the next best option.
|
||||||
|
|
||||||
|
### Source
|
||||||
|
|
||||||
|
#### Prerequisites
|
||||||
|
|
||||||
|
You need the following to be able to build DrillSergeant:
|
||||||
|
|
||||||
|
- .NET 6 (available for Windows, macOS, and modern Linux distributions)
|
||||||
|
- git
|
||||||
|
|
||||||
|
#### Prepare
|
||||||
|
|
||||||
|
First, clone the repository with git:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
git clone https://scm.wyattjmiller.com/wymiller/DrillSergeant
|
||||||
|
```
|
||||||
|
|
||||||
|
Then, change directories to where you've cloned DrillSergeant:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
cd path/to/DrillSergeant
|
||||||
|
```
|
||||||
|
|
||||||
|
#### Build
|
||||||
|
|
||||||
|
Then, to build a full release of DrillSergeant (you can change the runtime to whatever fits your platform. You can learn more about this [here](https://docs.microsoft.com/en-us/dotnet/core/rid-catalog)):
|
||||||
|
|
||||||
|
```bash
|
||||||
|
dotnet publish DrillSergeant.csproj --configuration Release --framework net6.0 --output publish --self-contained True --runtime linux-x64 --verbosity Normal /property:PublishTrimmed=True /property:PublishSingleFile=True /property:IncludeNativeLibrariesForSelfExtract=True /property:DebugType=None /property:DebugSymbols=False
|
||||||
|
```
|
||||||
|
|
||||||
|
Then, you can find the binary in the `publish/` directory. You can move this executable to somewhere in the `$PATH` or you make a new enviroment variable to be integrated into your `$PATH`.
|
||||||
|
|
||||||
|
## Known Issues
|
||||||
|
|
||||||
|
- A user must be in the root of a git project in order for this program to run.
|
||||||
|
|
||||||
|
## Next Steps/Contributing
|
||||||
|
|
||||||
|
- See the [contributing](./CONTRIBUTING.md) file!
|
||||||
|
|
||||||
|
## Troubleshooting
|
||||||
|
|
||||||
|
Please file a issue on the issue page and I will get back with you as soon as possible.
|
||||||
|
|
||||||
|
## Attribution
|
||||||
|
|
||||||
|
Thank you to the developers, engineers, project managers, and contributors of the following projects - you make this program possible!
|
||||||
|
|
||||||
|
- [LibGit2Sharp](https://github.com/libgit2/libgit2sharp/)
|
||||||
|
- [OpenXML](https://docs.microsoft.com/en-us/office/open-xml/open-xml-sdk)
|
||||||
|
- [System.CommandLine](https://github.com/dotnet/command-line-api)
|
||||||
|
- [Pastel](https://github.com/silkfire/Pastel)
|
Loading…
Reference in New Issue
Block a user