CHANGELOG.md

4.4.0

• Add Twitter::API::FriendsAndFollowers#friends and Twitter::API::FriendsAndFollowers#followers (@tibbon)
• Add method parameter to Twitter::API::Users#users (@thomasjklemm)
• Correct endpoint of Twitter::Client#report_spam method (@uasi)
• Refactor Twitter::Request class
• Remove Array core extensions
• Remove String core extensions
• Remove Hash core extensions
• Do not require 'identity_map' by default
• Automatically define inquirer methods

4.3.0

• Add Twitter::API#profile_banner

4.2.0

• Use new resource for Twitter::API#retweets_of_me
• Twitter::API#favorite no longer raises Twitter::Error::Forbidden
• Twitter::API#retweet no longer raises Twitter::Error::Forbidden
• Add Twitter::Error::AlreadyFavorited
• Add Twitter::Error::AlreadyRetweeted

4.1.2

• Add abort_on_exception to Enumerable#threaded_map (@aheaven87)

4.1.1

• Fix bug in Twitter::Tweet#full_text
• Add Twitter::Tweet#favouriters, Twitter::User#favoriters_count, and Twitter::User#favouriters_count aliases

4.1.0

• Handle new API v1.1 list response format

4.0.0

• Update all endpoints to Twitter API v1.1
• Replace per_page parameter with count
• Use HTTP POST for users/lookup
• Add error classes for new Twitter API v1.1 response codes
• Cache screen name in an instance variable to avoid API calls
• Update Twitter::RateLimit class for API v1.1
• Remove search endpoint
• Remove media endpoint
• Disable identity map by default
• Remove deprecated RateLimit.instance method
• Removed deprecated Twitter::Tweet#oembed method
• Rename resources for v1.1
• Remove notification methods; use Twitter::API#friendship_update instead
• Remove Twitter::API#end_session
• Add Twitter::Tweet#retweet? method and Twitter::Tweet#retweet alias
• Major changes for Twitter API v1.1
• Remove Twitter::API#no_retweet_ids
• Remove Twitter::API#retweeted_to_user
• Remove Twitter::API#trends_daily
• Remove Twitter::API#trends_weekly
• Remove Twitter::API#rate_limited?
• Remove Twitter::Client#rate_limit
• Remove Twitter::API#rate_limit_status
• Remove Twitter::API#accept
• Remove Twitter::API#deny
• Remove Twitter::API#related_results
• Remove Twitter::API#recommendations
• Remove Twitter::API#network_timeline

3.8.0

• Do not attempt to parse redirects (@twoism)
• Add profile banner methods to Twitter::User class
• Add Twitter::Error::UnprocessableEntity
• Add Twitter::API#update_profile_banner and Twitter::API#remove_profile_banner
• Add Twitter::Tweet#reply?

3.7.0

• Remove support for IO hash syntax
• Allow Tempfile to be passed to Twitter::API#update_with_media
• Set Content-Type header to multipart/form-data when uploading a file
• Do not attempt to parse bodies that only contain spaces
• Add Twitter::Tweet#entities? method
• Add Twitter::User#status? method

3.6.0

• Rename Twitter::Status to Twitter::Tweet
• Make Twitter::Cursor an Enumerable
• Always define respond_to_missing? when overriding method_missing

3.5.0

• Add Twitter::API#related_results
• Alias Twitter::API#status_destroy to Twitter::API#tweet_destroy
• Alias Twitter::API#status_activity to Twitter::API#tweet_activity
• Move IdentityMapKeyError under Twitter::Error namespace

3.4.1

• Prevent MultiJson::DecodeError error from bubbling up
• Add British aliases for "favorite" methods on Twitter::Status
• Correctly handle nil response body

3.4.0

• Refactor retweeted_to and retweeted_by into multiple methods

3.3.1

• Fix authentication bug

3.3.0

• Refactor Twitter::RateLimit class to be non-global
• Combine Twitter::RateLimit#retry_after and Twitter::RateLimit#reset_in into a single method
• Create proper interface for Twitter::IdentityMap
• Move Twitter::Point and Twitter::Polygon classes under Twitter::Geo namespace
• Move Twitter::Photo class under Twitter::Media namespace

3.2.0

• Make identity map configurable
• Decouple identity map from object instantiation
• Make IdentityMapKeyError inherit from IndexError
• Break up Twitter::User class into Twitter::BasicUser, Twitter::SourceUser, Twitter::TargetUser, and Twitter::User

3.1.0

• Add size option to Twitter::User#profile_image_url and Twitter::User#profile_image_url_https
• Make object equality more strict
• Pass options from Twitter::Client.user to Twitter::Client.verify_credentials

3.0.0

• All returned hashes now use Symbol keys instead of String keys
• Twitter::Client methods now allow multiple arguments and return an Array
• Twitter::Client#users can now return more than 100 Twitter::User objects
• Twitter::Client#search now returns a Twitter::SearchResult object instead of an array of Twitter::Status objects (@wjlroe)
• Twitter::Client#follow now checks to make sure a user is not already being followed before following
• Add Twitter::Client#follow! to follow a user without checking whether they are already being followed
• Add an identity map
• Attempt to pull credentials from the environment when not specified
• Add default timeout options
• Middleware is now specified as a Faraday::Builder
• Faraday errors are now captured and re-raised as a Twitter::Error::ClientError
• Replace Twitter::Error.ratelimit methods with the singleton Twitter::RateLimit class
• Remove explicit proxy and user agent configuration
• Remove untested gateway middleware
• Remove deprecated Twitter::Status#expanded_urls method

2.5.0

• Remove Active Support dependency

2.4.0

• Twitter::User objects can be used interchangeably with user IDs or screen names
• Twitter::List objects can be used interchangeably with list IDs or slugs

2.3.0

• Merge Twitter::Client modules into a monolithic Twitter::Client class
• Add Twitter::Status#full_text
• Add profile_image_url_https accessor to Twitter::Status (@terryjray)
• Make Status#screen_name return from_user attribute and vice versa
• Add created_at attribute to Twitter::List
• Add ability to pass a user to Twitter::Client#recommendations
• Alias trends to local_trends (@Tricon)

2.2.0

• Don't create a new Faraday instance on every request
• Add Twitter::Mention#source
• Add Twitter::ListMemeberAdded (@aamerabbas)
• Add entities attribute to Twitter::Status (@tomykaira)
• Add Twitter::Client#list_remove_members

2.1.0

• Add in_reply_to_status_id attribute to Twitter::Status
• Remove twitter-text dependency
• Add Twitter::Status#retweeted_status
• Add optional parameter hash to Twitter::Client#oembed
• Fix Twitter::Status object returned by Twitter::Client#retweet
• Add from_user_name and to_user_name attributes to Twitter::Status

2.0.0

• Replace Hashie::Mash with custom classes and Ruby primitaives
• Any instance method that returns a boolean can now be called with a trailing question mark
• The created_at instance method now returns a Time instead of a String
• Replace the Twitter::Search class with Twitter::Client#search
• Add object equivalence
• [Twitter::Client#totals has been removed. Use Twitter::Client#user instead]((https://github.com/sferik/twitter/commit/1ad0928a6232324072e8d960242a99949016cf50)
• Twitter.faraday_options has been renamed to Twitter.connection_options
• All error classes have been moved inside the Twitter::Error namespace
• Remove support for XML response format
• Remove all deprecated methods

1.7.2

• Update multi_xml dependency to 0.4.0 (@masterkain)
• Add support for passing options directly to faraday (@icambron)
• Deprecate Trends#trends_current and remove the XML response format

1.7.1

• Refactor connection and requests to accept options (@laserlemon)
• Include X-Phx header for internal APIs only (@laserlemon)

1.7.0

• Add Account#totals and Account#settings (@gazoombo)
• Add Activity#about_me and Activity#by_friends
• Add Help#configuration and Help#language (@anno)
• Add Search#images_facets and Search#video_facets
• Add Search#search
• Add Statuses#media_timeline
• Add Tweets#update_with_media (@JulienNakache)
• Add Urls#resolve
• Add User#contributees (@GhettoCode)
• Add User#contributor
• Add User#recommendations
• Add User#suggest_users
• Move API version out of endpoint and into path

1.6.2

• Update hashie dependency to 1.1.0

1.6.1

• Update faraday dependency to 0.7.0 (@ngauthier)

1.6.0

• Add a custom OAuth implementation (@NathanielBarnes)
• Unify naming of boolean methods
• Add convenience method to determine whether a user exists
• Fully remove Rash

1.5.0

• Change interface to make Twitter module behave more like a class

1.4.1

• Update multi_json dependency to version 1.0.0

1.4.0

• Update list methods to use new resources (@erebor)
• Fix copy/paste bug in Error#ratelimit_remaining

1.3.0

• Update faraday dependency to version 0.6
• Include response headers when raising an error
• Fix typo in README for accessing friends and followers (@surfacedamage)

1.2.0

• Respect global load path
• Use map and Hash[] instead of inject({}) (@wtnelson)
• Check headers for Retry-After in absence of retry-after (@wtnelson)
• Fix name of #list_add_members resource
• Don't strip @ signs from screen names
• Make #places_similar method return a token (@nicolassanta)

1.1.2

• Opt-in for testing with rubygems-test
• Add support for Twitter.respond_to? (@fernandezpablo)

1.1.1

• Don't set cached screen_name when creating a new API client

1.1.0

• Overload all methods that require a screen_name parameter (@gabriel_somoza)
• Rename user_screen_name to screen_name (@jalada)
• Handle error returns from lookup (@leshill)
• Use 'tude' parameter for attitudes (@ALindeman)
• Add Enumerable mixin to Twitter::Search (@ALindeman)

1.0.0

• Fix conditional inclusion of jruby-openssl in Ruby 1.9
• Allow users to pass in screen names with leading '@'
• UTF-8 encode Utils module
• Copy-edit documentation (@dianakimball)
• Add methods to Search class
• Changes to Search class
• Add proxy support
• Make #suggestions method consistent with Twitter API documentation
• Rename default user agent
• Make all global settings overrideable at the class level
• Expose a property in EnhanceYourCalm for HTTP header "Retry-After" (@duylam)
• Merge Base, Geo, Trends, and Unauthenticated into Client class (@laserlemon)
• Move examples into README
• Rename Twitter.scheme to Twitter.protocol
• Map access key/secret names to SimpleOAuth correctly
• Improved error handling by separating HTTP 4xx errors from HTTP 5xx errors, so HTTP 4xx errors can be parsed first
• Add tests for XML response format
• Switch from httparty to faraday HTTP client library
• Switch from oauth to simple_oauth for authentication (@laserlemon)
• Handle errors in faraday middleware
• Add #NewTwitter methods and tests
• Fix tests that assume position in a Hash (@duncan)
• Enable SSL by default (add option to disable SSL)
• Use HTTP DELETE method instead of HTTP POST for all destructive methods
• Change the method signature for Base#users and Base#friendships to accept an Array and an options Hash
• Add Twitter.profile_image method (@ratherchad)
• Improve website style (@rodrigo3n)
• Make request format configurable

0.9.12

• Rename parameters to be less confusing (@rorra)
• Update user method to match the Twitter API docs (@nerdEd)
• Add aliases for search methods
• Add Twitter.user_agent and Twitter.user_agent= methods
• Add Search#locale method

0.9.11

• Add a Search#filter method (@pjdavis)
• Add test to ensure Search#fetch doesn't overwrite @query(:q) (@pjdavis)
• Add Search#retweeted and Search#not_retweeted methods (@levycarneiro)
• Switch from YAJL to MultiJson (@MichaelRykov)

0.9.10

• Specify Twitter API version for all REST API calls
• Parse all responses with YAJL JSON parser
• Ensure that users are tested (@duncan)
• Remove redgreen due to Ruby 1.9 incompatibility (@duncan)
• Make all tests pass in Ruby 1.9 (@duncan)

0.9.9

• Bump dependency versions
• Remove Basic Auth (@rodrigo3n)
• Flatten ids_or_usernames before iterating (@jacqui)
• Add an example to list followers and friends sorted by followers count (@danicuki)
• Add optional query parameter to list_subscribers
• Change trends endpoint to api.twitter.com/1/trends
• Use Bundler

0.9.8

• Geo API (@anno)
• Set api_endpoint for unauthenticated calls (@earth2marsh)

0.9.7

• Add api_endpoint option for Search

0.9.6

• Deprecated Basic Auth
• Add api_endpoint option for OAuth

0.9.5

• Saved searches (@zmoazeni)
• Handle null result sets in search more gracefully (@sferik)
• Add report_spam (@chrisrbailey)
• Tests for friendship_exists? method (@sferik)
• Replace JSON parser with YAJL JSON parser (@sferik)
• Cursors for lists (@zmoazeni)

0.9.4

• Rolled back search API endpoint to get around rate limiting issues (@secobarbital)

0.9.3

• Restore Ruby 1.8.6 compatibility (@raykrueger)

0.9.2

• Make error handling consistent between authenticated and unauthenticated method calls (@sferik)
• Test error handling for unauthenticated methods (@sferik)

0.9.1

• Add cursor to lists method (@sferik)
• Add Twitter API version to trends method calls (@sferik)
• Add Twitter API version to unauthenticated method calls (@sferik)
• Remove rubygems dependencies (@sferik)

0.9.0

• Add Base#retweeters_of method
• Add result_type to search for popular/recent results
• Add users method for bulk user lookup (@sferik)
• Add Twitter API version to authenticated method calls (@sferik)
• Search exclusions (@abozanich)

0.8.6

• Bump httparty version (@dewski)

0.8.5

• Add Search#next_page? and Search#fetch_next_page methods (@cyu)

0.8.4

• Add query parameter to membership method (@mingyeow)
• Add Search#phrase method (@zagari)
• Add Trends#available and Trends#location methods

0.8.3

• Add Twitter.list_timeline method (@spastorino)

0.8.2

• Add Base#update_profile_image method (@urajat)

0.8.1

• Add Twitter.timeline method

0.8.0

• Make API endpoint configurable to use services like Tumblr

0.7.11

• Add list timeline paging (@kchen1)

0.7.10

• Add Base#blocks and Base#blocking methods

0.7.9

• Add Base#retweets method (@ivey)

0.7.8

• Use cursor parameter to list_members method (@ivey)

0.7.7

• Fix bug in list_remove_member when using OAuth
• Bump oauth dependency to version 0.3.6
• Add Base#update_profile_background method (@kev_in)
• Add Base#blocked_ids method (@rizwanreza)
• Add Search#since_date and Search#until_date methods (@jschairb)

0.7.6

• Add Base#home_timeline method (@coderifous)

0.7.5

• Use Hashie instead of Mash to avoid conflicts with extlib (@hassox)

0.7.4

• Support for user search

0.7.3

• Add Base#list_subscriptions method (@christospappas)

0.7.2

• Add Base#friendship_show method (@dcrec1)

0.7.1

• Bump dependency versions

0.7.0

• Add support for lists

0.6.14

• Lower oauth dependency to version 0.3.4 as people are complaining about 0.3.5

0.6.13

• Bump oauth dependency to version >= 0.3.5

0.6.12

• Fix fakeweb test issue (@obie)
• Add Search#user_agent method

0.6.11

• Add the ability to sign in with Twitter instead of authorizing

0.6.10

• Add Trends#current, Trends#daily, and Trends#weekly methods

0.6.9

• Bump oauth dependency to version 0.3.4

0.6.8

• Fix httparty dependency

0.6.7

• Bump httparty dependency to version 0.4.3 which allows response.message and fixes errors that the lack of response.message was causing

0.6.6

• Add query parameter to user method
• Add ssl optional parameter to use HTTPS instead of HTTP for HTTPAuth
• Add Twitter.status, Twitter.friend_ids, and Twitter.follower_ids methods

0.6.5

• Fix friend_ids and follower_ids bombing on mashing

0.6.4

• More explicit about dependency versions in gemspec and when requiring

0.6.3

• Add Twitter.user method

0.6.2

• Add Search#max method

0.6.1

• Rename one of the two friend_ids methods to follower_ids

0.6.0

• Add HTTP authentication

0.5.3

• Only send follow parameter to Twitter if follow is true for calls to friendship_create

0.5.2

• Add mash as an install dependency
• Add options to search
• Add missing variables in exception raising
• Add development dependencies to Rakefile to make that more explicit (@technomancy)
• Add workaround for Mash#hash that allows using return objects in sets and such (@technomancy)

0.5.1

• Add data error hash returned from Twitter to a few of the exceptions to help with debugging
• Fix bug with friendship_exists? throwing a stringify keys error because it was returning true or false instead of a Hash or Array

0.5.0

• Proxy no longer supported (someone please add it back in, I never use proxies)
• Identica support killed with an axe (nothing against them but I don't use it)
• CLI shot to death (will be reborn at a later date using OAuth and its own gem)

0.4.3

• Make verify_credentials return a Twitter::User rather than a Hpricot doc

0.4.2

• Add Base#friend_ids and Base#follower_ids methods (@joshowens)

0.4.1

• Add better exception handling (@billymeltdown)
• Add Search#page method (@ivey)
• Add an option to display tweets on CLI in reverse chronological order (@coderdaddy)
• Add in_reply_to_status_id option for replying to statuses (@anthonycrumley)
• [Fix a bug where the @config was improperly set (@pope)
• Fix verify_credentials to include a format (@dlsspy)

0.4.0

• Remove Active Support dependency and switched to echoe for gem management
• Remove CLI dependencies

0.3.7

• Fix source parameter not getting through

0.3.6

• Refactor the remaining methods that were not using request to use it

0.3.5

• Remove sqlite-ruby dependency

0.3.4

• Add Search class

0.3.3

• Add Identica support (@dlsspy)
• Update methods to POST instead of GET

0.3.2

• Add the CLI gems as dependencies until it is separated from the API wrapper
• Add cleaner CLI errors for no active account or no accounts at all
• Add username and password parameters to add method

0.3.1

• Add open method to CLI
• Add -f option to timeline and replies which ignores the since_id and shows all results
• Add clear_config to remove all cached values
• Improved the output of timelines and replies

0.3.0

• Support multiple accounts in CLI and switching between them
• Make d method accept stdin
• Add Status#source, Status#truncated, Status#in_reply_to_status_id, Status#in_reply_to_user_id, Status#favorited, and User#protected methods
• Add Base#friendship_exists?, Base#update_location, Base#update_delivery_device, Base#favorites, Base#create_favorite, Base#destroy_favorite, Base#block, and Base#unblock methods
• Rewrite methods that had since or lite parameters to use a Hash

0.2.7

• Add Base#rate_limit_status method (@danielmorrison)
• Add source parameter to Base#post
• Add twittergem as the source when posting from the command-line interface
• Raise Twitter::RateExceeded when you hit your limit (@jimoleary)
• Raise Twitter::Unavailable when Twitter returns 503
• Make Twitter::CantConnect messages more descriptive
• Make quoting your message optional when posting from the command-line interface (@bcaccinolo)
• Alias post to p on the command-line interface (@bcaccinolo)
• Unescape HTML and add color to the command-line interface (@mileszs)
• Add gemspec (@technoweenie, [@mileszs(https://twitter.com/mileszs))
• Fix stack trace error on first command-line operation (@mrose2n)

0.2.6

• Found a simpler way of doing stdin without any extra gem dependencies

0.2.5

• Command-line interface can use stdin for posting (@reclusive_geek) $ twitter post 'test without stdin' # => twitters: test without stdin $ echo 'test with stdin' | twitter post 'and an argv(1)' # => twitters: test with stdin and an argv(1) $ echo 'test with stdin without any argv(1)' | twitter post # => twitters: test with stdin without any argv(1)

0.2.4

• Add lite parameter to friends and followers methods, which doesn't include the user's current status (@danielmorrison)
• Update since parameter to use HTTP header (@danielmorrison)
• Add since parameter on timeline and replies methods (@danielmorrison)

0.2.3

• Add d to the command-line interface (@humbucker)
• Add progress dots while waiting for confirmation when Twitter is being slow (@HendyIrawan)

0.2.2

• Add Base#leave and Base#follow methods

0.2.1

0.2.0

• Alias direct_messages to received_messages
• Add Base#sent_messages, Base#create_friendship, Base#destroy_friendship, Base#featured, Base#replies, Base#destroy, and Base#status methods
• Add Active Support dependency
• Add Base#d method (@jnewland)
• Fix since parameter in Base#direct_messages method (@jnewland)

0.1.1

• Add support for Hpricot 0.5+ (@erebor)

0.1.0

• Add Base#d method
• Add Base#direct_messages method
• Add Base#featured and Base#friends_for methods
• Add tests
• Remove relative_created_at

0.0.5

• Code cleanup

0.0.4

• Add User#location, User#description, User#url, and User#profile_image_url methods (@al3x)

0.0.3

• Make error message more informative

0.0.2

• Add command-line options for friend and follower
• Improved docs

0.0.1

• Initial release