3 unstable releases

0.2.0 Jul 16, 2024
0.1.1 Feb 6, 2024
0.1.0 Jan 25, 2024

#483 in Database interfaces

Download history 105/week @ 2024-07-13 23/week @ 2024-07-20 38/week @ 2024-07-27 91/week @ 2024-08-03 75/week @ 2024-08-10 81/week @ 2024-08-17 148/week @ 2024-08-24 175/week @ 2024-08-31 147/week @ 2024-09-07 150/week @ 2024-09-14 125/week @ 2024-09-21 125/week @ 2024-09-28 129/week @ 2024-10-05 117/week @ 2024-10-12 244/week @ 2024-10-19

632 downloads per month

Apache-2.0

27KB
484 lines

graphql-schema-diff

crates.io] docs.rs

This crate implements diffing of two GraphQL schemas, returning a list of changes. It powers the changelog feature and operation checks at Grafbase.

Example

use graphql_schema_diff::{diff, Change, ChangeKind};

let source = r#"
  type Pizza {
    id: ID!
    name: String!
    toppings: [Topping!]!
  }

  enum Topping {
    OLIVES
    MUSHROOMS
    PINEAPPLE
  }
"#;

let target = r#"
  type Pizza {
    id: ID!
    name: PizzaName
    toppings: [Topping!]!
  }

  type PizzaName {
    english: String
    italian: String!
  }

  enum Topping {
    OLIVES
    MUSHROOMS
    POTATO
  }
"#;

let changes = diff(source, target).unwrap();

assert_eq!(changes,
   &[
        Change {
            path: String::from("Pizza.name"),
            kind: ChangeKind::ChangeFieldType
        },
        Change {
            path: String::from("PizzaName"),
            kind: ChangeKind::AddObjectType
        },
        Change {
            path: String::from("Topping.PINEAPPLE"),
            kind: ChangeKind::RemoveEnumValue
        },
        Change {
            path: String::from("Topping.POTATO"),
            kind: ChangeKind::AddEnumValue
        }
]);

Cargo features

  • serde: Serialize and Deserialize impls for Change (default: on).

Dependencies

~4.5MB
~69K SLoC