https://github.com/fmorgner/FMTwitterKit

A simple to use but full-featured Twitter framework
https://github.com/fmorgner/FMTwitterKit

Last synced: about 1 month ago
JSON representation

A simple to use but full-featured Twitter framework

• Host: GitHub
• URL: https://github.com/fmorgner/FMTwitterKit
• Owner: fmorgner
• Created: 2010-08-24T17:55:28.000Z (over 14 years ago)
• Default Branch: master
• Last Pushed: 2011-09-11T14:28:03.000Z (over 13 years ago)
• Last Synced: 2023-03-10T23:38:41.211Z (almost 2 years ago)
• Language: Objective-C
• Homepage:
• Size: 197 KB
• Stars: 4
• Watchers: 2
• Forks: 1
• Open Issues: 0
• Metadata Files:
  • Readme: README.asciidoc

Awesome Lists containing this project

• awesome - FMTwitterKit - A simple to use but full-featured Twitter framework (etc)

README

        
ReadMe

======

Felix Morgner 

:Author Initials: FHM

:website: http://www.felixmorgner.ch

:numbered:

FMTwitterKit provides you with simple ways to work with tweets and Twitter users. In the next few lines I'd like to show you the basic concepts of FMTwitterKit and how to use it.

How the data flows into FMTwitterKit

------------------------------------

You are responsible for the downloading of the raw XML data from the twitter.com servers. You could use your own URLs or do it the recommended way and use the integrated URL constants. This way you are always up-to-date with the latest changes done by twitter.

What you get back

-----------------

After you downloaded the XML data from the twitter.com servers you will want to give to the 'tweetsFromXMLDocument:' method on 'FMTweetFactory'. This method returns you an array of 'FMTweet's.

Why FMTweet and not a simple dictionary

---------------------------------------

"Tweets _are_ tweets _stay_ tweets forever" - Felix Morgner on tweets

First, FMTweet represents a tweet whereas a dictionary represents a dictionary. In Objective-C we live in an object-oriented world. This is one of the reasons why a tweet is represented as a tweet.

Another reason is that FMTweet can provide you with some convenience methods. For example: Twitter only provides you with the hex value for the users profile text color and thats where FMTweet comes in handy. You can ask a FMTweet for a NSColor representation of the users profile text color.

About authorization and authentication

--------------------------------------

Once upon a time twitter used 'HTTP Basic Auth' for authenticating twitter users. In this time gaining access to the 'friends- timeline' of a user, or posting to the 'user timeline' was pretty easy to accomplish. Since then this has totally changed. Now twitter uses OAuth, an open authentication standard, as authentication protocol. In OAuth not users but applications get authorized and authenticated. This is the reason why FMTwitterKit doesn't do authentication for you.

How to get a tweet to twitter

-----------------------------

To post a tweet to twitter, you need to supply twitter with a POST request including at least the status text in the HTTP body. Twitter then replies to you with a JSON or XML representation. Since FMTwitterKit uses XML for it's whole workflow you should use the XML returning URL or - much better - use the integrated URL constant.