My Battlesnake
- Free software: MIT license
- Documentation: https://mysnake.readthedocs.io.
# Greg's Python 3 version of the Starter Snake from https://github.com/battlesnakeio/starter-snake-python
A simple [Battlesnake AI](http://battlesnake.io) written in Python.
Visit [https://github.com/battlesnakeio/community/blob/master/starter-snakes.md](https://github.com/battlesnakeio/community/blob/master/starter-snakes.md) for API documentation and instructions for running your AI.
This AI client uses the [bottle web framework](http://bottlepy.org/docs/dev/index.html) to serve requests and the [gunicorn web server](http://gunicorn.org/) for running bottle on Heroku. Dependencies are listed in [requirements.txt](requirements.txt).
[![Deploy](https://www.herokucdn.com/deploy/button.png)](https://heroku.com/deploy)
#### You will need...
- a working Python 2.7 development environment ([getting started guide](http://hackercodex.com/guide/python-development-environment-on-mac-osx/))
- experience [deploying Python apps to Heroku](https://devcenter.heroku.com/articles/getting-started-with-python#introduction)
- [pip](https://pip.pypa.io/en/latest/installing.html) to install Python dependencies
## Running the Snake Locally
- [Fork this repo](https://github.com/battlesnakeio/starter-snake-python/fork).
2) Clone repo to your development environment:
`
git clone [email protected]:<your github username>/starter-snake-python.git
`
3) Install dependencies using [pip](https://pip.pypa.io/en/latest/installing.html):
`
pip install -e .
`
4) Run local server:
`
python app/main.py
`
5) Test your snake by sending a curl to the running snake
`
curl -XPOST -H 'Content-Type: application/json' -d '{ "hello": "world"}' http://localhost:8080/start
`
## Deploying to Heroku
1) Create a new Heroku app:
`
heroku create [APP_NAME]
`
2) Deploy code to Heroku servers:
`
git push heroku master
`
3) Open Heroku app in browser:
`
heroku open
`
or visit [http://APP_NAME.herokuapp.com](http://APP_NAME.herokuapp.com).
4) View server logs with the heroku logs command:
`
heroku logs --tail
`
## Questions?
Email [[email protected]](mailto:[email protected]), or tweet [@send_with_us](http://twitter.com/send_with_us).
This package was created with Cookiecutter and the audreyr/cookiecutter-pypackage project template.