web-API: replace ?mutable-type with ?format={chk,sdmf,mdmf} #1552

New Issue

tahoe-lafs · 2011-10-02T00:42:22Z

davidsarah commented

2011-10-02 00:42:22 +00:00

We agreed (on IRC) to change the ?mutable-type= query parameter to a ?format= parameter with options chk, sdmf, and mdmf. For compatibility, the ?mutable=true flag would still be accepted and would mean the same as ?format=sdmf (at least for now). The values should be case-insensitive.

This way, if we add a new immutable format in future, it won't require a new query parameter. This also makes the implementation of #1547 easier.

We agreed (on IRC) to change the `?mutable-type=` query parameter to a `?format=` parameter with options `chk`, `sdmf`, and `mdmf`. For compatibility, the `?mutable=true` flag would still be accepted and would mean the same as `?format=sdmf` (at least for now). The values should be case-insensitive. This way, if we add a new immutable format in future, it won't require a new query parameter. This also makes the implementation of #1547 easier.

tahoe-lafs added the

labels 2011-10-02 00:42:22 +00:00

tahoe-lafs added this to the 1.9.0 milestone 2011-10-02 00:42:22 +00:00

davidsarah commented

2011-10-02 01:34:48 +00:00

I'm writing tests for this, so Kevan, you only need to do the docs and implementation.

Note that there's a "mutable-type" field in the returned JSON that should also be changed to "format", and should have the value "chk" for immutable uploads.

I'm writing tests for this, so Kevan, you only need to do the docs and implementation. Note that there's a `"mutable-type"` field in the returned JSON that should also be changed to `"format"`, and should have the value `"chk"` for immutable uploads.