Overview

jsii allows code in any language to naturally interact with JavaScript classes. It is the technology that enables the AWS Cloud Development Kit to deliver polyglot libraries from a single codebase!

A class library written in TypeScript can be used in projects authored in TypeScript or Javascript (as usual), but also in Python, Java, C# (and other languages from the .NET family), ...

:question: Documentation

Head over to our documentation website!

The jsii toolchain is spread out on multiple repositories:

• aws/jsii-compiler is where the jsii compiler is maintained
• aws/jsii-rosetta is where the jsii-rosetta sample code transliteration tool is maintained
• aws/jsii is where the rest of the toolchain is maintained, including:
  • The jsii runtime libraries for the supported jsii target languages
  • @jsii/spec, the package that defines the .jsii assembly specification
  • jsii-pacmak, the bindings generator for jsii packages
  • jsii-reflect, a higher-level way to process .jsii assemblies
  • jsii-config, an interactive tool to help configure your jsii package

:book: Blog Posts

Here's a collection of blog posts (in chronological order) related to jsii:

• 2020-01-11: How to Create CDK Constructs, by Matthew Bonig
• 2020-05-27: [Generate Python, Java, and .NET software libraries from a TypeScript source][floydpink-2020-05-27], by Hari Pachuveetil
• 2020-12-23: [How the jsii open source framework meets developers where they are][romain-2020-12-23], by Romain Marcadier

[floydpink-2020-05-27]: https://aws.amazon.com/fr/blogs/opensource/generate-python-java-dotnet-software-libraries-from-typescript-source/ [romain-2020-12-23]: https://aws.amazon.com/blogs/opensource/how-the-jsii-open-source-framework-meets-developers-where-they-are/

:information_source: If you wrote blog posts about jsii and would like to have them referenced here, do not hesitate to file a pull request to add the links here!

:gear: Contributing

See CONTRIBUTING.

Contributors ✨

Thanks goes to these wonderful people (emoji key):

AWS CDK Automation 🚧 👀	Aaron Costley 🐛 💻 🤔 👀	Abdallah Hodieb 🐛	Adam Ruka 🐛 💻 🚧 👀	Adrian Dimech 💻	Adrian Hesketh 💻	Alex Pulver 🐛
Amir Szekely 🚧	Andi Pabst 🐛	Andrew Wason 🐛 💻	André Fontenele 💻	Andy Slezak 💻	Ansgar Mertens 🚧 💻 🐛	Anshul Guleria 🤔
Ari Palo 🤔	Armaan Tobaccowalla 🐛	Bartłomiej Jurek 🐛	Ben Bridts 📖	Ben Chaimberg 📖	Ben Farr 📖	Ben Walters 🤔
Benjamin Macher 📖	Benjamin Maizels 💻 👀	Bervianto Leo Pratama 🚧	Bill Cauchois 🤔	Bradley Sherman 💻	Brecht Verhoeve 🤔	Breland Miley 💻
CaerusKaru 💻 🚧	Calvin Combs 💻 👀	Camilo Bermúdez 🐛	Campion Fellin 💻	Carter Van Deuren 🐛	Chris Garvis 📖	Christian Moore 🐛
Christophe Vico 🐛	Christopher Currie 💻 🤔	Christopher Rybicki 📖 🐛 💻	Colin Francis 🚧	CommanderRoot 💻	Cory Hall 🐛	Cristian Măgherușan-Stanciu 🐛
CyrusNajmabadi 🐛 🤔	Damian Silbergleith 💻 🐛	Daniel Dinu 🐛 💻	Daniel Schmidt 🐛 💻	Daniel Schroeder 🐛 💻 📖 🤔 🚧	Dave Slotnick 🐛	David Bell 💻
Donald Stufft 🐛 💻 🤔 👀	Dongie Agnir 💻 👀	Eduardo Rabelo 📖	Eduardo Sena S. Rosa 🐛	Elad Ben-Israel 🐛 💻 🤔 🚧 👀 📢	Eli Polonsky 🐛 💻 🤔 🚧 👀	Eric Carboni 📖
Eric Z. Beard 📆	Erik Karlsson 🐛	Eugene Kozlov 💻	Fabio Gentile 🐛	Florian Eitel 🤔	Glib Shpychka 🐛	Graham Lea 🤔 👀
Greg Lucas 💻	Hamza Assyad 🐛 💻 🤔 👀	Hari Pachuveetil 📝 📖	Hirotaka Tagawa / wafuwafu13 💻	Hsing-Hui Hsu 💻 📖 🤔 👀	Huy Phan (Harry) 💻	Ikko Ashimine 📖
James 🐛 💻	James Kelley 🐛	James Mead 💻	James Siri 💻 🚧	Jason Del Ponte 🤔 👀	Jason Fulghum 🤔 📆 👀	Jeff Malins 💻
Jerry Kindall 📖 🤔	Jimmy Gaussen 🤔	Johannes Weber 📖	John Pantzlaff 💻	Jon Day 💻	Jon Steinich 🐛 🤔 💻	Joseph Lawson 👀
Joseph Martin 🐛	Junix 🐛	Justin Frahm 🐛	Justin Taylor 🐛	Kaizen Conroy 💻 🐛	Kaizen Conroy 💻	Kaushik Borra 🐛
Kendra Neil 🚧	Knut O. Hellan 🐛	Kyle Thomson 💻 👀	Leandro Padua 🐛	Liang Zhou 🐛 💻	Madeline Kusters 💻 🐛	Maja S Bratseth 🐛
Marcos Diez 🐛	Mark Nielsen 💻	Matthew Bonig 🐛 📝	Matthew Pirocchi 💻 🤔 👀	Meng Xin Zhu 🐛	Michael Neil 🚧	Mike Lane 🐛
Mitch Garnaat 🐛 💻 🤔 👀	Mitchell Valine 🐛 💻 🤔 🚧 👀	Mohamad Soufan 📖	Mohamed Elasmar 💻	Momo Kornher 💻	Mykola Mogylenko 🐛	Naumel 👀
Neta Nir 💻 🤔 🚧 👀	Nick Lynch 🐛 💻 🚧 👀	Niranjan Jayakar 🐛 💻 🤔 🚧 👀	Noah Litov 💻 🚧 👀	Otavio Macedo 💻 🐛	PIDZ - Bart 🤔	Pahud Hsieh 💻
Peter Woodworth 🚧	Petr Kacer 🐛	Petra Barus 💻	Philip Cali 🤔	Quentin Loos 🤔	Raphael 🐛	Richard H Boyd 🐛
Rico Huijbers 🐛 💻 🤔 🚧 👀	Romain Marcadier 🐛 💻 🎨 🤔 🚧 👀 📝	Ryan Parker 💻	SADIK KUZU 👀	SK 🤔	Sam Fink 💻 👀	Sam Goodwin 👀
Sebastian Korfmann 🐛 💻 🤔	Sepehr Laal 🐛	Shailja Khurana 🚧	Shane Witbeck 🤔	Shiv Lakshminarayan 💻 🚧 👀	Somaya 💻 🤔 🚧 👀	Stephen Kuenzli 📖
Takahiro Sugiura 📖	The Gitter Badger 💻 🚧	Thomas Poignant 🐛	Thomas Steinbach 🐛	Thorsten Hoeger 💻	Tim Wagner 🐛 🤔	Timothy Jones 🐛
Tobias Lidskog 💻	Tom Bonner 🐛	Tom Keller 🚧	Ty Coghlan 🐛	Tyler van Hensbergen 🤔	Vinayak Kukreja 💻	Vlad Hrybok 🐛
Vladimir Shchur 🐛	Will Bender 🐛	Yan Zhulanow 💻	Yathi 💻	Yigong Liu 🐛 🤔	Zach Bienenfeld 🐛	ajnarang 🤔
andyan 📖	aniljava 💻	arnogeurts-sqills 🐛 💻	cn-cit 🐛	deccy-mcc 🐛	dependabot-preview[bot] 🐛 🚧	dependabot[bot] 🚧
dheffx 🐛	gregswdl 🐛	guyroberts21 📖	mattBrzezinski 📖	mergify 🚧	mergify[bot] 🚧	nathannaveen 🚧
seiyashima42 🐛 💻 📖	sullis 💻	vaneek 🐛	wendysophie 🐛	ysuzuki19 📖

This project follows the all-contributors specification. Contributions of any kind welcome!

:balance_scale: License

jsii is distributed under the Apache License, Version 2.0.

See LICENSE and NOTICE for more information.