twitter-man

Table of Contents

• About the Project
  • Built With
• Getting Started
  • Prerequisites
  • Installation
• Usage
• Contributing

About The Project

A Go cli tool that streams tweets from Twitter to Webex Teams via adaptivecards.

Here's why:

• To demonstrate concurrency in Go
• Explore community Go libraries
• Explore the Twitter API and Webex Teams API

Built With

• Go
• Webex Teams
• Twitter
• Cobra
• Logrus
• go-twitter

Getting Started

Prerequisites

• Go installed (https://golang.org/doc/install)
• A Webex Teams Bot Access Token (https://developer.webex.com)
• Twitter Developer Account + Project with Read Only permissions (https://developer.twitter.com)

Installation

Secrets are passed into the cli application through environment variables. The following environment variables are required to run this application.

# Twitter environment variables
TWITTER_CONSUMER_KEY
TWITTER_CONSUMER_SECRET
TWITTER_ACCESS_TOKEN
TWITTER_ACCESS_SECRET

# Webex Teams environment variables
WEBEXTEAMS_TOKEN

1. Clone the repo

git clone https://github.com/patrickcisco/twitter-man

2. Build from source

go build -o twitter-man main.go

3. Run the twitter-man binary

./twitter-man --help

Usage

twitter-man --help
A cli application that streams tweets from Twitter

Usage:
  twitter-man [command]

Available Commands:
  help        Help about any command
  stream      Begin streaming twitter tweets

Flags:
      --config string   config file (default is $HOME/.twitter-man.yaml)
  -h, --help            help for twitter-man
      --log string      log level (default "info")

Use "twitter-man [command] --help" for more information about a command.


twitter-man stream --tag "#ciscolive" --tag "#ciscodevnet" --to_person_email "nobody@cisco.com"

Contributing

1. Fork the Project
2. Create your Feature Branch
3. Commit your Changes
4. Push to the Branch
5. Open a Pull Request