NewsToChat

NewsToChat gathers your favorite articles across the web and posts a link to them in HipChat.

###Development

Get the required dependencies:
- Download Vagrant from:
  - http://www.vagrantup.com/downloads.html
- Download VirtualBox and the Extension Pack from:
  - https://www.virtualbox.org/
Clone the repository and start the virtual machine (the first time will take awhile to boot)
- $ git clone https://github.com/kherrick/NewsToChat
- $ cd NewsToChat/
- $ bin/vm start
- $ bin/vm make init
To turn off the virtual machine
- $ bin/vm stop
To login to the virtual machine
- $ bin/vm ssh
Run unit tests, and see a coverage report:
- bin/vm make test
- bin/vm make test-coverage

###Hosting

Successfully hosted on:
- Amazon AWS / Debian 7.6 / PHP 5.4.4
- Had to apt-get install php5-cli php5-curl php5-sqlite to make things work properly from a default install.

###Methods for usage

There are three basic commands:
- pullnews: pull from the identified news sources, scan for duplicates in the database, and save them.
- pushnews: push one news item to the identified chat target and mark the item as expired.
- maintenance: perform maintenance on the pool of news articles in the database.
Example using the vagrant setup: bin/vm ./newstochat.php pushnews -e true
NewsToChat is a very basic script at this point, for example, it can be ran manually or queued up to execute via cron jobs.

pborel / NewsToChat