Cloudflare-მა Forge წარადგინა: ღია კოდის მილსადენი SDK-ებისა და CLI-ების გენერაციისთვის

Cloudflare-მა ღია კოდის პროექტი Forge წარადგინა. ეს არის მოდულური გენერაციის მილსადენი, რომელიც API-ის სპეციფიკაციებიდან SDK-ებს, CLI-ებს, დოკუმენტაციასა და ბიბლიოთეკებს ქმნის. კომპანიის განცხადებით, ნებისმიერს შეუძლია მისი განთავსება და უფასოდ გაშვება.

პროექტი ჯერ ადრეულ ეტაპზეა, თუმცა უკვე ქმნის cf CLI-სთვის საჭირო გამოსავალს. მომდევნო თვეებში ის უზრუნველყოფს Cloudflare-ის API-ის დოკუმენტაციის, SDK-ებისა და სხვა პროდუქტების გენერაციას.

რატომ შექმნა Cloudflare-მა Forge

Cloudflare-ის API 3 500-ზე მეტ ოპერაციას მოიცავს. ამ API-ებს ასობით სერვისი ამუშავებს, რომლებიც Rust-ზე, Go-ზე, TypeScript-სა და Python-ზეა დაწერილი. კომპანიის თქმით, მთელი API-ისთვის ერთი CLI-ის აშენებისას საჭირო გახდა გენერაციის ისეთი მილსადენი, რომელიც ამ მასშტაბს გაუმკლავდებოდა.

Forge CI-ში, თითოეული გუნდის API-ის რეპოზიტორიაში მუშაობს. ის ყოველ ცვლილებას ამოწმებს და CLI-ის, დოკუმენტაციისა და SDK-ების წინასწარ ნაგებობებს ქმნის, სადაც მხოლოდ ახალი ცვლილებებია გამოკვეთილი. ამის შედეგად გუნდი შეცდომას კოდის შერწყმამდე ამოიცნობს. მიდგომა Workers Previews-ის პრინციპს იმეორებს.

ტრანსფორმერები და ჯაჭვური გენერაცია

Forge-ის ტრანსფორმერები ერთმანეთს უკავშირდება: ერთი გამოსავლიდან მეორე იქმნება. მაგალითად, OpenAPI-ს საწყისი აღწერილობა TypeScript-ის SDK-ში აისახება, რომელიც თავის მხრივ cf CLI-ისა და Cap'n Web-ის სპეციფიკაციებს წარმოქმნის.

პლატფორმა დღეს OpenAPI-ს მხარს უჭერს, თუმცა აგებულია ისე, რომ მომავალში AsyncAPI, GraphQL, Cap'n Proto და Protobuf დაემატოს. ტრანსფორმერების საშუალებით შესაძლებელია TanStack Query-ს ბაინდინგების, Zod ან Valibot სქემების, MCP სერვერების, დაფებისა და მთლიანი აპლიკაციების გენერაციაც.

ვერსიონირება და ღია კოდი

Forge ასევე ეხმარება Cloudflare-ს API-ის ვერსიონირებაში. კომპანიის v4 API ათი წელია მთავარი ვერსიაა. შემდგომში Cloudflare გეგმავს ისეთი მიდგომის დანერგვას, რომელიც ახალი ძირითადი ვერსიების გამოშვებას ძველი კლიენტებისა და SDK-ების გატეხვის გარეშე დაუშვებს.

კომპანიის განცხადებით, ახალი SDK-ები TypeScript-ზე, Rust-ზე, Python-ზე, Go-ზე, PHP-სა და Terraform-ზე მალე გამოვა. Forge Apache 2.0 ლიცენზიით ვრცელდება: ნებისმიერს შეუძლია მისი გაშვება ნებისმიერი მიზნით, საკუთარი ცვლილებებით, დახურულად და უფასოდ.