fp-ts README

The project's README from github.com/gcanti/fp-ts. As one markdown file: README.md.

Functional programming in TypeScript

build status npm downloads

📢 Important Announcement: fp-ts is Joining the Effect-TS Ecosystem!

We are excited to announce that the fp-ts project is officially merging with the Effect-TS ecosystem. This is a significant step forward in the functional programming landscape, bringing together two powerful libraries under one roof. Giulio Canti, the author of fp-ts, is being welcomed into the Effect organization, promising an exciting future with enhanced capabilities and support.

What This Means for New Users:

Effect-TS can be regarded as the successor to fp-ts v2 and embodies what would be considered fp-ts v3. This merger marks a significant evolution in the library's capabilities, integrating more features and functionalities tailored towards robust, type-safe, and scalable functional programming.

For more details on this merger and what it entails, please refer to the official announcement here. Additionally, you can explore more about Effect-TS and its offerings on our website and documentation.

Introduction

fp-ts is a library for typed functional programming in TypeScript.

fp-ts aims to allow developers to use popular patterns and abstractions that are available in most functional languages. For this, it includes the most popular data types, type classes and abstractions such as Option, Either, IO, Task, Functor, Applicative, Monad to empower users to write pure FP apps and libraries built atop higher order abstractions.

A distinctive feature of fp-ts with respect to other functional libraries is its implementation of Higher Kinded Types, which TypeScript doesn't support natively.

Inspired by

Sponsors

Unsplash
Unsplash
https://unsplash.com/

The internet’s source for visuals.
Powered by creators everywhere.

Installation

To install the stable version:

npm install fp-ts

Make sure to always have a single version of fp-ts installed in your project. Multiple versions are known to cause tsc to hang during compilation. You can check the versions currently installed using npm ls fp-ts (make sure there's a single version and all the others are marked as deduped).

TypeScript compatibility

Strictness – This library is conceived, tested and is supposed to be consumed by TypeScript with the strict flag turned on.

fp-ts version required typescript version
2.0.x+ 3.5+
1.15.x+ 3.1+
<= 1.14.4 2.8+ (*)

(*) If you are running < [email protected] you have to polyfill the unknown type. You can use unknown-ts as a polyfill.

Documentation

Disclaimer. Teaching functional programming is out of scope of this project, so the documentation assumes you already know what FP is.

Help

If you need help with fp-ts check out:

Development

License

The MIT License (MIT)

fp-ts (gcanti/fp-ts)

Searching Database…

11.5K ·GitHub
Что это?fp-ts — это библиотека для типизированного функционального программирования на TypeScript, которая приносит в приложения на TypeScript такие паттерны и абстракции, как Option, Either, IO, Task, Functor, Applicative и Monad.
Это фреймворк, под который нужно перестроить приложение, или библиотека, которую можно использовать по частям?Это библиотека компонуемых типов данных и классов типов, которые вы импортируете и используете по мере необходимости, а не фреймворк, диктующий структуру приложения.
Как добавить её в проект?Установите стабильную версию через npm и оставьте в проекте только одну версию fp-ts, чтобы компилятор не зависал.
Нужно ли что-то особенное в конфигурации TypeScript?Да, fp-ts собирается и тестируется с включённым флагом strict в TypeScript; использование без строгого режима не является поддерживаемой конфигурацией.
Проект всё ещё активно развивается?Нет, fp-ts вливается в экосистему Effect-TS и считается замещённым; Effect-TS описывается как преемник и то, чем должна была стать fp-ts v3.
Какие типы данных и абстракции есть из коробки?fp-ts включает наиболее распространённые строительные блоки ФП, такие как Option, Either, IO, Task, Functor, Applicative и Monad, а также другие.
Что повлияло на дизайн fp-ts?При проектировании fp-ts опирались на Haskell, PureScript и Scala, перенося их типизированные паттерны ФП в мир TypeScript.
Зачем fp-ts нужна собственная кодировка для Higher Kinded Types?TypeScript не поддерживает Higher Kinded Types нативно, поэтому fp-ts реализует собственную кодировку, чтобы такие абстракции, как Functor и Monad, работали обобщённо.
Раз fp-ts вливается в Effect-TS, стоит ли начинать новые проекты с fp-ts?Новым пользователям рекомендуют Effect-TS, который в README описан как преемник и то, чем должна была стать fp-ts v3.
What are similar projects?date-fns, nuqs, lila, recompose, router, ramda, core-js, validator.js
Creator
gcanti
Size
22.6 MB
Stars
11.5K
Age
9y
Commits · 90 Days