v0.0.2

movebank-mirror-api 0.0.2.

Minor maintenance release: bumps the movebank-mirror library
dependency to 0.0.2 so users who follow the README's quick-start
get both tools at consistent versions.

What changed

• movebank-mirror dep: 0.0.1 → 0.0.2. The library's
  EventDataDownloader was updated post-0.0.1 to request event_id
  explicitly and stop over-eagerly downloading other join columns
  (see movebank-mirror's v0.0.2 release notes
  for the full story). The fix is in the downloader, not in any code
  this server uses at runtime — movebank-mirror-api reads on-disk
  mirror state via the same StudyJson deserializer it always used.
  No server-side behaviour changes.

• --version reports 0.0.2.

Verified compatibility

The full R-client regression was re-run against this release —
unchanged from 0.0.1, as expected for a no-server-code-change
dependency bump:

Client	Result
move v1	4 / 4 checks pass
move2 (0.5+)	4 / 4 checks pass
movebank-api-client	Covered by the in-process DirectReadIntegrationTest, runs on every build

Install

Requires JDK 21.

tar -xf movebank-mirror-api-boot-0.0.2.tar
./movebank-mirror-api-boot-0.0.2/bin/movebank-mirror-api -d /var/lib/movebank-mirror

(.zip available too if you prefer.)

Pairs with the rest of the family

• movebank-mirror 0.0.2 — recommended; the 0.0.1 mirror tool also works fine with this server.
• movebank-api-client 0.0.2
• movebank-rocker — pinned R environment for move/move2 against your local mirror

License

LGPL-2.1.

v0.0.1

movebank-mirror-api 0.0.1.

A read-only HTTP server that replays the Movebank REST API on
top of a local on-disk mirror produced by
movebank-mirror.

Verified compatibility

Verified against the canonical R clients in the movement-ecology
ecosystem on this release:

Client	Result
move v1	4 / 4 checks pass (compatibility/move-r/verify.R)
move2 (0.5+)	4 / 4 checks pass (compatibility/move2-r/verify.R)
movebank-api-client	Covered by the in-process DirectReadIntegrationTest, runs on every build

The R-client regression is documented and reproducible against
the pinned R environment in
mcb77/movebank-rocker.

Install

Requires JDK 21.

tar -xf movebank-mirror-api-boot-0.0.1.tar
./movebank-mirror-api-boot-0.0.1/bin/movebank-mirror-api -d /var/lib/movebank-mirror

(.zip available too if you prefer.)

Then point any Movebank-API client at http://localhost:8080/movebank.

Pairs with the rest of the family

• movebank-mirror — populates the mirror directory this server reads from
• movebank-api-client — Java client that works against this server unchanged
• movebank-rocker — pinned R environment for move/move2 against your local mirror

What's load-bearing about the "weird-looking" code

This server replicates Movebank's own undocumented behavioural
quirks so existing R clients work unchanged. See
BUG_COMPATIBILITY.md for the verbatim
curl-against-live-API findings and the corresponding server fixes.
Read this before refactoring EventService / MirrorService /
DirectReadController.

Known gaps

TODO.md tracks them transparently. Headlines:

• sort and limit query parameters are ignored
• No authentication (default bind is 127.0.0.1 deliberately;
  put a reverse proxy in front before exposing externally)
• In-memory cache: every request re-reads study JSON from disk

Most existing clients work fine with these gaps; they hit the
80% the API is used for.

License

LGPL-2.1.