@@ -9,6 +9,7 @@ Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "Solution Items", "Solution | |||
ProjectSection(SolutionItems) = preProject | |||
.gitignore = .gitignore | |||
LICENSE = LICENSE | |||
README.md = README.md | |||
EndProjectSection | |||
EndProject | |||
Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "Discord.Net.Tests", "Discord.Net.Tests\Discord.Net.Tests.csproj", "{855D6B1D-847B-42DA-BE6A-23683EA89511}" | |||
@@ -43,6 +43,20 @@ namespace Discord.API | |||
return Http.Get<APIResponses.GetMessages[]>(Endpoints.ChannelMessages(channelId, 50), options); | |||
} | |||
//Members | |||
public static Task Kick(string serverId, string memberId, HttpOptions options) | |||
{ | |||
return Http.Delete(Endpoints.ServerMember(serverId, memberId), options); | |||
} | |||
public static Task Ban(string serverId, string memberId, HttpOptions options) | |||
{ | |||
return Http.Put(Endpoints.ServerBan(serverId, memberId), options); | |||
} | |||
public static Task Unban(string serverId, string memberId, HttpOptions options) | |||
{ | |||
return Http.Delete(Endpoints.ServerBan(serverId, memberId), options); | |||
} | |||
//Invites | |||
public static Task<APIResponses.CreateInvite> CreateInvite(string channelId, int maxAge, int maxUses, bool isTemporary, bool hasXkcdPass, HttpOptions options) | |||
{ | |||
@@ -82,5 +96,25 @@ namespace Discord.API | |||
{ | |||
return Http.Get<APIResponses.GetIce>(Endpoints.VoiceIce, options); | |||
} | |||
} | |||
public static Task Mute(string serverId, string memberId, HttpOptions options) | |||
{ | |||
var request = new APIRequests.SetMemberMute { Mute = true }; | |||
return Http.Patch(Endpoints.ServerMember(serverId, memberId), options); | |||
} | |||
public static Task Unmute(string serverId, string memberId, HttpOptions options) | |||
{ | |||
var request = new APIRequests.SetMemberMute { Mute = false }; | |||
return Http.Patch(Endpoints.ServerMember(serverId, memberId), options); | |||
} | |||
public static Task Deafen(string serverId, string memberId, HttpOptions options) | |||
{ | |||
var request = new APIRequests.SetMemberDeaf { Deaf = true }; | |||
return Http.Patch(Endpoints.ServerMember(serverId, memberId), options); | |||
} | |||
public static Task Undeafen(string serverId, string memberId, HttpOptions options) | |||
{ | |||
var request = new APIRequests.SetMemberDeaf { Deaf = false }; | |||
return Http.Patch(Endpoints.ServerMember(serverId, memberId), options); | |||
} | |||
} | |||
} |
@@ -18,19 +18,21 @@ | |||
// /api/guilds | |||
public static readonly string Servers = $"{BaseApi}/guilds"; | |||
public static string Server(string id) { return $"{Servers}/{id}"; } | |||
public static string Server(string id) => $"{Servers}/{id}"; | |||
public static string ServerMember(string serverId, string userId) => $"{Servers}/{serverId}/members/{userId}"; | |||
public static string ServerBan(string serverId, string userId) => $"{Servers}/{serverId}/bans/{userId}"; | |||
// /api/guilds | |||
// /api/invites | |||
public static readonly string Invites = $"{BaseApi}/invite"; | |||
public static string Invite(string id) { return $"{Invites}/{id}"; } | |||
public static string Invite(string id) => $"{Invites}/{id}"; | |||
// /api/channels | |||
public static readonly string Channels = $"{BaseApi}/channels"; | |||
public static string Channel(string id) { return $"{Channels}/{id}"; } | |||
public static string ChannelTyping(string id) { return $"{Channels}/{id}/typing"; } | |||
public static string ChannelMessages(string id) { return $"{Channels}/{id}/messages"; } | |||
public static string ChannelMessages(string id, int limit) { return $"{Channels}/{id}/messages?limit={limit}"; } | |||
public static string ChannelInvites(string id) { return $"{Channels}/{id}/invites"; } | |||
public static string Channel(string id) => $"{Channels}/{id}"; | |||
public static string ChannelTyping(string id) => $"{Channels}/{id}/typing"; | |||
public static string ChannelMessages(string id) => $"{Channels}/{id}/messages"; | |||
public static string ChannelMessages(string id, int limit) => $"{Channels}/{id}/messages?limit={limit}"; | |||
public static string ChannelInvites(string id) => $"{Channels}/{id}/invites"; | |||
// /api/voice | |||
public static readonly string Voice = $"{BaseApi}/voice"; | |||
@@ -50,5 +50,16 @@ namespace Discord.API.Models | |||
[JsonProperty(PropertyName = "mentions")] | |||
public string[] Mentions; | |||
} | |||
public class SetMemberMute | |||
{ | |||
[JsonProperty(PropertyName = "mute")] | |||
public bool Mute; | |||
} | |||
public class SetMemberDeaf | |||
{ | |||
[JsonProperty(PropertyName = "deaf")] | |||
public bool Deaf; | |||
} | |||
} | |||
} |
@@ -26,18 +26,23 @@ namespace Discord | |||
public IEnumerable<User> Users { get { return _users; } } | |||
private AsyncCache<User, API.Models.UserReference> _users; | |||
public User GetUser(string id) => _users[id]; | |||
public IEnumerable<Server> Servers { get { return _servers; } } | |||
private AsyncCache<Server, API.Models.ServerReference> _servers; | |||
public Server GetServer(string id) => _servers[id]; | |||
public IEnumerable<Channel> Channels { get { return _channels; } } | |||
private AsyncCache<Channel, API.Models.ChannelReference> _channels; | |||
public Channel GetChannel(string id) => _channels[id]; | |||
public IEnumerable<Message> Messages { get { return _messages; } } | |||
private AsyncCache<Message, API.Models.MessageReference> _messages; | |||
public Message GetMessage(string id) => _messages[id]; | |||
public IEnumerable<Role> Roles { get { return _roles; } } | |||
private AsyncCache<Role, API.Models.Role> _roles; | |||
public Role GetRole(string id) => _roles[id]; | |||
public bool IsConnected { get { return _isReady; } } | |||
@@ -267,14 +272,14 @@ namespace Discord | |||
case "GUILD_ROLE_CREATE": | |||
{ | |||
var data = e.Event.ToObject<WebSocketEvents.GuildRoleCreateUpdate>(); | |||
var role = UpdateRole(data); | |||
var role = _roles.Update(data.Role.Id, data.Role); | |||
RaiseRoleCreated(role); | |||
} | |||
break; | |||
case "GUILD_ROLE_UPDATE": | |||
{ | |||
var data = e.Event.ToObject<WebSocketEvents.GuildRoleCreateUpdate>(); | |||
var role = UpdateRole(data); | |||
var role = _roles.Update(data.Role.Id, data.Role); | |||
RaiseRoleUpdated(role); | |||
} | |||
break; | |||
@@ -412,9 +417,7 @@ namespace Discord | |||
return _servers.Update(response.Id, response); | |||
} | |||
public Task<Server> LeaveServer(Server server) | |||
{ | |||
return LeaveServer(server.Id); | |||
} | |||
=> LeaveServer(server.Id); | |||
public async Task<Server> LeaveServer(string id) | |||
{ | |||
CheckReady(); | |||
@@ -422,6 +425,31 @@ namespace Discord | |||
return _servers.Remove(id); | |||
} | |||
//Bans | |||
public Task Ban(Server server, User user) | |||
=> Ban(server.Id, user.Id); | |||
public Task Ban(Server server, string userId) | |||
=> Ban(server.Id, userId); | |||
public Task Ban(string server, User user) | |||
=> Ban(server, user.Id); | |||
public Task Ban(string serverId, string userId) | |||
{ | |||
CheckReady(); | |||
return DiscordAPI.Ban(serverId, userId, _httpOptions); | |||
} | |||
public Task Unban(Server server, User user) | |||
=> Unban(server.Id, user.Id); | |||
public Task Unban(Server server, string userId) | |||
=> Unban(server.Id, userId); | |||
public Task Unban(string server, User user) | |||
=> Unban(server, user.Id); | |||
public Task Unban(string serverId, string userId) | |||
{ | |||
CheckReady(); | |||
return DiscordAPI.Unban(serverId, userId, _httpOptions); | |||
} | |||
//Invites | |||
public Task<Invite> CreateInvite(Server server, int maxAge, int maxUses, bool isTemporary, bool hasXkcdPass) | |||
{ | |||
@@ -503,34 +531,53 @@ namespace Discord | |||
} | |||
} | |||
public Server GetServer(string id) | |||
{ | |||
return _servers[id]; | |||
} | |||
public Channel GetChannel(string id) | |||
//Voice | |||
public Task Mute(Server server, User user) | |||
=> Mute(server.Id, user.Id); | |||
public Task Mute(Server server, string userId) | |||
=> Mute(server.Id, userId); | |||
public Task Mute(string server, User user) | |||
=> Mute(server, user.Id); | |||
public Task Mute(string serverId, string userId) | |||
{ | |||
return _channels[id]; | |||
} | |||
public User GetUser(string id) | |||
{ | |||
return _users[id]; | |||
CheckReady(); | |||
return DiscordAPI.Mute(serverId, userId, _httpOptions); | |||
} | |||
public Models.Message GetMessage(string id) | |||
public Task Unmute(Server server, User user) | |||
=> Unmute(server.Id, user.Id); | |||
public Task Unmute(Server server, string userId) | |||
=> Unmute(server.Id, userId); | |||
public Task Unmute(string server, User user) | |||
=> Unmute(server, user.Id); | |||
public Task Unmute(string serverId, string userId) | |||
{ | |||
return _messages[id]; | |||
CheckReady(); | |||
return DiscordAPI.Unmute(serverId, userId, _httpOptions); | |||
} | |||
public Role GetRole(string id) | |||
public Task Deafen(Server server, User user) | |||
=> Deafen(server.Id, user.Id); | |||
public Task Deafen(Server server, string userId) | |||
=> Deafen(server.Id, userId); | |||
public Task Deafen(string server, User user) | |||
=> Deafen(server, user.Id); | |||
public Task Deafen(string serverId, string userId) | |||
{ | |||
return _roles[id]; | |||
CheckReady(); | |||
return DiscordAPI.Deafen(serverId, userId, _httpOptions); | |||
} | |||
private Role UpdateRole(WebSocketEvents.GuildRoleCreateUpdate role, bool addNew = true) | |||
public Task Undeafen(Server server, User user) | |||
=> Undeafen(server.Id, user.Id); | |||
public Task Undeafen(Server server, string userId) | |||
=> Undeafen(server.Id, userId); | |||
public Task Undeafen(string server, User user) | |||
=> Undeafen(server, user.Id); | |||
public Task Undeafen(string serverId, string userId) | |||
{ | |||
return new Role(role.Role.Id, role.GuildId, this) | |||
{ | |||
Name = role.Role.Name, | |||
Permissions = role.Role.Permissions | |||
}; | |||
CheckReady(); | |||
return DiscordAPI.Undeafen(serverId, userId, _httpOptions); | |||
} | |||
private void CheckReady() | |||
@@ -30,32 +30,63 @@ namespace Discord.Helpers | |||
#else | |||
private const bool _isDebug = false; | |||
#endif | |||
internal static Task<ResponseT> Get<ResponseT>(string path, object data, HttpOptions options) | |||
where ResponseT : class | |||
=> Send<ResponseT>("GET", path, data, options); | |||
internal static Task<string> Get(string path, object data, HttpOptions options) | |||
=> Send("GET", path, data, options); | |||
internal static Task<ResponseT> Get<ResponseT>(string path, HttpOptions options) | |||
where ResponseT : class | |||
=> Send<ResponseT>("GET", path, null, options); | |||
internal static Task<string> Get(string path, HttpOptions options) | |||
=> Send("GET", path, null, options); | |||
internal static Task<ResponseT> Post<ResponseT>(string path, object data, HttpOptions options) | |||
where ResponseT : class | |||
=> Send<ResponseT>("POST", path, data, options); | |||
internal static Task<string> Post(string path, object data, HttpOptions options) | |||
=> Send("POST", path, data, options); | |||
internal static Task<ResponseT> Post<ResponseT>(string path, HttpOptions options) | |||
where ResponseT : class | |||
=> Send<ResponseT>("POST", path, null, options); | |||
internal static Task<string> Post(string path, HttpOptions options) | |||
=> Send("POST", path, null, options); | |||
internal static Task<ResponseT> Put<ResponseT>(string path, object data, HttpOptions options) | |||
where ResponseT : class | |||
=> Send<ResponseT>("PUT", path, data, options); | |||
internal static Task<string> Put(string path, object data, HttpOptions options) | |||
=> Send("PUT", path, data, options); | |||
internal static Task<ResponseT> Put<ResponseT>(string path, HttpOptions options) | |||
where ResponseT : class | |||
=> Send<ResponseT>("PUT", path, null, options); | |||
internal static Task<string> Put(string path, HttpOptions options) | |||
=> Send("PUT", path, null, options); | |||
//GET | |||
internal static async Task<ResponseT> Get<ResponseT>(string path, object data, HttpOptions options) | |||
internal static Task<ResponseT> Patch<ResponseT>(string path, object data, HttpOptions options) | |||
where ResponseT : class | |||
{ | |||
string requestJson = JsonConvert.SerializeObject(data); | |||
string responseJson = await SendRequest("GET", path, requestJson, options, true); | |||
var response = JsonConvert.DeserializeObject<ResponseT>(responseJson); | |||
#if DEBUG | |||
CheckResponse(responseJson, response); | |||
#endif | |||
return response; | |||
} | |||
internal static async Task<ResponseT> Get<ResponseT>(string path, HttpOptions options) | |||
=> Send<ResponseT>("PATCH", path, data, options); | |||
internal static Task<string> Patch(string path, object data, HttpOptions options) | |||
=> Send("PATCH", path, data, options); | |||
internal static Task<ResponseT> Patch<ResponseT>(string path, HttpOptions options) | |||
where ResponseT : class | |||
{ | |||
string responseJson = await SendRequest("GET", path, null, options, true); | |||
var response = JsonConvert.DeserializeObject<ResponseT>(responseJson); | |||
#if DEBUG | |||
CheckResponse(responseJson, response); | |||
#endif | |||
return response; | |||
} | |||
=> Send<ResponseT>("PATCH", path, null, options); | |||
internal static Task<string> Patch(string path, HttpOptions options) | |||
=> Send("PATCH", path, null, options); | |||
//POST | |||
internal static async Task<ResponseT> Post<ResponseT>(string path, object data, HttpOptions options) | |||
internal static Task<ResponseT> Delete<ResponseT>(string path, object data, HttpOptions options) | |||
where ResponseT : class | |||
=> Send<ResponseT>("DELETE", path, data, options); | |||
internal static Task<string> Delete(string path, object data, HttpOptions options) | |||
=> Send("DELETE", path, data, options); | |||
internal static Task<ResponseT> Delete<ResponseT>(string path, HttpOptions options) | |||
where ResponseT : class | |||
=> Send<ResponseT>("DELETE", path, null, options); | |||
internal static Task<string> Delete(string path, HttpOptions options) | |||
=> Send("DELETE", path, null, options); | |||
internal static async Task<ResponseT> Send<ResponseT>(string method, string path, object data, HttpOptions options) | |||
where ResponseT : class | |||
{ | |||
string requestJson = JsonConvert.SerializeObject(data); | |||
@@ -66,7 +97,7 @@ namespace Discord.Helpers | |||
#endif | |||
return response; | |||
} | |||
internal static async Task<string> Post(string path, object data, HttpOptions options) | |||
internal static async Task<string> Send(string method, string path, object data, HttpOptions options) | |||
{ | |||
string requestJson = JsonConvert.SerializeObject(data); | |||
string responseJson = await SendRequest("POST", path, requestJson, options, _isDebug); | |||
@@ -75,7 +106,7 @@ namespace Discord.Helpers | |||
#endif | |||
return responseJson; | |||
} | |||
internal static async Task<ResponseT> Post<ResponseT>(string path, HttpOptions options) | |||
internal static async Task<ResponseT> Send<ResponseT>(string method, string path, HttpOptions options) | |||
where ResponseT : class | |||
{ | |||
string responseJson = await SendRequest("POST", path, null, options, true); | |||
@@ -85,7 +116,7 @@ namespace Discord.Helpers | |||
#endif | |||
return response; | |||
} | |||
internal static async Task<string> Post(string path, HttpOptions options) | |||
internal static async Task<string> Send(string method, string path, HttpOptions options) | |||
{ | |||
string responseJson = await SendRequest("POST", path, null, options, _isDebug); | |||
#if DEBUG | |||
@@ -94,26 +125,6 @@ namespace Discord.Helpers | |||
return responseJson; | |||
} | |||
//DELETE | |||
internal static async Task<ResponseT> Delete<ResponseT>(string path, HttpOptions options) | |||
where ResponseT : class | |||
{ | |||
string responseJson = await SendRequest("DELETE", path, null, options, true); | |||
var response = JsonConvert.DeserializeObject<ResponseT>(responseJson); | |||
#if DEBUG | |||
CheckResponse(responseJson, response); | |||
#endif | |||
return response; | |||
} | |||
internal static async Task<string> Delete(string path, HttpOptions options) | |||
{ | |||
string responseJson = await SendRequest("DELETE", path, null, options, _isDebug); | |||
#if DEBUG | |||
CheckEmptyResponse(responseJson); | |||
#endif | |||
return responseJson; | |||
} | |||
private static async Task<string> SendRequest(string method, string path, string data, HttpOptions options, bool hasResponse) | |||
{ | |||
options = options ?? new HttpOptions(); | |||
@@ -1,7 +1,7 @@ | |||
using System.Reflection; | |||
[assembly: AssemblyTitle("Discord.Net")] | |||
[assembly: AssemblyDescription("A .Net API wrapper for the Discord client")] | |||
[assembly: AssemblyDescription("A .Net API wrapper for the Discord client.")] | |||
[assembly: AssemblyConfiguration("")] | |||
[assembly: AssemblyCompany("RogueException")] | |||
[assembly: AssemblyProduct("Discord.Net")] | |||
@@ -1,4 +1,4 @@ | |||
# Discord.Net | |||
# Discord.Net v0.2 | |||
A .Net API Wrapper for the Discord client (http://discordapp.com). | |||
## This is an alpha! | |||
@@ -6,18 +6,16 @@ The Discord API is still in active development, meaning this library may break a | |||
Discord.Net is also in early development so several functions may be unstable or not work at all. | |||
# Features | |||
- Login/Logout (account or anonymous) | |||
- Accepting Invites (standard or human readable) | |||
- Deleting Invites | |||
- Login/Logout (with credentials or anonymous) | |||
- Accepting/Creating/Deleting Invites (standard or human readable) | |||
- Receiving/Sending Messages | |||
- Creating/Destroying Servers | |||
- Creating/Destroying Channels | |||
- Kick/Ban/Unban/Mute/Unmute/Deafen/Undeafen Users | |||
- Several Discord Events | |||
# Upcoming | |||
- Modifying User/Channel/Server Settings | |||
- Creating Invites | |||
- Kick/Ban/Unban/Mute/Unmute/Deafen/Undeafen | |||
- Sending Private Messages | |||
# Example (Echo Client) | |||