2 releases
Uses old Rust 2015
0.1.1 | Nov 24, 2017 |
---|---|
0.1.0 | Nov 24, 2017 |
#16 in #autogenerated
88 downloads per month
27KB
370 lines
Rust API for swagger_client
Cargo swagger
Overview
This client/server was generated by the [swagger-codegen] (https://github.com/swagger-api/swagger-codegen) project. By using the OpenAPI-Spec from a remote server, you can easily generate a server stub.
To see how to make this your own, look here:
- API version: 0.1.1
- Build date: 2017-11-24T13:03:19.937Z For more information, please visit https://metacom.metaswitch.com/
This autogenerated project defines an API crate swagger_client
which contains:
- An
Api
trait defining the API in Rust. - Data types representing the underlying data model.
- A
Client
type which implementsApi
and issues HTTP requests for each operation. - A router which accepts HTTP requests and invokes the appropriate
Api
method for each operation.
It also contains an example server and client which make use of swagger_client
:
- The example server starts up a web server using the
swagger_client
router, and supplies a trivial implementation ofApi
which returns failure for every operation. - The example client provides a CLI which lets you invoke any single operation on the
swagger_client
client by passing appropriate arguments on the command line.
You can use the example server and client as a basis for your own code. See below for more detail on implementing a server.
Examples
Run examples with:
cargo run --example <example-name>
To pass in arguments to the examples, put them after --
, for example:
cargo run --example client -- --help
Running the server
To run the server, follow these simple steps:
cargo run --example server
Running a client
To run a client, follow one of the following simple steps:
cargo run --example client UploadApi
HTTPS
The examples can be run in HTTPS mode by passing in the flag --https
, for example:
cargo run --example server -- --https
This will use the keys/certificates from the examples directory. Note that the server chain is signed with
CN=localhost
.
Writing a server
The server example is designed to form the basis for implementing your own server. Simply follow these steps.
- Set up a new Rust project, e.g., with
cargo init --bin
. - Insert
swagger_client
into themembers
array under [workspace] in the rootCargo.toml
, e.g.,members = [ "swagger_client" ]
. - Add
swagger_client = {version = "0.1.1", path = "swagger_client"}
under[dependencies]
in the rootCargo.toml
. - Copy the
[dependencies]
and[dev-dependencies]
fromswagger_client/Cargo.toml
into the rootCargo.toml
's[dependencies]
section.- Copy all of the
[dev-dependencies]
, but only the[dependencies]
that are required by the example server. These should be clearly indicated by comments. - Remove
"optional = true"
from each of these lines if present.
- Copy all of the
Each autogenerated API will contain an implementation stub and main entry point, which should be copied into your project the first time:
cp swagger_client/examples/server.rs src/main.rs
cp swagger_client/examples/server_lib/mod.rs src/lib.rs
cp swagger_client/examples/server_lib/server.rs src/server.rs
Now
- From
src/main.rs
, remove themod server_lib;
line, and uncomment and fill in theextern crate
line with the name of this server crate. - Move the block of imports "required by the service library" from
src/main.rs
tosrc/lib.rs
and uncomment. - Change the
let server = server::Server {};
line tolet server = SERVICE_NAME::server().unwrap();
whereSERVICE_NAME
is the name of the server crate. - Run
cargo build
to check it builds. - Run
cargo fmt
to reformat the code. - Commit the result before making any further changes (lest format changes get confused with your own updates).
Now replace the implementations in src/server.rs
with your own code as required.
Updating your server to track API changes
Later, if the API changes, you can copy new sections from the autogenerated API stub into your implementation. Alternatively, implement the now-missing methods based on the compiler's error messages.
Dependencies
~5.5–7.5MB
~170K SLoC