Task Watchr

What is this?

This is a simple way to create tasks in your favourite task management systems via twitter mentions.

Current Architecture And Features

The project splits into the two parts: the core and the frontend.

The core lives inside lib-directory. It designed to be fully independent from any frontend, so it is possible to call it from terminal or web-interface. It requires right social credentials passed as arguments and right settings for task-managment adapters to be stored inside Redis.

The frontend is a rails app, that gives a user an opportunity to easily connect twitter and task mgmt accounts, configure adapters and kick-off the fetchr.

Features

• Twitter's rate-limits handling
• Full importing of your mentions timeline
• Watching for a new mentions
• Auto-retrying for failed postings
• Possibility to work in sync/async mode
• Redbooth integration

Current limitations

Core limitations

• No way to stop the fetchr
• Sidekiq runs on a default settings, need to tune them up

Frontend Limitations

• Adapters' settings page is too coupled with the main site, better to be an engine
• Redbooth settings page makes a sync-network call to get a list of tasklists
• Adding new adapters should be simplified
• Runs on Webrick, need to setup something serious.

How to add a new adapter?

Core support

• Add new adapter to lib/social_posts/adapters. It should respond to post_task method.
• Add TokenUpdater class if needed
• Extend SocialPostr::ADAPTERS_LIST with your adapter's name

Frontend

• Create settings page for the adapter
• Extend FetchrStatusDecorator to support statuses for it

How to run locally?

Requirements

• Ruby 2.1
• Redis

Actions

• clone it
• bundle install
• take a look into .env.sample and create your own .env with the right values
• run tests bundle exec rspec. Note that twitter fetch specs will fail even with right ENV-vars, because its bundled to a specific account