Project 4 - Twitter Stream

Twitter Stream is an android app that allows a user to view his Twitter timeline and post a new tweet. The app utilizes Twitter REST API.

Time spent: 20 hours spent in total

User Stories

The following required functionality is completed:

• [x] User can sign in to Twitter using OAuth login
• [x] User can view tweets from their home timeline
  • [x] User is displayed the username, name, and body for each tweet
  • [x] User is displayed the relative timestamp for each tweet "8m", "7h"
  • [x] User can view more tweets as they scroll with infinite pagination. Number of tweets is unlimited. However there are Twitter Api Rate Limits in place.
• [x] User can compose and post a new tweet
  • [x] User can click a “Compose” icon in the Action Bar on the top right
  • [x] User can then enter a new tweet and post this to twitter
  • [x] User is taken back to home timeline with new tweet visible in timeline
• [x] The app includes all required user stories from Week 3 Twitter Client
• [x] User can switch between Timeline and Mention views using tabs
  • [x] User can view their home timeline tweets.
  • [x] User can view the recent mentions of their username.
• [x] User can navigate to view their own profile
  • [x] User can see picture, tagline, # of followers, # of following, and tweets on their profile.
• [x] User can click on the profile image in any tweet to see another user's profile.
  • [x] User can see picture, tagline, # of followers, # of following, and tweets of clicked user.
  • [x] Profile view includes that user's timeline
• [x] User can infinitely paginate any of these timelines (home, mentions, user) by scrolling to the bottom

The following optional features are implemented:

• [x] User can see a counter with total number of characters left for tweet on compose tweet page
• [x] User can click a link within a tweet body on tweet details view. The click will launch the web browser with relevant page opened.
• [x] User can pull down to refresh tweets timeline
• [ ] User can open the twitter app offline and see last loaded tweets. Persisted in SQLite tweets are refreshed on every application launch. While "live data" is displayed when app can get it from Twitter API, it is also saved for use in offline mode.
• [ ] User can tap a tweet to open a detailed tweet view
• [ ] User can select "reply" from detail view to respond to a tweet
• [x] Improve the user interface and theme the app to feel "twitter branded"
• [ ] User can view following / followers list through the profile
• [ ] Implements robust error handling, check if internet is available, handle error cases, network failures
• [ ] When a network request is sent, user sees an indeterminate progress indicator
• [x] User can "reply" to any tweet on their home timeline
  • [x] The user that wrote the original tweet is automatically "@" replied in compose
• [x] User can take favorite (and unfavorite) or retweet actions on a tweet
• [ ] User can search for tweets matching a particular query and see results
• [x] Usernames and hashtags are styled and clickable within tweets using clickable spans

The following bonus features are implemented:

• [x] User can see embedded image media within the tweet detail view
• [ ] User can watch embedded video within the tweet
• [x] Compose tweet functionality is build using modal overlay
• [x] Use Parcelable instead of Serializable using the popular Parceler library.
• [x] Leverage RecyclerView as a replacement for the ListView and ArrayAdapter for all lists of tweets.
• [x] Move the "Compose" action to a FloatingActionButton instead of on the AppBar.
• [x] On the Twitter timeline, leverage the CoordinatorLayout to apply scrolling behavior that hides / shows the toolbar.
• [ ] Replace all icon drawables and other static image assets with vector drawables where appropriate.
• [ ] Leverages the data binding support module to bind data into layout templates.
• [x] Replace Picasso with Glide for more efficient image rendering.
• [ ] Enable your app to receive implicit intents from other apps. When a link is shared from a web browser, it should pre-fill the text and title of the web page when composing a tweet.
• [x] When a user leaves the compose view without publishing and there is existing text, prompt to save or delete the draft. The draft can be resumed from the compose view.
• [ ] Leverages the data binding support module to bind data into layout templates.
• [x] On the profile screen, leverage the CoordinatorLayout to apply scrolling behavior as the user scrolls through the profile timeline.
• [ ] User can view their direct messages (or send new ones)

The following additional features are implemented:

• [ ] List anything else that you can get done to improve the app functionality!

Video Walkthrough

[Link to Video Walkthrough] https://github.com/santhoshsachindran/TwitterStream/blob/master/Project4.mp4

Notes

Describe any challenges encountered while building the app.

Open-source libraries used

• Android Async HTTP - Simple asynchronous HTTP requests with JSON parsing
• Picasso - Image loading and caching library for Android
• Parceler - Android Parcelables made easy through code generation
• Glide - An image loading and caching library for Android focused on smooth scrolling
• Butterknife - Bind Android views and callbacks to fields and methods
• Android OAuth Handler - Android OAuth Wrapper makes authenticating with APIs simple

License

Copyright [2016] [Santhosh Sachindran]

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

    http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.