Folders and files

Name		Name	Last commit message	Last commit date
Latest commit History 5,856 Commits
.github		.github
mock-server		mock-server
src		src
templates		templates
tests		tests
.gitignore		.gitignore
CODE_OF_CONDUCT.md		CODE_OF_CONDUCT.md
CONTRIBUTING.md		CONTRIBUTING.md
LICENSE.md		LICENSE.md
README.md		README.md
composer.json		composer.json
composer.lock		composer.lock
example.php		example.php
package-lock.json		package-lock.json
phpcs.xml		phpcs.xml
phpunit.xml		phpunit.xml

Repository files navigation

⚙️ Appwrite SDK Generator

WORK IN PROGRESS - NOT READY FOR GENERAL USAGE

Appwrite SDK generator is a PHP library for auto-generating SDK libraries for multiple languages and platforms.

The SDK Generator uses predefined language settings asTwig templates to generate codebases based on different API specs.

Currently, the only spec supported is Swagger 2.0, but we intend to add support for more specifications in the near future. This generator is still lacking support for any definition/model specs.

Getting Started

Install using composer:

CLI

composer update --ignore-platform-reqs --optimize-autoloader

Docker (UNIX)

docker run --rm --interactive --tty --volume"$(pwd)":/app composer install --ignore-platform-reqs

Docker (Windows)

docker run --rm --interactive --tty --volume"%cd%":/app composer install --ignore-platform-reqs

Create language and SDK instances and generate code to target directory.

<?phprequire_once'vendor/autoload.php';useAppwrite\Spec\Swagger2;useAppwrite\SDK\SDK;useAppwrite\SDK\Language\PHP;// Read API specification file (Swagger 2) and create spec instance$spec =newSwagger2(file_get_contents('https://appwrite.io/v1/open-api-2.json?extension=1'));// Create language instance$lang =newPHP();$lang// Set language or platform specific options    ->setComposerPackage('my-api')    ->setComposerVendor('my-company');// Create the SDK object with the language and spec instances$sdk  =newSDK($lang,$spec);$sdk    ->setLogo('https://appwrite.io/v1/images/console.png')    ->setLicenseContent('License content here.')    ->setVersion('v1.1.0');$sdk->generate(__DIR__ .'/examples/php');// Generate source code

Supported Specs

Swagger 2
OpenAPI 3 (Not Ready)
RAML 1.0 (Not Ready)
RAML 0.8 (Not Ready)
Postman 2.0 (Not Ready)
Postman 1.0 (Not Ready)
API Blueprint 1A (Not Ready)

Supported Client / Platform SDKs

Language	Supported Versions	Coding Standards	Package Manager	Maintainer
Web	ES5+	NPM Coding Style	NPM, Yarn,	@eldadfux
Flutter		Effective Dart	pub tool	@bartektartanus @Almoullim @lohanidamodar
Android (Kotlin, Java)	5.0+	Android style guide	Gradle, Maven	@abnegate
iOS, macOS (Swift)	iOS 15+, macOS 11+	Swift Style Guide	Swift Pkg Manager	@abnegate
Unity (Csharp)			?	You?

Supported Server SDKs

Language	Supported Versions	Coding Standards	Package Manager	Contributors
TypeScript		NPM Coding Style	NPM, Yarn	@eldadfux
NodeJS	8, 10, 12	NPM Coding Style	NPM, Yarn	@eldadfux
PHP	7.0+	PHP FIG	Composer	@eldadfux
Ruby	2.4+	Ruby Style Guide	GEM	@eldadfux @abnegate
Python	3.5+	PEP8	PIP	@eldadfux @abnegate
Dart	2.7+	Effective Dart	pub	@lohanidamodar
Go		Effective Go	go get	@panz3r [@phaus]
.NET	.NET core 3.1	C# Coding Conventions	NuGet	@komemi @TorstenDittmann
D			?	You?
Kotlin	1.4.31+	Kotlin style guide	Gradle, Maven	@abnegate
Java	8+	Google style guide	Gradle, Maven	@abnegate
Swift	5.5+	Swift Style Guide	Swift Pkg Manager	@abnegate
Docker CLI			Docker Hub	@christyjacob4

Contributing

All code contributions, including those by people with commit access, must go through a pull request and be approved by a core developer before being merged. This is to ensure proper review of all the code.

We truly ❤️ pull requests! If you wish to help, you can learn more about how you can contribute to this project in thecontribution guide.