EVE Technology Lab

That's a valid question. You will need 3 modules, EveLib.Core, EveLib.EveCentral and EveLib.EveOnline. The reference errors you are seeing, is most likely because you need to add a reference to EveLib.Core in EveCentral and EveOnline.
Assuming you are using VS:
With all 3 projects in your solution, you will see a sub-item under each project called "References". Rightclick this, select "Add reference", select EveLib.Core under "Solution -> Projects". Do this for both EveCentral and EveOnline, and you should be good to go.

Let me know if you're still having issues.

You're not entirely clear on what isn't working, could you be more specific? eZet.EveLib.Modules is just a namespace. I do however recognize that the library isn't distributed in a very user-friendly manner at the moment, though I'm not sure what would be the best way to distribute it either.

edit:
Oh, I misread. You need to add EveLib.EveCentral and/or EveLib.EveOnline as a reference in the project you want to use it in, the same way you did with Core.

LOL got there at the same time :-)

The API parses the XML and returns an object, depending on the request you make. The EveOnline module returns objects of the type EveApiResponse[T] (cant use html tags) where T is specific to the request, EveCentral uses EveCentralSomeName where SomeName depends on the request.

There are more specific examples in the github readme.

edit:
As a follow up, the best way to insert it in a db would be to convert the API objects into the domain models/data models you use for your database, and then insert those into your database. To convert you can use a simple mapper that reads the data from the API object, and maps it to a new domain object.

A specific example for asset list would be:

var key = new CharacterKey(12345, "someVcode");
var character =key.Characters.Single(c => c.CharacterName == "Icahmura Hasaki");
var result = character.GetAssetList(); // or replace var with EveApiResponse[AssetList]

Keep in mind [ ] is a repacement for HTML style pointy brackets if you aren't used to generics. Anyone know if you can get around the forum limitations for showing these?

You can then use intellisense or some other code completion to see the available properties on result, or you can check the source or debug the object to see what's available. In most cases it follows the XML structure, but some properties are slightly renamed for clarity.

You need to create a new key object for each API key you want to use, for various design reasons. They are lightweight though and has no impact on anything really :)

You can loop through all characters available for a key by iterating key.Characters, as a normal list. Or you can select a specific one by ID or Name like I showed above.

Place the key data in some enumerable structure, like a List[KeyData] of KeyData objects with a Id and vcode property, or a Dictionary[int, string] with id and vcode respectively.

Then iterate through it like so:


Just keep asking questions, I dont mind helping. I'm sure there are others that can use the information aswell :)

edit:
Added example of storing keys for later

And another thing, depending on if you check the validity of the keys beforehand or not, you should add checks for that too.

If you have few keys, you can check it by using key.IsValidKey which returns a bool value. Keep in mind though that this DOES query the api endpoint immediately.

If you have many keys, or a few keys that are expected to be correct, you can catch InvalidRequestException instead, and check if the InnerException.Response.StatusCode == HttpStatusCode.Forbidden instead, which means the key is invalid or doesn't have the right permissions.

The assets structure is somewhat complicated as assets can contain other assets and so on.

First off, you have to get response.Result to get to the request specific data, for all EveApiResponses objects.

EveApiResponse[AssetList].Result has a a property Assets, which is a collection of Asset objects. Asset objects are a top level object, which is bound to a location in eve. Each Asset object can be a regular item, or a container. It has a property called Items, which is a list of contained Item objects. Each Item object can again have a list of contained Item objects, available in a list called Items.

So basically it's a tree with unknown depth, and you need to navigate it as such.

To find the top level assets you simply iterate response.Result.Assets, where response is the EveApiResponse.

foreach (AssetList.Asset asset in response.Result.Assets) {
// do work
}


edit:
Looking a the code now, it doesn't make sense to make a seperation between Item and Asset, as the only difference is that Asset has a LocationId while Item doesn't. I should probably just set LocationId to 0 for the top level types. Unless there's a reason I did it like this that I cannot remember.

All the data is in there, but you do have to iterate through to get it all. You can check if something contains something by checking if Items.Count == 0 or not, on any Item or Asset.

If you have previously done this in your own code, it's basically exactly the same structure, since it reflects the structure of the returned XML.

edit:
There are many ways to create a single flat list of the items. You can use a flatten function, or traverse the tree recursively or iteratively. I'll have to first take a look at the Asset and Item seperation now though, got me curious. If there's no reason to separate, I'll merge them. Hopefully it won't create problems for anyone :)