2019-09-18 16:34:48 +02:00
|
|
|
|
# pyEDSM – a Python Wrapper for EDSM’s API #
|
|
|
|
|
|
2021-03-17 09:31:43 +01:00
|
|
|
|
The current state might very well be the final one, depending on what I might
|
|
|
|
|
need in the future for command-line usage.
|
|
|
|
|
|
|
|
|
|
This was born as supplemental scripts for my [VoiceAttack
|
|
|
|
|
profiles](https://alternerdtive.github.io/VoiceAttack-profiles) and as I’ve had
|
|
|
|
|
to make some plugins for that in the meantime anyway I will move all this to
|
|
|
|
|
.Net for use in those.
|
|
|
|
|
|
|
|
|
|
tl;dr: if you want more features here, your best bet is to fork or open a pull
|
|
|
|
|
request.
|
|
|
|
|
|
2019-09-18 16:34:48 +02:00
|
|
|
|
## Implementation Progress ##
|
|
|
|
|
|
|
|
|
|
- [x] Status
|
|
|
|
|
- [ ] Commander
|
|
|
|
|
- [ ] Logs
|
2019-11-14 08:16:35 +01:00
|
|
|
|
- [ ] get-logs
|
|
|
|
|
- [x] get-position
|
|
|
|
|
- [ ] set-comment
|
|
|
|
|
- [ ] get-comment
|
|
|
|
|
- [ ] get-comments
|
2019-09-18 16:34:48 +02:00
|
|
|
|
- [ ] System
|
2019-11-14 08:16:35 +01:00
|
|
|
|
- [x] bodies
|
|
|
|
|
- [ ] estimated-value
|
|
|
|
|
- [ ] stations
|
|
|
|
|
- [ ] market
|
|
|
|
|
- [ ] shipyard
|
|
|
|
|
- [ ] outfitting
|
|
|
|
|
- [ ] factions
|
2022-07-02 15:36:05 +02:00
|
|
|
|
- [x] traffic
|
2019-11-14 08:16:35 +01:00
|
|
|
|
- [ ] deaths
|
2019-09-18 16:34:48 +02:00
|
|
|
|
- [ ] Systems
|
|
|
|
|
- [x] system
|
2020-01-08 13:42:17 +01:00
|
|
|
|
- [x] systems
|
2019-09-18 16:34:48 +02:00
|
|
|
|
- [ ] sphere-systems
|
|
|
|
|
- [ ] cube-systems
|
|
|
|
|
- [ ] Journal
|
|
|
|
|
|
2021-03-17 09:31:43 +01:00
|
|
|
|
~~Current goal is to implement most parts of the System and Systems API as well
|
|
|
|
|
as some of the Commander and Logs API. Everything else is _not planned_ at the
|
|
|
|
|
moment.~~ See above!
|
2019-09-18 16:34:48 +02:00
|
|
|
|
|
|
|
|
|
Throw money at me and I’ll do what you want :)
|
|
|
|
|
|
|
|
|
|
Whatever is currently implemented is likely to change on a whim until there’s
|
|
|
|
|
a first release. You have been warned.
|
|
|
|
|
|
|
|
|
|
## Things You Probably Want to Use ##
|
|
|
|
|
|
2021-03-17 09:31:43 +01:00
|
|
|
|
Have a look at [`edsm/models.py`](edsm/models.py) or [my `elite-scripts`
|
|
|
|
|
repo](https://github.com/alterNERDtive/elite-scripts) that I made this for.
|
|
|
|
|
Basically you create a new `System`/`Commander` object (usually by name) and
|
|
|
|
|
start using properties; that will query EDSM in the background.
|
|
|
|
|
|
|
|
|
|
Oh, the tests in `edsm/test_*.py` might be interesting, too.
|
2019-09-18 16:34:48 +02:00
|
|
|
|
|
|
|
|
|
## Things You Probably Don’t Want to Use ##
|
|
|
|
|
|
2021-03-17 09:31:43 +01:00
|
|
|
|
You can also find the raw API stuff in `edsm/*Api.py`. You probably don’t want
|
|
|
|
|
to use that directly, but hey, all the power to you.
|
2019-09-18 16:34:48 +02:00
|
|
|
|
|
2019-09-22 03:50:50 +02:00
|
|
|
|
## Need Help / Want to Contribute? ##
|
2019-09-18 16:34:48 +02:00
|
|
|
|
|
|
|
|
|
If you run into any problems, please look at the
|
|
|
|
|
[develop](https://github.com/alterNERDtive/pyEDSM/tree/develop) branch and see
|
|
|
|
|
if it’s fixed there already.
|
|
|
|
|
|
|
|
|
|
If you have no idea what I was saying in that last paragraph and / or the things
|
|
|
|
|
mentioned there don’t fix your problem, please [file an
|
|
|
|
|
issue](https://github.com/alterNERDtive/pyEDSM/issues). Thanks! :)
|
2019-09-22 03:50:50 +02:00
|
|
|
|
|
2020-04-24 10:25:46 +02:00
|
|
|
|
You can also [say “Hi” on Discord](https://discord.gg/7wKEDDr) if that is your
|
2019-09-22 03:50:50 +02:00
|
|
|
|
thing.
|