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 (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

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

: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} 🐛
_{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 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!

:balance_scale: License

jsii is distributed under the Apache License, Version 2.0.

See LICENSE and NOTICE for more information.

Release files for jsii 1.85.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for jsii 1.85.0
File	Size	Uploaded
jsii-1.85.0.tar.gz	593.9 kB	Jul 17, 2023	Details

Built distribution (wheel)

Table of built distributions (wheels) for jsii 1.85.0
File	Interpreter	ABI	Platform	Reset
jsii-1.85.0-py3-none-any.whl 574.0 kB Jul 17, 2023	Python 3	none	any	Details

Total release size: 1.2 MB

Release files / jsii-1.85.0.tar.gz

Download URL	jsii-1.85.0.tar.gz
Size	593.9 kB
Tags	Source
SHA-256 checksum How to use checksums	`b77194cf053c06c6bdffc887a4d1d2a41113c6f4780a7d78d70a780a70998008`
BLAKE2b-256 checksum How to use checksums	`98b3699448aa0995b063c6bc944265b0a5cd436eb4a42aefdd1fcff58ef988dd`
Upload date	Jul 17, 2023
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/4.0.2 CPython/3.11.2`

Release files / jsii-1.85.0-py3-none-any.whl

Download URL	jsii-1.85.0-py3-none-any.whl
Size	574.0 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`379feb1a1a3c4e449307564f42a7cddef05e43760cbfbbfe8434f6448cd668a0`
BLAKE2b-256 checksum How to use checksums	`6910f3208b42c86b390e6b1c6300ed9ddbb19977e86ed4d363fcdfe0422c554d`
Upload date	Jul 17, 2023
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/4.0.2 CPython/3.11.2`