iceflowre / go-wargaming

Wargaming.net API client in Go

Iceflower

My Projects

Click to show list!

Git Commit Check ।

Check git commits for certain rules, for example the message.

Available as a CLI with git hooks support or optimized for GitHub Actions.

Godot Addons ।

Pack of useful Godot additions to make your life easier!.

Contains multiple plugins like QRCode generation and a license manager!

ircDiscordRelay ।

Message and information relay between IRC and Discord.

Red Eclipse Server Docker ।

Provides the source for an easy handling and maintaining Docker image of a Red Eclipse Server.

Additional with an Go console application which can be run automatically to update the images.

Simple Icons ।

Self created monochrome icons with an enhanced visibility.

Provided in colored and white.

Wargaming API Client ।

Go client for accessing Wargaming.net Public API.

The API client is generated automatically based on the documentation provided by Wargaming.

My Archived Projects

Click to show list!

Celaria Map Toolkit ।

Celaria Map Toolkit can convert different map formats of the game Celaria from one into another.

Go DSLP ।

The Distributed Systems Learning Protocol (DSLP) realizes the transmission of messages over an already established transport connection, in this case TCP.

javaPrimesSearch ।

This is my first "project" in Java, just search primes and save them.

MP3 Monitoring ।

Monitors folders and copies new mp3s to another one..

Available as CLI and gui based on Qt6.

Universal Download ।

unidown manages downloads and will only download items again when they are newer or not downloaded yet.

It is written with the target to be extended by plugins. unidown itself can only manage the produced data from 3rd party plugins.

unidown MR Plugin ।

Download all available german ebooks from the MobileRead wiki

Noteable Contributions

Click to show list!

Inexor Vulkan Renderer ।

Inexor is an open-source project which develops a new 3D octree game engine by combining modern C++ with Vulkan API.

go-wargaming's Issues

[generator] Document how to use the generator in a fork

When fixing the generator (patchs.go fixes), a contributor needs to build the local patched version.

However go build -o generator github.com/IceflowRE/go-wargaming/v4/tools/generator (like instructed in the README) will build the unpatched version from the upstream repository, not the local checkout.

It's possible to build the generator locally (go build -o generator tools/_generator/main.go, but it has other side effects, mainly messing-up the imports:

 import (
-       "github.com/IceflowRE/go-wargaming/v4/wargaming/wgnTime"
+       "/wargaming/wgnTime"
 )

Put also adding // spacing comment lines:

 // realm:
-//     Valid realms: RealmAsia, RealmEu, RealmNa
+//
+//     Valid realms: RealmAsia, RealmEu, RealmNa
+//
 // search:
-//     Player name search string. Parameter "type" defines minimum length and type of search. Using the exact search type, you can enter several names, separated with commas. Maximum length: 24.
+//
+//     Player name search string. Parameter "type" defines minimum length and type of search. Using the exact search type, you can enter several names, separated with commas. Maximum length: 24.

My go version:

> go version
go version go1.19.8 linux/amd64

Add contribution guide

Add more how to contribute information.
Whcih also includes

• Commit naming convention
• Which files does what, especially the generator
• ...

godoc formatting is wrong

From #6

Put also adding // spacing comment lines:

 // realm:
-//     Valid realms: RealmAsia, RealmEu, RealmNa
+//
+//     Valid realms: RealmAsia, RealmEu, RealmNa
+//
 // search:
-//     Player name search string. Parameter "type" defines minimum length and type of search. Using the exact search type, you can enter several names, separated with commas. Maximum length: 24.
+//
+//     Player name search string. Parameter "type" defines minimum length and type of search. Using the exact search type, you can enter several names, separated with commas. Maximum length: 24.

Access to "error", "status" and "meta" fields in responses

Having access to the "error", "status" and "meta" would be really nice.

In particular, the "meta" field can contain pagination information (ex: number of items, number of pages) which are extremely helpful when iterating through paginated lists.

Response payload examples:

• error:

{
    "status": "error",
    "error": {
        "field": "ship_id",
        "message": "INVALID_SHIP_ID",
        "code": 407,
        "value": "3315513040a"
    }
}

• status + meta:

{
    "status": "ok",
    "meta": {
      "count": 100,
      "page_total": 7,
      "total": 608,
      "limit": 100,
      "page": 1
    },
    "data": {
        "3315513040": {
            "ship_id": 3315513040,
            "name": "[Zaō]"
        }
    }
}