np / purescript-ffi-simple

We're sure you have your reasons

purescript-ffi-simple

We're sure you have your reasons.

Rationale

What if we could do FFI without writing javascript much, if it all?

This library sits at the unsafeCoerce end of the safety scale - it is expected that your usage of these functions will provide the necessary safety while we provide the primitives with low overhead and little imposition upon how you structure your code.

Usage

import FFI.Simple

import Data.Array as A

foreign import data React :: Type
foreign import data Element :: Type

react :: React
react = require 'react'

createElement :: forall r. String -> Record r -> Array Element -> Element
createElement c p cs = applyTo react (args3 c p cs)

Dedication

Send it a message -- Joe Armstrong (1950-2019)

Changelog

0.2.3

Improvements:

• F.S.Globals:
  • Made global check not just window, but also globalThis, global, so supporting any environment. But nodejs is shit, so it's basically useless in that environment.
• Improved tests for existing functionality

New:

• F.S.Functions:
  • new
• F.S.Objects:
  • Property checks:
    • hasOwnProperty - non-inherited props
    • isIn - possibly inherited props
  • Safer Property access:
    • (.?)
    • maybeGetProperty
    • maybeGetProperty'
• F.S.Undef:
  • maybeUndef - the Maybe analogue of nullUndef

0.2.2

Improvements:

• F.S.Globals:
  • Warns on module load if window is not defined
  • If window is not defined:
    • global will always return Nothing
    • unsafeGlobal will always quietly return undef

0.2.1

Breakages:

• F.S.Undef:
  • Undefined -> Undef
  • undefined -> undef

New:

• F.S.Globals:
  • unsafeGlobal - Assume a global will be present, quietly return undef if it is not. (Bring your own safety!)

0.2.0

Breakages:

• F.S.Functions:
  • bind' -> bindTo
  • apply -> applyTo
  • delay now takes a value to provide
• F.S.Objects:
  • typeof -> typeOf

New:

• F.S.Globals (new module):
  • global - look up a global by name
• F.S.Objects:
  • instanceOf - wrapper for js instanceof
  • (.=) / setProperty' to set a property
  • (!=) / defineProperty' to define a readonly property

0.1.2

• Remove F.S.Require as i can't figure out how to make a build work with it.
• Remove call, callMethod and callMethod' from F.S.Functions
• Add F.S.Functions.delay
• Made dotty operators infixl
• Depend on effect and refs

0.1.1

• Add F.S.PseudoArray.unshift

Copyright and License

Copyright (c) 2019 James Laver

This software is free and open source software licensed under the terms of the Mozilla Public License (MPL) 2.0