cfc_network_promises

Network-based promise library

Usage

• NP.net.send( name, ... )
  Send a net message on name containing the varargs ..., no need for any net.WriteString or likewise.
  Returns a promise resolving or rejecting with whatever data returned via NP.net.receive()
  Note: This function sends more than just the varargs, only receive this with NP.net.receive()

• NP.net.receive( name, func )
  Receive a net message on name calling func, where func is of the form:
  function( callingPly, ... )
  The ... will be whatever they were in the corresponding NP.net.send()
  Note: Both send and receive will check if the name is already pooled, and if not, will add it as a network string ( NP.net.send will still error if called on client using an unpooled name )

• NP.http.post( url, data, timeout )
  Post data to a url, with an optional timeout ( defaulting to 5 seconds ).
  Returns a promise resolving in the form:
  function( statusCode, jsonData, headers )
  where jsonData is parsed from the post body, or rejecting in the form:
  function ( errorStr )
  Note: The url must return in JSON, if the JSON cannot be parsed with util.JSONToTable() then the promise will reject.

• NP.http.fetch( url, timeout )
  Identical to NP.http.post() but fetches instead.

Example

Server side:

    -- "getData" automatically pooled by this function.
    -- Receive on getServerStatus, return the result of fetching the scripting url
    NP.net.receive( "getData", function( ply )
        return NP.http.fetch( "https://my.website.com/getData" )
    end )

Client side:

    -- Send net message, print result or error
    NP.net.send( "getData" ):next( function( status, data )
        -- Success
        print( status ) -- Hopefully 200
        PrintTable( data ) -- Some data
    end, function( err )
        -- Failure
        print( "Error: ", err )
    end )

Credit

The deferred library (lua/network_promises/include/deferred.lua) was written by zserge, here, and modified for CFC to support varargs in promise resolves and rejects.