https://github.com/matchbook-ts/matchbook-ts
pattern matching in javascript & typescript made easy
https://github.com/matchbook-ts/matchbook-ts
ava declarative declarative-programming easy functional functional-programming functions javascript library matchbook no-dependencies package pattern-matching reactive-programming simple small tiny tiny-library ts typescript
Last synced: 6 months ago
JSON representation
pattern matching in javascript & typescript made easy
- Host: GitHub
- URL: https://github.com/matchbook-ts/matchbook-ts
- Owner: matchbook-ts
- License: mit
- Created: 2020-04-13T05:14:34.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2023-01-06T03:17:49.000Z (almost 3 years ago)
- Last Synced: 2025-03-31T03:15:21.009Z (7 months ago)
- Topics: ava, declarative, declarative-programming, easy, functional, functional-programming, functions, javascript, library, matchbook, no-dependencies, package, pattern-matching, reactive-programming, simple, small, tiny, tiny-library, ts, typescript
- Language: TypeScript
- Homepage: https://matchbook-ts.github.io/matchbook-ts/docs/
- Size: 10.2 MB
- Stars: 34
- Watchers: 1
- Forks: 0
- Open Issues: 14
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 🔥 matchbook
## pattern matching in typescript & javascript made easy
matchbook is a lightweight & easy to use pattern matching library,
for TypeScript and JavaScript.
If you want to know more about matchbook,
[check out the docs][api_docs] or [read on](#table-of-contents)!
If you want to start using matchbook, install it like any other npm package:
`npm i @matchbook/ts`
---
### badges
|npm |code |other|
|--- |--- |---|
|[![npm version][npm_ver_badge]][npm_link] |![top lang][lang_badge] |[![build][build_badge]][build_link]|
|[![pkg size][npm_size_badge]][npm_link] |[![google typescript style][gts_badge]][gts_url] |![license][license_badge]|
|[![source rank][source_rank_badge]][libraries_io] |[![codacy][codacy_badge]][codacy_link] | |
| |[![codecov][codecov_badge]][codecov_link] | |
## table of contents
- [what matchbook does for you](#what-matchbook-does-for-you)
- [what you can do for matchbook](#what-you-can-do-for-matchbook)
- [pattern matching explained](#pattern-matching-explained)
- [matchbook at a glance](#matchbook-at-a-glance)
- [matchbook at a slightly longer glance (examples)](#matchbook-at-a-slightly-longer-glance)
- [switching on part of an object](#switching-on-part-of-an-object)
- [switching on an `enum`](#switching-on-an-enum)
- [acting on the type of an Event](#acting-on-the-type-of-an-event)
- [matching if a value is an `instanceof` a constructor](#matching-if-a-value-is-an-instanceof-a-constructor)
## what matchbook does for you
_(list is in no particular order)_
- **expressive** - pattern matching helps you write **less code** that's **more expressive** than if/else trees
- **simple** - API is just 5 functions, 1 error class, and some stylistic aliases for the core functions
- **powerful** - type inference backed by Typescript
- **well documented** - [check out the docs here!][api_docs]
- **low cost** - no runtime dependencies, & small package size
- **reliable** - 100% unit test coverage, with all pushes verified via Travis CI
## what you can do for matchbook
### use it!
The project is very minimal, with the intent of starting with a very simple & focused API
that grows with its needs.
### ask questions!
If you have any questions, any feedback, or just want to shoot the shirt,
[open an issue][new_issue] of type `question`, and we'll do our best to answer quickly!
## pattern matching explained
Pattern matching is a modern language feature that is similar to a `switch` / `case` statement.
With pattern matching, you can switch on the _type_ of the incoming value,
meaning you can reduce a lot of extra-verbose if-else branches just by
replacing them with pattern matching statements.
You might consider using pattern matching if you find you're switching on types
or states frequently, and want to handle the different cases in a
concise and expressive way.
This project takes heavy inspiration from [Rust's pattern matching idiom][rust_match].
## matchbook at a glance
want to know more? [read the docs][api_docs]!
## matchbook at a slightly longer glance
want to know more? [read the docs][api_docs]!
### switching on part of an object
### switching on an `enum`
### acting on the type of an Event
[Type guards][type_guard]
### matching if a value is an `instanceof` a constructor
[api_docs]: https://matchbook-ts.github.io/matchbook-ts/docs/
[rust_match]: https://doc.rust-lang.org/book/ch06-02-match.html
[codecov_link]: https://codecov.io/gh/matchbook-ts/matchbook-ts
[codecov_badge]: https://codecov.io/gh/matchbook-ts/matchbook-ts/branch/master/graph/badge.svg
[build_link]: https://travis-ci.org/matchbook-ts/matchbook-ts
[build_badge]: https://travis-ci.org/matchbook-ts/matchbook-ts.svg?branch=master
[npm_ver_badge]: https://img.shields.io/npm/v/@matchbook/ts
[npm_size_badge]: https://img.shields.io/bundlephobia/min/@matchbook/ts
[npm_link]: https://www.npmjs.com/package/@matchbook/ts
[lang_badge]: https://img.shields.io/github/languages/top/matchbook-ts/matchbook-ts
[license_badge]: https://img.shields.io/github/license/matchbook-ts/matchbook-ts
[source_rank_badge]: https://img.shields.io/librariesio/sourcerank/npm/@matchbook/ts
[libraries_io]: https://libraries.io/npm/@matchbook%2Fts
[codacy_badge]: https://api.codacy.com/project/badge/Grade/dd3aa51feb4b4b9988d2a1c9ea543187
[codacy_link]: https://www.codacy.com/gh/matchbook-ts/matchbook-ts?utm_source=github.com&utm_medium=referral&utm_content=matchbook-ts/matchbook-ts&utm_campaign=Badge_Grade
[new_issue]: https://github.com/matchbook-ts/matchbook-ts/issues/new
[gts_badge]: https://img.shields.io/badge/code%20style-google-blueviolet.svg
[gts_url]: https://github.com/google/gts
[type_guard]: https://www.typescriptlang.org/docs/handbook/advanced-types.html#using-type-predicates