circuits v0.3.1

circuits

A simple socket-io framework for client and server communcation around CRUD operations

Usage

install using npm

npm install circuits

Basic client server example source

# port to listen to
testPort = 8001
# create a server
httpServer = http.Server()
# instantiate a Circuits server with a controller router
server = new Server httpServer, (controller)->
	switch controller
		# match against the requested router to a specific one
		# every router needs to implement the CRUD operation 
		# it needs to support
		when 'echo' then {
				"read" : (message, id, cb)-> 
					# the first argument for the callback is 
					cb(null,message)
			}


httpServer.listen testPort

client = sioc.connect("http://localhost:#{testPort}")

client.on 'connect', ->
	client.emit Operation, 'echo', CRUD.read, 'any bats in here?',(err, data)->
		if (data == 'any bats in here?')
			console.log 'No bats here I guess..'
			process.exit()

ToDo: Example using Circuits with a Backbone model Example using Circuits with a Backbone collection Example using Circuits with Express framework

Whats in the box?

create Circuits server instance

new circuits.Server( httpServer, controllerResolver, [acl, redisHost, redisDB, redis, redisPort, circuitChannel] )

• httpServer instance of require('http').Server
• controllerResolver function that returns an object with mapping to CRUD operation for provided controller name
• acl the ACL object, if none provided it allowes everything
• redisHost IP address of your redis (default is "127.0.0.1")
• redisDB redis db to use (default is 10 )
• redisPort redis port (deault is 6379)
• circuitChannel name space for communication between Circuits instances

messages

circuits.Messages is a map of String => String of supported Circuits messages

the Operation message is a request for a message to be dispatched to respective controller on the server

arguments

required operation params for the different CRUD operations

CRUD.create

CRUD.read

CRUD.update

CRUD.delete

CRUD operations

circuits.CRUD

is simply a map of String => String of
create, read,update, delete and patch

ACL

circuits.ACL constructor arguments

example of a controller+crud group rules

{
	"MyModel" : {
		"create" : ["public"],
		"read" : ["public"],
		"update" : ["users"],
		"delete" : []
	},
	"SecretModel" : {
		"create" : ["users"],
		"read" : ["users"],
		"update" : ["users"],
		"delete" : ["users"]
	}
}

is simply an object mapping controllers to respective allowed crud operations

High Level Design