This is a pre-production deployment of Warehouse, however changes made here WILL affect the production instance of PyPI.
Latest Version Dependencies status unknown Test status unknown Test coverage unknown
Project Description
==========================
Telecom Log Service Client
==========================

Telecom Log Service Client (``tlscli``) is a Python command-line client for
CORBA Telecom Log Service.

Using it you can:

* create a new log
* query a log
* add or remove log records

For more information on the TelecomLogService, see:
http://www.omg.org/spec/TLOG/

The project is hosted on Launchpad:
https://launchpad.net/tlscli

Example
=======
Here's an example session, assuming a Telecom Log Service is running::

me@mymachine$ tlscli -ORBInitRef LogMgr=`cat /var/run/corba/tls.ior` list
me@mymachine$ tlscli -ORBInitRef LogMgr=`cat /var/run/corba/tls.ior` create
0
me@mymachine$ tlscli -ORBInitRef LogMgr=`cat /var/run/corba/tls.ior` list
0
me@mymachine$ tlscli -ORBInitRef LogMgr=`cat /var/run/corba/tls.ior` info 0
id: 0
QoS: none
max-record-life: infinite
max-size: unlimited
current-size: 56 bytes
records: 1
log-full-action: wrap
administrative-state: unlocked
forwarding-state: on
operational-state: enabled
interval: now - forever
availability-status: { off-duty: False; full: False }
capacity-alarm-thresholds: [100]
week-mask:
------------------------------------------------------------------------------
me@mymachine$ tlscli -ORBInitRef LogMgr=`cat /var/run/corba/tls.ior` write 'Hello world!' to 0
me@mymachine$ tlscli -ORBInitRef LogMgr=`cat /var/run/corba/tls.ior` info 0
id: 0
QoS: none
max-record-life: infinite
max-size: unlimited
current-size: 57 bytes
records: 1
log-full-action: wrap
administrative-state: unlocked
forwarding-state: on
operational-state: enabled
interval: now - forever
availability-status: { off-duty: False; full: False }
capacity-alarm-thresholds: [100]
week-mask:
------------------------------------------------------------------------------
me@mymachine$ tlscli -ORBInitRef LogMgr=`cat /var/run/corba/tls.ior` retrieve 10 after `date +%Y%m%d` from 0
id: 1
time: Sat Dec 25 17:11:57 2010
attributes: []
info: Hello world!
------------------------------------------------------------------------------


This creates a new log with id 0, then write a new log record to it with text ``Hello world``.

Prerequisites
=============

To install ``tlscli``, you need:
* a working installation of
`omniORBpy <http: omniorb.sourceforge.net=""/>`_, or a working installation of
`PyORBit <https: github.com="" gnome="" pyorbit="">`_.
* `python-dateutil <http: niemeyer.net="" python-dateutil="">`_

To proceed to installation, run the following command from where you unpacked
``tlscli``::

me@mymachine$ python setup.py install --user

This will automatically install everything needed into
your ``$HOME/.local`` (``tlscli`` itself will be in ``$HOME/.local/bin``).

To run ``tlscli``, you need a Telecom Log Service running somewhere.
``tlscli`` is known to work with the following implementations:

* ``tao_tls_basic``, ``tao_tls_event`` and ``tao_tls_notify`` provided
with `TAO <http: www.cs.wustl.edu="" ~schmidt="" tao.html="">`_
* ``tlserl``, an Erlang implementation available on
`bitbucket <https: bitbucket.org="" tgg="" tlserl=""/>`_

Running
=======

When invoking ``tlscli`` you need to specify how to connect to the LogMgr.
The LogMgr is the object to use to access (or create) logs.

This is achieved by specifying an initial reference for the LogMgr, using one
of the three following methods:

* add ``-ORBInitRef LogMgr=corbaname:iiop:1.2@MACHINE:PORT#NAME``
* add ``-ORBInitRef LogMgr=corbaloc:iiop:1.2@MACHINE:PORT/NAME``
* add ``-ORBInitRef LogMgr=IOR:IOR``

where ``MACHINE:PORT`` specify where to find a Telecom Log Service (or
a Name Service for ``corbaname``), and ``NAME`` is the name to use
for the service (or the Name Service for ``corbaname``).

Please read `The corbaloc and corbaname URLs chapter
<http: www.ciaranmchale.com="" corba-explained-simply="" the-corbaloc-and-corbaname-urls.html="">`_
in the great online free book
`CORBA Explained Simply <http: www.ciaranmchale.com="" corba-explained-simply=""/>`_.

Commands
========

Creating a new log
------------------
To create a new log, use ``tlscli create``. This will return the id of the
newly created log.

Querying an existing log
------------------------
* ``list`` will return the id of all logs available from the given LogMgr.
This is the default command if none is specified
* ``info`` will return information about an existing log, such as size,
record count and current status
* ``query`` can be used to search for log records matching a given constraint
* ``retrieve`` retrieves a given count of log records before or after the
specified date

Modifying an existing log
-------------------------
* ``write`` adds a new log record to an existing log
* ``delete`` removes log records matching a given constraint from an existing
log


For more information on commands, use ``tlscli --help``.
Release History

Release History

1.1.0

This version

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

1.0.1

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

1.0.0

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

0.8.0

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

Download Files

Download Files

TODO: Brief introduction on what you do with files - including link to relevant help section.

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
tlscli-1.1.0.tar.gz (20.5 kB) Copy SHA256 Checksum SHA256 Source Apr 2, 2013

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS HPE HPE Development Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting