Package Exports

atomic-fns
atomic-fns/core/index.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (atomic-fns) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

atomic-fns

Read the Docs

Like Lodash, but for ESNext and with types.

Stop shipping code built for browsers from 2015. Really though, look at all the issues.

You may prefer this because it's:

Modular: Pick what you need. Supports tree-shaking, no side effects and works with all bundlers.
ESNext: Uses modern idiomatic syntax, data structures, and control flow techniques.
Lazy: Leverage generators, iterators, and functional composition.
Zero deps: Built from scratch with no runtime dependencies or polyfills.
Well tested: All modules have comprehensive test suites aiming for 100% coverage.
TypeScript & docs: Includes type declaration files and js with JSDocs for best in class experience.

Docs

📖 Available at atomic-fns.dev

Get Started

This library is available as an npm package.

To install the package you need to have npm (or yarn) and then run:

npm install atomic-fns

How to use

Just import any function or class you need.

import { sorted, times, uniqueId } from 'atomic-fns'

times(5, (i) => i)
// -> [0, 1, 2, 3, 4]

sorted([4, 3, 2, 1])
// -> [1, 2, 3, 4]

uniqueId('user_')
// -> 'user_101225005'
...

You could also import any individual module directly from an html page like this:

<script type="module">
  import {
    namedtuple, FrozenSet, SortedSet, SortedMap
  } from 'https://unpkg.com/atomic-fns/core/collections';
  // your code goes here...
</script>

See the full list of modules.

Data model

This library features a data model similar to Python but not always. Only the missing parts have been implemented, while respecting the JS standards.

For example in Python collections size() is a method while in JS its just a property. So this library uses size property instead of methods. Similarly, the len function implementation checks for both length and size since many JS objects have a length property.

Special method names

This library adds support for operators using object methods such as:

obj.eq(other) adds custom obj == other.
obj.lt(other) adds custom obj < other.
obj.lte(other) adds custom obj <= other.
obj.gt(other) adds custom obj > other.
obj.gte(other) adds custom obj >= other.
obj.compare(other) overloads sorting operations.

When you implement those, you can also apply operators to values like eq(x, y), lte(x, y), compare(x, y), etc. to get the result of x.<operator>(y).

New Types

Introduces some common base interfaces and typing patterns you may have seen like Optional, Result, Comparable, Iterator, and others.

Sorted Containers

Other Containers

Contributing

If you want to contribute to the project and make it better, your help is very welcome. Contributing is also a great way to learn more about social coding on Github, new technologies and and their ecosystems and how to make constructive, helpful bug reports, feature requests and the noblest of all contributions: a good, clean pull request. You will be listed as a Champion on the official site as well.

License

Apache License 2.0