Pybbs

基于Python的BBS实现，提供BBS数据接口。

基础结构

C结构的存取

初版实现

需要在对应的类定义域：_fields与_parser。

_fields:

• _fields为一个list，其中每项对应一个C结构里的域。
• 每项可以是一个字符串（域名），或者是一个list。
• 如果是一个list，那第一个必须是个字符串（域名），第二个是类型，之后是类型参数。
  • 类型1： C字符串。从内存中读取之后，会自动截断到第一个\0
  • 类型2： 需要再次parse的域。目前主要用来实现数组。类型参数是再次parse的格式字符串。
    • 例如，对于一个int数组，['friends_uid', 2, '=%di' % Config.MAXFRIENDS ]，会再次用后面那个格式进行parse，得到一个list。

_parser:

• 定义为struct.Struct(格式字符串)
• 格式字符串里，每项对应了_fields里的一个域。
• 对于普通类型，例如int，直接在对应位置写'i'就可以。
• 对于需要再次parse的类型，这里只要取出一个字符串就完了，一般是'9s'这样的形式。

样例:

来自UserInfo类

 _fields = ['active', 'uid', 'pid', 'invisible', 'sockactive', 'sockaddr', 'destuid', 'mode', 'pager', 'in_chat', ['chatid', 1], ['from', 1], 'logintime', 'fill', 'freshtime', 'utmpkey', 'mailbox_prop', ['userid', 1], ['realname', 1], ['username', 1], 'friendsnum', ['friends_uid', 2, '=%di' % Config.MAXFRIENDS ], 'currentboard', 'mailcheck']
    _parser = struct.Struct('=iiiiiiiiii16s%dsi36siiI20s20s40si%dsiI' % (Config.IPLEN + 4, Config.MAXFRIENDS * 4))

对应c结构：

struct user_info {              /* Structure used in UTMP file */
    int active;                 /* When allocated this field is true */
    int uid;                    /* Used to find user name in passwd file */
    int pid;                    /* kill() to notify user of talk request */
    int invisible;              /* Used by cloaking function in Xyz menu */
    int sockactive;             /* Used to coordinate talk requests */
    int sockaddr;               /* ... */
    int destuid;                /* talk uses this to identify who called */
    int mode;                   /* UL/DL, Talk Mode, Chat Mode, ... */
    int pager;                  /* pager toggle, true, or false */
    int in_chat;                /* for in_chat commands   */
    char chatid[16];            /* chat id, if in chat mode */
    char from[IPLEN + 4];       /* machine name the user called in from */
    time_t logintime;
#ifdef HAVE_WFORUM
	char fill[35];
	unsigned char yank;
#else 
    char fill[36];
#endif
    time_t freshtime;
    int utmpkey;
    unsigned int mailbox_prop;  /* properties of currentuser's mailbox */
    char userid[20];
    char realname[20];
    char username[40];
    int friendsnum;
    int friends_uid[MAXFRIENDS];
#ifdef FRIEND_MULTI_GROUP
    unsigned int friends_p[MAXFRIENDS];
#endif
    int currentboard;
	unsigned int mailcheck;				/* if have new mail or new msg, stiger */
};

数据接口实现

• 登录
  • 用户名/密码登录

已实现，考虑安全原因禁用

• • OAuth登录

部分实现，只是能用而已……

• 帖子
  • 获取帖子

已实现

• • 发帖
  • 同主题上一帖/下一贴

已实现

• 版面
  • 获取所有版面列表

已实现

• 精华区
• 收藏夹
  • 获取收藏夹列表

已实现

• 消息

在XMPP接口中实现

• 好友列表

在XMPP接口中实现

• 邮箱

XMPP实现

XMPP阶段：

• 认证
  • 基于外部OAuth
  • 基于明文

TLS层已经加密了，所以无所谓。

已实现，见xmppauth.XMPPAuth类

• 登录
  • 更新用户信息
  • 增加session

已实现。在xmppserver.XMPPServer类中__init__部分。调用Session.Register()进行注册。

• 好友列表
  • 获取好友列表(roaster)

已实现。在roster.Roster类中。

• • 跟踪好友状态并更新好友列表

已实现。在rosters.Rosters类中，包括update_sessions()等

• • 隐身功能

已实现，看不见的人，就是看不见……

但是在消息方面有个问题。原来是允许给隐身的人回复消息的，但现在不好判断是否回复，干脆统统不许。

• • 增加好友
  • 删除好友
  • 修改好友昵称
• 消息
  • 发送消息

已实现。参见rosters.Rosters.send_msg()

• • 消息通知

已实现。

目前设计为，当收到SIGUSR2，让所有登录用户检查是否有新消息。

• • 接收消息

已实现。保存内部已读索引，每次检查消息，如果有新消息，则发送给用户。

• 修改状态
• 扩展

很多成本不大…… 有空搞搞就好了

• • jabber:iq:last

上次活动时间（在线）/上次上线时间（下线）/uptime（服务器）

• • jabber:iq:version

软件版本/系统信息

• • vcard-temp

用户信息，例如名字、全名、……

初步实现，返回用户名……

• • urn:xmpp:time

用户本地时间……

• • disco#info

查询支持的扩展列表。已实现

• 注销
  • 更新用户信息
  • 移除session

已实现。用Session.Unregister()。