Package: gigawork
gigaworkAn automated tool for extracting GitHub Actions' workflows from Git repositories written in Python.gigawork(Give meGitHubActionsWorkflows) is primarily designed to be used as a command-line tool.
Given a Git repository, it extracts the different workflows and their versions from the Git history.
The extraction is done by traversing the Git history of the repository and going back in time respecting the first-parent rule until the first commit (or the given reference) is reached.
The workflows are saved in a given directory along with relevant metadata (seeUsage) in a given CSV file.InstallationThe easiest way to installgigaworkis to install from Pypipip install gigaworkAnother easy way to installgigaworkis viapipfrom this GitHub repositorypip install git+https://github.com/cardoeng/gigaworkAlternatively, you can clone this repository and install it locallygit clone https://github.com/cardoeng/gigawork
cd gigawork
pip install .You may wish to use this tool in a virtual environment. You can use the following commands.virtualenv gigawork_venv
source gigawork_venv/bin/activate
pip install gigaworkUsageAfter installation, thegigaworkcommand-line tool should be available in your shell. Otherwise, please replacegigaworkbypython -m gigawork. The explanations in the following stays valid in both cases.You can usegigaworkwith the following arguments:Usage: gigawork [OPTIONS] REPOSITORY

  Extract the GitHub Actions workflow files from a single Git repository
  `REPOSITORY`. The extraction is done by traversing the Git history of the
  repository starting from the reference given to `-r` and going back in time
  respecting the first-parent rule until the first commit (or the reference
  given to `-a`) is reached. The Git repository can be local or distant. In
  the latter case, it will be pulled locally and deleted unless specified
  otherwise. Every extracted workflow file will be stored in the directory
  given to `-w` (or the directory `workflows` if not specified). The metadata
  related to the extracted workflows will be written in the CSV file given to
  `-o`, or in the standard output if not specified. The metadata related to
  the renaming of workflows will be stored in the CSV file given to `-ro`, or
  not stored if not specified.

  Example of usage: gigawork myRepository -n myRepositoryName -s directory -o
  output.csv --no-headers

Options:
  -r, --ref, --branch REF         The most recent commit reference (i.e.,
                                  commit SHA or TAG) to be considered for the
                                  extraction.
  -s, --save-repository DIRECTORY
                                  Save the repository to the given directory
                                  in case `REPOSITORY` was distant.
  -u, --update                    Fetch the repository at the given path.
  -a, --after REF                 Only consider commits after the given commit
                                  reference (i.e., commit SHA or TAG).
  -w, --workflows DIRECTORY       The directory where the extracted GitHub
                                  Actions workflow files will be stored.
  -o, --output FILE               The output CSV file where information
                                  related to the dataset will be stored. By
                                  default, the information will written to the
                                  standard output.
  -ao, --auxiliary-output FILE    The output CSV file where information
                                  related to the auxiliary files will be
                                  stored. By default, the information will not
                                  be stored.
  -n, --repository-name TEXT      Add a column `repository` to the output file
                                  where each value will be equal to the
                                  provided parameter.
  --no-headers                    Remove the header row from the CSV output
                                  file.
  -h, --help                      Show this message and exit.The CSV file given to-o(or that will be written to the standard output by default) will contain the following columns:repository: the name of the repository if-nwas specifiedcommit_hash: the commit SHA of the commit where the workflow file was extractedauthor_name: the name of the author of the commitauthor_email: the email of the author of the commitcommitter_name: the name of the committer of the commitcommitter_email: the email of the committer of the commitcommitted_date: the committed date of the commitauthored_date: the authored date of the commitfile_path: the path of the workflow file in the repositoryprevious_file_path: The path to this file before it has been touchedfile_hash: the SHA of the workflow file (and so, its name in the output directory)previous_file_hash: The name of the related workflow file in the dataset, before it has been touchedchange_type: the type of change (A for added, M for modified, D for deleted). Note that a renamed file will be seen as a modification.ExamplesAs an example, the following command extracts every workflow files from the repositoryexample_repository, add the namemy-example-namein the output. It also saves various information (such as commit SHA, author name, ...) inoutput.csv(with the headers as--no-headersis not specified). Each workflow file will be saved in the directoryworkflows(which is also the default save directory).gigaworkexample_repository-nmy-example-name-ooutput.csv-wworkflowsNote that the repository does not have to be already cloned. The tool can fetch it for you and clean up (unless told otherwise) when the work is done. An example is shown below. The GitHub repositoryhttps://github.com/cardoeng/gigaworkwill be fetched, saved under thegigaworkdirectory and therepositorycolumn will begigawork_namein the resulting CSV file. Note that, if-s gigaworkwas not specified, the tool will create a temporary directory and clean up when it finishes.gigaworkhttps://github.com/cardoeng/gigawork-ngigawork_name-sgigawork-ooutput.csvLicenseDistributed underGNU Lesser General Public License v3.