
Awesome Jev ni Nini?
Awesome Jev ni saraka iliyoratibiwa ya miradi ya chanzo huria iliyoundwa kwa kutumia TypeSafe Jev. Katalogi hii ina miradi 59 inayojumuisha SDK za mteja, miunganisho ya programu, zana za wasanidi, mifumo ya utafutaji, programu za watumiaji wa mwisho, na utafiti.
Miradi hii hutumia Jev kwa maamuzi yenye aina maalum badala ya uzalishaji wa kawaida wa maandishi yasiyo na muundo maalum. Kulingana na mradi, maamuzi hayo husaidia kazi kama vile uainishaji, utoaji wa alama, upangaji wa viwango, uelekezaji, uthibitishaji, uchujaji, na uteuzi wa vitendo.
Awesome Jev ni mradi huru na hauhusiani na TypeSafe. Kujumuishwa kwenye saraka si uthibitisho wa ubora.
Sifa Muhimu za Saraka
- Katalogi iliyopangwa: Miradi imepangwa katika SDK, miunganisho, zana za wasanidi, utafutaji, programu, na utafiti.
- Mawasilisho yaliyopitiwa: Kila mradi uliowasilishwa hupitiwa kwa kujitegemea kabla ya wasimamizi kuamua kama wauunganishe.
- Uthibitishaji unaotegemea chanzo: Jev Review Action hukagua ushahidi wa chanzo, maelezo ya mradi, na maagizo ya usanidi.
- Maamuzi ya ukaguzi yenye aina maalum: Jev hutoa maamuzi yaliyopangwa, huku msimbo wa hazina ukitoa maoni ya ukaguzi.
- Usaidizi mpana wa lugha: Sehemu ya SDK inajumuisha Python, JavaScript na TypeScript, Go, Rust, Ruby, PHP, Swift, Elixir, .NET, Scala, na mifumo mingine.
- Utaratibu wa michango ulio wazi: Wachangiaji wanaweza kupendekeza hadi maingizo kumi ya miradi katika ombi moja la kuvuta.
Usanidi na Ufikiaji
Kutumia katalogi
Awesome Jev ni saraka, kwa hiyo hakuna kitu cha kusakinisha kwa ajili ya kuvinjari tu. Fungua hazina, chagua kategoria, kisha fuata kiungo cha mradi hadi hazina yake ya chanzo.
Mahitaji ya usakinishaji yanategemea miradi binafsi iliyoorodheshwa. Baada ya kuchagua mradi, soma README yake kwa maelezo kuhusu usakinishaji wa vifurushi, usanidi wa API, mazingira yanayotumika, na maagizo ya matumizi. Usidhani kwamba miradi yote ina mchakato sawa wa usanidi au leseni sawa.
Kujiandaa kuchangia
Ili kuongeza mradi, anza kwa mwongozo wa uchangiaji wa hazina. Unaweza kujumuisha hadi maingizo kumi katika ombi la kuvuta. Njia za chanzo si lazima kwa sababu mkaguzi anaweza kutafuta msimbo wa muunganisho kiotomatiki.
- Thibitisha kwamba mradi ni wa chanzo huria na umejengwa kwa TypeSafe Jev.
- Soma mwongozo wa uchangiaji ili kujua muundo unaotarajiwa wa uwasilishaji.
- Andika maelezo mafupi yanayoakisi kile ambacho msimbo wa chanzo hufanya kwa hakika.
- Ongeza maingizo yasiyozidi kumi ya miradi kwenye ombi la kuvuta.
- Wasilisha ombi la kuvuta na ukague matokeo ya kiotomatiki.
- Shughulikia masuala yanayohusu ushahidi wa chanzo, maagizo ya usanidi, maelezo, au uainishaji.
Ukihitaji msaada, tumia kiolezo cha suala la msaada wa uwasilishaji cha hazina.
Jinsi ya Kupata Mradi Sahihi wa Jev
Hatua ya 1: Anza na matumizi yako
Kategoria hutoa njia ya haraka zaidi ya kupunguza orodha ya katalogi:
- SDK: Chagua hizi unapoongeza API ya maamuzi yenye aina maalum ya TypeSafe moja kwa moja kwenye msimbo wa programu.
- Muunganisho: Anza hapa unapounganisha Jev na mfumo, itifaki, hifadhidata, mtiririko wa kazi wa kivinjari, au mfumo wa wakala uliopo.
- Zana za wasanidi: Chunguza sehemu hii kwa ukaguzi wa msimbo, utafutaji wa hazina, ukaguzi wa CI, uteuzi wa majaribio, uchujaji wa matokeo ya zana, na mtiririko wa kazi wa mawakala wa usimbaji.
- Utafutaji: Tumia miradi hii kwa kupanga upya nyaraka, maamuzi ya utafutaji wa wavuti, au urambazaji wa grafu.
- Programu: Kagua bidhaa kamili na maonyesho kama vile mawakala wa kivinjari, programu za biashara, viwanja vya majaribio, na zana za matumizi ya kompyuta.
- Utafiti: Tumia sehemu hii kusoma utekelezaji wa marudio, vipimo vya utendaji, miundo ya maombi, na ulinganisho wa miundo.
Hatua ya 2: Chagua kiwango sahihi cha utekelezaji
Ikiwa unaunda programu maalum, SDK kwa kawaida ndiyo mwanzo wa moja kwa moja zaidi. Katalogi inajumuisha wateja rasmi wa JavaScript na TypeScript na Python, pamoja na utekelezaji wa jumuiya kwa lugha nyingine kadhaa.
Ikiwa mazingira yako tayari yana muunganisho maalum, tumia huo kabla ya kuunda mmoja kuanzia mwanzo. Kwa mfano, katalogi inaorodhesha miunganisho ya Home Assistant, Hono, Laravel, Rails, PostgreSQL, RubyLLM, wateja wa MCP, na otomatiki ya vivinjari.
Hatua ya 3: Thibitisha maelezo ya mradi
Kabla ya kutumia mradi ulioorodheshwa, fungua hazina yake na ukague nyaraka pamoja na msimbo wake wa chanzo. Kagua hatua za usakinishaji, hali ya uendelezaji, tabia ya API inayotumika, na leseni. Hazina ya Awesome Jev inabainisha wazi kwamba miradi iliyoorodheshwa huhifadhi leseni zake binafsi.
Mifano ya Msingi ya Matumizi
Mfano wa 1: Kuchagua SDK ya programu
Tuseme unataka maamuzi ya Jev yenye aina maalum katika huduma ya Python. Nenda kwenye SDK na ulinganishe SDK rasmi ya TypeSafe Python na mteja wa jumuiya wa kiashiria asiye wa kusubiri aliyeorodheshwa kama jevclient. Maelezo ya katalogi yanaonyesha majukumu yao ya jumla, lakini hazina zao binafsi zina maagizo halisi ya usakinishaji na API.
Lengo: Ongeza Jev kwenye huduma ya Python
Kategoria: SDK
Wagombea: SDK ya TypeSafe Python, jevclient
Hatua inayofuata: Linganisha nyaraka za hazina zao na miundo ya watejaMfano wa 2: Kuongeza ukaguzi wa kisemantiki kwenye mtiririko wa kazi wa uendelezaji
Kwa ukaguzi wa maombi ya kuvuta au ukaguzi wa Git wa ndani, chunguza sehemu ya Zana za msanidi. Mifano muhimu ni Jev Review, Jev Review Action, jev-git, jev-pref, Leanest, na Supercov. Maelezo yao yanatofautisha ukaguzi wa msimbo, uchujaji wa tofauti zilizowekwa tayari, utekelezaji wa mapendeleo, uteuzi wa majaribio, na tathmini ya ubora wa chanzo.
Lengo: Chuja mabadiliko yaliyowekwa tayari kwa maudhui hatarishi
Kategoria: Zana za msanidi
Mgombea: jev-git
Sababu: Ingizo lake la katalogi linaeleza uchujaji kabla ya commit na kabla ya pushMfano wa 3: Kupanga matokeo ya utafutaji
Kwa umuhimu wa hati, sehemu ya Utafutaji inajumuisha hev reranker, maktaba ya Python inayotumia hukumu za Jev Noul kupatia hati zinazogombea alama na kisha kuzipanga au kuzichuja. Jev Search hushughulikia mtiririko mpana zaidi kwa kuchagua vyanzo, vipindi vya muda, na hoja zinazogombea kabla ya kupanga matokeo.
Mfano wa 4: Kupata muunganisho uliopo wa mfumo
Ikiwa programu yako inatumia PostgreSQL, chunguza pg_typesafe, ambayo huita Jev kutoka SQL kwa ajili ya shughuli za Choice, Noul, na Score, ikijumuisha utambuzi na uainishaji wa mafungu. Kwa programu ya Laravel, katalogi inaorodhesha muunganisho usio rasmi wenye majibu yenye aina, maombi ya kusubiri, uingizaji wa utegemezi wenye upeo, na nakala bandia za majaribio.
Kuelewa Mchakato wa Ukaguzi
Hifadhi hutumia Jev Review Action kusaidia ukaguzi wa mapendekezo. Kitendo hiki hukagua ushahidi wa chanzo, hutathmini maelezo na maagizo ya usanidi yaliyopendekezwa, na kupendekeza kategoria.
Mchakato hutenganisha uamuzi wa mashine na usimamizi wa hifadhi:
- Msimbo na nyaraka za mapendekezo hutoa ushahidi.
- Jev hurejesha hukumu zenye aina kuhusu pendekezo.
- Msimbo wa hifadhi hubadilisha hukumu hizo kuwa maoni ya ukaguzi.
- Wasimamizi hufanya uamuzi wa mwisho wa kuunganisha.
Kwa maelezo zaidi, soma sera ya ukaguzi na kumbukumbu za uthibitishaji za hifadhi.
Vidokezo vya Juu
Tofautisha miradi rasmi na ya jumuiya
Baadhi ya maingizo yametambuliwa wazi kuwa wateja rasmi, huku mengine yakielezwa kuwa utekelezaji wa jumuiya au huru. Tumia lebo hizo unapotathmini matarajio ya usaidizi, lakini bado thibitisha hali ya sasa katika hifadhi ya kila mradi.
Linganisha miradi kwa muundo wa maamuzi
Kategoria hukuonyesha mahali mradi unapofaa, huku maelezo yakifichua jinsi unavyotumia Jev. Tafuta miundo inayojirudia kama vile uelekezaji, upangaji, uthibitishaji, uainishaji, uchujaji unaotegemea alama, udhibiti wa zana, na uteuzi wa vitendo. Kulinganisha miradi kwa miundo hii kunaweza kufichua mawazo ya usanifu yanayoweza kutumika tena hata inapotumia lugha tofauti.
Tumia miradi ya utafiti kuelewa uoanifu
Sehemu ya utafiti inajumuisha LitJev, uzalishaji upya wa wazi unaohudumia schema ya ombi na jibu la Jev /v1/systemone kwa shughuli za choice, score, na noul. Pia inajumuisha kipimo kinacholinganisha TypeSafe Jev na Qwen kwenye mizigo kadhaa ya kazi ya sintetiki. Ichukulie hii kama rasilimali ya utafiti na wasiliana na hifadhi zao kabla ya kutoa hitimisho kuhusu utekelezaji au utendaji.
Thibitisha nyaraka za usanidi kabla ya kuwasilisha
Kwa kuwa mchakato wa ukaguzi huchunguza maagizo ya usanidi, hakikisha watumiaji wanaweza kuelewa jinsi ya kuendesha au kuunganisha mradi wako. Weka maelezo ya katalogi kuwa finyu na yenye kutegemea ushahidi badala ya kudai uwezo ambao chanzo hakionyeshi.
Kagua leseni kando
Awesome Jev yenyewe ina leseni ya MIT, lakini leseni hiyo haitumiki kiotomatiki kwa miradi iliyoorodheshwa. Kagua leseni ya kila hifadhi iliyochaguliwa kabla ya kutumia, kurekebisha, au kusambaza upya msimbo wake.
Hitimisho
Awesome Jev hutoa ramani ya vitendo ya mfumo huria wa TypeSafe Jev. Anza na kategoria inayolingana na matumizi yako, linganisha maelezo ya miradi, kisha thibitisha usakinishaji, tabia ya API, uendelezaji, na leseni katika hifadhi asilia. Ikiwa umeunda mradi unaokidhi masharti, fuata mwongozo wa michango na utumie mchakato wa ukaguzi unaotegemea ushahidi kuupendekeza ujumuishwe.
