GitGeo

Gitgeo

ค้นพบภูมิศาสตร์ของซอฟต์แวร์โอเพนซอร์ซ สำรวจตำแหน่งทางภูมิศาสตร์ของนักพัฒนาซอฟต์แวร์ที่เกี่ยวข้องกับที่เก็บ GitHub หรือแพ็คเกจ Python (PYPI)

ตัวอย่างเช่นดูทางภูมิศาสตร์ของผู้มีส่วนร่วมในคำขอแพ็คเกจ Python

ทำไมต้องใช้ Gitgeo?

• ความอยากรู้
• การจัดการชุมชนซอฟต์แวร์โอเพ่นซอร์ส
• การวิจัยเกี่ยวกับระบบนิเวศซอฟต์แวร์โอเพนซอร์ส
• การปฏิบัติตามความปลอดภัยด้านไอที

งานเขียนที่เกี่ยวข้อง

• บล็อกภาพรวมของ Gitgeo
• Gitgeo นำไปใช้กับบล็อกวิทยาศาสตร์ Data Open Source

การติดตั้ง

pip install gitgeo

หรือ:

git clone https://github.com/IQTLabs/GitGeo

การใช้งาน

(ต้องการการเชื่อมต่ออินเทอร์เน็ต)

• ก่อนอื่นให้สร้างโทเค็นการเข้าถึงส่วนบุคคลของ GitHub หนึ่งตัวขึ้นไป

• ประการที่สองเรียกใช้คำสั่งเหล่านี้ในบรรทัดคำสั่งเพื่อตั้งค่าตัวแปรสภาพแวดล้อม:

   export GITHUB_USERNAME= ' [github_username] '
  export GITHUB_TOKEN= ' [github_token] '

• อีกทางเลือกหนึ่งคือใช้โทเค็นหลายตัวสร้างไฟล์ที่เรียกว่า tokens.txt ในไดเรกทอรีของรหัสและป้อนโทเค็นการเข้าถึงส่วนบุคคลของ GitHub ในแต่ละบรรทัด

• ประการที่สามเรียกใช้คำสั่งเหล่านี้ในบรรทัดคำสั่ง:

gitgeo --package [package_name]

gitgeo --repo [github_repo_url]

ตัวอย่างเช่น:

>>> gitgeo --package requests

 -
แพ็คเกจ: คำขอ
-
ผู้สนับสนุนสถานที่ตั้ง
* หมายถึงผู้ดูแล PYPI
-
Kennethreitz42 | เวอร์จิเนียสหรัฐอเมริกา
Lukasa * | ลอนดอนประเทศอังกฤษ
Sigmavirus24 | เมดิสัน, วิสคอนซิน
Nateprewitt * | ไม่มี
Slingamn | ไม่มี
Brauliovm | Malaga & Granada, สเปน
dpursehouse | คาวาซากิ
Jgorset | ออสโล, นอร์เวย์
-

หรือ:

>>> gitgeo --repo www.github.com/psf/requests

 -
GitHub repo: PSF/คำขอ
-
ผู้สนับสนุนสถานที่ตั้ง
-
Kennethreitz42 | เวอร์จิเนียสหรัฐอเมริกา | ประเทศสหรัฐอเมริกา
Lukasa | ลอนดอน, อังกฤษ | สหราชอาณาจักร
Sigmavirus24 | เมดิสัน, WI | ประเทศสหรัฐอเมริกา
Nateprewitt | ไม่มี | ไม่มี
-

มีตัวเลือกบรรทัดคำสั่งอื่น ๆ ด้วย:

เพิ่ม --summary เพื่อให้ได้ผลลัพธ์ที่สรุปโดยประเทศ เช่น

>>> gitgeo --package requests --summary

 -
แพ็คเกจ: คำขอ
GitHub repo: PSF/คำขอ
-
ประเทศ | # ของผู้มีส่วนร่วม
-
สหรัฐอเมริกา 37
ไม่มี 23
สหราชอาณาจักร 4
แคนาดา 4
เยอรมนี 4
สวิตเซอร์แลนด์ 4
สเปน 2
รัสเซีย 2
-

เพิ่ม --map เมื่อใช้ตัวเลือก --repo เพื่อสร้างแผนที่ HTML ที่บันทึกไว้ในโฟลเดอร์ผลลัพธ์ ดูภาพด้านบนสำหรับตัวอย่างคงที่ แผนที่จริงรวมถึงการซูมและความสามารถของคำแนะนำเครื่องมือ

เพิ่ม --ouput_csv เพื่อส่งออก CSV ของผลลัพธ์ไปยังโฟลเดอร์ผลลัพธ์

ในการสร้าง CSV ของผู้มีส่วนร่วมจากที่เก็บจำนวนมากให้ป้อนที่เก็บในบรรทัดแยกต่างหากในไฟล์ repos.txt จากนั้นใช้ธง --multirepo

เพิ่ม multirepo_map จากนั้นชื่อไฟล์เพื่อสร้างแผนที่ของ CSV ouput เอาต์พุต CSV จะต้องอยู่ในโฟลเดอร์ผลลัพธ์

เพิ่ม --num และระบุหลาย 100 จาก 100 (ค่าเริ่มต้น) ถึง 500 เพื่อระบุจำนวนผู้ร่วมที่วิเคราะห์ต่อ repo

เรียกใช้การทดสอบ:

pytest

ต้องการมีส่วนร่วม?

• เปิดประชาสัมพันธ์ เราดีใจที่ได้รับคำขอดึง เราใช้ Black และ Pylint และ Pydocstyle แม้ว่าเราจะยินดีที่จะช่วยเหลือหากคุณไม่เคยใช้เครื่องมือเหล่านั้นมาก่อน
• เปิดปัญหา บอกปัญหาของคุณหรือฟังก์ชั่นที่คุณต้องการ
• ต้องการช่วยสร้างชุมชนที่เกี่ยวข้องกับ Gitgeo และเครื่องมือสำรวจระบบนิเวศซอฟต์แวร์โอเพนซอร์ซที่คล้ายกันหรือไม่? กรุณาส่งอีเมลไปที่ [email protected]