hdrs   ![Build Status] ![Latest Version]

HDFS Native Client in Rust based on hdfs-sys.

Quick Start

```rust use std::io::{Read, Write};

use hdrs::Client;

fn main() -> Result<(), Box> { let fs = Client::connect("hdfs://127.0.0.1:9000")?;

let mut f = fs.open_file().write(true).create(true).open("/tmp/hello.txt")?;
let n = f.write("Hello, World!".as_bytes())?;

let mut f = fs.open_file().read(true).open("/tmp/hello.txt")?;
let mut buf = vec![0; 1024];
let n = f.read(&mut buf)?;

let _ = fs.remove_file("/tmp/hello.txt")?;

Ok(())

} ```

Compiletime

hdrs depends on hdfs-sys which links libjvm to work.

Please make sure JAVA_HOME is set correctly:

shell export JAVA_HOME=/path/to/java export LD_LIBRARY_PATH=${JAVA_HOME}/lib/server:${LD_LIBRARY_PATH}

Runtime

hdrs depends on hdfs-sys which uses JNI to call functions provided by jars that provided by hadoop releases.

Please also make sure HADOOP_HOME, LD_LIBRARY_PATH is set correctly during runtime:

shell export HADOOP_HOME=/path/to/hadoop export LD_LIBRARY_PATH=${JAVA_HOME}/lib/server:${LD_LIBRARY_PATH}

hdrs will detect CLASSPATH based on HADOOP_HOME, users can override the behavior via setting CLASSPATH manually:

shell export CLASSPATH=$(find $HADOOP_HOME -iname "*.jar" | xargs echo | tr ' ' ':')

Contributing

Check out the CONTRIBUTING.md guide for more details on getting started with contributing to this project.

Getting help

Submit issues for bug report or asking questions in discussion.

Acknowledgment

This project is highly inspired by clang-sys

License

<sup>Licensed under Apache License, Version 2.0.</sup>