This GitHub Action connects GitHub and X-Developer service - Git Analytics Platform for Engineering Productivity.
This Action retrieves the Git log from CI workspace directly during the process in a workflow job. The user must specify X-Developer account ID-key and team id in GitHub secrets.
Enter X-Developer Site and register an account for free.
Get your APPID
APPKEY
from API page.
- For free users, you could only create public team, which will be listed in X-Developer Explore but only developers have permission to access internal reports, we recommend this to open source projects.
- Private team is only for paid users.
This GitHub Action is free for all the users.
Once you created a team, check your TEAMID
from API page.
Enter your repository setting -> secrets, create APPID
APPKEY
TEAMID
and specify the values.
You could create
APPID
andAPPKEY
in organizationsecrets
if you're working in an organization.
To analysis daily activities on non-master branches, please create a workflow
yaml file as below:
on: push: branches: [ dev, test ] # Non-master branches jobs: analysis: runs-on: ubuntu-latest steps: - uses: actions/checkout@v1 - name: X-Developer Analysis Action uses: FieldTech/x-developer-analysis-action@V1.2 with: APPID: ${{ secrets.APPID }} APPKEY: ${{ secrets.APPKEY }} TEAMID: ${{ secrets.TEAMID }}
To analysis publish or pull request activities on master
branch, please create a workflow
yaml file as below (specify Master parameter to True):
on: push: branches: [ master ] # master branch jobs: analysis: runs-on: ubuntu-latest steps: - uses: actions/checkout@v1 - name: X-Developer Analysis Action uses: FieldTech/x-developer-analysis-action@V1.2 with: APPID: ${{ secrets.APPID }} APPKEY: ${{ secrets.APPKEY }} TEAMID: ${{ secrets.TEAMID }} Master: True # specify master parameter to True
It has three steps as below: setup Python
environment, install xdclient
and run xdclient
command line.
name: X-Developer Analysis Action on: push: branches: [ master ] jobs: build: runs-on: ubuntu-latest steps: - uses: actions/checkout@v1 - name: Setup Python 2.7 uses: actions/setup-python@v1 with: python-version: 2.7.18 - name: Install X-Developer client run: pip install xdclient - name: Run X-Developer analysis env: APPID: ${{ secrets.APPID }} APPKEY: ${{ secrets.APPKEY }} TEAMID: ${{ secrets.TEAMID }} run: python -m xdclient -i $APPID -k $APPKEY -t $TEAMID -m True
Feel free to access these public projects.
Any question or request, please contact us via support@withfield.tech
All the scripts and documentation in this project under the MIT License.