"TwoEatMe" is a little experiment to create a Twitter, text-based client, using git, Python and Python's Tweepy library to handle Twitter's API.
The following are a sequence of steps followed to prepare our system to be able to properly run-and-create TwoEatMe. This may serve you in case you want to play with the code.
Usage of it relies on your own responsibility: it's not Rocket Science, but in case something goes wrong, you are fully responsible for the use of it (the intended usage of whatever I put in here is for my own personal use).
Please report bugs here if you find one.
The code and the things contained within the repository (excluding content accessible through links) are offered under a GPL 2.0 License: Sharing is caring.
To run this code, you may need to have installed in your computer or have available to the following set of components:
- Python: you need to have Python installed. I am working with Python 2.X, so I am not sure on whether the code may work with Python 3.X.
- Python pip: you need to have Python pip installed. This normally may be available on your Python Installation. Otherwise, please check the Python Pip Page.
- Tweepy: you need to have Tweepy Installed. Once Python and Pip are installed, go into your terminal and shell and run
pip install tweepy. - Twitter Account You may need a Twitter Account.
- Twitter App Credentials You DEFINITELY need a Twitter App to gain the required credentials any developer needs to build an app, including: - Twitter Consumer Key - Twitter Consumer Secret Key - Twitter Access Token - Twitter Access Token Secret
The program is hosted under the master folder on this repository (check 'TwoEatMe.py').
You can run it on your terminal (do not forget to check the "Dependencies" on the section above) or your Command Prompt by copying your file on your local drive and, on the same folder, run 'python TwoEatMe.py'.
Current program is able to:
- Tweepy Library Check: Program checks whether Tweepy Library is installed on your system.
- OS Check: Program checks which OS are you using (Windows, macOS or Linux).
- File containing Twitter Apps Check: Program checks whether 'Keys-DO-NOT-COMMIT.txt' file (containing user keys and tokens necessary to run the tool) exists.
- If not, program will prompt you to enter your Twitter Apps Credentials and how to obtain them.
- Program will then load them under 'Keys-DO-NOT-COMMIT.txt' file, so it won't ask you again about it.
- If so, program will read your Twitter Apps keys
- TwoEatMe Options Menu: the program displays a menu with some Twitter options you can trigger, including:
- Your Basic Twitter Information: Display basic details on your Twitter Account.
- Your Additional Twitter Information: Display additional details on your Twitter Account you may not be aware of.
- Your last Tweet's Basic Information: Display basic details on your last published Tweet.
- Your last Tweet's Additional Information: Display additional details on your last published Tweet you may not be aware of.
- The last 10 Tweets you received: Display the last 10 Public tweets you may have received on your Twitter Timeline.
- The last 10 Tweets you sent: Display the last 10 Public tweets you may have sent on Twitter.
- Send Tweets: You are now able to send tweets from your Twitter Account (using your own Twitter Apps Credentials.
- Check Global Trends: Display Twitter Global Trending Topics.
- Program Options Menu: the program displays a couple of internal options you can trigger, including:
- Clear the Screen: The option will clear the text already displayed in the screen.
- Quit the Application: The option will instruction the program to succesfully quit and go back to the command prompt on your shell.
- Dependencies checks (tweepy library, chcp, API keys)
- Display Menu with options:
- Send a Tweet.
- Display Twitter Global Trends
- Display Basic / Advanced Details on the last Tweet you sent.
- Display last 10 Tweets you Received / Sent
- Display Basic / Advanced Details on you at Twitter.
- Clear Screen / Quit the Program
- Review and Improve Code Quality
Future: See Issues Page
- Enter YOUR idea or request in the issues area.