Initial commit

Author: saurvs

.gitignore

@@ -0,0 +1,2 @@
+target
+Cargo.lock

Cargo.toml

@@ -0,0 +1,9 @@
+[package]
+name = "nfd"
+version = "0.0.1"
+authors = ["Saurav Sachidanand <[email protected]>"]
+
+build = "build.rs"
+
+[dependencies]
+libc = "0.2.7"

LICENSE.md

@@ -0,0 +1,19 @@
+Copyright (c) 2015 Saurav Sachidanand
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

README.md

@@ -0,0 +1,35 @@
+# nfd-rs ![](https://img.shields.io/badge/license-MIT-blue.svg)
+
+`nfd-rs` is a Rust binding to the library [nativefiledialog](https://github.com/mlabbe/nativefiledialog), that provides a convenient cross-platform interface to opening file dialogs on Linux, OS X and Windows.
+
+Currently, only single file and save dialogs are supported, and the crate has been tested only on OS X. And yes, APIs may break with newer versions.
+
+## Usage
+
+* Add the dependency `nfd` in your ```Cargo.toml```
+  ```toml
+  [dependencies]
+  nfd = "0.0.1"
+  ```
+
+* Open a single file dialog
+  ```rust
+  extern crate nfd;
+
+  use nfd::*;
+
+  fn main() {
+    let filter_str = "";
+    let default_path = "~";
+    let result = open_file_dialog(filter_str, default_path);
+
+    match result {
+        NFDResult::Okay(file_path) => println!("File path = {:?}", file_path),
+        NFDResult::Cancel => println!("User canceled"),
+        NFDResult::Error(error) => println!("Error: {}", error),
+    }
+  }
+  ```
+
+## To build
+Follow the instructions [here](https://github.com/mlabbe/nativefiledialog/blob/master/README.md) to build libraries in C and an OS-specific language. Then, set the `NFD_LIB_DIR` environment variable to the path of the directory in which the libraries are stored. Now run `cargo build`.

build.rs

@@ -0,0 +1,8 @@
+use std::env;
+
+fn main() {
+    let ndf_lib_dir = env::var("NFD_LIB_DIR").unwrap();
+    println!("cargo:rustc-link-search=native={}",ndf_lib_dir);
+    println!("cargo:rustc-link-lib=static=nfd");
+    println!("cargo:rustc-link-lib=framework=AppKit");
+}

examples/example.rs

@@ -0,0 +1,15 @@
+extern crate nfd;
+
+use nfd::*;
+
+fn main() {
+    let filter_str = "";
+    let default_path = "~";
+    let result = open_file_dialog(filter_str, default_path);
+
+    match result {
+        NFDResult::Okay(file_path) => println!("File path = {:?}", file_path),
+        NFDResult::Cancel => println!("User canceled"),
+        NFDResult::Error(error) => println!("Error: {}", error),
+    }
+}

src/ffi.rs

@@ -0,0 +1,16 @@
+use libc::c_char;
+
+#[repr(C)]
+pub enum nfdresult_t {
+    NFD_ERROR,
+    NFD_OKAY,
+    NFD_CANCEL
+}
+
+#[link(name = "nfd")]
+extern {
+    pub fn NFD_OpenDialog(filter_list: *const c_char, default_path: *const c_char, outPath: *mut *mut c_char) -> nfdresult_t;
+    pub fn NFD_SaveDialog(filter_list: *const c_char, default_path: *const c_char, outPath: *mut *mut c_char) -> nfdresult_t;
+
+    pub fn NFD_GetError() -> *const c_char;
+}

src/lib.rs

@@ -0,0 +1,77 @@
+extern crate libc;
+
+mod ffi;
+
+use libc::c_char;
+use std::ffi::*;
+use ffi::*;
+
+/// Result of opening a file dialog
+pub enum NFDResult {
+    /// User pressed okay. `String` is the file path selected
+    Okay(String),
+    /// User pressed cancel
+    Cancel,
+    /// Program error. `String` is the error description
+    Error(String),
+}
+
+enum DialogType {
+    SingleFile,
+    SaveFile
+}
+
+/// Open single file dialog
+#[inline(always)]
+pub fn open_file_dialog(filter_list: &str, default_path: &str) -> NFDResult {
+    open_dialog(filter_list, default_path, &DialogType::SingleFile)
+}
+
+/// Open save dialog
+#[inline(always)]
+pub fn open_save_dialog(filter_list: &str, default_path: &str) -> NFDResult {
+    open_dialog(filter_list, default_path, &DialogType::SaveFile)
+}
+
+fn open_dialog(filter_list: &str, default_path: &str, dialog_type: &DialogType) -> NFDResult {
+
+    let mut final_cstring = CString::new("").unwrap();
+    let out_path = CString::new("").unwrap().into_raw() as *mut *mut c_char;
+    let result: nfdresult_t;
+
+    unsafe {
+        result = match dialog_type {
+            &DialogType::SingleFile => {
+                NFD_OpenDialog(
+                CString::new(filter_list).unwrap().as_ptr(),
+                CString::new(default_path).unwrap().as_ptr(),
+                out_path)
+            },
+
+            &DialogType::SaveFile => {
+                NFD_SaveDialog(
+                CString::new(filter_list).unwrap().as_ptr(),
+                CString::new(default_path).unwrap().as_ptr(),
+                out_path)
+            },
+        };
+
+        match result {
+            nfdresult_t::NFD_OKAY => {
+                final_cstring = CString::from_raw(*out_path);
+            },
+            nfdresult_t::NFD_ERROR => {
+                final_cstring = CStr::from_ptr(NFD_GetError()).to_owned();
+            }
+            _ => {},
+        }
+    }
+
+    let final_string = final_cstring.to_str().unwrap().to_string();
+
+    match result {
+        nfdresult_t::NFD_OKAY => NFDResult::Okay(final_string),
+        nfdresult_t::NFD_CANCEL => NFDResult::Cancel,
+        nfdresult_t::NFD_ERROR => NFDResult::Error(final_string)
+    }
+}