/iabgpp-rs

Rust implementation of the IAB Global Privacy Platform (GPP) consent string

Primary LanguageRustApache License 2.0Apache-2.0

iabgpp-rs

Rust implementation of the IAB Global Privacy Platform (GPP) consent string specification.

⚠️ This is work in progress.

Features

  • Eager or lazy decoding of GPP sections
  • Owning type (GPPString)
  • Reference type (GPPStr)
  • Read support for all current GPP sections

Usage example

Cargo.toml:

[dependencies]
iab-gpp = "0.1"

main.rs:

use std::error::Error;
use std::str::FromStr;
use iab_gpp::v1::GPPString;

fn main() -> Result<(), Box<dyn Error>> {
    let s = "DBABM~CPXxRfAPXxRfAAfKABENB-CgAAAAAAAAAAYgAAAAAAAA";
    let gpp_str = GPPString::from_str(s).expect("a valid GPP string");

    for &id in gpp_str.section_ids() {
        println!("Section id: {:?}", id);

        let section = gpp_str.decode_section(id).expect("a valid section");
        println!("Section: {:?}", &section);
    }
}

GPP Standard support

This crate intends to be in sync with the GPP specification, meaning that it should be able to read payloads with the versions specified here.

If the standard gets updated with new versions, this page should keep track of incompatibilities.

Legend:

  • ✅ complete support
  • 🧪 experimental or partial support
  • ❌ no support
Section Reading Writing
GPP string v1 ✅ ❌
US Privacy v1 (deprecated) ✅ ❌
EU TCF v2.2 ✅ ❌
EU TCF v1 (deprecated) ✅ ❌
Canadian TCF v1 (deprecated) ✅ ❌
Canadian TCF v1.1 ✅ ❌
US - National v1 ✅ ❌
US - California v1 ✅ ❌
US - Virginia v1 ✅ ❌
US - Colorado v1 ✅ ❌
US - Utah v1 ✅ ❌
US - Connecticut v1 ✅ ❌

Development status

The current plan:

  • complete reader implementation for version 0.1
  • read + write support in version 0.2