Skip to content

Latest commit

 

History

History
90 lines (63 loc) · 2.44 KB

README.md

File metadata and controls

90 lines (63 loc) · 2.44 KB

EVE Tools for trading

Trading tools collection for EVE Online.

Author: Hanbo Guo

Contact: [email protected]

What is EVE Tools

EVE Tools is a Python package that simplifies EVE ESI. The goal is to write easier and faster Python scripts that analyze EVE data for ISK making.

Installations

0. Have a working Python environment.

1. Install using PyPI

pip3 install eve_tools

or install manually:

  1. First download everything under this repo.
  2. Run requirements.txt file with pip install:
cd path/to/your/download/eve_tools-master

pip3 install -r requirements.txt
  1. Run setup code:
python setup.py install

2. Sample usage

from eve_tools import ESIClient

resp = ESIClient.get("/markets/{region_id}/orders/", region_id=10000002, type_id=12005)
print(resp.status)  # 200
print(resp.data)

This code requests data from /markets/{region_id}/orders/ endpoint, by specifying a region_id (10000002 for Jita) and a type_id (12005 for Ishtar). It returns a ESIResponse object, and the payload can be accessed through resp.data.

If you want market history of multiple items:

from eve_tools import ESIClient

resp = ESIClient.get("/markets/{region_id}/orders/", async_loop=["type_id"], region_id=10000002, type_id=[12005, 1405])
# resp: [ESIResponse, ESIResponse]
print(len(resp))  # 2
print(type(resp[0]))  # ESIResponse

You can use async_loop argument to specify if you want to loop through, for example, type_id. You can potentially give a loooong list of type ids to search for.

3. Run tests

There are some built-in tests to verify if everything works as expected:

from eve_tools.tests import *
import unittest

test_config.set(cname="your character", structure_name="a player structure that you have docking access")
unittest.main()

You would see around 20+ tests running. Internet connection is required. If you witness any error during testing, please email me.

If you see some tests being skipped:

...ss........ss.....

Ran 24 tests in 16.00s

OK (skipped=4)

This means either some endpoints are down (which cripples apis), or your test configuration is incorrect. Use test_config.set() to configure your tests and rerun tests.

PS: if you spot any errors or if you have some advice, feel free to email me. You could also send emails to Hanbie Serine in game.