Tennis Top Trumps

Top Trumps Game for ATP tennis players
Explore the docs »

View Live Demo · Report Bug · Request Feature

Table of Contents

1. About The Project
   • Built With
2. Getting Started
   • Prerequisites
   • Installation
3. Usage
4. Roadmap
5. Contributing
6. License
7. Contact
8. Acknowledgments

About The Project

In the style of the Top Trumps game, you start with ten cards with stats on pro tennis players. Choose the best stat and if it beats your opponents card you get their card. If your card stat is weaker you lose and your opponent gets your card.

(back to top)

Built With

• 
• 

The advantage of using plotly is everything from the front-end to the back-end is built using python. No need to learn javascript and seamlessly put online with https://pythonanywhere.com (free account to get you going). Pythonanywhere has most python packages installed on their own side so you just need to put your .py file and it should run straight away.

(back to top)

Getting Started

To get a local copy up and running follow these simple example steps.

Prerequisites

Install Python (better to use Anaconda https://www.anaconda.com/)

Installation

1. Clone the repo

   git clone https://github.com/gkennaugh/tennis-top-trumps.git

2. Install required packages from requirements.txt

   pip install -r requirements.txt

3a. Move totaldf.csv to a new folder called tennis_atp-master

3b. Unzip pictures.zip and move all the pictures to a new folder as follows... /static/assets/atp/

4. Run python app.py in a new Anaconda Command Prompt

   python app.py

   Open the app in your local browser at http://localhost:8061

(back to top)

Usage

To play a Top Trumps style game with ATP tennis players

For more examples, please refer to the Documentation

(back to top)

Roadmap

• [-] Find and download and clean stats on pro tennis players for the last 10 or so years
• [-] Find and modify images of pro players
• [-] Create dashboard of the game
• [-] Scoring system and moving cards to winner

See the open issues for a full list of proposed features (and known issues).

(back to top)

Contributing

Contributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated.

If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag "enhancement". Don't forget to give the project a star! Thanks again!

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'Add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

(back to top)

License

Distributed under the GNU General Public License v3.0. See LICENSE.txt for more information.

(back to top)

Contact

Your Name - @twitter_handle) - info@oriondvd.co.uk

Project Link: https://github.com/gkennaugh/tennis-top-trumps

(back to top)

Acknowledgments

(back to top)