Command line tools¶
Pyro has several command line tools that you will be using sooner or later. They are generated and installed when you install Pyro.
- pyro4-ns (name server)
- pyro4-nsc (name server client tool)
- pyro4-test-echoserver (test echo server)
- pyro4-check-config (prints configuration)
- pyro4-flameserver (flame server)
- pyro4-httpgateway (http gateway server)
If you prefer, you can also invoke the various “executable modules” inside Pyro directly, by using Python’s “-m” command line argument.
Some of these tools are described in detail in their respective sections of the manual:
- Name server tools:
- See Starting the Name Server and Name server control tool for detailed information.
- HTTP gateway server:
- See Pyro via HTTP and JSON for detailed information.
Test echo server¶
python -m Pyro4.test.echoserver [options] (or simply: pyro4-test-echoserver [options])
This is a simple built-in server that can be used for testing purposes. It launches a Pyro object that has several methods suitable for various tests (see below). Optionally it can also directly launch a name server. This way you can get a simple Pyro server plus name server up with just a few keystrokes.
A short explanation of the available options can be printed with the help option:
Print a short help message and exit.
The echo server object is available by the name
test.echoserver. It exposes the following methods:
Simply returns the given argument object again.
Generates a run time exception.
Terminates the echo server.
python -m Pyro4.configuration (or simply: pyro4-check-config) This is the equivalent of:
>>> import Pyro4 >>> print(Pyro4.config.dump())
It prints the Pyro version, the location it is imported from, and a dump of the active configuration items.