fisher

ชาวประมง

ตัวจัดการปลั๊กอินสำหรับปลา - เปลือกแบบโต้ตอบที่เป็นมิตรของคุณ อุปสรรค์ปลั๊กอินสด!

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

• ฟิชเชอร์เป็นปลาบริสุทธิ์ 100% ทำให้ง่ายต่อการมีส่วนร่วมหรือแก้ไข
• การดาวน์โหลดปลั๊กอินที่เกิดขึ้นพร้อมกันอย่างรวดเร็วซึ่งจะทำให้คุณเป็นจริง
• จำเป็นต้องกำหนดค่าเป็นศูนย์ - เราไม่ได้ล้อเล่น!
• โอ้ปลา! ปลั๊กอินรองรับด้วย

☝การอัพเกรดจากฟิชเชอร์ 3.x ขึ้นไป? รัดและอ่านสิ่งนี้!

การติดตั้ง

 curl -sL https://raw.githubusercontent.com/jorgebucaran/fisher/main/functions/fisher.fish | source && fisher install jorgebucaran/fisher 

เร็ว

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

การติดตั้งปลั๊กอิน

ในการติดตั้งปลั๊กอินให้ใช้คำสั่ง install และชี้ไปที่ที่เก็บ GitHub

 fisher install jorgebucaran/nvm.fish

ต้องการติดตั้งจาก Gitlab? ไม่มีปัญหา - เพียงแค่ล่วงหน้า gitlab.com/ ไปยังเส้นทางปลั๊กอิน

นอกจากนี้คุณยังสามารถขัดขวางปลั๊กอินเวอร์ชันเฉพาะได้โดยการเพิ่มสัญลักษณ์ @ หลังจากชื่อปลั๊กอินตามด้วยแท็กสาขาหรือการกระทำ

 fisher install IlanCosman/tide@v5

และเฮ้คุณสามารถติดตั้งปลั๊กอินจากไดเรกทอรีท้องถิ่นได้เช่นกัน!

 fisher install ~/path/to/plugin

หัวขึ้น! ฟิชเชอร์ขยายปลั๊กอินลงในไดเรกทอรีการกำหนดค่าปลาของคุณโดยค่าเริ่มต้นการเขียนทับไฟล์ที่มีอยู่ หากนั่นไม่ใช่แยมของคุณตั้งค่า $fisher_path ไปยังตำแหน่งที่คุณต้องการและใส่ไว้ในเส้นทางฟังก์ชั่นของคุณ (#640)

ปลั๊กอินรายการ

ใช้คำสั่ง list เพื่อดูปลั๊กอินที่ติดตั้งไว้เป็นประกายทั้งหมดของคุณ

$ fisher list
jorgebucaran/fisher
ilancosman/tide@v5
jorgebucaran/nvm.fish
/home/jb/path/to/plugin

คำสั่ง list ยังเล่นได้ดีด้วยนิพจน์ทั่วไปสำหรับการกรองเอาต์พุต

$ fisher list ^ /
/home/jb/path/to/plugin

อัปเดตปลั๊กอิน

update คำสั่งเป็นกู้ภัย! มันอัปเดตปลั๊กอินอย่างน้อยหนึ่งรายการเป็นเวอร์ชันล่าสุดและยิ่งใหญ่ที่สุดของพวกเขา

 fisher update jorgebucaran/fisher

เพียงพิมพ์ fisher update เพื่ออัปเดตทุกอย่างในที่เดียว

การลบปลั๊กอิน

บอกลาปลั๊กอินที่ติดตั้งด้วยคำสั่ง remove

 fisher remove jorgebucaran/nvm.fish

รู้สึกทำลาย? เช็ดทุกอย่างรวมถึงฟิชเชอร์เอง

 fisher list | fisher remove 

ใช้ไฟล์ fish_plugins ของคุณ

เมื่อใดก็ตามที่คุณติดตั้งหรือถอดปลั๊กอินออกจากบรรทัดคำสั่งฟิชเชอร์จะลงปลั๊กอินที่ติดตั้งทั้งหมดใน $__fish_config_dir/fish_plugins เพิ่มไฟล์นี้ลงใน DotFiles หรือ Version Control ของคุณเพื่อแบ่งปันการกำหนดค่าของคุณในระบบที่แตกต่างกันได้อย่างง่ายดาย

นอกจากนี้คุณยังสามารถแก้ไขไฟล์นี้และเรียกใช้ fisher update เพื่อกระทำการเปลี่ยนแปลงเช่น PRO:

 $EDITOR $__fish_config_dir/fish_plugins 

jorgebucaran/fisher
ilancosman/tide@v5
jorgebucaran/nvm.fish
+ PatrickF1/fzf.fish
- /home/jb/path/to/plugin 

 fisher update

สิ่งนี้จะติดตั้ง patrickf1 / fzf.fish , ลบ / home / jb / path / to / ปลั๊กอิน และอัปเดตทุกอย่างอื่น

การสร้างปลั๊กอิน

ปลั๊กอินสามารถรวมไฟล์จำนวนใดก็ได้ใน functions conf.d และไดเรกทอรี completions ปลั๊กอินส่วนใหญ่เป็นเพียงฟังก์ชั่นเดียวหรือตัวอย่างการกำหนดค่า ดูกายวิภาคของปลั๊กอินทั่วไป:

 พลิก
├── ความสำเร็จ
flipper
├── conf.d
flipper
functions
    └── Flipper.fish

ไฟล์และไดเรกทอรีที่ไม่ใช่ .fish ภายในสถานที่เหล่านี้จะถูกคัดลอกไปยัง $fisher_path ภายใต้ functions conf.d หรือ completions ตามลำดับ

ระบบเหตุการณ์

เหตุการณ์ปลาแจ้งปลั๊กอินเมื่อติดตั้งอัปเดตหรือลบออก

โปรดทราบว่า --on-event จะต้องโหลดเมื่อมีการปล่อยกิจกรรมของพวกเขา ดังนั้นวางตัวจัดการกิจกรรมของคุณในไดเรกทอรี conf.d

 # Defined in flipper/conf.d/flipper.fish

function _flipper_install --on-event flipper_install
    # Set universal variables, create bindings, and other initialization logic.
end

function _flipper_update --on-event flipper_update
    # Migrate resources, print warnings, and other update logic.
end

function _flipper_uninstall --on-event flipper_uninstall
    # Erase "private" functions, variables, bindings, and other uninstall logic.
end 

การสร้างธีม

ชุดรูปแบบเป็นเหมือนปลั๊กอินปลาอื่น ๆ แต่มีไฟล์ .theme ในไดเรกทอรี themes ชุดรูปแบบได้รับการแนะนำในปลา 3.4 และทำงานร่วมกับ fish_config Builtin ธีมยังสามารถมีไฟล์ใน functions conf.d หรือ completions หากจำเป็น ตรวจสอบว่าปลั๊กอินธีมทั่วไปเป็นอย่างไร:

 เหงือก
├ดุ conf.d
gills
ชุดรูปแบบ
    gills

ใช้ $fisher_path กับธีม

หากคุณปรับแต่ง $fisher_path เพื่อใช้ไดเรกทอรีอื่นนอกเหนือจาก $__fish_config_dir ธีมของคุณจะไม่สามารถใช้ได้ผ่าน fish_config นั่นเป็นเพราะปลาคาดว่าธีมของคุณจะอยู่ใน $__fish_config_dir/themes ไม่ใช่ $fisher_path/themes สิ่งนี้ยังไม่สามารถกำหนดค่าได้ในปลา แต่มีคำขอเพิ่มคุณสมบัตินั้น

ไม่กลัว! คุณสามารถแก้ปัญหานี้ได้อย่างง่ายดายโดย symlinking themes ของฟิชเชอร์ลงในการกำหนดค่าปลาของคุณ ก่อนอื่นให้สำรองไดเรกทอรีธีมที่มีอยู่

 mv $__fish_config_dir/themes $__fish_config_dir/themes.bak

ถัดไปสร้าง Symlink สำหรับไดเรกทอรีธีมของฟิชเชอร์

 ln -s $fisher_path/themes $__fish_config_dir/themes

ต้องการใช้ปลั๊กอินธีมและรักษาธีมท้องถิ่นของคุณเองหรือไม่? คุณสามารถทำได้เช่นกัน (#708)

การค้นพบได้

ในขณะที่ฟิชเชอร์ไม่ได้พึ่งพาที่เก็บปลั๊กอินกลางการค้นพบปลั๊กอินใหม่ไม่จำเป็นต้องรู้สึกเหมือนนำทางน่านน้ำที่ไม่ได้จดที่แผนที่ เพื่อเพิ่มการมองเห็นของปลั๊กอินของคุณและทำให้ผู้ใช้ค้นหาได้ง่ายขึ้นให้เพิ่มหัวข้อที่เกี่ยวข้องในที่เก็บของคุณโดยใช้ fish-plugin ด้วยการทำเช่นนั้นคุณไม่เพียง แต่มีส่วนร่วมในชุมชนฟิชเชอร์ แต่ยังช่วยให้ผู้ใช้สามารถสำรวจปลั๊กอินใหม่และปรับปรุงประสบการณ์เปลือกปลาของพวกเขา อย่าปล่อยให้ปลั๊กอิน Discovery เป็นธุรกิจที่คาวการติดแท็กปลั๊กอินของคุณวันนี้!

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

ฟิชเชอร์เริ่มต้นการเดินทางในปี 2559 โดย @jorgebucaran ในฐานะผู้จัดการการกำหนดค่าเชลล์สำหรับปลา ระหว่างทางหลายคนช่วยกำหนดมันให้เป็นสิ่งที่เป็นอยู่ทุกวันนี้ โอ้ปลาของฉันปูทางเป็นเฟรมเวิร์กปลายอดนิยมครั้งแรก @Jethrokuan ให้การสนับสนุนที่สำคัญในช่วงปีแรก ๆ ข้อเสนอแนะที่ตรงไปตรงมาของ @Patrickf1 พิสูจน์แล้วว่ามีค่าอันล้ำค่าและอีกครั้ง Bootstrapping Fisher เป็นแนวคิดที่ยอดเยี่ยมของ @Ilancosman ขอบคุณผู้สนับสนุนทุกคนของเรา! <3

ใบอนุญาต

มิกซ์