diff --git a/build.php b/build.php new file mode 100644 index 000000000..3e859a236 --- /dev/null +++ b/build.php @@ -0,0 +1,599 @@ + [ + 'android', 'apple', 'flutter', 'web' + ], + 'console' => [ + 'cli', + ], + 'server' => [ + 'dart', 'deno', 'dotnet', 'kotlin', 'node', 'php', 'python', 'ruby', 'swift' + ], + ]; + + $usage = function () use ($supportedPlatforms, $supportedSDKs) { + echo "Usage: php example.php [ ...]\n"; + echo "\n"; + echo " The platform you want to generate the SDK for.\n"; + echo " Supported platforms: " . implode(", ", $supportedPlatforms) . "\n"; + echo "\n"; + echo " The SDK you want to generate. Supported SDKs:\n"; + echo " " . implode(", ", array_merge(...array_values($supportedSDKs))) . "\n"; + echo " If no SDKs are provided, all SDKs for the specified platform will be generated.\n"; + exit(1); + }; + + if ($argc < 2) { + $usage(); + } + + $platform = $argv[1]; + if (!in_array($platform, $supportedPlatforms)) { + $usage(); + } + + $sdks = []; + if ($argc > 2) { + $sdks = array_slice($argv, 2); + } + + function getSSLPage($url) + { + $ch = curl_init(); + curl_setopt($ch, CURLOPT_HEADER, false); + curl_setopt($ch, CURLOPT_URL, $url); + curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false); + curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, false); + curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); + $result = curl_exec($ch); + curl_close($ch); + return $result; + } + + $spec = getSSLPage("https://raw.githubusercontent.com/appwrite/appwrite/master/app/config/specs/swagger2-latest-{$platform}.json"); + + if (empty($spec)) { + throw new Exception('Failed to fetch spec from Appwrite server'); + } + + switch ($platform) { + case 'client': + if (empty($sdks) || in_array('android', $sdks)) { + // Android + $sdk = new SDK(new Android(), new Swagger2($spec)); + + $sdk + ->setName('Android') + ->setNamespace('io appwrite') + ->setDescription('Appwrite is an open-source backend as a service server that abstract and simplify complex and repetitive development tasks behind a very simple to use REST API. Appwrite aims to help you develop your apps faster and in a more secure way. Use the Flutter SDK to integrate your app with the Appwrite server to easily start interacting with all of Appwrite backend APIs and tools. For full API documentation and tutorials go to https://appwrite.io/docs') + ->setShortDescription('Appwrite Android SDK') + ->setURL('https://example.com') + ->setGitUserName('appwrite') + ->setGitRepoName('sdk-for-android') + ->setLogo('https://appwrite.io/v1/images/console.png') + ->setLicenseContent('test test test') + ->setWarning('**This SDK is compatible with Appwrite server version 0.7.x. For older versions, please check previous releases.**') + ->setChangelog('**CHANGELOG**') + ->setVersion('0.0.0-SNAPSHOT') + ->setTwitter('appwrite_io') + ->setDiscord('564160730845151244', 'https://appwrite.io/discord') + ->setDefaultHeaders([ + 'x-appwrite-response-format' => '0.7.0', + ]); + $sdk->generate(__DIR__ . '/examples/android'); + } + + if (empty($sdks) || in_array('apple', $sdks)) { + // Swift (Client) + $sdk = new SDK(new Apple(), new Swagger2($spec)); + + $sdk + ->setName('NAME') + ->setDescription('Repo description goes here') + ->setShortDescription('Repo short description goes here') + ->setURL('https://example.com') + ->setLogo('https://appwrite.io/v1/images/console.png') + ->setLicenseContent('test test test') + ->setWarning('**WORK IN PROGRESS - NOT READY FOR USAGE**') + ->setChangelog('**CHANGELOG**') + ->setVersion('0.0.1') + ->setGitUserName('repoowner') + ->setGitRepoName('reponame') + ->setTwitter('appwrite_io') + ->setDiscord('564160730845151244', 'https://appwrite.io/discord') + ->setDefaultHeaders([ + 'X-Appwrite-Response-Format' => '1.2.0', + ]); + + $sdk->generate(__DIR__ . '/examples/apple'); + } + + if (empty($sdks) || in_array('flutter', $sdks)) { + // Flutter + $flutter = new Flutter(); + $flutter->setPackageName('appwrite'); + $sdk = new SDK($flutter, new Swagger2($spec)); + + $sdk + ->setName('NAME') + ->setDescription('Repo description goes here') + ->setShortDescription('Repo short description goes here') + ->setURL('https://example.com') + ->setLogo('https://appwrite.io/v1/images/console.png') + ->setLicenseContent('test test test') + ->setWarning('**WORK IN PROGRESS - NOT READY FOR USAGE**') + ->setChangelog('**CHANGELOG**') + ->setExamples('**EXAMPLES** ') + ->setVersion('0.0.1') + ->setGitUserName('repoowner') + ->setGitRepoName('reponame') + ->setTwitter('appwrite_io') + ->setDiscord('564160730845151244', 'https://appwrite.io/discord') + ->setDefaultHeaders([ + 'X-Appwrite-Response-Format' => '1.2.0', + ]); + + $sdk->generate(__DIR__ . '/examples/flutter'); + } + + if (empty($sdks) || in_array('web', $sdks)) { + // Web + $sdk = new SDK(new Web(), new Swagger2($spec)); + + $sdk + ->setName('NAME') + ->setDescription('Repo description goes here') + ->setShortDescription('Repo short description goes here') + ->setVersion('0.0.0') + ->setURL('https://example.com') + ->setLogo('https://appwrite.io/v1/images/console.png') + ->setLicenseContent('test test test') + ->setWarning('**WORK IN PROGRESS - NOT READY FOR USAGE**') + ->setChangelog('**CHANGELOG**') + ->setReadme("## Getting Started") + ->setGitUserName('repoowner') + ->setGitRepoName('reponame') + ->setTwitter('appwrite_io') + ->setDiscord('564160730845151244', 'https://appwrite.io/discord') + ->setDefaultHeaders([ + 'X-Appwrite-Response-Format' => '1.2.0', + ]); + + $sdk->generate(__DIR__ . '/examples/web'); + } + + if (empty($sdks) || in_array('rest', $sdks)) { + // REST + $sdk = new SDK(new REST(), new Swagger2($spec)); + + $sdk + ->setName('NAME') + ->setDescription('Repo description goes here') + ->setShortDescription('Repo short description goes here') + ->setURL('https://example.com') + ->setLogo('https://appwrite.io/v1/images/console.png') + ->setLicenseContent('test test test') + ->setWarning('**WORK IN PROGRESS - NOT READY FOR USAGE**') + ->setChangelog('**CHANGELOG**') + ->setVersion('0.0.1') + ->setGitUserName('repoowner') + ->setGitRepoName('reponame') + ->setTwitter('appwrite_io') + ->setDiscord('564160730845151244', 'https://appwrite.io/discord'); + + $sdk->generate(__DIR__ . '/examples/REST'); + } + + if (empty($sdks) || in_array('graphql', $sdks)) { + // GraphQL + $sdk = new SDK(new GraphQL(), new Swagger2($spec)); + + $sdk + ->setName('GraphQL') + ->setDescription('Appwrite is an open-source backend as a service server that abstract and simplify complex and repetitive development tasks behind a very simple to use REST API. Appwrite aims to help you develop your apps faster and in a more secure way. Use the Flutter SDK to integrate your app with the Appwrite server to easily start interacting with all of Appwrite backend APIs and tools. For full API documentation and tutorials go to https://appwrite.io/docs') + ->setLogo('https://appwrite.io/v1/images/console.png'); + $sdk->generate(__DIR__ . '/examples/graphql'); + } + break; + case 'console': + if (empty($sdks) || in_array('cli', $sdks)) { + // CLI + $language = new CLI(); + $language->setNPMPackage('appwrite-cli'); + $language->setExecutableName('appwrite'); + $language->setLogo(json_encode(" + _ _ _ ___ __ _____ + /_\ _ __ _ ____ ___ __(_) |_ ___ / __\ / / \_ \ + //_\\\| '_ \| '_ \ \ /\ / / '__| | __/ _ \ / / / / / /\/ + / _ \ |_) | |_) \ V V /| | | | || __/ / /___/ /___/\/ /_ + \_/ \_/ .__/| .__/ \_/\_/ |_| |_|\__\___| \____/\____/\____/ + |_| |_| + +")); + $language->setLogoUnescaped(" + _ _ _ ___ __ _____ + /_\ _ __ _ ____ ___ __(_) |_ ___ / __\ / / \_ \ + //_\\\| '_ \| '_ \ \ /\ / / '__| | __/ _ \ / / / / / /\/ + / _ \ |_) | |_) \ V V /| | | | || __/ / /___/ /___/\/ /_ + \_/ \_/ .__/| .__/ \_/\_/ |_| |_|\__\___| \____/\____/\____/ + |_| |_| "); + + $sdk = new SDK($language, new Swagger2($spec)); + + $sdk + ->setName('NAME') + ->setVersion('0.16.0') + ->setDescription('Repo description goes here') + ->setShortDescription('Repo short description goes here') + ->setURL('https://appwrite.io') + ->setLogo('https://appwrite.io/v1/images/console.png') + ->setLicense('BSD-3-Clause') + ->setLicenseContent('test test test') + ->setWarning('**WORK IN PROGRESS - NOT READY FOR USAGE**') + ->setChangelog('**CHANGELOG**') + ->setGitUserName('appwrite') + ->setGitRepoName('sdk-for-cli') + ->setTwitter('appwrite_io') + ->setDiscord('564160730845151244', 'https://appwrite.io/discord') + ->setDefaultHeaders([ + 'X-Appwrite-Response-Format' => '0.15.0', + ]); + + $sdk->generate(__DIR__ . '/examples/cli'); + } + + if (empty($sdks) || in_array('rest', $sdks)) { + // REST + $sdk = new SDK(new REST(), new Swagger2($spec)); + + $sdk + ->setName('NAME') + ->setDescription('Repo description goes here') + ->setShortDescription('Repo short description goes here') + ->setURL('https://example.com') + ->setLogo('https://appwrite.io/v1/images/console.png') + ->setLicenseContent('test test test') + ->setWarning('**WORK IN PROGRESS - NOT READY FOR USAGE**') + ->setChangelog('**CHANGELOG**') + ->setVersion('0.0.1') + ->setGitUserName('repoowner') + ->setGitRepoName('reponame') + ->setTwitter('appwrite_io') + ->setDiscord('564160730845151244', 'https://appwrite.io/discord'); + + $sdk->generate(__DIR__ . '/examples/REST'); + } + + if (empty($sdks) || in_array('graphql', $sdks)) { + // GraphQL + $sdk = new SDK(new GraphQL(), new Swagger2($spec)); + + $sdk + ->setName('GraphQL') + ->setDescription('Appwrite is an open-source backend as a service server that abstract and simplify complex and repetitive development tasks behind a very simple to use REST API. Appwrite aims to help you develop your apps faster and in a more secure way. Use the Flutter SDK to integrate your app with the Appwrite server to easily start interacting with all of Appwrite backend APIs and tools. For full API documentation and tutorials go to https://appwrite.io/docs') + ->setLogo('https://appwrite.io/v1/images/console.png'); + $sdk->generate(__DIR__ . '/examples/graphql'); + } + break; + case 'server': + if (empty($sdks) || in_array('php', $sdks)) { + // PHP + $php = new PHP(); + $php + ->setComposerVendor('appwrite') + ->setComposerPackage('appwrite'); + $sdk = new SDK($php, new Swagger2($spec)); + + $sdk + ->setName('NAME') + ->setDescription('Repo description goes here') + ->setShortDescription('Repo short description goes here') + ->setURL('https://example.com') + ->setLogo('https://appwrite.io/images/github.png') + ->setLicenseContent('test test test') + ->setWarning('**WORK IN PROGRESS - NOT READY FOR USAGE**') + ->setChangelog('**CHANGELOG**') + ->setGitUserName('repoowner') + ->setGitRepoName('reponame') + ->setTwitter('appwrite_io') + ->setDiscord('564160730845151244', 'https://appwrite.io/discord') + ->setDefaultHeaders([ + 'X-Appwrite-Response-Format' => '1.2.0', + ]); + + $sdk->generate(__DIR__ . '/examples/php'); + } + + if (empty($sdks) || in_array('deno', $sdks)) { + // Deno + $sdk = new SDK(new Deno(), new Swagger2($spec)); + + $sdk + ->setName('NAME') + ->setDescription('Repo description goes here') + ->setShortDescription('Repo short description goes here') + ->setVersion('0.0.0') + ->setURL('https://example.com') + ->setLogo('https://appwrite.io/v1/images/console.png') + ->setLicenseContent('test test test') + ->setWarning('**WORK IN PROGRESS - NOT READY FOR USAGE**') + ->setChangelog('**CHANGELOG**') + ->setGitUserName('repoowner') + ->setGitRepoName('reponame') + ->setTwitter('appwrite_io') + ->setDiscord('564160730845151244', 'https://appwrite.io/discord') + ->setDefaultHeaders([ + 'X-Appwrite-Response-Format' => '1.2.0', + ]); + + $sdk->generate(__DIR__ . '/examples/deno'); + } + if (empty($sdks) || in_array('node', $sdks)) { + // Node + $sdk = new SDK(new Node(), new Swagger2($spec)); + + $sdk + ->setName('NAME') + ->setDescription('Repo description goes here') + ->setShortDescription('Repo short description goes here') + ->setURL('https://example.com') + ->setLogo('https://appwrite.io/v1/images/console.png') + ->setLicenseContent('test test test') + ->setWarning('**WORK IN PROGRESS - NOT READY FOR USAGE**') + ->setChangelog('**CHANGELOG**') + ->setGitUserName('repoowner') + ->setGitRepoName('reponame') + ->setTwitter('appwrite_io') + ->setDiscord('564160730845151244', 'https://appwrite.io/discord') + ->setDefaultHeaders([ + 'X-Appwrite-Response-Format' => '1.2.0', + ]); + + $sdk->generate(__DIR__ . '/examples/node'); + } + + if (empty($sdks) || in_array('ruby', $sdks)) { + // Ruby + $sdk = new SDK(new Ruby(), new Swagger2($spec)); + + $sdk + ->setName('NAME') + ->setDescription('Repo description goes here') + ->setShortDescription('Repo short description goes here') + ->setURL('https://example.com') + ->setLogo('https://appwrite.io/v1/images/console.png') + ->setLicenseContent('test test test') + ->setWarning('**WORK IN PROGRESS - NOT READY FOR USAGE**') + ->setChangelog('**CHANGELOG**') + ->setGitUserName('repoowner') + ->setGitRepoName('reponame') + ->setTwitter('appwrite_io') + ->setDiscord('564160730845151244', 'https://appwrite.io/discord') + ->setDefaultHeaders([ + 'X-Appwrite-Response-Format' => '1.2.0', + ]); + + $sdk->generate(__DIR__ . '/examples/ruby'); + } + + if (empty($sdks) || in_array('python', $sdks)) { + // Python + $sdk = new SDK(new Python(), new Swagger2($spec)); + + $sdk + ->setName('NAME') + ->setDescription('Repo description goes here') + ->setShortDescription('Repo short description goes here') + ->setURL('https://example.com') + ->setLogo('https://appwrite.io/v1/images/console.png') + ->setLicenseContent('test test test') + ->setWarning('**WORK IN PROGRESS - NOT READY FOR USAGE**') + ->setChangelog('**CHANGELOG**') + ->setGitUserName('repoowner') + ->setGitRepoName('reponame') + ->setTwitter('appwrite_io') + ->setDiscord('564160730845151244', 'https://appwrite.io/discord') + ->setDefaultHeaders([ + 'X-Appwrite-Response-Format' => '1.2.0', + ]); + + $sdk->generate(__DIR__ . '/examples/python'); + } + + if (empty($sdks) || in_array('dart', $sdks)) { + // Dart + $dart = new Dart(); + $dart->setPackageName('dart_appwrite'); + + $sdk = new SDK($dart, new Swagger2($spec)); + + $sdk + ->setName('NAME') + ->setDescription('Repo description goes here') + ->setShortDescription('Repo short description goes here') + ->setURL('https://example.com') + ->setLogo('https://appwrite.io/v1/images/console.png') + ->setLicenseContent('test test test') + ->setWarning('**WORK IN PROGRESS - NOT READY FOR USAGE**') + ->setChangelog('**CHANGELOG**') + ->setExamples('**EXAMPLES** ') + ->setVersion('0.0.1') + ->setGitUserName('repoowner') + ->setGitRepoName('reponame') + ->setTwitter('appwrite_io') + ->setDiscord('564160730845151244', 'https://appwrite.io/discord') + ->setDefaultHeaders([ + 'X-Appwrite-Response-Format' => '1.2.0', + ]); + + $sdk->generate(__DIR__ . '/examples/dart'); + } + + if (empty($sdks) || in_array('go', $sdks)) { + // GO + + $sdk = new SDK(new Go(), new Swagger2($spec)); + + $sdk + ->setName('NAME') + ->setDescription('Repo description goes here') + ->setShortDescription('Repo short description goes here') + ->setURL('https://example.com') + ->setVersion('0.0.1') + ->setGitUserName('appwrite') + ->setGitRepoName('sdk-for-go') + ->setLogo('https://appwrite.io/v1/images/console.png') + ->setLicenseContent('test test test') + ->setWarning('**WORK IN PROGRESS - NOT READY FOR USAGE**') + ->setChangelog('**CHANGELOG**') + ->setTwitter('appwrite_io') + ->setDiscord('564160730845151244', 'https://appwrite.io/discord') + ->setDefaultHeaders([ + 'X-Appwrite-Response-Format' => '1.2.0', + ]); + + $sdk->generate(__DIR__ . '/examples/go'); + } + + if (empty($sdks) || in_array('swift', $sdks)) { + // Swift (Server) + $sdk = new SDK(new Swift(), new Swagger2($spec)); + + $sdk + ->setName('NAME') + ->setDescription('Repo description goes here') + ->setShortDescription('Repo short description goes here') + ->setURL('https://example.com') + ->setLogo('https://appwrite.io/v1/images/console.png') + ->setLicenseContent('test test test') + ->setWarning('**WORK IN PROGRESS - NOT READY FOR USAGE**') + ->setChangelog('**CHANGELOG**') + ->setVersion('0.0.1') + ->setGitUserName('repoowner') + ->setGitRepoName('reponame') + ->setTwitter('appwrite_io') + ->setDiscord('564160730845151244', 'https://appwrite.io/discord') + ->setDefaultHeaders([ + 'X-Appwrite-Response-Format' => '1.2.0', + ]); + + $sdk->generate(__DIR__ . '/examples/swift-server'); + } + + if (empty($sdks) || in_array('dotnet', $sdks)) { + // DotNet + $sdk = new SDK(new DotNet(), new Swagger2($spec)); + + $sdk + ->setName('NAME') + ->setDescription('Repo description goes here') + ->setShortDescription('Repo short description goes here') + ->setURL('https://example.com') + ->setLogo('https://appwrite.io/v1/images/console.png') + ->setLicenseContent('test test test') + ->setWarning('**WORK IN PROGRESS - NOT READY FOR USAGE**') + ->setChangelog('**CHANGELOG**') + ->setVersion('0.0.1') + ->setGitUserName('repoowner') + ->setGitRepoName('reponame') + ->setTwitter('appwrite_io') + ->setDiscord('564160730845151244', 'https://appwrite.io/discord') + ->setDefaultHeaders([ + 'X-Appwrite-Response-Format' => '1.2.0', + ]); + + $sdk->generate(__DIR__ . '/examples/dotnet'); + } + + if (empty($sdks) || in_array('rest', $sdks)) { + // REST + $sdk = new SDK(new REST(), new Swagger2($spec)); + + $sdk + ->setName('NAME') + ->setDescription('Repo description goes here') + ->setShortDescription('Repo short description goes here') + ->setURL('https://example.com') + ->setLogo('https://appwrite.io/v1/images/console.png') + ->setLicenseContent('test test test') + ->setWarning('**WORK IN PROGRESS - NOT READY FOR USAGE**') + ->setChangelog('**CHANGELOG**') + ->setVersion('0.0.1') + ->setGitUserName('repoowner') + ->setGitRepoName('reponame') + ->setTwitter('appwrite_io') + ->setDiscord('564160730845151244', 'https://appwrite.io/discord'); + + $sdk->generate(__DIR__ . '/examples/REST'); + } + + if (empty($sdks) || in_array('kotlin', $sdks)) { + // Kotlin + $sdk = new SDK(new Kotlin(), new Swagger2($spec)); + + $sdk + ->setName('Kotlin') + ->setNamespace('io appwrite') + ->setDescription('Appwrite is an open-source backend as a service server that abstract and simplify complex and repetitive development tasks behind a very simple to use REST API. Appwrite aims to help you develop your apps faster and in a more secure way. Use the Flutter SDK to integrate your app with the Appwrite server to easily start interacting with all of Appwrite backend APIs and tools. For full API documentation and tutorials go to https://appwrite.io/docs') + ->setShortDescription('Appwrite Kotlin SDK') + ->setURL('https://example.com') + ->setGitUserName('appwrite') + ->setGitRepoName('sdk-for-kotlin') + ->setLogo('https://appwrite.io/v1/images/console.png') + ->setLicenseContent('test test test') + ->setWarning('**This SDK is compatible with Appwrite server version 0.7.x. For older versions, please check previous releases.**') + ->setChangelog('**CHANGELOG**') + ->setVersion('0.0.0-SNAPSHOT') + ->setTwitter('appwrite_io') + ->setDiscord('564160730845151244', 'https://appwrite.io/discord') + ->setDefaultHeaders([ + 'x-appwrite-response-format' => '0.8.0', + ]); + $sdk->generate(__DIR__ . '/examples/kotlin'); + } + + if (empty($sdks) || in_array('graphql', $sdks)) { + // GraphQL + $sdk = new SDK(new GraphQL(), new Swagger2($spec)); + + $sdk + ->setName('GraphQL') + ->setDescription('Appwrite is an open-source backend as a service server that abstract and simplify complex and repetitive development tasks behind a very simple to use REST API. Appwrite aims to help you develop your apps faster and in a more secure way. Use the Flutter SDK to integrate your app with the Appwrite server to easily start interacting with all of Appwrite backend APIs and tools. For full API documentation and tutorials go to https://appwrite.io/docs') + ->setLogo('https://appwrite.io/v1/images/console.png'); + $sdk->generate(__DIR__ . '/examples/graphql'); + } + + break; + } +} catch (Exception $exception) { + echo 'Error: ' . $exception->getMessage() . ' on ' . $exception->getFile() . ':' . $exception->getLine() . "\n"; +} catch (Throwable $exception) { + echo 'Error: ' . $exception->getMessage() . ' on ' . $exception->getFile() . ':' . $exception->getLine() . "\n"; +} + +echo "Example SDKs generated successfully\n";