{"id":18406333,"url":"https://github.com/kipper-lang/kipper","last_synced_at":"2025-10-25T17:32:33.444Z","repository":{"id":37022121,"uuid":"411260595","full_name":"Kipper-Lang/Kipper","owner":"Kipper-Lang","description":"The Kipper programming language for Browsers and Node.js 🦊✨ Made at HTL Leonding \u0026 JKU Linz","archived":false,"fork":false,"pushed_at":"2025-04-06T05:53:06.000Z","size":15959,"stargazers_count":27,"open_issues_count":57,"forks_count":5,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-09T21:19:11.119Z","etag":null,"topics":["antlr4","cli","collaborate","compiler","hacktoberfest","javascript","kipper","language","nodejs","programming-lang","typescript"],"latest_commit_sha":null,"homepage":"https://kipper-lang.org","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Kipper-Lang.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":"CITATION.cff","codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2021-09-28T11:51:43.000Z","updated_at":"2025-03-27T08:32:08.000Z","dependencies_parsed_at":"2023-07-27T02:55:25.466Z","dependency_job_id":"a3e09b2f-4e40-4fcc-8b40-9a2ebd8ea5c4","html_url":"https://github.com/Kipper-Lang/Kipper","commit_stats":{"total_commits":2399,"total_committers":10,"mean_commits":239.9,"dds":"0.25719049604001665","last_synced_commit":"ae29c999321e85f6cb12569ac601491a1bc5ad95"},"previous_names":["kipper-lang/kipper","luna-klatzer/kipper"],"tags_count":73,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Kipper-Lang%2FKipper","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Kipper-Lang%2FKipper/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Kipper-Lang%2FKipper/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Kipper-Lang%2FKipper/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Kipper-Lang","download_url":"https://codeload.github.com/Kipper-Lang/Kipper/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248111973,"owners_count":21049578,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["antlr4","cli","collaborate","compiler","hacktoberfest","javascript","kipper","language","nodejs","programming-lang","typescript"],"created_at":"2024-11-06T03:08:18.622Z","updated_at":"2025-10-25T17:32:33.430Z","avatar_url":"https://github.com/Kipper-Lang.png","language":"TypeScript","readme":"![](./img/Kipper-Logo-with-head.png)\n\n# The Kipper programming language - `kipper` 🦊✨\n\n[![Version](https://img.shields.io/npm/v/kipper?label=npm%20stable\u0026color=%23cd2620\u0026logo=npm)](https://npmjs.org/package/kipper)\n[![Dev Version](https://img.shields.io/github/v/tag/Kipper-Lang/Kipper?include_prereleases\u0026label=dev\u0026logo=github\u0026sort=semver)](https://github.com/Kipper-Lang/Kipper/tags)\n[![codecov](https://codecov.io/gh/Kipper-Lang/Kipper/branch/main/graph/badge.svg?token=S4RQT7X3YP)](https://codecov.io/gh/Kipper-Lang/Kipper)\n[![Issues](https://img.shields.io/github/issues/Kipper-Lang/Kipper)](https://github.com/Kipper-Lang/Kipper/issues)\n[![License](https://img.shields.io/github/license/Kipper-Lang/Kipper?color=cyan)](https://github.com/Kipper-Lang/Kipper/blob/main/LICENSE)\n[![FOSSA Status](https://app.fossa.com/api/projects/git%2Bgithub.com%2FLuna-Klatzer%2FKipper.svg?type=shield)](https://app.fossa.com/projects/git%2Bgithub.com%2FLuna-Klatzer%2FKipper?ref=badge_shield)\n[![DOI](https://zenodo.org/badge/411260595.svg)](https://zenodo.org/badge/latestdoi/411260595)\n\nKipper is a JavaScript-like strongly and strictly typed language with Python flavour. It aims to provide\nstraightforward, simple, secure and type-safe coding with better efficiency and developer satisfaction! \nIntegrating strict type handling, runtime types, casts, among many other features, for a safer development experience!\n\nIt compiles to both JavaScript and TypeScript, and can be set up in your terminal, Node.js or ES6+ browser. 🦊💻\n\n_For more details, you can read more about this project in the sections [\"Goals \u0026 Planned Features\"](#goals--planned-features) and [\"Why Kipper?\"](#why-kipper-)._\n\n## General Information\n\n- Website: https://kipper-lang.org\n- Docs: https://docs.kipper-lang.org\n- Playground: https://play.kipper-lang.org\n- Issue Tracker: https://issues.kipper-lang.org\n- Roadmap: [View Kipper Roadmap 🦊🚧](https://github.com/Kipper-Lang/Kipper/discussions/139)\n- Changelog: [View CHANGELOG.md](https://github.com/Kipper-Lang/Kipper/blob/main/CHANGELOG.md)\n\n## Installation\n\nTo install the whole Kipper package with its CLI, run the following command:\n\n```bash\nnpm i kipper\n```\n\nIf you are using `pnpm` or `yarn`, use `pnpm i kipper` or `yarn add kipper`.\n\n## Project Packages\n\n- [`kipper`](https://www.npmjs.com/package/kipper): The Kipper compiler and API, which ships with all child packages.\n- [`@kipper/core`](https://www.npmjs.com/package/@kipper/core): The core implementation of the Kipper compiler.\n- [`@kipper/cli`](https://www.npmjs.com/package/@kipper/cli): The Kipper command line interface (CLI).\n- [`@kipper/web`](https://www.npmjs.com/package/@kipper/web): The standalone web-module for the Kipper compiler.\n- [`@kipper/target-js`](https://www.npmjs.com/package/@kipper/target-js): The JavaScript target for the Kipper\n  compiler.\n- [`@kipper/target-ts`](https://www.npmjs.com/package/@kipper/target-ts): The TypeScript target for the Kipper\n  compiler.\n\n## Goals \u0026 Planned Features\n\n_View the current implementation state in the [Kipper Roadmap 🦊🚧](https://github.com/Kipper-Lang/Kipper/discussions/139)._\n\n- Full compiler ensured type safety, by analysing and reporting code during compilation.\n- Duck typing type checking with TypeScript-like interface types for both compile and runtime.\n- Runtime type and type checking features, where original compile time type issues can be\n  resolved during runtime.\n- Strict cast and conversion handling, so that potentially or definitely problematic usage\n  is detected by the compiler and ensures the developer has to handle them.\n- Avoidance of `any` type issues, with ensurance of compiler checks that operations and data\n  access are valid.\n- Runtime errors and safety checks in case of incomplete or faulty typing. This should avoid\n  issues, such as \"TypeError: can't access property \"...\" of undefined\".\n- Null safety, by enforcing non-null types unless explicitly allowed.\n- Conversion behaviour functions in classes to customise conversion behaviour.\n- Operator overloading and additional customisation behaviour.\n- Type Conversion Overloading to customise conversion behaviour.\n- Full translation to/and integration with JavaScript and TypeScript.\n- Import Support for `.ts` files, as well as `.d.ts` + `.js` files.\n- Translation support for all ES versions as far as ES6 (JavaScript target specific)\n\n## How to use Kipper?\n\nTo use Kipper you have three options:\n\n- Run it in the browser using the CDN [`kipper-standalone.min.js`](https://cdn.jsdelivr.net/npm/@kipper/web@latest/kipper-standalone.min.js) file, which bundles the entire compiler\n  for your browser.\n- Run it using the NodeJS CLI [`@kipper/cli`](https://www.npmjs.com/package/@kipper/cli).\n- Import the package [`@kipper/core`](https://www.npmjs.com/package/@kipper/core) in NodeJS or Deno.\n\n### In a browser with `@kipper/web` 🦊🌐\n\nFor running Kipper in the browser, you will have to include the `kipper-standalone.js` file, which\nprovides the Kipper Compiler for the browser and enables the compilation of Kipper code to JavaScript.\n\nSimple example of compiling and running Kipper code in a browser:\n\n```html\n\u003c!-- Kipper dependency --\u003e\n\u003cscript src=\"https://cdn.jsdelivr.net/npm/@kipper/web@latest/kipper-standalone.min.js\"\u003e\u003c/script\u003e\n\n\u003c!-- You won't have to define Kipper or anything after including the previous file. It will be defined per default  --\u003e\n\u003c!-- with the global 'Kipper' --\u003e\n\u003cscript type=\"module\"\u003e\n\t// Define your own logger and compiler, which will handle the compilation\n\tconst logger = new Kipper.KipperLogger((level, msg) =\u003e {\n\t\tconsole.log(`[${Kipper.getLogLevelString(level)}] ${msg}`);\n\t});\n\t// Define your own compiler with your wanted configuration\n\tconst compiler = new Kipper.KipperCompiler(logger);\n\n\t// Compile the code to JavaScript\n\t// Top-level await ref: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Operators/await#top_level_await\n\tconst result = await compiler.compile(`call print(\"Hello world!\");`, {\n\t\ttarget: new KipperJS.TargetJS(),\n\t});\n\tconst jsCode = result.write();\n\n\t// Finally, run your program\n\teval(jsCode);\n\u003c/script\u003e\n```\n\n### Locally using Node.js with `@kipper/cli` 🦊🖥️\n\nThis is to recommend way to use Kipper if you want to dive deeper into Kipper, as it allows you to locally use and run\nkipper, without depending on a browser.\n\nFor example:\n\n- Compiling a Kipper program:\n  ```bash\n  kipper compile file.kip\n  ```\n- Executing a Kipper program using Node.js:\n  ```bash\n  kipper run file.kip\n  ```\n\nThis also enables the usage of Kipper files with the `.kip` extension, which can be read and compiled to TypeScript,\nwithout having to configure anything yourself. This also allows the input of data over the\nconsole and file-interactions, which are not supported inside a browser.\n\nFor more info go to the [`@kipper/cli` README](https://github.com/Kipper-Lang/Kipper/blob/main/kipper/cli/README.md).\n\n### Locally in your own code with `@kipper/core` 🦊⌨️\n\nThis is the recommended way if you intend to use kipper in a workflow or write code yourself to manage\nthe compiler. This also allows for special handling of logging and customising the compilation process.\n\nSimple example of using the Kipper Compiler in Node.js:\n\n- JavaScript (CommonJS):\n\n  ```js\n  const fs = require(\"fs\").promises;\n  const kipper = require(\"@kipper/core\");\n  const kipperJS = require(\"@kipper/target-js\");\n\n  const path = \"INSERT_PATH\";\n  fs.readFile(path, \"utf8\").then(async (fileContent) =\u003e {\n  \tconst compiler = new kipper.KipperCompiler();\n\n  \t// Compile the code string or stream\n  \tlet result = await compiler.compile(fileContent, { target: new kipperJS.TargetJS() });\n  \tlet jsCode = result.write();\n\n  \t// Running the Kipper program\n  \teval(jsCode);\n  });\n  ```\n\n- TypeScript (CommonJS):\n\n  ```ts\n  import { promises as fs } from \"fs\";\n  import { KipperCompiler } from \"@kipper/core\";\n  import { TargetJS } from \"@kipper/target-js\";\n\n  const path = \"INSERT_PATH\";\n  fs.readFile(path, \"utf8\" as BufferEncoding).then(async (fileContent: string) =\u003e {\n  \tconst compiler = new KipperCompiler();\n\n  \t// Compile the code string or stream\n  \tlet result = await compiler.compile(fileContent, { target: new TargetJS() });\n  \tlet jsCode = result.write();\n\n  \t// Running the Kipper program\n  \teval(jsCode);\n  });\n  ```\n\n## Why Kipper? 🦊❓\n\n_Skip this section, if you are not interested in the details behind Kipper and this\nproject. It is not required knowledge for using or trying out Kipper._\n\nThe primary reason for the development of Kipper is the simplification of the development process for developers, both\nin the web and server-side space, by improving on common type and non-type-related issues. Through this, the language\nshould help developers fix those issues more reliably and quickly.\n\nTherefore, this programming language, like TypeScript, aims to provide more safety and functionality using, among other\nthings, compile-time error checking and transpilation. This primarily relies on the addition of types and type checking,\nas a way to ensure that programs work as intended and that developers can discover errors before they run their code.\n\nTypeScript already does a great job at this, so why is Kipper needed and how does it do things differently? TypeScript is\nan amazing language, which is why Kipper has many of its designs and features similarly implemented. A big issue\nthat TypeScript can't detect and properly resolve is the issue of inconsistent or non-determined typing. This is a\nfundamental issue when working with dynamic data or JavaScript code in TypeScript, where types are unknown or can't be\nknown before runtime. TypeScript is unable to work with this code appropriately and requires the user to make\nassumptions about its types at compile-time. This leads to many issues where the compiler is unable to check for many\npotential issues and is often largely turned off, as the developers themselves are required to decide what is correct\nand often make serious mistakes in the process, causing code to become unpredictable and error-prone during execution.\nEven with runtime-bound `instanceof` and `typeof` checks, it becomes a tedious effort that often results in more errors,\ndue to issues arising while trying to fix the original problems.\n\nKipper therefore tries to implement a standardised way to easily solve those issues, by providing consistent compile- and\nruntime types, type checks, and error handling. This means the compiler will be there to assist the developer both during\ncompile time and runtime, extending its capabilities of ensuring code is secure and providing methods for developers to handle\nthem in a consistent and easy-to-understand way. This also means functionality like casts or conversions is more\nstrictly handled and doesn't overwrite type-checking behaviour. Even so, Kipper will always try not to be invasive,\nand developers can choose during development time how to handle different cases and how Kipper should handle them during\nruntime.\n\nUsing this approach, Kipper will add many features developers know from other languages, such as:\n- Runtime Casting\n- Runtime Type Casting\n- Pattern Matching\n- Consistent Typing and Compile Time Cast Checks\n- Custom Runtime Types\n\nBeyond this, there is a whole paper illustrating the design, implementation and reasons behind Kipper, which can be found at\n\u003ca href=\"https://raw.githubusercontent.com/Kipper-Lang/Thesis/refs/heads/main/Kipper-Thesis-2025-04-08.pdf\"\u003e\"Kipper - Programming Language for Improved Runtime Type-Safety\"\u003c/a\u003e (written in English,\nwith additional German oath and abstract).\n\n## Contributing to Kipper\n\nIf you want to contribute to Kipper, we have a full guide explaining the structure of Kipper and how to use GitHub\nissues and pull requests. Check it out [here](https://github.com/Kipper-Lang/Kipper/blob/main/CONTRIBUTING.md)!\n\nIf you have any questions or concerns, you can open up a discussion page [here](https://github.com/Kipper-Lang/Kipper/discussions)!\n\nWe appreciate any feedback or help! Kipper is open-source and free for anyone, help us make it even better! 🦊❤️\n\n## Copyright and License\n\n![License](https://img.shields.io/github/license/Kipper-Lang/Kipper?color=cyan)\n[![FOSSA Status](https://app.fossa.com/api/projects/git%2Bgithub.com%2FLuna-Klatzer%2FKipper.svg?type=shield)](https://app.fossa.com/projects/git%2Bgithub.com%2FLuna-Klatzer%2FKipper?ref=badge_shield)\n\nCopyright (C) 2021-2024 Luna Klatzer\n\nThis program is free software: you can redistribute it and/or modify it under\nthe terms of the GNU General Public License as published by the Free Software\nFoundation, either version 3 of the License, or\n(at your option) any later version.\n\nThis program is distributed in the hope that it will be useful, but WITHOUT ANY\nWARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A\nPARTICULAR PURPOSE. See the GNU General Public License for more details.\n\nYou should have received a copy of the GNU General Public License along with\nthis program. If not, see \u003chttps://www.gnu.org/licenses/\u003e.\n\nSee the [LICENSE](https://raw.githubusercontent.com/Kipper-Lang/Kipper/main/LICENSE)\nfor information on terms \u0026 conditions for usage.\n\n### FOSSA License Report\n\n[![FOSSA Status](https://app.fossa.com/api/projects/git%2Bgithub.com%2FLuna-Klatzer%2FKipper.svg?type=large)](https://app.fossa.com/projects/git%2Bgithub.com%2FLuna-Klatzer%2FKipper?ref=badge_large)\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkipper-lang%2Fkipper","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkipper-lang%2Fkipper","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkipper-lang%2Fkipper/lists"}