Git - ฉันจะดูประวัติการเปลี่ยนแปลงของวิธีการ / ฟังก์ชันได้อย่างไร

ดังนั้นฉันจึงพบคำถามเกี่ยวกับวิธีดูประวัติการเปลี่ยนแปลงของไฟล์ แต่ประวัติการเปลี่ยนแปลงของไฟล์นี้มีขนาดใหญ่มากและฉันสนใจเฉพาะการเปลี่ยนแปลงของวิธีใดวิธีหนึ่งเท่านั้น ดังนั้นจะเป็นไปได้ไหมที่จะดูประวัติการเปลี่ยนแปลงของวิธีการนั้น ๆ

ฉันรู้ว่าสิ่งนี้จะต้องใช้คอมไพล์ในการวิเคราะห์โค้ดและการวิเคราะห์จะแตกต่างกันสำหรับภาษาต่างๆ แต่การประกาศวิธีการ / ฟังก์ชันดูคล้ายกันมากในภาษาส่วนใหญ่ดังนั้นฉันจึงคิดว่าอาจมีคนใช้ฟีเจอร์นี้

ภาษาที่ฉันกำลังใช้งานอยู่คือ Objective-C และ SCM ที่ฉันกำลังใช้อยู่คือ git แต่ฉันสนใจที่จะทราบว่าคุณลักษณะนี้มีอยู่สำหรับ SCM / ภาษาใด ๆ หรือไม่

เวอร์ชันล่าสุดของการgit logเรียนรู้รูปแบบพิเศษของ-Lพารามิเตอร์:

-L: <funcname>: <ไฟล์>

ติดตามวิวัฒนาการของช่วงบรรทัดที่กำหนดโดย"<start>,<end>"(หรือชื่อฟังก์ชัน regex <funcname>) ภายในไฟล์<file>. คุณไม่สามารถให้ตัว จำกัด pathspec ใด ๆ ขณะนี้ จำกัด เฉพาะการเดินโดยเริ่มจากการแก้ไขครั้งเดียวกล่าวคือคุณสามารถให้อาร์กิวเมนต์การแก้ไขเชิงบวกเป็นศูนย์หรือเชิงบวกได้เพียงครั้งเดียว คุณสามารถระบุตัวเลือกนี้ได้มากกว่าหนึ่งครั้ง
...
ถ้า“:<funcname>”กำหนดให้แทน<start>และ<end>เป็นนิพจน์ทั่วไปที่แสดงช่วงจากบรรทัด funcname แรกที่ตรงกัน<funcname>จนถึงบรรทัด funcname ถัดไป “:<funcname>”ค้นหาจากจุดสิ้นสุดของ-Lช่วงก่อนหน้าหากมีหรือจากจุดเริ่มต้นของไฟล์ “^:<funcname>”ค้นหาจากจุดเริ่มต้นของไฟล์

กล่าวอีกนัยหนึ่ง: ถ้าคุณขอ Git ไปgit log -L :myfunction:path/to/myfile.cตอนนี้จะพิมพ์ประวัติการเปลี่ยนแปลงของฟังก์ชันนั้นอย่างมีความสุข

ใช้git gui blameเป็นเรื่องยากที่จะทำให้การใช้ในสคริปต์และในขณะที่git log -Gและgit log --pickaxeแต่ละคนสามารถแสดงให้คุณเห็นเมื่อนิยามวิธีการปรากฏตัวขึ้นหรือหายไปฉันไม่ได้พบวิธีที่จะทำให้พวกเขาแสดงรายการการเปลี่ยนแปลงทั้งหมดที่เกิดขึ้นกับร่างกายของวิธีการของคุณ

อย่างไรก็ตามคุณสามารถใช้gitattributesและtextconvคุณสมบัติเพื่อรวมโซลูชันที่ทำเช่นนั้นได้ แม้ว่าคุณสมบัติเหล่านี้มีไว้เพื่อช่วยให้คุณทำงานกับไฟล์ไบนารีได้ แต่ก็ทำงานได้ดีเช่นกัน

กุญแจสำคัญคือให้ Git ลบออกจากไฟล์ทุกบรรทัดยกเว้นรายการที่คุณสนใจก่อนที่จะดำเนินการต่าง ๆ จากนั้นgit log, git diffฯลฯ จะเห็นเฉพาะพื้นที่ที่คุณกำลังสนใจใน

นี่คือโครงร่างของสิ่งที่ฉันทำในภาษาอื่น คุณสามารถปรับแต่งได้ตามความต้องการของคุณเอง

• เขียนเชลล์สคริปต์สั้น ๆ (หรือโปรแกรมอื่น ๆ ) ที่ใช้อาร์กิวเมนต์เดียว - ชื่อของไฟล์ต้นฉบับ - และแสดงผลเฉพาะส่วนที่น่าสนใจของไฟล์นั้น (หรือไม่มีอะไรเลยหากไม่มีสิ่งใดที่น่าสนใจ) ตัวอย่างเช่นคุณอาจใช้สิ่งsedต่อไปนี้:

  #!/bin/sh
  sed -n -e '/^int my_func(/,/^}/ p' "$1"
  

• กำหนดtextconvตัวกรองGit สำหรับสคริปต์ใหม่ของคุณ (ดูgitattributesรายละเอียดเพิ่มเติมในหน้า man) ชื่อของตัวกรองและตำแหน่งของคำสั่งสามารถเป็นอะไรก็ได้ที่คุณต้องการ

  $ git config diff.my_filter.textconv /path/to/my_script
  

• บอกให้ Git ใช้ตัวกรองนั้นก่อนคำนวณความแตกต่างของไฟล์ที่เป็นปัญหา

  $ echo "my_file diff=my_filter" >> .gitattributes
  

• ตอนนี้ถ้าคุณใช้-G.(สังเกต.) เพื่อแสดงรายการคอมมิตทั้งหมดที่สร้างการเปลี่ยนแปลงที่มองเห็นได้เมื่อใช้ตัวกรองของคุณคุณจะมีคอมมิตที่คุณสนใจทุกประการตัวเลือกอื่น ๆ ที่ใช้กิจวัตรต่างของ Git เช่น--patchจะ ยังได้รับมุมมองที่ จำกัด นี้

  $ git log -G. --patch my_file
  

• โวล่า!

การปรับปรุงที่มีประโยชน์อย่างหนึ่งที่คุณอาจต้องการทำคือให้สคริปต์ตัวกรองของคุณใช้ชื่อเมธอดเป็นอาร์กิวเมนต์แรก (และไฟล์เป็นที่สอง) วิธีนี้ช่วยให้คุณสามารถระบุวิธีการใหม่ที่น่าสนใจเพียงแค่โทรgit configแทนที่จะต้องแก้ไขสคริปต์ของคุณ ตัวอย่างเช่นคุณอาจพูดว่า:

$ git config diff.my_filter.textconv "/path/to/my_command other_func"

แน่นอนว่าสคริปต์ตัวกรองสามารถทำอะไรก็ได้ที่คุณต้องการรับข้อโต้แย้งมากขึ้นหรืออะไรก็ได้: มีความยืดหยุ่นมากกว่าที่ฉันแสดงไว้ที่นี่

git logมีตัวเลือก '-G' ที่สามารถใช้เพื่อค้นหาความแตกต่างทั้งหมด

-G <regex>ดูความแตกต่างที่มีการเพิ่มหรือเส้นที่ถูกนำออกตรงกับที่กำหนด

เพียงแค่ระบุ regex ที่เหมาะสมของชื่อฟังก์ชันที่คุณสนใจ ตัวอย่างเช่น,

$ git log --oneline -G'^int commit_tree'
40d52ff make commit_tree a library function
81b50f3 Move 'builtin-*' into a 'builtin/' subdirectory
7b9c0a6 git-commit-tree: make it usable from other builtins

สิ่งที่ใกล้เคียงที่สุดที่คุณสามารถทำได้คือกำหนดตำแหน่งของฟังก์ชันของคุณในไฟล์ (เช่นบอกว่าฟังก์ชันของคุณi_am_buggyอยู่ที่บรรทัด 241-263 ของfoo/bar.c) จากนั้นเรียกใช้บางสิ่งเพื่อให้ได้ผล:

git log -p -L 200,300:foo/bar.c

สิ่งนี้จะเปิดน้อยลง (หรือเพจเจอร์ที่เทียบเท่า) ตอนนี้คุณสามารถพิมพ์/i_am_buggy(หรือเทียบเท่าเพจเจอร์ของคุณ) และเริ่มก้าวผ่านการเปลี่ยนแปลง

สิ่งนี้อาจได้ผลขึ้นอยู่กับรูปแบบรหัสของคุณ:

git log -p -L /int i_am_buggy\(/,+30:foo/bar.c

ซึ่งจะ จำกัด การค้นหาจาก Hit แรกของ regex นั้น (ตามหลักการแล้วการประกาศฟังก์ชันของคุณ) ถึงสามสิบบรรทัดหลังจากนั้น อาร์กิวเมนต์สิ้นสุดสามารถเป็น regexp ได้เช่นกันแม้ว่าการตรวจพบว่าด้วย regexp เป็นประพจน์ iffier

วิธีที่ถูกต้องคือการใช้งานgit log -L :function:path/to/fileที่อธิบายไว้ในคำตอบ Eckes

แต่นอกจากนี้หากฟังก์ชันของคุณมีความยาวมากคุณอาจต้องการดูเฉพาะการเปลี่ยนแปลงที่คอมมิตต่างๆได้แนะนำไม่ใช่บรรทัดฟังก์ชันทั้งหมดรวมทั้งไม่ได้ปรับเปลี่ยนสำหรับแต่ละคอมมิตที่อาจแตะเพียงบรรทัดเดียว เหมือนปกติdiffไม่

ปกติgit logสามารถดูความแตกต่างกับแต่ตอนนี้ไม่ได้ทำงานร่วมกับ-p -Lดังนั้นคุณต้องgrep git log -Lแสดงเฉพาะบรรทัดที่เกี่ยวข้องและส่วนหัว commits / files เพื่อกำหนดบริบท เคล็ดลับในที่นี้คือการจับคู่เฉพาะเส้นสีเทอร์มินัลเพิ่ม--colorสวิตช์ด้วยนิพจน์ทั่วไป สุดท้าย:

git log -L :function:path/to/file --color | grep --color=never -E -e "^(^[\[[0-9;]*[a-zA-Z])+" -3

โปรดทราบว่าควรจะเกิดขึ้นจริงที่แท้จริง^[ ^[คุณสามารถพิมพ์ได้โดยการกด ^ V ^ [ในทุบตีที่เป็นCtrl+ V, +Ctrl [อ้างอิงที่นี่

-3สวิตช์สุดท้ายยังอนุญาตให้พิมพ์บริบทเอาต์พุต 3 บรรทัดก่อนและหลังแต่ละบรรทัดที่ตรงกัน คุณอาจต้องการปรับเปลี่ยนตามความต้องการของคุณ

git ตำหนิแสดงให้คุณเห็นว่าใครเป็นคนสุดท้ายที่เปลี่ยนแต่ละบรรทัดของไฟล์ คุณสามารถระบุบรรทัดที่จะตรวจสอบเพื่อหลีกเลี่ยงการรับประวัติของบรรทัดนอกฟังก์ชันของคุณ

1. แสดงประวัติฟังก์ชันด้วยgit log -L :<funcname>:<file>ดังที่แสดงในคำตอบของ eckesและgit doc

   หากไม่แสดงอะไรเลยโปรดดูที่การกำหนดส่วนหัว hunk ที่กำหนดเองเพื่อเพิ่มสิ่งที่ต้องการ*.java diff=javaลงใน.gitattributes ไฟล์เพื่อรองรับภาษาของคุณ

2. แสดงประวัติฟังก์ชันระหว่างคอมมิตกับ git log commit1..commit2 -L :functionName:filePath

3. แสดงประวัติฟังก์ชันที่มากเกินไป (อาจมีหลายฟังก์ชันที่มีชื่อเดียวกัน แต่มีพารามิเตอร์ต่างกัน) ด้วย git log -L :sum\(double:filepath