Workspace Root

A utility to get workspace root.

The functions will try to get the workspace root by searching for the Cargo.lock file. Then it will return the directory that contains the file. If the file is not found, an error will be returned instead.

Installation

Install this package as a dependency in the project:

cargo add workspace_root

Usage

Get workspace root with the following code:

use std::path::PathBuf;

use workspace_root::get_workspace_root;

let root: PathBuf = get_workspace_root();

Async version also available with async_std, smol and tokio features:

// This is a `async_std` example

use async_std::path::PathBuf;

use workspace_root::async_std::get_workspace_root_async;

let root: PathBuf = get_workspace_root_async().await;

// This is a `smol` example

use std::path::PathBuf;

use workspace_root::smol::get_workspace_root_async;

let root: PathBuf = get_workspace_root_async().await;

// This is a `tokio` example

use std::path::PathBuf;

use workspace_root::tokio::get_workspace_root_async;

let root: PathBuf = get_workspace_root_async().await;

Contributing

For contributing, please refer to the contributing guide.

License

This project is licensed under the terms of the MIT license.