Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/awslabs/jsii

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!
https://github.com/awslabs/jsii

aws cross-language node typescript

Last synced: 3 months ago
JSON representation

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!

Host: GitHub
URL: https://github.com/awslabs/jsii
Owner: aws
License: apache-2.0
Created: 2017-10-04T18:23:37.000Z (about 7 years ago)
Default Branch: main
Last Pushed: 2024-04-22T12:20:42.000Z (7 months ago)
Last Synced: 2024-04-22T12:51:18.647Z (7 months ago)
Topics: aws, cross-language, node, typescript
Language: TypeScript
Homepage: https://aws.github.io/jsii
Size: 204 MB
Stars: 2,553
Watchers: 44
Forks: 240
Open Issues: 167
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md

Awesome Lists containing this project

awesome-cdk - jsii - JavaScript interop interface, the technology that CDK uses to create language bindings (currently supports .NET, Java and Python). (Related Projects / Multi-accounts setup)
awesome-cdk - jsii - JavaScript interop interface, the technology that CDK uses to create language bindings (currently supports .NET, Java and Python). (Related Projects / Multi-accounts setup)

README

        # ![jsii](./logo/png/128.png)

[![Join the chat at https://cdk.Dev](https://img.shields.io/static/v1?label=Slack&message=cdk.dev&color=brightgreen&logo=slack)](https://cdk.dev)

[![All Contributors](https://img.shields.io/github/all-contributors/aws/jsii/main?label=%E2%9C%A8%20All%20Contributors)](#contributors-)

[![Build Status](https://github.com/aws/jsii/workflows/Main/badge.svg)](https://github.com/aws/jsii/actions?query=workflow%3AMain+branch%3Amain)

[![npm](https://img.shields.io/npm/v/jsii?logo=npm)](https://www.npmjs.com/package/jsii)

[![docker](https://img.shields.io/badge/Docker-public.ecr.aws%2Fjsii%2Fsuperchain-brightgreen?logo=docker)](https://gallery.ecr.aws/jsii/superchain)

## Overview

`jsii` allows code in any language to naturally interact with JavaScript classes. It is the technology that enables the

[AWS Cloud Development Kit][cdk] to deliver polyglot libraries from a single codebase!

[cdk]: https://github.com/aws/aws-cdk

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](https://aws.github.io/jsii)!

The jsii toolchain is spread out on multiple repositories:

- [aws/jsii-compiler](https://github.com/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](https://github.com/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](https://github.com/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][mbonig-2020-01-11], by [Matthew Bonig][@mbonig]

- **2020-05-27:**  [Generate Python, Java, and .NET software libraries from a TypeScript

  source][floydpink-2020-05-27], by [Hari Pachuveetil][@floydpink]

- **2020-12-23:**  [How the jsii open source framework meets developers where they are

  ][romain-2020-12-23], by [Romain Marcadier][@RomainMuller]

[mbonig-2020-01-11]: https://www.matthewbonig.com/2020/01/11/creating-constructs/

[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/

[@mbonig]: http://www.matthewbonig.com/

[@floydpink]: https://harimenon.com/

[@romainmuller]: https://github.com/RomainMuller

> :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](./CONTRIBUTING.md).

## Contributors ✨

Thanks goes to these wonderful people ([emoji key](https://allcontributors.org/docs/en/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](https://github.com/all-contributors/all-contributors) specification.

Contributions of any kind welcome!

## :balance_scale: License

**jsii** is distributed under the [Apache License, Version 2.0][apache-2.0].

See [LICENSE](./LICENSE) and [NOTICE](./NOTICE) for more information.

[apache-2.0]: https://www.apache.org/licenses/LICENSE-2.0