1# Script for adding git tags for each release
2
3It is useful to tag commits for each androidx release for the following
4reasons:
5
6* This places the release history into the commit history.
7* Developers can find which commits were included within each artifact
8version.
9* Tags are easy references for diff-ing two versions of an artifact.
10
11This script takes in a file that lists the commits, artifacts, and versions
12of that release.  A new release file must be added along with every release.
13These files have the following filename format:
14AndroidX-Release-YYYY-MM-DD.txt, where YYYY-MM-DD is the release date.
15
16And have the following scructure:
17<Release Date in YYYY-MM-DD format>
18<SHA>:<artifactId>:<version>
19<SHA>:<artifactId>:<version>
20.
21.
22.
23<SHA>:<artifactId>:<version>
24
25The script then uses this file to generate two tags for each SHA in the file.
26This first tag is maps the commit to the release date and artifactId:
27<YYYY-MM-DD>-release-<artifactId>
28The second tag maps the commit to the artifact version.  This is the last
29commit included with that version (inclusive cuttoff):
30<artifactId>-<version>
31