Diesel CLI Extension

Diesel CLI Extension is a tool-belt that aids Diesel CLI after it built schema.rs.

It contains 4 functions at this moment. 1. Generate protobuf file.(diesel_ext proto) 2. Generate model rust structs.(diesel_ext model) 3. Generate conversion implementations.(diesel_ext into_proto, and diesel_ext from_proto)

Installation

cargo install diesel_cli_ext

How to use

First of all, diesel print-schema > src/schema.rs

TL;DR:

``` Usage: target/debug/diesel_ext FILE [options]

Common Options: -s, --schema-file PATH Set schema file path -h, --help Print this help menu

Model Options: -m, --model Set as model output -M, --map "FROMTYPE TOTYPE" Set type mappings (can be set multiple times) e.g. --map "BigInt iccc" -I, --import-types "TYPE" This field adds use statements to the top of every table! declaration. (can be set multiple times) e.g. --importtypes "diesel::sqltypes::*" --derive-mod "TABLENAME MODIFIER" (NOT ready)This field adds derives for certain tables. (can be set multiple times) e.g. --derive-mod "tablename +Debug" --derive-mod "tablename2 -Debug" -d, --derive DERIVES set struct derives -r, --ruststyledmodel_fields set struct field names to be styled according to Rust guidelines

Proto Options: -t, --add-table-name Add #[tablename = x] before structs -p, --proto Set as proto output -i, --intoproto Set as into_proto output ```

(You can see it again by diesel_ext --help)

Output demonstrations are as below...

To generate model structs:

e.g. diesel_ext > src/db/db_models.rs , diesel_ext -m > src/models.rs, diesel_ext --model > src/models.rs (it is the default option)

Sample model output: ``` rust use chrono::NaiveDateTime; use bigdecimal::BigDecimal;

[derive(Queryable)]

pub struct CarryOverBalance { pub account_id : i64, pub debit : BigDecimal, pub description : String, }

[derive(Queryable)]

pub struct Order { pub id1 : i64, pub time : NaiveDateTime, pub json : String, } ```

To generate prelimiting proto file:

diesel_ext -p > myproto.proto, diesel_ext --proto > myproto.proto

Sample output: ``` r syntax = "proto3";

message CarryOverBalance { int64 account_id = 1; string debit = 2; string description = 3; } message Order { int64 id1 = 1; string time = 2; string json = 3; }

message EnquireCarryOverBalanceRequest { int64 id =1; } message EnquireOrderRequest { int64 id =1; }

service MessageRpc { rpc getCarryOverBalance (EnquireCarryOverBalanceRequest) returns (CarryOverBalance) { } rpc getOrder (EnquireOrderRequest) returns (Order) { } } ```

To generate proto conversions:

diesel_ext -f -c class_name > proto/src/conversion/from_proto.rs, diesel_ext -i -c class_name > proto/src/conversion/into_proto.rs

(if you omit the second parameter, names will be displayed as _name_ for your search and replace.)

Sample output(from): ``` rust use models; use proto::client_service; use std::str::FromStr; use std::convert::From;

impl From for models::CarryOverBalance { fn from(i: classname::CarryOverBalance) -> Self { models::CarryOverBalance{ accountid: i.getaccountid(), debit: i.getdebit().tostring(), description: i.getdescription().tostring(), } } }

impl From for models::Order { fn from(i: classname::Order) -> Self { models::Order{ id1: i.getid1(), time: i.gettime().tostring(), json: i.getjson().tostring(), } } }

```

into: ``` rust use models; use proto::client_service; use std::str::FromStr; use std::convert::From;

impl From for classname::CarryOverBalance { fn from(i: models::CarryOverBalance) -> Self { let mut o = classname::CarryOverBalance::new(); o.setaccountid(i.accountid.into()); o.setdebit(i.debit.tostring()); o.setdescription(i.description.to_string()); o } }

impl From for classname::Order { fn from(i: models::Order) -> Self { let mut o = classname::Order::new(); o.setid1(i.id1.into()); o.settime(i.time.tostring()); o.setjson(i.json.to_string()); o } } ```