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), ...

❓ 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 (except releases in the 1.x line, which are maintained in this repository)
• aws/jsii-rosetta is where the jsii-rosetta sample code transliteration tool is maintained (except releases in the 1.x line, which are maintained in this repository)
• aws/jsii is where the rest of the toolchain is maintained, including:
  • @jsii/spec, the package that defines the .jsii assembly specification
  • jsii-config, an interactive tool to help configure your jsii package
  • jsii-pacmak, the bindings generator for jsii packages
  • jsii-reflect, a higher-level way to process .jsii assemblies
  • The jsii runtime libraries for the supported jsii target languages
  • 1.x release lines of jsii and jsii-rosetta

📖 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, by Hari Pachuveetil
• 2020-12-23: How the jsii open source framework meets developers where they are , by Romain Marcadier

ℹ️ 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!

⚙️ 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 🐛
Andi Pabst 🐛	Andrew Wason 🐛 💻	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 🤔	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 📖 🐛 💻
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 Z. Beard 📆	Erik Karlsson 🐛	Eugene Kozlov 💻	Fabio Gentile 🐛	Florian Eitel 🤔
Glib Shpychka 🐛	Graham Lea 🤔 👀	Greg Lucas 💻	Hamza Assyad 🐛 💻 🤔 👀	Hari Pachuveetil 📝 📖	Hsing-Hui Hsu 💻 📖 🤔 👀	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 🐛
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 📖	Mykola Mogylenko 🐛	Naumel 👀	Neta Nir 💻 🤔 🚧 👀	Nick Lynch 🐛 💻 🚧 👀	Niranjan Jayakar 🐛 💻 🤔 🚧 👀
Noah Litov 💻 🚧 👀	Otavio Macedo 💻 🐛	PIDZ - Bart 🤔	Peter Woodworth 🚧	Petr Kacer 🐛	Petra Barus 💻	Philip Cali 🤔
Quentin Loos 🤔	Raphael 🐛	Richard H Boyd 🐛	Rico Huijbers 🐛 💻 🤔 🚧 👀	Romain Marcadier 🐛 💻 🎨 🤔 🚧 👀 📝	SADIK KUZU 👀	SK 🤔
Sam Fink 💻 👀	Sam Goodwin 👀	Sebastian Korfmann 🐛 💻 🤔	Sepehr Laal 🐛	Shane Witbeck 🤔	Shiv Lakshminarayan 💻 🚧 👀	Somaya 💻 🤔 🚧 👀
Stephen Kuenzli 📖	Takahiro Sugiura 📖	The Gitter Badger 💻 🚧	Thomas Poignant 🐛	Thomas Steinbach 🐛	Thorsten Hoeger 💻	Tim Wagner 🐛 🤔
Tobias Lidskog 💻	Tom Bonner 🐛	Ty Coghlan 🐛	Tyler van Hensbergen 🤔	Vlad Hrybok 🐛	Vladimir Shchur 🐛	Will Bender 🐛
Yan Zhulanow 💻	Yigong Liu 🐛 🤔	Zach Bienenfeld 🐛	ajnarang 🤔	aniljava 💻	arnogeurts-sqills 🐛 💻	cn-cit 🐛
deccy-mcc 🐛	dependabot-preview[bot] 🐛 🚧	dependabot[bot] 🚧	dheffx 🐛	gregswdl 🐛	guyroberts21 📖	mattBrzezinski 📖
mergify 🚧	mergify[bot] 🚧	nathannaveen 🚧	seiyashima42 🐛 💻 📖	sullis 💻	vaneek 🐛	wendysophie 🐛

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

⚖️ License

jsii is distributed under the Apache License, Version 2.0.

See LICENSE and NOTICE for more information.