IterationCapacity is a Go program that retrieves data from Azure DevOps to provide insights into a project team's velocity over time. It creates a 'data.sqlite' file (database) to store all the data it retrieves from Azure DevOps regarding a project's team capacity and attempts to create an insight into a team's velocity over time.
To run IterationCapacity, you will need:
- Go (version 1.16 or later)
- The following Go packages:
- "github.com/microsoft/azure-devops-go-api/azuredevops"
- "github.com/microsoft/azure-devops-go-api/azuredevops/work"
- "github.com/mattn/go-sqlite3"
To install IterationCapacity, follow these steps:
- Clone this repository to your local machine.
- Install the required dependencies by running the following command:
go get -u github.com/microsoft/azure-devops-go-api/azuredevops github.com/microsoft/azure-devops-go-api/azuredevops/work github.com/mattn/go-sqlite3
- In the root directory of the repository, run the following command to build the program:
go build
Before running IterationCapacity, you will need to create an arguments.json
file in the root directory of the repository. This file should contain the following information:
{
"orgURL": "https://dev.azure.com/<YourOrg>",
"token": "<PersonalAccessToken>",
"project": "<YourProject>",
"team": "<YourTeam>",
"sprintStart": 67,
"daysInSprint": 14.0
}
Replace <PersonalAccessToken>
, <YourOrg>
, <YourProject>
, <YourTeam>
, 67
, 14.0
(number of days in a sprint) with the relevant information for your project.
Once you have created the arguments.json
file, you can run IterationCapacity by executing the following command in the root directory of the repository:
./IterationCapacity
This will create a 'data.sqlite' file (database) in the root directory of the repository that contains all the data retrieved from Azure DevOps.
If you encounter any issues when running IterationCapacity, please check the following:
- Ensure that you have installed all the necessary dependencies.
- Check that the
arguments.json
file contains the correct information for your project. - If you are still experiencing issues, please consult the Go documentation or seek help from the Go community.
- This program only works with Azure DevOps as a data source.
- The program is currently hardcoded to use 'data.sqlite' as the database filename.