Installation

[dependencies]postal = "0.2"

extern crate postal;

Usage example (expand_address)

externcrate postal;use postal::{Context,InitOptions,ExpandAddressOptions};// initialize a context to work withletmut ctx =Context::new();// enable address expansion for this contextctx.init(InitOptions{expand_address:true,parse_address:false}).unwrap();// these options are safe to persist and reuse between calls to `expand_address`letmut opts =ExpandAddressOptions::new();// (optional) set languages; this can improve runtime performance significantly, approximately 30% in benchmarksopts.set_languages(vec!["en"].as_slice());// expand a single address into a `postal::Expansions` iteratorlet exps = ctx.expand_address("1234 Cherry Ln, Podunk TX",&mut opts).unwrap();for ein exps{dbg!(e);}

externcrate postal;use postal::{Context,InitOptions,ParseAddressOptions};// initialize a context to work withletmut ctx =Context::new();// enable address parsing for this contextctx.init(InitOptions{expand_address:false,parse_address:true}).unwrap();// these options are safe to persist and reuse between calls to `parse_address`.// Note: `language` and `country` are technically options that libpostal will accept// for purposes of parsing addresses, but it ignores them at present.letmut opts =ParseAddressOptions::new();// parse a single address into a `postal::Components` iteratorlet comps = ctx.parse_address("1234 Cherry Ln, Podunk TX",&mut opts).unwrap();for cin comps{dbg!(c);}

Development setup

cargo buildcargotest -- --nocapture --test-threads 1cargo bench

Release History

Meta

Contributing