minifast / atom-cursor

An immutable data container

Atom Cursor

An extensible data container and observer utility suite extracted from Broadcast.

Installation

$ yarn add atom-cursor

or

$ npm install atom-cursor

About Ministry of Velocity

Ministry of Velocity is a software consultancy and product development group based out of San Francisco.

atom-cursor's Issues

How to contribute?

This has more to do with missing boilerplate, but contributions are easier with:

• Continuous integration, with a status badge
• NPM version badge
• Pull request boilerplate
• License information
• Contributor shout-outs
• MoV's logo

Subsequent selects overwrite the Cursor path

Cursor#select has some unfortunate behavior, which is that it overwrites the local path, meaning that all selects select from the root.

Here's what's expected:

const cursor = new Atom({delicious: {treats: 'amazing'}}).toCursor()
cursor.select('delicious').select('treats').get()
=> 'amazing'

And instead here's what happens:

const cursor = new Atom({delicious: {treats: 'amazing'}}).toCursor()
cursor.select('delicious').select('treats').get()
=> undefined

Why use Cursor/Atom?

Here's the most-asked question of any piece of software, especially those extracted by teams using tools every day. We likely need the following documentation:

• Basic usage
• Brief historical motivation
• Comparison with Redux (encapsulation vs. global scope)
• Comparison with Baobab

How to use Cursor/Atom?

In keeping with the need for initial documentation, most folks will need to see the following examples, including a test suite:

• Repository
• Deriving an Entity from a Repository
• React component
• Web request-backed Repository that updates a React component
• React Native Navigation root with login