aboutsummaryrefslogtreecommitdiffstats
path: root/protocols/bee.h
blob: 6f896c5148af198b279157659412e5ca9bbde24e (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
  /********************************************************************\
  * BitlBee -- An IRC to other IM-networks gateway                     *
  *                                                                    *
  * Copyright 2002-2010 Wilmer van der Gaast and others                *
  \********************************************************************/

/* Stuff to handle, save and search buddies                             */

/*
  This program is free software; you can redistribute it and/or modify
  it under the terms of the GNU General Public License as published by
  the Free Software Foundation; either version 2 of the License, or
  (at your option) any later version.

  This program is distributed in the hope that it will be useful,
  but WITHOUT ANY WARRANTY; without even the implied warranty of
  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  GNU General Public License for more details.

  You should have received a copy of the GNU General Public License with
  the Debian GNU/Linux distribution in /usr/share/common-licenses/GPL;
  if not, write to the Free Software Foundation, Inc., 59 Temple Place,
  Suite 330, Boston, MA  02111-1307  USA
*/

#ifndef __BEE_H__
#define __BEE_H__

struct bee_ui_funcs;

typedef struct bee
{
	struct set *set;
	
	GSList *users;
	struct account *accounts; /* TODO(wilmer): Use GSList here too? */
	
	const struct bee_ui_funcs *ui;
	void *ui_data;
} bee_t;

bee_t *bee_new();
void bee_free( bee_t *b );

typedef enum
{
	BEE_USER_ONLINE = 1,    /* Compatibility with old OPT_LOGGED_IN flag */
	BEE_USER_AWAY = 4,      /* Compatibility with old OPT_AWAY flag */
} bee_user_flags_t;

typedef struct bee_user
{
	struct im_connection *ic;
	char *handle;
	char *fullname;
	char *group;

	bee_user_flags_t flags;
	char *status;
	char *status_msg;
	
	bee_t *bee;
	void *ui_data;
} bee_user_t;

typedef struct bee_ui_funcs
{
	gboolean (*user_new)( bee_t *bee, struct bee_user *bu );
	gboolean (*user_free)( bee_t *bee, struct bee_user *bu );
	gboolean (*user_fullname)( bee_t *bee, bee_user_t *bu );
	gboolean (*user_status)( bee_t *bee, struct bee_user *bu, struct bee_user *old );
	gboolean (*user_msg)( bee_t *bee, bee_user_t *bu, const char *msg, time_t sent_at );
	
	struct file_transfer* (*ft_in_start)( bee_t *bee, bee_user_t *bu, const char *file_name, size_t file_size );
	gboolean (*ft_out_start)( struct im_connection *ic, struct file_transfer *ft );
	void (*ft_close)( struct im_connection *ic, struct file_transfer *ft );
	void (*ft_finished)( struct im_connection *ic, struct file_transfer *ft );
} bee_ui_funcs_t;


/* bee.c */
bee_t *bee_new();
void bee_free( bee_t *b );

/* bee_user.c */
bee_user_t *bee_user_new( bee_t *bee, struct im_connection *ic, const char *handle );
int bee_user_free( bee_t *bee, struct im_connection *ic, const char *handle );
bee_user_t *bee_user_by_handle( bee_t *bee, struct im_connection *ic, const char *handle );
int bee_user_msg( bee_t *bee, bee_user_t *bu, const char *msg, int flags );

/* Callbacks from IM modules to core: */
/* Buddy activity */
/* To manipulate the status of a handle.
 * - flags can be |='d with OPT_* constants. You will need at least:
 *   OPT_LOGGED_IN and OPT_AWAY.
 * - 'state' and 'message' can be NULL */
G_MODULE_EXPORT void imcb_buddy_status( struct im_connection *ic, const char *handle, int flags, const char *state, const char *message );
/* Not implemented yet! */ G_MODULE_EXPORT void imcb_buddy_times( struct im_connection *ic, const char *handle, time_t login, time_t idle );
/* Call when a handle says something. 'flags' and 'sent_at may be just 0. */
G_MODULE_EXPORT void imcb_buddy_msg( struct im_connection *ic, const char *handle, char *msg, guint32 flags, time_t sent_at );

#endif /* __BEE_H__ */
ass="w"> return 0; if( sscanf( s, "%d", &i ) != 1 ) return 0; return i; } int set_getbool( set_t **head, const char *key ) { char *s = set_getstr( head, key ); if( !s ) return 0; return bool2int( s ); } int set_isvisible( set_t *set ) { /* the default value is not stored in value, only in def */ return !( ( set->flags & SET_HIDDEN ) || ( ( set->flags & SET_HIDDEN_DEFAULT ) && ( set->value == NULL ) ) ); } int set_setstr( set_t **head, const char *key, char *value ) { set_t *s = set_find( head, key ); char *nv = value; if( !s ) /* Used to do this, but it never really made sense. s = set_add( head, key, NULL, NULL, NULL ); */ return 0; if( value == NULL && ( s->flags & SET_NULL_OK ) == 0 ) return 0; /* Call the evaluator. For invalid values, evaluators should now return SET_INVALID, but previously this was NULL. Try to handle that too if NULL is not an allowed value for this setting. */ if( s->eval && ( ( nv = s->eval( s, value ) ) == SET_INVALID || ( ( s->flags & SET_NULL_OK ) == 0 && nv == NULL ) ) ) return 0; if( s->value ) { g_free( s->value ); s->value = NULL; } /* If there's a default setting and it's equal to what we're trying to set, stick with s->value = NULL. Otherwise, remember the setting. */ if( !s->def || ( strcmp( nv, s->def ) != 0 ) ) s->value = g_strdup( nv ); if( nv != value ) g_free( nv ); return 1; } int set_setint( set_t **head, const char *key, int value ) { char s[24]; /* Not quite 128-bit clean eh? ;-) */ g_snprintf( s, sizeof( s ), "%d", value ); return set_setstr( head, key, s ); } void set_del( set_t **head, const char *key ) { set_t *s = *head, *t = NULL; while( s ) { if( g_strcasecmp( s->key, key ) == 0 ) break; s = (t=s)->next; } if( s ) { if( t ) t->next = s->next; else *head = s->next; g_free( s->key ); g_free( s->old_key ); g_free( s->value ); g_free( s->def ); g_free( s ); } } int set_reset( set_t **head, const char *key ) { set_t *s; s = set_find( head, key ); if( s ) return set_setstr( head, key, s->def ); return 0; } char *set_eval_int( set_t *set, char *value ) { char *s = value; /* Allow a minus at the first position. */ if( *s == '-' ) s ++; for( ; *s; s ++ ) if( !isdigit( *s ) ) return SET_INVALID; return value; } char *set_eval_bool( set_t *set, char *value ) { return is_bool( value ) ? value : SET_INVALID; } char *set_eval_list( set_t *set, char *value ) { GSList *options = set->eval_data, *opt; for( opt = options; opt; opt = opt->next ) if( strcmp( value, opt->data ) == 0 ) return value; /* TODO: It'd be nice to show the user a list of allowed values, but we don't have enough context here to do that. May want to fix that. */ return NULL; } char *set_eval_to_char( set_t *set, char *value ) { char *s = g_new( char, 3 ); if( *value == ' ' ) strcpy( s, " " ); else sprintf( s, "%c ", *value ); return s; } char *set_eval_oauth( set_t *set, char *value ) { account_t *acc = set->data; if( bool2int( value ) && strcmp( acc->pass, PASSWORD_PENDING ) == 0 ) *acc->pass = '\0'; return set_eval_bool( set, value ); }