Modern C# Twitter API using .NET Reactive Extensions, async calls
C# PowerShell
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
artwork
build
src
.gitignore
LICENSE.md
README.md

README.md

BoxKite.Twitter

boxkite logo

BoxKite.Twitter is a .NET 4.6 Library that provides an interface to the Twitter API 1.1, licensed MS-PL.

Supporting .NET 4.6, Universal Windows Platform (UWP), iOS (Mono/Xamarin) and Portable Class Libaries; it uses modern .NET development mechanisms async/await and Reactive Extensions.

Questions? You can find me on Twitter, of course! @RealNickHodge

@ghuntley has a great BoxKite.Twitter examples here

Version News

Version 2.4.0 Changes:

  • Add support for >140 character Direct Message sending. BoxKite.Twitter does not truncate messages, but the Direct Message API required passing a parameter indicating support for >140 characters. This is now implemented.

Version 2.3.0 Changes:

  • Change Desktop .NET to 4.6
  • Remove Windows 8/Windows Phone 8 targets (please use Portable or older versions of BoxKite.Twitter)
  • Addition of Universal Windows Platform supporting both Windows 10 and Windows Mobile 10

Version 2.2.x Changes:

  • Thanks to @vikingcode, new extended_entities are added to the Twitter object. This is in preparation for Twitter's addition of video to their supported media types As this is yet to be widely used, expect some fixes!
  • Added various other edge/new APIs (GetConfiguration) with appropriate tests

Version 2.1 Changes:

  • Many areas of code cleanup, with some property/model name changes
  • If SearchStream/UserStream disconnects; will try a reconnect (automatically)

Version 2.0.x-pre Implements/Changes:

Plans for 2.3 Release

  • cleanup with <Func> work in Backfills
  • better state machine for connect/disconnect eg: in mobile environments
  • change to BoxKiteTwitter exception handling from "inline" (what a stupid idea that was) errors

Version 1.5.x Implements:

  • start of Application-only Authentication via OAuth2
  • this is going to require some rework in the API to permit App-level API access (pull user timelines, friends of account, list resources, search in tweets etc) without a user login.

Version 1.4.x Implements:

  • Getting/Setting Profile Banners (added to twitter API 21st April 2014)
await session.GetProfileBanners(screen_name:"realnickhodge");
await session.ChangeProfileBanner("boxkite1500x500", fs);
  • User now contains Profile Banner URL, if turned on by the user (thanks Paul!)

Version 1.3.x Fixes/Implements:

  • Universal App support
  • Roll in Reactive.EventAggregator into BoxKite.Twitter itself because @shiftkey

Version 1.2.x Fixes/Implements:

  • As per Twitter List IDs moving to 64 bits in early 2014
  • TwitterConnection is the central "entry point" to BoxKite.Twitter
  • VS2013 build
  • IStreamEvent work to abstract messages from the UserStream
  • various other fixes

1.0.6 (and 1.0.5) Fixes/Implements:

  • Adding support for latest Portable HTTPClient
  • Adding more Rx in many places to make life easier
  • Fixed bug where gzip compression on the HTTP Stream (for userstreams) didn't flush tweets from the server-side.
  • various small bugs found in tweet backfills, found when testing with a fresh account

1.0.4 Fixes/Implements:

  • As per Twitter: User IDs moving to 64 bits later in 2013
  • Note: Using .NET long to hold user_id
  • Note: this impacts any downstream client expecting plain old 32 bit ints
  • FriendlyDateTimeString now says "Just Now" rather than "in 13 seconds" when user's device clock has drifted forward from correct internet time.

Twitter API Coverage

At the present time, BoxKite.Twitter supports API version 1.1 of the following:

NuGet Package

BoxKite.Twitter listing on NuGet

Install-Package BoxKite.Twitter

So What Does the Code look like?

Pop into the wiki to see code examples

Wiki documentation

Documentation is online and provided in the Wiki

Extra Info and Documentation

To Build:

  • Visual Studio 2015 Update 1 with latest NuGet supporting PCLs (Portable Class Libraries) and Universal Windows Platform
  • Solution is Visual Studio 2015 Update 1, but code should work and build with previous versions of Visual Studio
  • Visual Studio 2015 Community Versions should also be OK (but I haven't tested this)
  • Uses Xamarin Studio 5.9.4 (or later) for Android and iOS builds. Disable these projects if you don't have Xamarin installed

Where you can help out

  • Modeling the API to make sense for more developers than me
  • Additional harness for Reactive hook up
  • Stronger "this works on non-Microsoft .NET platforms" live testing and experience
  • Always more Documentation, of course

API Coverage, With Tests & Intellisense Comments

From Twitter REST API v1.1

Tests:

  • 124 test methods with average of 4 assertion tests each
  • Both Twitter API 1.1 and Userstream Unit Tests
  • 53 "Live Fire Tests" (Live integration tests) Included as a separate project, it is engaged via the Console; uses a real Twitter Account to exercise the API. Configurable Test series, individual tests that can be run.
  • Test source is JSON from dev.twitter.com and where innaccurate on the site, taken from live data or corrected to match live data.
  • Error response type testing (eg: 429 rate_limits) & generic decode tests included

Dependencies

(Dependency when running BoxKite.Twitter.Tests only)

  • Great little collection of extension methods that make writing UnitTests easier FluentAssertions (MS-PL)

Copyright, License Information

BoxKite.Twitter was started by Brendan Forster (https://github.com/shiftkey/) as a part of a larger Twitter project now on permanent hiatus.

BoxKite.Twitter is Licensed under: MS-PL

Copyright: Nick Hodge and Brendan Forster 2012-2016

BoxKite Logo is Copyright 2012 Nick Hodge

Why BoxKite?

Everyone likes flying kites, right? The original inventor of the box kite was Lawrence Hargrave. In 1893. And he was an Australian. Sadly missing from our newer plastic yet colourful currency, Lawrence was one of those guys who helped manned flight become a reality.

And keeping with the Twitter bird theme, flying and airborne I created a fork of the MahTweets twitter client in late 2011 and named it MahTweets Lawrence Hargrave.

In mid 2012, Brendan needed a code name for a new Twitter "thing" he was working on. Keeping in this flighty theme, I named his app "BoxKite". For posterity's sake, I have absconded with Brendan's code, and my contributed codename (and a nifty icon) and have dubbed this project BoxKite.