Skip to content

Latest commit

 

History

History
189 lines (130 loc) · 4.89 KB

python.rst

File metadata and controls

189 lines (130 loc) · 4.89 KB

Python API

odorik

odorik

OdorikException

OdorikException

Base class for all exceptions.

Odorik

param user

User ID

type user

string

param password

API password

type password

string

param url

API server URL, if not specified default is used

type url

string

param config

Configuration object, overrides any other parameters.

type config

OdorikConfig

Access class to the API, define user, password and optionally API URL.

get(path, args=None)

param path

Request path

type path

string

param args

Optional request parameters

type args

dict

rtype

string

Performs single API GET call.

get_json(path, args=None)

param path

Request path

type path

string

param args

Optional request parameters

type args

dict

rtype

object

Performs single API GET call and parses JSON reply including error handling.

balance()

rtype

float

Returns current balance.

mobile_data(from_date, to_date, number=None)

param from_date

Starting date

type from_date

datetime.datetime

param to_date

Ending date

type to_date

datetime.datetime

param number

Phone number in form of 00420789123456

type number

string

rtype

list

Returns mobile data usage list in given interval. Optionally filtered for given number.

send_sms(recipient, message, sender='5517')

param recipient

Number where to sent SMS.

type recipient

string

param message

Text of the message.

type message

string

param sender

Optional sender number.

type sender

string

rtype

string

Sends a SMS message.

callback(caller, recipient, line=None)

param caller

Number which is calling.

type caller

string

param recipient

Number to call.

type recipient

string

param line

Line to use for accounting.

type line

string or None

rtype

string

Initiates callback.

calls(from_date, to_date, line=None, status=None, direction=None):

param from_date

Starting date

type from_date

datetime.datetime

param to_date

Ending date

type to_date

datetime.datetime

param line

Line to use for listing

type line

string or None

param status

Call status, one of 'answered', 'missed'

type status

string

param direction

Call direction, one of 'in', 'out', 'redirected'

type direction

string

rtype

list

Returns list of calls in given interval. Optionally filtered for given line.

sms(from_date, to_date, line=None):

param from_date

Starting date

type from_date

datetime.datetime

param to_date

Ending date

type to_date

datetime.datetime

param line

Line to use for listing

type line

string or None

rtype

list

Returns list of sms in given interval. Optionally filtered for given line.

lines()

rtype

list

Returns list of dictionaries with information about lines.

odorik.config

odorik.config

OdorikConfig

param section

Configuration section to use

type section

string

Configuration file parser following XDG specification.

load(path=None)

param path

Path where to load configuration.

type path

string

Loads configuration from a file, if none is specified it loads from odorik configuration file placed in XDG configuration path (~/.config/odorik and /etc/xdg/odorik).

odorik.main

odorik.main

main(settings=None, stdout=None, args=None)

param settings

settings to override

type settings

list of tuples

param stdout

stdout for printing output, uses sys.stdout as default

type stdout

file

param args

command line argumets to process, uses sys.args as default

type args

list

Main entry point for command line interface.

register_command(command)

Decorator to register Command class in main parser used by main.

Command

Main class for invoking commands.