Add canonicalize function

src/lib/lib.rs

@@ -162,6 +162,7 @@ mod toc;
 mod zipper;
 mod templates;
 mod bookoption;
+mod misc;
 
 #[cfg(feature = "proofread")]
 mod grammar_check;

src/lib/misc.rs

@@ -0,0 +1,31 @@
+// Copyright (C) 2016 Élisabeth HENRY.
+//
+// This file is part of Crowbook.
+//
+// Crowbook is free software: you can redistribute it and/or modify
+// it under the terms of the GNU Lesser General Public License as published
+// by the Free Software Foundation, either version 2.1 of the License, or
+// (at your option) any later version.
+//
+// Crowbook is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+// GNU Lesser General Public License for more details.
+//
+// You should have received a copy of the GNU Lesser General Public License
+// along with Crowbook.  If not, see <http://www.gnu.org/licenses/>.
+
+//! Misc utility functions used across crowbook
+
+use std;
+use std::path::Path;
+
+/// Try to canonicalize a path using std::fs::canonicalize, and returns the
+/// unmodified path if it fails (e.g. if the path doesn't exist (yet))
+pub fn canonicalize<P: AsRef<Path>>(path: P) -> String {
+    if let Ok(path) = std::fs::canonicalize(path.as_ref()) {
+        format!("{}", path.display())
+    } else {
+        format!("{}", path.as_ref().display())
+    }
+}