diff --git a/README.md b/README.md index 41e6f250..e341cc51 100644 --- a/README.md +++ b/README.md @@ -1,14 +1,17 @@ -[![Build Status](https://travis-ci.org/tejado/pgoapi.svg?branch=master)](https://travis-ci.org/tejado/pgoapi) +[![POGODEV](https://github.com/pogodevorg/assets/blob/master/public/img/logo-github.png?raw=true)](https://pogodev.org) -# pgoapi - a pokemon go api lib in python -pgoapi is a client/api/demo for Pokemon Go by https://github.com/tejado. +# pgoapi - a pokemon go api lib in python [![Build Status](https://travis-ci.org/pogodevorg/pgoapi.svg?branch=develop)](https://travis-ci.org/pogodevorg/pgoapi) + +pgoapi is a client/api/demo for Pokemon Go by https://github.com/tejado & https://github.com/pogodevorg. It allows automatic parsing of requests/responses by finding the correct protobuf objects over a naming convention and will return the response in a parsed python dictionary format. - * This is unofficial - USE AT YOUR OWN RISK ! - * I don't play pokemon go ! - * No bot/farming code included ! +## Disclaimers + + * This is unofficial - **USE AT YOUR OWN RISK**! + * Botting or farming is **not supported**. + +## Features -## Feature Support * Python 2 and 3 * Google/PTC auth * Address parsing for GPS coordinates @@ -18,7 +21,7 @@ It allows automatic parsing of requests/responses by finding the correct protobu * Thread-safety * Advanced logging/debugging * Uses [POGOProtos](https://github.com/AeonLucid/POGOProtos) - * Mostly all available RPC calls (see [API reference](https://docs.pogodev.org) on the wiki) + * Most RPC calls are available (see [API reference](https://docs.pogodev.org) on the wiki) ## Documentation Documentation is available at the github [pgoapi wiki](https://wiki.pogodev.org). @@ -39,6 +42,10 @@ git+https://github.com/pogodevorg/pgoapi.git@develop#egg=pgoapi If you are not using setuptools/pip, follow the instructions in the Contributing section below to clone this repository and then install pgoapi using the appropriate method for your project. +### Hashing + +The API utilises the [API Hashing service](https://hashing.pogodev.org) provided by Bossland. Calls require a valid hash key to work on newer API Versions. + ## Contributing Contributions are highly welcome. Please use github or [Discord](https://discord.pogodev.org) for it! @@ -53,16 +60,24 @@ If you already have a copy of the repository you can use `git submodule update - Once you have cloned the repository, switch to the `develop` branch. To merge your changes back into the main repository, make a pull request to `develop`. +## Core Maintainers + +[![Noctem](https://github.com/Noctem.png?size=36) - Noctem](https://github.com/Noctem) + +[![ZeChrales](https://github.com/ZeChrales.png?size=36) - ZeChrales](https://github.com/ZeChrales) + +[![Ephemerality](https://github.com/Ephemerality.png?size=36) - Ephemerality](https://github.com/Ephemerality) + + ## Credits -[Mila432](https://github.com/Mila432/Pokemon_Go_API) for the login secrets -[elliottcarlson](https://github.com/elliottcarlson) for the Google Auth PR -[AeonLucid](https://github.com/AeonLucid/POGOProtos) for improved protos -[AHAAAAAAA](https://github.com/AHAAAAAAA/PokemonGo-Map) for parts of the s2sphere stuff -[mikeres0](https://github.com/mikeres0) for the slack channel including auto signup -[DeirhX](https://github.com/DeirhX) for thread-safety + +* [Mila432](https://github.com/Mila432/Pokemon_Go_API) for the login secrets +* [elliottcarlson](https://github.com/elliottcarlson) for the Google Auth PR +* [AeonLucid](https://github.com/AeonLucid/POGOProtos) for improved protos +* [AHAAAAAAA](https://github.com/AHAAAAAAA/PokemonGo-Map) for parts of the s2sphere stuff +* [mikeres0](https://github.com/mikeres0) for the slack channel including auto signup +* [DeirhX](https://github.com/DeirhX) for thread-safety ## Ports -[Node Port](https://github.com/Armax/Pokemon-GO-node-api) by Arm4x -[Node Port - pogobuf](https://github.com/cyraxx/pogobuf) by cyraxx -[![Analytics](https://ga-beacon.appspot.com/UA-1911411-4/pgoapi.git/README.md?pixel&useReferer)](https://github.com/igrigorik/ga-beacon) +See [Awesome Pokemon Go](https://github.com/pogodevorg/awesome-pokemongo#api-libraries)