fdiff

เกี่ยวกับ

fdiff เป็นเครื่องมือเปรียบเทียบบรรทัดคำสั่ง Python สำหรับการประเมินความแตกต่างของเม็ดในข้อมูลตาราง opentype ระหว่างไฟล์ตัวอักษร เครื่องมือนี้ให้การสนับสนุนข้ามแพลตฟอร์มสำหรับตัวอักษรท้องถิ่นและแบบฟอนต์ระยะไกลบนระบบ MacOS, Windows และ GNU/Linux ด้วย Python V3.7+ Interpreter

กำลังมองหาภาพรวมระดับสูงของความแตกต่างของตาราง opentype มากกว่าการเปลี่ยนแปลงระดับต่ำ? ตรวจสอบเครื่องมือ fbdiff ของ Van Rossum

มันทำอะไร

• ใช้อาร์กิวเมนต์พา ธ ไฟล์แบบอักษรสองตัว (หรือ URL สำหรับแบบอักษรระยะไกล) สำหรับการเปรียบเทียบแบบอักษร
• Dumps Opentype Table Data ในรูปแบบ Fonttools Library TTX (XML)
• เปรียบเทียบข้อมูลตาราง opentype ในสองไฟล์โดยใช้รูปแบบ diff Unified กับ 3 บรรทัดของบริบทโดยรอบ

คุณสมบัติเสริม

• ตัวกรอง opentype ตารางด้วย --include หรือ --exclude ตัวเลือกที่รวม
• ปรับเปลี่ยนจำนวนเส้นบริบทที่แสดงใน Diff ด้วยตัวเลือก -l หรือ --lines
• แสดงบรรทัด N แรกของเอาต์พุต diff ด้วยตัวเลือก --head
• แสดงบรรทัด N สุดท้ายของเอาต์พุต diff ด้วยตัวเลือก --tail
• ดำเนินการ diff ด้วยเครื่องมือ diff ภายนอกโดยใช้ตัวเลือก --external

เรียกใช้ fdiff --help เพื่อดูตัวเลือกที่มีอยู่ทั้งหมด

เนื้อหา

• การติดตั้ง
• การใช้งาน
• ปัญหา
• การบริจาค
• กิตติกรรมประกาศ
• ใบอนุญาต

การติดตั้ง

fdiff ต้องการล่าม Python 3.7+

แนะนำให้ติดตั้งในสภาพแวดล้อมเสมือนจริงของ Python3

ใช้วิธีการติดตั้งใด ๆ ต่อไปนี้:

PIP ติดตั้งจาก PYPI

 $ pip3 install fdiff

การติดตั้ง PIP จากแหล่งที่มา

 $ git clone https://github.com/source-foundry/fdiff.git
$ cd fdiff
$ pip3 install -r requirements.txt .

ผู้พัฒนาติดตั้งจากแหล่งที่มา

วิธีการต่อไปนี้ติดตั้งโครงการและการพึ่งพานักพัฒนาที่เป็นตัวเลือกที่เกี่ยวข้องเพื่อให้การเปลี่ยนแปลงแหล่งที่มาพร้อมใช้งานโดยไม่จำเป็นต้องติดตั้งใหม่

 $ git clone https://github.com/source-foundry/fdiff.git
$ cd fdiff
$ pip3 install --ignore-installed -r requirements.txt -e ".[dev]"

การใช้งาน

ไฟล์แบบอักษรท้องถิ่น

 $ fdiff [OPTIONS] [PRE-FONT FILE PATH] [POST-FONT FILE PATH]

ไฟล์ฟอนต์ระยะไกล

fdiff รองรับการร้องขอสำหรับไฟล์ฟอนต์ระยะไกลที่เข้าถึงได้สาธารณะ แทนที่อาร์กิวเมนต์พา ธ ไฟล์ด้วย URL:

 $ fdiff [OPTIONS] [PRE-FONT FILE URL] [POST-FONT FILE URL]

fdiff ทำงานร่วมกับการรวมกันของไฟล์แบบอักษรท้องถิ่นและระยะไกล ตัวอย่างเช่นในการเปรียบเทียบไฟล์ฟอนต์โพสต์ในพื้นที่กับไฟล์ฟอนต์ระยะไกลระยะไกลเพื่อประเมินการเปลี่ยนแปลงในท้องถิ่นกับไฟล์ตัวอักษรที่ถูกส่งไปยังรีโมตก่อนหน้านี้ให้ใช้ไวยากรณ์ต่อไปนี้:

 $ fdiff [OPTIONS] [PRE-FONT FILE URL] [POST-FONT FILE FILE PATH]

เคล็ดลับ : บริการโฮสติ้งที่เก็บ GIT ระยะไกล (เช่น GitHub) รองรับการเข้าถึงไฟล์ในสาขา GIT ที่แตกต่างกันโดย URL ใช้ URL สาขาที่เก็บข้อมูลเหล่านี้เพื่อเปรียบเทียบแบบอักษรข้ามสาขา GIT ในที่เก็บของคุณ

ตัวเลือก

ตัวกรอง opentype ตาราง

หากต้องการรวมเฉพาะตารางที่ระบุใน Diff ของคุณให้ใช้ตัวเลือก --include รวมกับรายการชื่อตารางที่คั่นด้วยเครื่องหมายจุลภาค:

 $ fdiff --include head,post [PRE-FONT FILE PATH] [POST-FONT FILE PATH]

ในการยกเว้นตารางที่ระบุใน Diff ของคุณให้ใช้ตัวเลือก --exclude ด้วยรายการชื่อตารางที่คั่นด้วยเครื่องหมายจุลภาค:

 $ fdiff --exclude glyf,OS/2 [PRE-FONT FILE PATH] [POST-FONT FILE PATH]

อย่ารวมช่องว่าง ระหว่างค่าชื่อตารางที่คั่นด้วยเครื่องหมายจุลภาค!

เปลี่ยนจำนวนเส้นบริบท

หากต้องการเปลี่ยนจำนวนบรรทัดของบริบทด้านบน/ต่ำกว่าบรรทัดที่มีความแตกต่างให้ใช้ตัวเลือก -l หรือ --lines ที่มีค่าจำนวนเต็มสำหรับจำนวนบรรทัดที่ต้องการ คำสั่งต่อไปนี้จะลดข้อมูลบริบทเป็นบรรทัดเดียวด้านบนและด้านล่างบรรทัดที่มีความแตกต่าง:

 $ fdiff -l 1 [PRE-FONT FILE PATH] [POST-FONT FILE PATH]

แสดงบรรทัดแรกของเอาต์พุต

ใช้ตัวเลือก --head ตามด้วยจำนวนเต็มสำหรับจำนวนบรรทัดที่จุดเริ่มต้นของเอาต์พุต ตัวอย่างเช่นคำสั่งต่อไปนี้แสดง 20 บรรทัดแรกของ Diff:

 $ fdiff --head 20 [PRE-FONT FILE PATH] [POST-FONT FILE PATH]

แสดงบรรทัด N สุดท้ายของเอาต์พุต

ใช้ตัวเลือก --tail ตามด้วยจำนวนเต็มสำหรับจำนวนบรรทัดที่ส่วนท้ายของเอาต์พุต ตัวอย่างเช่นคำสั่งต่อไปนี้แสดง 20 บรรทัดสุดท้ายของ Diff:

 $ fdiff --tail 20 [PRE-FONT FILE PATH] [POST-FONT FILE PATH]

ใช้เครื่องมือ diff ภายนอก

โปรดทราบ : คุณสมบัตินี้ยังไม่ได้รับการทดสอบในแพลตฟอร์มที่รองรับทั้งหมด โปรดรายงานปัญหาใด ๆ ที่คุณเจอในการติดตามปัญหาโครงการ

โดยค่าเริ่มต้น FDIFF ดำเนินการแตกต่างกับแหล่งงูหลาม หากคุณพบปัญหาประสิทธิภาพด้วยวิธีการนี้คุณสามารถใช้งาน DIFF Executables ที่รวบรวมได้ซึ่งมีอยู่บนแพลตฟอร์มของคุณ FDIFF จะทิ้งไฟล์ TTX และเรียกใช้คำสั่งที่คุณระบุไว้ในบรรทัดคำสั่งที่ผ่านเส้นทางไฟล์ Font Dump FONT PRE และ POST TTX เป็นอาร์กิวเมนต์ตำแหน่งแรกและตำแหน่งที่สองไปยังคำสั่งของคุณ

ตัวอย่างเช่นคุณอาจเรียกใช้คำสั่ง diff -u บน gnu/linux หรือ macOS เช่นนี้:

 $ fdiff --external="diff -u" [PRE-FONT FILE PATH] [POST-FONT FILE PATH]

FDIFF รองรับการจัดรูปแบบสีในตัวและการกรองตาราง opentype เมื่อใช้กับเครื่องมือ diff ภายนอก ตัวเลือกสายบริบทหัวและหางไม่ได้รับการสนับสนุนด้วยการใช้เครื่องมือ diff ภายนอก

ปิดการใช้งานสี diffs

ANSI Escape Code Colored Diffs จะดำเนินการโดยค่าเริ่มต้นในสภาพแวดล้อมเทอร์มินัล

หากต้องการดูความแตกต่างโดยไม่มีรหัส Escape ANSI ในเทอร์มินัลของคุณให้รวมตัวเลือก --nocolor ในคำสั่งของคุณ:

 $ fdiff --nocolor [PRE-FONT FILE PATH] [POST-FONT FILE PATH]

ตัวเลือกอื่น ๆ

ใช้ fdiff -h เพื่อดูตัวเลือกที่มีอยู่ทั้งหมด

ปัญหา

โปรดรายงานปัญหาเกี่ยวกับตัวติดตามปัญหาโครงการ

การบริจาค

การบริจาคยินดีต้อนรับอย่างอบอุ่น สภาพแวดล้อมการพึ่งพาการพัฒนาสามารถติดตั้งในโหมดแก้ไขได้ด้วยเอกสารการติดตั้งนักพัฒนาด้านบน

โปรดใช้วิธีการขอการดึง GitHub มาตรฐานเพื่อเสนอการเปลี่ยนแปลงแหล่งที่มา

การตัดแต่งไฟล์ต้นฉบับ

ไฟล์ต้นฉบับของ Python นั้นเป็นผ้าคลุมหน้าด้วย flake8 ดูเป้าหมาย test-lint MakeFile สำหรับรายละเอียด

การทดสอบ

โครงการดำเนินการทดสอบการรวมอย่างต่อเนื่องในบริการการกระทำของ GitHub ด้วยเครื่องมือ pytest โมดูลทดสอบอยู่ในไดเรกทอรี tests ของที่เก็บ

การทดสอบท้องถิ่นโดยรุ่น Python Interpreter สามารถทำได้ด้วยคำสั่งต่อไปนี้ที่ดำเนินการจากรูทของที่เก็บ:

 $ tox -e [PYTHON INTERPRETER VERSION]

โปรดดูเอกสาร tox สำหรับรายละเอียดเพิ่มเติม

ทดสอบความครอบคลุม

การทดสอบความครอบคลุมของหน่วยจะดำเนินการด้วยเครื่องมือ coverage ดูเป้าหมาย test-coverage MakeFile สำหรับรายละเอียด

กิตติกรรมประกาศ

fdiff ถูกสร้างขึ้นด้วยไลบรารีซอฟต์แวร์ Fonttools Free Fanttools และดำเนินการข้อความต่าง ๆ ของไฟล์ตัวอักษรไบนารีโดยใช้การถ่ายโอนข้อมูลรูปแบบการทำให้เป็นอนุกรมตาราง TTX Opentype ตามที่กำหนดไว้ในไลบรารี Fonttools

ใบอนุญาต

ลิขสิทธิ์ 2019 Source Foundry ผู้เขียนและผู้สนับสนุน

ได้รับใบอนุญาตภายใต้ใบอนุญาต Apache เวอร์ชัน 2.0 ("ใบอนุญาต"); คุณไม่สามารถใช้ไฟล์นี้ยกเว้นตามใบอนุญาต คุณอาจได้รับสำเนาใบอนุญาตที่

http://www.apache.org/licenses/license-2.0

เว้นแต่ว่ากฎหมายที่บังคับใช้หรือตกลงเป็นลายลักษณ์อักษรซอฟต์แวร์ที่แจกจ่ายภายใต้ใบอนุญาตจะถูกแจกจ่ายตาม "ตามพื้นฐาน" โดยไม่มีการรับประกันหรือเงื่อนไขใด ๆ ไม่ว่าจะโดยชัดแจ้งหรือโดยนัย ดูใบอนุญาตสำหรับภาษาเฉพาะที่ควบคุมการอนุญาตและข้อ จำกัด ภายใต้ใบอนุญาต