Rust models of NeosVR's API.
Featuring full serde support, time for datetimes, and strum for better enums.
Any official documentation of Neos' API is lacking, and the API is still changing too. So this crate can't guarantee correctness. Some of the types are based solely on educated guesses even.
This crate provides an example API client with the optional api_client feature.
- Better documentation in general
- Splitting some linked
Option<T>fields into their own sub-structs
The integration tests contact the live API. That's why they are ignored by default.
Some of them also require authentication.
Sadly not all the things can even be reliably tested without creating a mock API. Which in turn defeats the purpose of the tests in the first place.
You can generate a user-sesion.json file with logging in via curl for example:
curl --request POST \
--url https://cloudx.azurewebsites.net/api/userSessions \
--header 'Content-Type: application/json' \
--header 'Accept: application/json' \
--data '{
"password": "pa$$word",
"secretMachineId": "string",
"rememberMe": true,
"ownerId": "string",
"email": "[email protected]",
"username": "string"
}' > user-session.jsonOnly use a single identification method (username/email/ownerId).
Also be sure to replace the rest of the values with your own.
Using a secretMachineId is also recommended to not log out your other sessions.
You can generate a random one for example with: openssl rand -hex 32
Make sure that you've got:
- an internet connection
- a valid
user-sesion.json
Then just run the tests;
# A specific test with output logging
cargo test --all-features get_user -- --exact --ignored --nocapture
# All tests
cargo test --all-features -- --ignoredNote that the license is MPL-2.0 instead of the more common MIT OR Apache-2.0.
A license change however can be negotiated if the Neos team wants to use this crate or adopt this crate into a more official one with a different license.