Welcome, guest | Sign In | My Account | Store | Cart

Notice! PyPM is being replaced with the ActiveState Platform, which enhances PyPM’s build and deploy capabilities. Create your free Platform account to download ActivePython or customize Python with the packages you require and get automatic updates.

Download
ActivePython
INSTALL>
pypm install evelink

How to install EVELink

  1. Download and install ActivePython
  2. Open Command Prompt
  3. Type pypm install evelink
 Python 2.7Python 3.2Python 3.3
Windows (32-bit)
Windows (64-bit)
Mac OS X (10.5+)
Linux (32-bit)
0.1.0p1
0.2.0Never BuiltWhy not?
0.1.0p1 Available View build log
Linux (64-bit)
0.2.0 Available View build log
0.1.0p1 Available View build log
 
Author
License
MIT License
Lastest release
version 0.2.0 on Jan 9th, 2014

EVELink provides a means to access the [EVE API](http://wiki.eveonline.com/en/wiki/EVE_API_Functions) from Python.

Example Usage

```python import evelink.api # Raw API access import evelink.eve # Wrapped API access for the /eve/ API path

System Message: WARNING/2 (<string>, line 10); backlink

Inline literal start-string without end-string.

System Message: WARNING/2 (<string>, line 10); backlink

Inline interpreted text or phrase reference start-string without end-string.

# Using the raw access level to get the name of a character api = evelink.api.API() result = api.get('eve/CharacterName', {'IDs': [1]}) print result.find('rowset').findall('row')[0].attrib['name']

# Using the wrapped access level to get the name of a character eve = evelink.eve.EVE() print eve.character_name_from_id(1)

# Using authenticated calls api = evelink.api.API(api_key=(12345, 'longvcodestring')) charid = eve.character_id_from_name("Character Name") char = evelink.char.Char(char_id = charid, api=api) print char.wallet_balance() ```

System Message: WARNING/2 (<string>, line 23); backlink

Inline literal start-string without end-string.

System Message: WARNING/2 (<string>, line 23); backlink

Inline interpreted text or phrase reference start-string without end-string.

Dependencies

EVELink does not require any extra dependencies for normal operation.

If you are developing on EVELink, however, the following packages are required in order to run the tests:

  • mock
  • nose
  • unittest2

A requirements.txt is provided as part of the repository for developer convenience.

Design

EVELink aims to support 3 "levels" of access to EVE API resources: raw, wrapped, and object.

### Raw access

Raw is the lowest level of access - it's basically just a small class that takes an API path and parameters and returns an xml.etree.ElementTree object. You probably don't want to use this layer of access, but it can be useful for API calls that EVELink doesn't yet support at a higher level of access.

### Wrapped access

Wrapped is the middle layer of access. The methods in the wrapped access layer still map directly to EVE API endpoints, but are "nicer" to work with. They're actual Python functions, so you can be sure you're passing the right arguments. They return basic Python types which makes the results simple to use.

### Object access

(not yet implemented)

Object access is the highest layer of access and the most encapsulated. Though implementation is being deferred until after the wrapped access layer is more complete, the goal here is to essentially emulate a set of ORM objects, allowing you do to things like Character(id=1234).corporation.name to fetch the name of the corporation that the character with ID 1234 is in.

Development

To acquire a development copy of the library and set up the requirements for testing:

`bash $ git clone https://github.com/eve-val/evelink.git $ cd evelink $ virtualenv venv --distribute $ source venv/bin/activate $ pip install -r requirements.txt `

To run the tests:

`bash $ nosetests `

To run the tests, including the appengine ones (this requires that you have Google AppEngine's python SDK installed):

`bash $ cd tests $ nosetests --with-gae `

Additional information for developers is available [here](https://github.com/eve-val/evelink/wiki/Development-Guidelines).

Subscribe to package updates

Last updated Jan 9th, 2014

Download Stats

Last month:1

What does the lock icon mean?

Builds marked with a lock icon are only available via PyPM to users with a current ActivePython Business Edition subscription.

Need custom builds or support?

ActivePython Enterprise Edition guarantees priority access to technical support, indemnification, expert consulting and quality-assured language builds.

Plan on re-distributing ActivePython?

Get re-distribution rights and eliminate legal risks with ActivePython OEM Edition.