Command line tool
=================

You can start a server from the command line calling `pizco.py`. For example::

    $ python pizco.py tcp://127.0.0.1:8000
    Server started at tcp://127.0.0.1:8000
    Press CTRL+c to stop ...

will start a server bound to localhost, port 8000. If you want to bind to a
particular pub endpoint, you can specify it with an extra parameter.

When the server is created in this way, no object is served. To instantiate
and serve an object, create a proxy, connect to it and call the instantiate method::

    from myproject import Robot

    proxy = Proxy('tcp://127.0.0.1:8000')
    proxy._proxy_agent.instantiate(Robot,
                                   args=('Robbie', ),
                                   kwargs={'age': 3})


Additional arguments can be used to configure the server:

**-g**: open a small window to display the server status.
      If the window is closed, the server is stopped.

**-v**: print debug information to the console.

**-p** *path*: add *path* to sys.path


This is script is called under the hood by `serve_in_process` to initiated
a server in detached processes.