Pendekatan Praktikal untuk Fail TOML dan Pengurusan Cawangan Jauh

Minggu ini saya berpeluang mengusahakan fail TOML Config dan menyemak perubahan yang dibuat pada repositori saya dengan menarik perubahan secara setempat daripada percabangan projek saya

Apakah itu Fail TOML

TOML (Tom's Obvious Minimal Language) ialah format fail konfigurasi yang menggunakan pasangan nilai kunci mudah untuk menentukan pembolehubah konfigurasi yang akan digunakan dalam program

fail TOML mungkin kelihatan seperti ini

[dependencies]
requests = ">=2.25.0"
flask = { version = "2.0.1", optional = true }


[database]
type = "postgres"
host = "localhost"
port = 5432
username = "admin"
password = "password123"

[database.settings]
pool_size = 5
timeout = 30

Cara fail ini berfungsi adalah dengan menggunakan penghurai untuk menghuraikan kandungan daripada fail TOML dan kemudian menggunakan pembolehubah dalam program

Sebab ia lebih disukai berbanding JSON atau YAML adalah kerana ia mudah ditulis dan difahami oleh manusia dan ia berjaya dalam pengurusan konfigurasi.

Kes Penggunaan TOML Saya

Minggu ini saya berpeluang mengusahakan projek yang hebat, Addcom, Ini adalah alat CLI yang mengambil sampel fail dan menjana komen sebaris untuk fail, ia menggunakan API Groq untuk menjana komen untuk fail

Kini apabila memanggil alat CLI, pengguna boleh menentukan beberapa argumen pilihan yang boleh digunakan semasa membuat permintaan API kepada Groq, iaitu yang berikut

• model - model yang akan digunakan untuk Groq API
• strim - ini ialah nilai boolean yang akan menentukan sama ada output perlu distrim atau tidak
• api_key- kunci API yang akan digunakan untuk Groq
• konteks- laluan ke fail yang akan memberikan konteks kepada LLM

Sekarang ia akan menjadi sangat mengecewakan bagi pengguna untuk menentukan nilai hujah yang sama berulang kali dalam alat CLI, untuk mengelakkan ini saya melaksanakan fail TOML yang akan mengandungi semua tetapan konfigurasi dan nilai yang akan digunakan supaya agak daripada menyatakan tetapan konfigurasi berulang kali, program hanya boleh melihat ke dalam fail TOML dan menggunakan tetapan yang berkaitan.

Aliran logik untuk program adalah seperti berikut

1) Alat CLI akan dipanggil dalam terminal
2) Jika tiada hujah, pembolehubah daripada fail TOML akan digunakan
3) Jika pembolehubah dalam fail TOML salah maka ia tidak akan digunakan, program akan keluar dengan kod ralat 0
4) Jika pengguna menyediakan argumen baris arahan serta fail TOML, argumen baris arahan akan digunakan
5) Operasi dilakukan dengan hujah yang betul

Untuk mencari gambaran keseluruhan deskriptif tentang isu yang saya bangkitkan dalam repo, klik di sini

lebih-lebih lagi untuk mencari PR yang berkaitan dengan klik yang sama di sini

Bekerja dengan Git Remotes

Sehingga kini, apabila saya terpaksa menggabungkan PR, saya perlu melakukannya melalui Github, tetapi kali ini saya menemui cara yang sangat menarik untuk melakukan perkara yang sama secara tempatan

Saya mempunyai seseorang yang bekerja untuk melaksanakan ciri untuk alat CLI saya, orang yang sama mencipta garpu pangkalan kod saya dan mula melaksanakan ciri tersebut, setelah ia dilaksanakan, mereka menolak kod tersebut ke cawangan topik mereka pada garpu mereka.

Sekarang sebelum saya boleh meluluskan perubahan, saya terpaksa menyemak perubahan kod dan memastikan ia berfungsi dan tidak menyebabkan sebarang isu yang belum pernah berlaku sebelum ini

Untuk mencapai matlamat ini, saya melaksanakan langkah berikut

git remote add <user_name> <user_name/fork>

arahan di atas akan menambah sambungan jauh pada garpu pangkalan kod saya

git fetch <user_name/fork>

ini akan mengambil semua cawangan baharu dari repositori jauh dan mengemas kini folder .git tempatan saya

git checkout -b review-change <user_name/fork>

ini akan mewujudkan cawangan baharu yang dipanggil sebagai perubahan semakan yang akan dibina di atas cawangan topik, supaya dapat menyemak perubahan yang dibuat oleh orang itu

sebaik sahaja saya menyemak perubahan, saya akan melakukan perkara berikut

git checkout main
git merge review-change

ini akan melakukan gabungan pantas kerana tiada perubahan dibuat pada utama tempatan saya

git push origin main

arahan ini akan dilakukan untuk menolak perubahan yang digabungkan pada repositori jauh saya yang kemudiannya akan menutup secara automatik PR yang telah dibuka oleh orang itu.

Kesimpulan

Minggu ini, saya memperoleh pengalaman berharga bekerja dengan fail konfigurasi TOML dan mengurus aliran kerja Git untuk sumbangan kod. Melaksanakan TOML membolehkan pengguna mentakrifkan tetapan konfigurasi boleh guna semula untuk projek Addcom, memudahkan penggunaan alat CLI dan meningkatkan kemudahan pengguna. Selain itu, saya belajar cara menyemak dan menggabungkan perubahan daripada garpu penyumbang secara setempat dengan menambahkan repositori jauh mereka, mengambil perubahan dan melakukan gabungan ke hadapan pantas.

Atas ialah kandungan terperinci Pendekatan Praktikal untuk Fail TOML dan Pengurusan Cawangan Jauh. Untuk maklumat lanjut, sila ikut artikel berkaitan lain di laman web China PHP!