cup.net.async package

Submodules

cup.net.async.common module

author:Guannan Ma create_date:2014 last_date:2014

cup.net.async.common.ip_port2connaddr(peer)

connaddr是个64bit的int

32 - 16 - 16 - 32 ip - port - stub - future

该函数以peer(ipaddr, port)为输入参数， 生成一个connaddr

cup.net.async.common.add_stub2connaddr(pack, stub)

connaddr是个64bit的int

32 - 16 - 16 - 32 ip - port - stub - future

该函数设置connaddr中的stub到connaddr

cup.net.async.common.add_future2connaddr(pack, future)

connaddr是个64bit的int

32 - 16 - 16 - 32 ip - port - stub - future

该函数设置connaddr中的future到connaddr

cup.net.async.common.get_ip_and_port_connaddr(pack)

connaddr是个64bit的int

32 - 16 - 16 - 32 ip - port - stub - future

该函数获取connaddr中的(ip, port)

cup.net.async.common.getip_connaddr(pack)

connaddr是个64bit的int

32 - 16 - 16 - 32 ip - port - stub - future

该函数获取connaddr中的ip

cup.net.async.common.getport_connaddr(pack)

connaddr是个64bit的int

32 - 16 - 16 - 32 ip - port - stub - future

该函数获取connaddr中的port

cup.net.async.common.getstub_connaddr(pack)

connaddr是个64bit的int

32 - 16 - 16 - 32 ip - port - stub - future

该函数获取connaddr中的stub

cup.net.async.common.getfuture_connaddr(pack)

connaddr是个64bit的int

32 - 16 - 16 - 32 ip - port - stub - future

该函数获取connaddr中的future

cup.net.async.conn module

author:Guannan Ma create_date:2014 last_date:2014 descrition:connection related module

class cup.net.async.conn.CConnContext

Bases: object

Connection上下文处理类

do_recv_data(data, data_len)

push data into the recving_msg queue network read should be in 1 thread only.

get_context_info()

get context info

get_peerinfo()

get peerinfo

get_recving_msg()

get the net msg being received

get_sock()

return associated socket

is_detroying()

is context being destroyed

is_reading()

get if it is reading

put_msg(flag, msg)

Put msg into the sending queue.

Parameters:flag –

flag determines the priority of the msg.

Msg with higher priority will have bigger chance to be

sent out soon.

TODO:If the msg queue is too big, consider close the network link

release_readlock()

release the readlock

release_writelock()

release the writelock

set_conn_man(conn)

set conn for context

set_peerinfo(peer)

set peerinfo

set_reading(is_reading)

set reading status

set_sock(sock)

associate socket

to_destroy()

destroy context

try_move2next_sending_msg()

move to next msg that will be sent

try_readlock()

try to acquire readlock

Returns:True if succeed. False, otherwise

try_writelock()

Returns:True if succeed. False, otherwise

class cup.net.async.conn.CConnectionManager(ip, bindport, thdpool_param)

Bases: object

connaddr. Convert ip:port into a 64-bit hex.

NET_RW_SIZE = 131072

exception QueueError(msg)

Bases: exceptions.Exception

internal queue error for CConnectionManager class

CConnectionManager.add_write_job(context)

add network write into queue

CConnectionManager.bind()

bind the ip:port

CConnectionManager.connect(peer)

Parameters:peer – ip:port

CConnectionManager.dump_stats()

dump stats

CConnectionManager.get_recv_msg()

get recv msg from queue

CConnectionManager.get_recv_msg_ind()

get recv msg ind

CConnectionManager.get_recv_queue()

get recving_msg queue

CConnectionManager.poll()

start to poll

CConnectionManager.push_msg2sendqueue(msg)

push msg into the send queue

CConnectionManager.read(context)

read with conn context

CConnectionManager.stop()

stop the connection manager

cup.net.async.msg module

author:Guannan Ma create_date:2014 last_date:2014 descrition:netmsg related module

class cup.net.async.msg.CNetMsg(is_postmsg=True)

Bases: object

CNetMsg

flag: System use only. type: System will use type > 65535. Users will use type <=65535

#head 0, SAGIT
for building connection #len - uint64 #fromip,port, stub -uint64 #toip,port, stub -uint64 #msg_type -uint32 #uniqid -uint64 #body -no limit (length:uint64)

MSGTYPE = <cup.net.async.msg.CMsgType object at 0x7f462e04e210>

MSG_FLAG_MAN = <cup.net.async.msg.CMsgFlag object at 0x7f462e04efd0>

MSG_SIGN = 'SAGIT0\\1'

get_body()

get msg body

get_bodylen()

get body length

get_flag()

get msg flag

get_from_addr()

get from addr

get_msg_len()

get msg len

get_msg_type()

get msg type

get_order_counts()

get order counts

get_to_addr()

get to addr

get_uniq_id()

get unique msg id

get_write_bytes(length)

get write bytes from the msg

is_a_recvmsg()

is a msg being received

is_a_sendmsg()

is a msg being sent

is_msg_already_sent()

is msg already sent

is_recvmsg_complete()

is msg received already

is_sendmsg_complete()

is msg sent complete

push_data(data)

push data into the msg

seek_write(length_ahead)

seek foreward by length

set_body(body)

set msg body

set_flag(flag)

set flag for the msg

set_from_addr(ip_port, stub_future)

set msg from addr

set_msg_type(msg_type)

set msg type

set_need_head(b_need=False)

Note:By default, the msg does not need to have a head unless it’s the first msg that posted/received.

set_to_addr(ip_port, stub_future)

set msg to addr

set_uniq_id(uniq_id)

set msg unique id

class cup.net.async.msg.CAckMsg(is_postmsg=True)

Bases: cup.net.async.msg.CNetMsg

ack msg example

get_ack()

get ack

set_ack(status, msg)

Parameters:

• status – status of the msg
• msg –

set_body(map_ack)

set body

cup.net.async.msgcenter module

author:Guannan Ma create_date:2014 last_date:2014 descrition:msg center related module

class cup.net.async.msgcenter.IMessageCenter(ip, port, thdpool_param=None, stat_intvl=20)

Bases: object

Message center class

default_handle(msg)

default handle for msgcenter

dump_stat()

dump message center class

handle(msg)

handle function which should be implemented by sub-class.

is_stopping()

is msg center being stopped

post_msg(msg)

post a net msg

run()

run the msgcenter

setup()

setup the message center

stop()

stop the message center

Module contents

author:Guannan Ma create_date:2014 last_date:2014 descrition:Async Module是ython tcp异步通讯框架.