# reelpath
[](./LICENSE)
[](https://github.com/nickgerace/reelpath/releases/latest)
[](https://crates.io/crates/reelpath)
`reelpath` is a CLI application that prints the absolute path for a given file or directory.
```sh
user at host in ~/github.com/nickgerace/reelpath
% reelpath README.md
/home/user/github.com/nickgerace/reelpath/README.md
```
## Motivation
Could this exist as a shell function?
Probably.
Did I want a cross-platform method to get the absolute path for a given file or directory?
Yes.
Since `reelpath` does not use any external dependencies, it supports all platforms that [Rust](https://www.rust-lang.org/) supports.
**Please file an [issue](https://github.com/nickgerace/reelpath/issues)** if you encounter an error on your platform of choice.
## Usage
You can supply multiple arguments to the CLI, use pipes with `xargs`, and use wildcards in a single argument.
```sh
reelpath file
reelpath directory
reelpath ../relative/path/to/file
reelpath ../relative/path/to/directory
reelpath $(ls)
reelpath file.* file.extension directory/*
## Installation
There multiple methods for installing `reelpath`.
### Homebrew and Linux Brew
You can use [macOS Homebrew](https://brew.sh) or [Linuxbrew](https://docs.brew.sh/Homebrew-on-Linux) to install the [tap](https://github.com/nickgerace/homebrew-reelpath).
```sh
brew install nickgerace/reelpath/reelpath
```
### Cargo
You can use [cargo](https://crates.io) to install the [crate](https://crates.io/crates/reelpath) on almost any platform.
```sh
cargo install gfold
```
Keeping the crate up to date is easy with [cargo-update](https://crates.io/crates/cargo-update).
```sh
cargo install cargo-update
cargo install-update -a
```
## Additional Notes
### Where is `CHANGELOG.md`?
This project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html), but does not leverage popular changelog formats, like [Keep a Changelog](https://keepachangelog.com/en/1.0.0/), because of its tiny size and purpose.
Using GitHub to compare two tags, commits, etc. should suffice for this project.
```
https://github.com/nickgerace/reelpath/compare/<one-tag>...<another-tag>
https://github.com/nickgerace/reelpath/compare/<latest-tag>...HEAD
```
### Where is the continuous integration?
Local developer testing suffices for this project due to its tiny size and purpose.
Continuous integration would be wasteful, but this is subject to change.
### Where are the binaries?
There are no binaries uploaded to GitHub since this application is best distributed via a package manager, such as [cargo](https://crates.io/).
Use one of the README's installation methods to build and install `reelpath`.
## Code of Conduct
This repository follows and enforces the Rust programming language's [Code of Conduct](https://www.rust-lang.org/policies/code-of-conduct).
## Additional Information
- Author: [Nick Gerace](https://nickgerace.dev)
- License: [Apache 2.0](./LICENSE)