Examples for rrlog
********************************


*A Remote Rotating Log for Python that works instantly*




Remote with sockets
=========================

This is the preferred way to log remotely.
It is also the right way for processes logging to the same file (with a server remotely, or on the same machine). 

**Host and Ports**

By default, the connection uses "localhost" and a default port → :py:data:`rrlog.globalconst.DEFAULTPORT_SOCKET`

You can specify a list of allowed ports on both sides.
The server listens on the first port available.
The client logs to the first port where a server is found.  



A socket client in your application
--------------------------------------

.. literalinclude:: ../demo/demo_socketclient.py
   :lines: 42-

→  :py:mod:`rrlog.socketclient`


**(Re-)Connection behavior**

A log client uses the log server whenever available. 
**While the log server is down, messages are lost silently.**
When the server is up again, all clients start to use the server again.  




Common server examples
-----------------------

For the socket client to make sense, start a log server in another process:


A socket server that prints to stdout
---------------------------------------------


.. literalinclude:: ../demo/demo_socketserverstdout.py
   :lines: 42-

→  :py:mod:`rrlog.server.socketserver`

→  :py:mod:`rrlog.server.printwriter`


A socket server that logs into files
------------------------------------------

.. literalinclude:: ../demo/demo_socketserverfiles.py
   :lines: 42-

→  :py:mod:`rrlog.server.socketserver`

→  :py:mod:`rrlog.server.filewriter`


A socket server that logs into a database
-------------------------------------------

.. literalinclude:: ../demo/demo_socketserverdatabase.py
   :lines: 42-

→  :py:mod:`rrlog.server.socketserver`

→  :py:mod:`rrlog.server.dbwriter_sa`