IP Filter

A set of crates for the construction and use of optimized IP filtering mechanisms.

Setup

1. Create private/secret.sh containing export IP2LOCATION_TOKEN=''
2. Run ./private/dl.sh DB1LITECSV DB1LITECSVIPV6
3. List available countries using cargo run -- -f private/DB1-LITE-V4.CSV list
4. Generate a filter using cargo run -- -i ./private/DB1-LITE-V4.CSV merge -c BD,BR,CN,HK,IL,IN,IQ,IR,KP,PK,QA,RO,RS,RU,SA,SG,SO,SS,SY,TR,TW,UA,DZ -o ./private/filter4.bin
5. Generate a filter using cargo run -- -i ./private/DB1-LITE-V6.CSV merge -c BD,BR,CN,HK,IL,IN,IQ,IR,KP,PK,QA,RO,RS,RU,SA,SG,SO,SS,SY,TR,TW,UA,DZ -6 -o ./private/filter6.bin
6. Verify IP ranges using cargo run -- -i ./private/filter4.bin load or cargo run -- -i ./private/filter6.bin load -6

Round trip checks

1. diff <(cargo run -- -i ./private/DB1-LITE-V4.CSV merge -c BD,BR,CN,HK,IL,IN,IQ,IR,KP,PK,QA,RO,RS,RU,SA,SG,SO,SS,SY,TR,TW,UA,DZ) <(cargo run -- -i ./private/filter4.bin load)
2. diff <(cargo run -- -i ./private/DB1-LITE-V6.CSV merge -c BD,BR,CN,HK,IL,IN,IQ,IR,KP,PK,QA,RO,RS,RU,SA,SG,SO,SS,SY,TR,TW,UA,DZ -6) <(cargo run -- -i ./private/filter6.bin load -6)

Various builds

• build: cargo hack --feature-powerset build
• clippy: cargo hack --feature-powerset clippy -- -D warnings
• fmt: cargo fmt --check
• miri: cargo +nightly hack --feature-powerset miri test
• docs: RUSTDOCFLAGS="--cfg docsrs" cargo +nightly doc --all-features
• publish: cargo publish --dry-run -p ipfilter