Skip to content
/ dbase Public

a dBASE III/IV/VisualFoxPro streaming parser for rust

Notifications You must be signed in to change notification settings

srenauld/dbase

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

31 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

dbase-parser: A dbaseIII/IV/foxpro iterative parser for rust

This crate provides the ability to read and parse dbf files, yielding typed objects as it goes. It is efficient, versatile, well-tested and, above all, maintained.

The motivation behind this is documented here. In particular, no parsing crate supported the memo (M) type, let alone the two variants of it.

Build Status Coverage Status

A disclaimer on versioning

As the crate is still under active development, versions may change relatively fast. Until we're at 1.x, consider the public API to be unstable.

In particular, the FieldValue enum may gain additional types as different DBF file formats surface.

Installation

Add dbase_parser to your dependencies.

Usage

Opening a file and streaming rows is a simple set of operations, as shown below:

extern crate dbase_parser;
use dbase_parser::{FieldValue, open};

let dbase_file = open("data.dbf");
let amount:f64 = dbase_file
  .map(|db| {
    db.into_iter().fold(0.0, |current, record| {
      record.get("amount").map(|value| match value {
        FieldValue::Numeric(value) => value.clone(),
        _ => 0.0
      }).unwrap_or(0.0)

  })
}).unwrap_or(0.0);

More options and types are available under the hood and exposed through the documentation.

Bugs

If you've found a bug or issue, don't hesitate to file an issue. If you are parsing a file, don't forget to attach it to your issue; make sure to anonymize the data if needed.

License

Licensed under either of

at your option.

Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.

About

a dBASE III/IV/VisualFoxPro streaming parser for rust

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages