cbNetwork

A Node.js implementation of cbNetwork

Philosophy

You might think we are crazy, but I think this is a nice project to learn how to use Node and perhaps encourages CoolBasic people to venture out.

We try to keep the API similar to the original cbNetwork's, but because of the asynchronous nature of Node we must do things little differently. For example we don't do ServerRead(), but we listen on new messages like this: server.on('message', function (data, client) { /* Let's get this done with */ }); And we don't have globals like _Net_GetByte(), we use the data parameter from the message event: data.getByte(); For more, see the documentation.

TODO

• Error handling
• Automated Unit testing
• More Examples

Coding conventions

• Line-endings are UNIX-like LF or \n but CoolBasic files use Windows-like CRLF or \r\n
• No tabs; use 2 spaces instead.
• Variables and functions use camelCaps, so the first letter is lowercase and the following words have their first letter in uppercase.
• Classes names start with a capital letter and so follow CamelCaps rules.
• Constants are written in uppercase and words are delimited with underscores "_".
• Column limit is 100, but it is not enforced - so no stupid midstatement newlines!
• Document your functions, classes, methods and complex structures with jsdoc-toolkit
  • see here for a reference of tags

cbNetwork internal data schema

1. Client connects to server
   • first 4 bytes: 00 00 00 00
2. Server responds
   • Server generates a client id (for example, 01 00 00 00)
   • first 4 bytes: client id
3. Client is connected and sends more data
   • first 4 bytes: client id received from server (for example, 01 00 00 00)
4. Server responds
   • first 4 bytes: client id, already generated
5. Client sends data:
   • first 4 bytes: the same client id
6. and so on and so forth.

MIT License

Copyright (C) 2011-2012 Ville Lahdenvuo [e-mail] & Vesa Laakso [e-mail]

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.