Πώς να ανακτήσετε τη σωστή διαφορά για ένα αίτημα έλξης GitHub

Εισαγωγή στον εντοπισμό δεσμεύσεων

Πριν από μερικούς μήνες, έκανα ένα αίτημα έλξης στο αποθετήριο GitHub για το έργο που χρησιμοποιώ στο πρόγραμμά μου. Έχω δουλέψει με αυτό το PR και τώρα φαίνεται ότι ο ευκολότερος τρόπος για να προχωρήσεις είναι να το αναδημιουργήσεις καθαρά.

Για να το κάνω αυτό, πρέπει να βρω ένα commit από το οποίο ξεκίνησα για να τρέξω το git diff στο τοπικό repo. Υπάρχει εύκολος τρόπος να βρείτε ένα commit SHA μερικούς μήνες πριν από το γνωστό; Ή θα πρέπει να εκτελέσω το git log και απλώς να το επιθεωρήσω οπτικά μέχρι να δω το commit με το οποίο ξεκίνησα;

Λεπτομερής επεξήγηση της χρήσης σεναρίου

Το πρώτο σενάριο είναι ένα σενάριο Bash που έχει σχεδιαστεί για να βρίσκει το SHA μιας δέσμευσης πριν από δύο μήνες και να δημιουργεί μια διαφορά για ένα αίτημα έλξης. Χρησιμοποιεί την εντολή git rev-list για να απαριθμήσει τα αντικείμενα δέσμευσης με αντίστροφη χρονολογική σειρά και, στη συνέχεια, βρίσκει την πρώτη δέσμευση πριν από την καθορισμένη ημερομηνία. ο date Η εντολή χρησιμοποιείται για τον υπολογισμό της ημερομηνίας πριν από δύο μήνες και git rev-parse χρησιμοποιείται για τη λήψη του SHA της πιο πρόσφατης δέσμευσης στον κλάδο. Τελικά, git diff δημιουργεί τη διαφορά μεταξύ αυτών των δύο δεσμεύσεων.

Το δεύτερο σενάριο είναι ένα σενάριο Python που αλληλεπιδρά με το GitHub API για την ανάκτηση δεσμεύσεων από ένα αποθετήριο. Χρησιμοποιεί το requests.get λειτουργία για να πραγματοποιήσετε μια κλήση API στο GitHub, ανακτώντας δεσμεύσεις από την ημερομηνία που υπολογίστηκε πριν από δύο μήνες χρησιμοποιώντας datetime.timedelta. Τα ανακτηθέντα δεδομένα JSON αναλύονται για την εύρεση των παλαιότερων και πιο πρόσφατων δεσμεύσεων και εκτυπώνονται τα SHA τους. Αυτό το σενάριο αξιοποιεί το datetime.isoformat μέθοδο για τη σωστή μορφοποίηση της ημερομηνίας για το αίτημα API.

#!/bin/bash
# Find the commit SHA from two months ago
# and get the diff for a pull request
COMMIT_DATE=$(date -d "2 months ago" '+%Y-%m-%d')
START_COMMIT=$(git rev-list -n 1 --before="$COMMIT_DATE" main)
# Replace 'main' with the appropriate branch if necessary
END_COMMIT=$(git rev-parse HEAD)
echo "Start commit: $START_COMMIT"
echo "End commit: $END_COMMIT"
git diff $START_COMMIT $END_COMMIT > pr_diff.patch

import requests
import datetime
# Set up your GitHub token and repo details
GITHUB_TOKEN = 'your_github_token'
REPO_OWNER = 'repo_owner'
REPO_NAME = 'repo_name'
# Calculate the date two months ago
two_months_ago = datetime.datetime.now() - datetime.timedelta(days=60)
headers = {'Authorization': f'token {GITHUB_TOKEN}'}
url = f'https://api.github.com/repos/{REPO_OWNER}/{REPO_NAME}/commits?since={two_months_ago.isoformat()}'
response = requests.get(url, headers=headers)
commits = response.json()
if commits:
    start_commit = commits[-1]['sha']
    end_commit = commits[0]['sha']
    print(f"Start commit: {start_commit}")
    print(f"End commit: {end_commit}")

# Open your terminal and navigate to the local repository
cd /path/to/your/repo
# Run git log and search for the commit SHA
git log --since="2 months ago" --pretty=format:"%h %ad %s" --date=short
# Note the commit SHA that you need
START_COMMIT=<your_start_commit_sha>
END_COMMIT=$(git rev-parse HEAD)
# Get the diff for the pull request
git diff $START_COMMIT $END_COMMIT > pr_diff.patch

Επανεξέταση των ιστορικών δεσμεύσεων για ακριβείς διαφορές

Μια άλλη ουσιαστική πτυχή της διαχείρισης των αιτημάτων έλξης και των ιστορικών δέσμευσης είναι η κατανόηση του τρόπου χρήσης της ισχυρής δυνατότητας reflog του Git. Το reflog καταγράφει ενημερώσεις στην άκρη των υποκαταστημάτων και άλλες αναφορές, επιτρέποντάς σας να προβάλετε τις ιστορικές κινήσεις των υποκαταστημάτων και να εντοπίσετε θέσεις προηγούμενων δεσμεύσεων, ακόμη και αν δεν είναι πλέον προσβάσιμες μέσω του ιστορικού υποκαταστημάτων. Αυτό μπορεί να είναι ιδιαίτερα χρήσιμο εάν πρέπει να βρείτε ένα commit SHA πριν από αρκετούς μήνες, αλλά δεν έχετε συγκεκριμένη ημερομηνία.

Τρέχοντας το git reflog εντολή, μπορείτε να δείτε ένα αρχείο καταγραφής αλλαγών στην κεφαλή του κλάδου, συμπεριλαμβανομένων επαναφορών, επανατοποθετήσεων και συγχωνεύσεων. Αυτό το αρχείο καταγραφής μπορεί να βοηθήσει στην αναγνώριση του SHA της δέσμευσης από την οποία ξεκινήσατε. Χρησιμοποιώντας αυτήν τη μέθοδο, μπορείτε να πλοηγηθείτε στις εγγραφές reflog για να εντοπίσετε την ακριβή δέσμευση, η οποία μπορεί στη συνέχεια να χρησιμοποιηθεί για να δημιουργήσει μια ακριβή διαφορά για το αίτημα έλξης σας.

Τελικές σκέψεις σχετικά με τη δημιουργία διαφορών για αιτήματα έλξης

Η εκ νέου δημιουργία ενός αιτήματος καθαρής έλξης περιλαμβάνει τον εντοπισμό του σωστού commit SHA από το παρελθόν. Χρησιμοποιώντας μεθόδους όπως git rev-list και git log, ή η αξιοποίηση σεναρίων που αλληλεπιδρούν με το GitHub API, μπορεί να βελτιστοποιήσει αυτή τη διαδικασία. Με την αυτοματοποίηση της ανάκτησης commit SHA και τη δημιουργία διαφορών, μπορείτε να εξοικονομήσετε χρόνο και να διασφαλίσετε την ακρίβεια. Αυτές οι τεχνικές είναι ανεκτίμητες για τη διατήρηση μιας καθαρής και οργανωμένης βάσης κωδικών, διευκολύνοντας την ομαλότερη συνεργασία και τη διαχείριση έργου.