[ { "path": ".github/FUNDING.yml", "content": "github: ogham\n" }, { "path": ".github/ISSUE_TEMPLATE/bug_report.md", "content": "---\nname: exa is unmaintained\nabout: Please use the active fork eza instead. \n---\n\nexa is unmaintained, please use the active fork eza instead. \n\n---\n" }, { "path": ".github/workflows/unit-tests.yml", "content": "name: Unit tests\n\non:\n push:\n branches: [ master ]\n paths:\n - '.github/workflows/*'\n - 'src/**'\n - 'Cargo.*'\n - build.rs\n pull_request:\n branches: [ master ]\n paths:\n - '.github/workflows/*'\n - 'src/**'\n - 'Cargo.*'\n - build.rs\n\nenv:\n CARGO_TERM_COLOR: always\n\njobs:\n unit-tests:\n runs-on: ${{ matrix.os }}\n\n continue-on-error: ${{ matrix.rust == 'nightly' }}\n\n strategy:\n matrix:\n os: [ubuntu-latest, macos-latest]\n rust: [1.66.1, stable, beta, nightly]\n\n steps:\n - name: Checkout repository\n uses: actions/checkout@v3\n\n - name: Install Rust toolchain\n uses: dtolnay/rust-toolchain@v1\n with:\n toolchain: ${{ matrix.rust }}\n\n - name: Install cargo-hack\n run: cargo install cargo-hack@0.5.27\n\n - name: Run unit tests\n run: cargo hack test --feature-powerset\n" }, { "path": ".gitignore", "content": "# Rust stuff\ntarget\n\n# Vagrant stuff\n.vagrant\n*.log\n\n# Compiled artifacts\n# (see devtools/*-package-for-*.sh)\n/exa-linux-x86_64\n/exa-linux-x86_64-*.zip\n/exa-macos-x86_64\n/exa-macos-x86_64-*.zip\n/MD5SUMS\n/SHA1SUMS\n\n# Snap stuff\nparts\nprime\nstage\n*.snap\n" }, { "path": ".rustfmt.toml", "content": "disable_all_formatting = true\n" }, { "path": "Cargo.toml", "content": "[package]\nname = \"exa\"\ndescription = \"A modern replacement for ls\"\nauthors = [\"Benjamin Sago \"]\ncategories = [\"command-line-utilities\"]\nedition = \"2021\"\nrust-version = \"1.66.1\"\nexclude = [\"/devtools/*\", \"/Justfile\", \"/Vagrantfile\", \"/screenshots.png\"]\nreadme = \"README.md\"\nhomepage = \"https://the.exa.website/\"\nlicense = \"MIT\"\nrepository = \"https://github.com/ogham/exa\"\nversion = \"0.10.1\"\n\n\n[[bin]]\nname = \"exa\"\n\n\n[dependencies]\nansi_term = \"0.12\"\nglob = \"0.3\"\nlazy_static = \"1.3\"\nlibc = \"0.2\"\nlocale = \"0.2\"\nlog = \"0.4\"\nnatord = \"1.0\"\nnum_cpus = \"1.10\"\nnumber_prefix = \"0.4\"\nscoped_threadpool = \"0.1\"\nterm_grid = \"0.2.0\"\nterminal_size = \"0.1.16\"\nunicode-width = \"0.1\"\nzoneinfo_compiled = \"0.5.1\"\n\n[target.'cfg(unix)'.dependencies]\nusers = \"0.11\"\n\n[dependencies.datetime]\nversion = \"0.5.2\"\ndefault-features = false\nfeatures = [\"format\"]\n\n[dependencies.git2]\nversion = \"0.13\"\noptional = true\ndefault-features = false\n\n[build-dependencies.datetime]\nversion = \"0.5.2\"\ndefault-features = false\n\n[features]\ndefault = [ \"git\" ]\ngit = [ \"git2\" ]\nvendored-openssl = [\"git2/vendored-openssl\"]\n\n\n# make dev builds faster by excluding debug symbols\n[profile.dev]\ndebug = false\n\n# use LTO for smaller binaries (that take longer to build)\n[profile.release]\nlto = true\n\n\n[package.metadata.deb]\nlicense-file = [ \"LICENCE\", \"4\" ]\ndepends = \"$auto\"\nextended-description = \"\"\"\nexa is a replacement for ls written in Rust.\n\"\"\"\nsection = \"utils\"\npriority = \"optional\"\nassets = [\n [ \"target/release/exa\", \"/usr/bin/exa\", \"0755\" ],\n [ \"target/release/../man/exa.1\", \"/usr/share/man/man1/exa.1\", \"0644\" ],\n [ \"target/release/../man/exa_colors.5\", \"/usr/share/man/man5/exa_colors.5\", \"0644\" ],\n [ \"completions/bash/exa\", \"/usr/share/bash-completion/completions/exa\", \"0644\" ],\n [ \"completions/zsh/_exa\", \"/usr/share/zsh/site-functions/_exa\", \"0644\" ],\n [ \"completions/fish/exa.fish\", \"/usr/share/fish/vendor_completions.d/exa.fish\", \"0644\" ],\n]\n" }, { "path": "Justfile", "content": "all: build test\nall-release: build-release test-release\n\n\n#----------#\n# building #\n#----------#\n\n# compile the exa binary\n@build:\n cargo build\n\n# compile the exa binary (in release mode)\n@build-release:\n cargo build --release --verbose\n\n# produce an HTML chart of compilation timings\n@build-time:\n cargo +nightly clean\n cargo +nightly build -Z timings\n\n# check that the exa binary can compile\n@check:\n cargo check\n\n\n#---------------#\n# running tests #\n#---------------#\n\n# run unit tests\n@test:\n cargo test --workspace -- --quiet\n\n# run unit tests (in release mode)\n@test-release:\n cargo test --workspace --release --verbose\n\n\n#------------------------#\n# running extended tests #\n#------------------------#\n\n# run extended tests\n@xtests:\n xtests/run.sh\n\n# run extended tests (using the release mode exa)\n@xtests-release:\n xtests/run.sh --release\n\n# display the number of extended tests that get run\n@count-xtests:\n grep -F '[[cmd]]' -R xtests | wc -l\n\n\n#-----------------------#\n# code quality and misc #\n#-----------------------#\n\n# lint the code\n@clippy:\n touch src/main.rs\n cargo clippy\n\n# update dependency versions, and checks for outdated ones\n@update-deps:\n cargo update\n command -v cargo-outdated >/dev/null || (echo \"cargo-outdated not installed\" && exit 1)\n cargo outdated\n\n# list unused dependencies\n@unused-deps:\n command -v cargo-udeps >/dev/null || (echo \"cargo-udeps not installed\" && exit 1)\n cargo +nightly udeps\n\n# check that every combination of feature flags is successful\n@check-features:\n command -v cargo-hack >/dev/null || (echo \"cargo-hack not installed\" && exit 1)\n cargo hack check --feature-powerset\n\n# build exa and run extended tests with features disabled\n@feature-checks *args:\n cargo build --no-default-features\n specsheet xtests/features/none.toml -shide {{args}} \\\n -O cmd.target.exa=\"${CARGO_TARGET_DIR:-../../target}/debug/exa\"\n\n# print versions of the necessary build tools\n@versions:\n rustc --version\n cargo --version\n\n\n#---------------#\n# documentation #\n#---------------#\n\n# build the man pages\n@man:\n mkdir -p \"${CARGO_TARGET_DIR:-target}/man\"\n pandoc --standalone -f markdown -t man man/exa.1.md > \"${CARGO_TARGET_DIR:-target}/man/exa.1\"\n pandoc --standalone -f markdown -t man man/exa_colors.5.md > \"${CARGO_TARGET_DIR:-target}/man/exa_colors.5\"\n\n# build and preview the main man page (exa.1)\n@man-1-preview: man\n man \"${CARGO_TARGET_DIR:-target}/man/exa.1\"\n\n# build and preview the colour configuration man page (exa_colors.5)\n@man-5-preview: man\n man \"${CARGO_TARGET_DIR:-target}/man/exa_colors.5\"\n" }, { "path": "LICENCE", "content": "The MIT License (MIT)\n\nCopyright (c) 2014 Benjamin Sago\n\nPermission is hereby granted, free of charge, to any person obtaining a copy\nof this software and associated documentation files (the \"Software\"), to deal\nin the Software without restriction, including without limitation the rights\nto use, copy, modify, merge, publish, distribute, sublicense, and/or sell\ncopies of the Software, and to permit persons to whom the Software is\nfurnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in all\ncopies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\nAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\nLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\nOUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE\nSOFTWARE.\n" }, { "path": "README.md", "content": "# exa is unmaintained, use the [fork eza](https://github.com/eza-community/eza) instead.\n\n(This repository isn’t archived because the only person with the rights to do so is unreachable).\n\n---\n\n
\n\n# exa\n\n[exa](https://the.exa.website/) is a modern replacement for _ls_.\n\n**README Sections:** [Options](#options) — [Installation](#installation) — [Development](#development)\n\n[![Unit tests](https://github.com/ogham/exa/actions/workflows/unit-tests.yml/badge.svg)](https://github.com/ogham/exa/actions/workflows/unit-tests.yml)\n
\n\n![Screenshots of exa](screenshots.png)\n\n---\n\n**exa** is a modern replacement for the venerable file-listing command-line program `ls` that ships with Unix and Linux operating systems, giving it more features and better defaults.\nIt uses colours to distinguish file types and metadata.\nIt knows about symlinks, extended attributes, and Git.\nAnd it’s **small**, **fast**, and just **one single binary**.\n\nBy deliberately making some decisions differently, exa attempts to be a more featureful, more user-friendly version of `ls`.\nFor more information, see [exa’s website](https://the.exa.website/).\n\n\n---\n\n\n

Command-line options

\n\n\nexa’s options are almost, but not quite, entirely unlike `ls`’s.\n\n### Display options\n\n- **-1**, **--oneline**: display one entry per line\n- **-G**, **--grid**: display entries as a grid (default)\n- **-l**, **--long**: display extended details and attributes\n- **-R**, **--recurse**: recurse into directories\n- **-T**, **--tree**: recurse into directories as a tree\n- **-x**, **--across**: sort the grid across, rather than downwards\n- **-F**, **--classify**: display type indicator by file names\n- **--colo[u]r**: when to use terminal colours\n- **--colo[u]r-scale**: highlight levels of file sizes distinctly\n- **--icons**: display icons\n- **--no-icons**: don't display icons (always overrides --icons)\n\n### Filtering options\n\n- **-a**, **--all**: show hidden and 'dot' files\n- **-d**, **--list-dirs**: list directories like regular files\n- **-L**, **--level=(depth)**: limit the depth of recursion\n- **-r**, **--reverse**: reverse the sort order\n- **-s**, **--sort=(field)**: which field to sort by\n- **--group-directories-first**: list directories before other files\n- **-D**, **--only-dirs**: list only directories\n- **--git-ignore**: ignore files mentioned in `.gitignore`\n- **-I**, **--ignore-glob=(globs)**: glob patterns (pipe-separated) of files to ignore\n\nPass the `--all` option twice to also show the `.` and `..` directories.\n\n### Long view options\n\nThese options are available when running with `--long` (`-l`):\n\n- **-b**, **--binary**: list file sizes with binary prefixes\n- **-B**, **--bytes**: list file sizes in bytes, without any prefixes\n- **-g**, **--group**: list each file’s group\n- **-h**, **--header**: add a header row to each column\n- **-H**, **--links**: list each file’s number of hard links\n- **-i**, **--inode**: list each file’s inode number\n- **-m**, **--modified**: use the modified timestamp field\n- **-S**, **--blocks**: list each file’s number of file system blocks\n- **-t**, **--time=(field)**: which timestamp field to use\n- **-u**, **--accessed**: use the accessed timestamp field\n- **-U**, **--created**: use the created timestamp field\n- **-@**, **--extended**: list each file’s extended attributes and sizes\n- **--changed**: use the changed timestamp field\n- **--git**: list each file’s Git status, if tracked or ignored\n- **--time-style**: how to format timestamps\n- **--no-permissions**: suppress the permissions field\n- **--octal-permissions**: list each file's permission in octal format\n- **--no-filesize**: suppress the filesize field\n- **--no-user**: suppress the user field\n- **--no-time**: suppress the time field\n\nSome of the options accept parameters:\n\n- Valid **--color** options are **always**, **automatic**, and **never**.\n- Valid sort fields are **accessed**, **changed**, **created**, **extension**, **Extension**, **inode**, **modified**, **name**, **Name**, **size**, **type**, and **none**. Fields starting with a capital letter sort uppercase before lowercase. The modified field has the aliases **date**, **time**, and **newest**, while its reverse has the aliases **age** and **oldest**.\n- Valid time fields are **modified**, **changed**, **accessed**, and **created**.\n- Valid time styles are **default**, **iso**, **long-iso**, and **full-iso**.\n\n\n---\n\n\n

Installation

\n\n\nexa is available for macOS and Linux.\nMore information on how to install exa is available on [the Installation page](https://the.exa.website/install).\n\n### Alpine Linux\n\nOn Alpine Linux, [enable community repository](https://wiki.alpinelinux.org/wiki/Enable_Community_Repository) and install the [`exa`](https://pkgs.alpinelinux.org/package/edge/community/x86_64/exa) package.\n\n apk add exa\n\n### Arch Linux\n\nOn Arch, install the [`exa`](https://www.archlinux.org/packages/community/x86_64/exa/) package.\n\n pacman -S exa\n\n### Android / Termux\n\nOn Android / Termux, install the [`exa`](https://github.com/termux/termux-packages/tree/master/packages/exa) package.\n\n pkg install exa\n\n### Debian\n\nOn Debian, install the [`exa`](https://packages.debian.org/stable/exa) package.\n\n apt install exa\n\n### Fedora\n\nOn Fedora, install the [`exa`](https://src.fedoraproject.org/modules/exa) package.\n\n dnf install exa\n\n### Gentoo\n\nOn Gentoo, install the [`sys-apps/exa`](https://packages.gentoo.org/packages/sys-apps/exa) package.\n\n emerge sys-apps/exa\n\n### Homebrew\n\nIf you’re using [Homebrew](https://brew.sh/) on macOS, install the [`exa`](http://formulae.brew.sh/formula/exa) formula.\n\n brew install exa\n\n### MacPorts\n\nIf you're using [MacPorts](https://www.macports.org/) on macOS, install the [`exa`](https://ports.macports.org/port/exa/summary) port.\n\n port install exa\n\n### Nix\n\nOn nixOS, install the [`exa`](https://github.com/NixOS/nixpkgs/blob/master/pkgs/tools/misc/exa/default.nix) package.\n\n nix-env -i exa\n\n### openSUSE\n\nOn openSUSE, install the [`exa`](https://software.opensuse.org/package/exa) package.\n\n zypper install exa\n\n### Ubuntu\n\nOn Ubuntu 20.10 (Groovy Gorilla) and later, install the [`exa`](https://packages.ubuntu.com/jammy/exa) package.\n\n sudo apt install exa\n\n### Void Linux\n\nOn Void Linux, install the [`exa`](https://github.com/void-linux/void-packages/blob/master/srcpkgs/exa/template) package.\n\n xbps-install -S exa\n\n### Manual installation from GitHub\n\nCompiled binary versions of exa are uploaded to GitHub when a release is made.\nYou can install exa manually by [downloading a release](https://github.com/ogham/exa/releases), extracting it, and copying the binary to a directory in your `$PATH`, such as `/usr/local/bin`.\n\nFor more information, see the [Manual Installation page](https://the.exa.website/install/linux#manual).\n\n### Cargo\n\nIf you already have a Rust environment set up, you can use the `cargo install` command:\n\n cargo install exa\n\nCargo will build the `exa` binary and place it in `$HOME/.cargo`.\n\nTo build without Git support, run `cargo install --no-default-features exa` is also available, if the requisite dependencies are not installed.\n\n\n---\n\n\n

Development\n\n\n \"Rust\n\n\n\n \"MIT\n\n

\n\nexa is written in [Rust](https://www.rust-lang.org/).\nYou will need rustc version 1.66.1 or higher.\nThe recommended way to install Rust for development is from the [official download page](https://www.rust-lang.org/tools/install), using rustup.\n\nOnce Rust is installed, you can compile exa with Cargo:\n\n cargo build\n cargo test\n\n- The [just](https://github.com/casey/just) command runner can be used to run some helpful development commands, in a manner similar to `make`.\nRun `just --list` to get an overview of what’s available.\n\n- If you are compiling a copy for yourself, be sure to run `cargo build --release` or `just build-release` to benefit from release-mode optimisations.\nCopy the resulting binary, which will be in the `target/release` directory, into a folder in your `$PATH`.\n`/usr/local/bin` is usually a good choice.\n\n- To compile and install the manual pages, you will need [pandoc](https://pandoc.org/).\nThe `just man` command will compile the Markdown into manual pages, which it will place in the `target/man` directory.\nTo use them, copy them into a directory that `man` will read.\n`/usr/local/share/man` is usually a good choice.\n\n- exa depends on [libgit2](https://github.com/rust-lang/git2-rs) for certain features.\nIf you’re unable to compile libgit2, you can opt out of Git support by running `cargo build --no-default-features`.\n\n- If you intend to compile for musl, you will need to use the flag `vendored-openssl` if you want to get the Git feature working.\nThe full command is `cargo build --release --target=x86_64-unknown-linux-musl --features vendored-openssl,git`.\n\nFor more information, see the [Building from Source page](https://the.exa.website/install/source).\n\n\n### Testing with Vagrant\n\nexa uses [Vagrant][] to configure virtual machines for testing.\n\nPrograms such as exa that are basically interfaces to the system are [notoriously difficult to test][testing].\nAlthough the internal components have unit tests, it’s impossible to do a complete end-to-end test without mandating the current user’s name, the time zone, the locale, and directory structure to test.\n(And yes, these tests are worth doing. I have missed an edge case on many an occasion.)\n\nThe initial attempt to solve the problem was just to create a directory of “awkward” test cases, run exa on it, and make sure it produced the correct output.\nBut even this output would change if, say, the user’s locale formats dates in a different way.\nThese can be mocked inside the code, but at the cost of making that code more complicated to read and understand.\n\nAn alternative solution is to fake *everything*: create a virtual machine with a known state and run the tests on *that*.\nThis is what Vagrant does.\nAlthough it takes a while to download and set up, it gives everyone the same development environment to test for any obvious regressions.\n\n[Vagrant]: https://www.vagrantup.com/\n[testing]: https://eev.ee/blog/2016/08/22/testing-for-people-who-hate-testing/#troublesome-cases\n\nFirst, initialise the VM:\n\n host$ vagrant up\n\nThe first command downloads the virtual machine image, and then runs our provisioning script, which installs Rust and exa’s build-time dependencies, configures the environment, and generates some awkward files and folders to use as test cases.\nOnce this is done, you can SSH in, and build and test:\n\n host$ vagrant ssh\n vm$ cd /vagrant\n vm$ cargo build\n vm$ ./xtests/run\n All the tests passed!\n\nOf course, the drawback of having a standard development environment is that you stop noticing bugs that occur outside of it.\nFor this reason, Vagrant isn’t a *necessary* development step — it’s there if you’d like to use it, but exa still gets used and tested on other platforms.\nIt can still be built and compiled on any target triple that it supports, VM or no VM, with `cargo build` and `cargo test`.\n" }, { "path": "Vagrantfile", "content": "Vagrant.configure(2) do |config|\n\n # We use Ubuntu instead of Debian because the image comes with two-way\n # shared folder support by default.\n UBUNTU = 'hashicorp/bionic64'\n\n config.vm.define(:exa) do |config|\n config.vm.provider :virtualbox do |v|\n v.name = 'exa'\n v.memory = 2048\n v.cpus = `nproc`.chomp.to_i\n end\n\n config.vm.provider :vmware_desktop do |v|\n v.vmx['memsize'] = '2048'\n v.vmx['numvcpus'] = `nproc`.chomp\n end\n\n config.vm.box = UBUNTU\n config.vm.hostname = 'exa'\n\n\n # Make sure we know the VM image’s default user name. The ‘cassowary’ user\n # (specified later) is used for most of the test *output*, but we still\n # need to know where the ‘target’ and ‘.cargo’ directories go.\n developer = 'vagrant'\n\n\n # Install the dependencies needed for exa to build, as quietly as\n # apt can do.\n config.vm.provision :shell, privileged: true, inline: <<-EOF\n if hash fish &>/dev/null; then\n echo \"Tools are already installed\"\n else\n trap 'exit' ERR\n echo \"Installing tools\"\n apt-get update -qq\n apt-get install -qq -o=Dpkg::Use-Pty=0 \\\n git gcc curl attr libgit2-dev zip \\\n fish zsh bash bash-completion\n fi\n EOF\n\n\n # Install Rust.\n # This is done as vagrant, not root, because it’s vagrant\n # who actually uses it. Sent to /dev/null because the progress\n # bar produces a ton of output.\n config.vm.provision :shell, privileged: false, inline: <<-EOF\n if hash rustc &>/dev/null; then\n echo \"Rust is already installed\"\n else\n trap 'exit' ERR\n echo \"Installing Rust\"\n curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh -s -- --profile minimal --component rustc,rust-std,cargo,clippy -y > /dev/null\n source $HOME/.cargo/env\n echo \"Installing cargo-hack\"\n cargo install -q cargo-hack\n echo \"Installing specsheet\"\n cargo install -q --git https://github.com/ogham/specsheet\n fi\n EOF\n\n\n # Privileged installation and setup scripts.\n config.vm.provision :shell, privileged: true, inline: <<-EOF\n\n # Install Just, the command runner.\n if hash just &>/dev/null; then\n echo \"just is already installed\"\n else\n trap 'exit' ERR\n echo \"Installing just\"\n wget -q \"https://github.com/casey/just/releases/download/v0.8.3/just-v0.8.3-x86_64-unknown-linux-musl.tar.gz\"\n tar -xf \"just-v0.8.3-x86_64-unknown-linux-musl.tar.gz\"\n cp just /usr/local/bin\n fi\n\n # Guarantee that the timezone is UTC — some of the tests\n # depend on this (for now).\n timedatectl set-timezone UTC\n\n\n # Use a different ‘target’ directory on the VM than on the host.\n # By default it just uses the one in /vagrant/target, which can\n # cause problems if it has different permissions than the other\n # directories, or contains object files compiled for the host.\n echo 'PATH=\"/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin:/home/#{developer}/.cargo/bin\"' > /etc/environment\n echo 'CARGO_TARGET_DIR=\"/home/#{developer}/target\"' >> /etc/environment\n\n\n # Create a variety of misc scripts.\n\n ln -sf /vagrant/devtools/dev-run-debug.sh /usr/bin/exa\n ln -sf /vagrant/devtools/dev-run-release.sh /usr/bin/rexa\n\n echo -e \"#!/bin/sh\\ncargo build --manifest-path /vagrant/Cargo.toml \\\\$@\" > /usr/bin/build-exa\n ln -sf /usr/bin/build-exa /usr/bin/b\n\n echo -e \"#!/bin/sh\\ncargo test --manifest-path /vagrant/Cargo.toml \\\\$@ -- --quiet\" > /usr/bin/test-exa\n ln -sf /usr/bin/test-exa /usr/bin/t\n\n echo -e \"#!/bin/sh\\n/vagrant/xtests/run.sh\" > /usr/bin/run-xtests\n ln -sf /usr/bin/run-xtests /usr/bin/x\n\n echo -e \"#!/bin/sh\\nbuild-exa && test-exa && run-xtests\" > /usr/bin/compile-exa\n ln -sf /usr/bin/compile-exa /usr/bin/c\n\n echo -e \"#!/bin/sh\\nbash /vagrant/devtools/dev-package-for-linux.sh \\\\$@\" > /usr/bin/package-exa\n echo -e \"#!/bin/sh\\ncat /etc/motd\" > /usr/bin/halp\n\n chmod +x /usr/bin/{exa,rexa,b,t,x,c,build-exa,test-exa,run-xtests,compile-exa,package-exa,halp}\n\n\n # Configure the welcoming text that gets shown:\n\n # Capture the help text so it gets displayed first\n rm -f /etc/update-motd.d/*\n bash /vagrant/devtools/dev-help.sh > /etc/motd\n\n # Tell bash to execute a bunch of stuff when a session starts\n echo \"source /vagrant/devtools/dev-bash.sh\" > /home/#{developer}/.bash_profile\n chown #{developer} /home/#{developer}/.bash_profile\n\n # Disable last login date in sshd\n sed -i '/PrintLastLog yes/c\\PrintLastLog no' /etc/ssh/sshd_config\n systemctl restart sshd\n\n\n # Link the completion files so they’re “installed”:\n\n # bash\n test -h /etc/bash_completion.d/exa \\\n || ln -s /vagrant/contrib/completions.bash /etc/bash_completion.d/exa\n\n # zsh\n test -h /usr/share/zsh/vendor-completions/_exa \\\n || ln -s /vagrant/contrib/completions.zsh /usr/share/zsh/vendor-completions/_exa\n\n # fish\n test -h /usr/share/fish/completions/exa.fish \\\n || ln -s /vagrant/contrib/completions.fish /usr/share/fish/completions/exa.fish\n EOF\n\n\n # Install kcov for test coverage\n # This doesn’t run coverage over the xtests so it’s less useful for now\n if ENV.key?('INSTALL_KCOV')\n config.vm.provision :shell, privileged: false, inline: <<-EOF\n trap 'exit' ERR\n\n test -e ~/.cargo/bin/cargo-kcov \\\n || cargo install cargo-kcov\n\n sudo apt-get install -qq -o=Dpkg::Use-Pty=0 -y \\\n cmake g++ pkg-config \\\n libcurl4-openssl-dev libdw-dev binutils-dev libiberty-dev\n\n cargo kcov --print-install-kcov-sh | sudo sh\n EOF\n end\n\n config.vm.provision :shell, privileged: true, path: 'devtools/dev-set-up-environment.sh'\n config.vm.provision :shell, privileged: false, path: 'devtools/dev-create-test-filesystem.sh'\n end\nend\n" }, { "path": "build.rs", "content": "/// The version string isn’t the simplest: we want to show the version,\n/// current Git hash, and compilation date when building *debug* versions, but\n/// just the version for *release* versions so the builds are reproducible.\n///\n/// This script generates the string from the environment variables that Cargo\n/// adds (http://doc.crates.io/environment-variables.html) and runs `git` to\n/// get the SHA1 hash. It then writes the string into a file, which exa then\n/// includes at build-time.\n///\n/// - https://stackoverflow.com/q/43753491/3484614\n/// - https://crates.io/crates/vergen\n\nuse std::env;\nuse std::fs::File;\nuse std::io::{self, Write};\nuse std::path::PathBuf;\n\nuse datetime::{LocalDateTime, ISO};\n\n\n/// The build script entry point.\nfn main() -> io::Result<()> {\n #![allow(clippy::write_with_newline)]\n\n let tagline = \"exa - list files on the command-line\";\n let url = \"https://the.exa.website/\";\n\n let ver =\n if is_debug_build() {\n format!(\"{}\\nv{} \\\\1;31m(pre-release debug build!)\\\\0m\\n\\\\1;4;34m{}\\\\0m\", tagline, version_string(), url)\n }\n else if is_development_version() {\n format!(\"{}\\nv{} [{}] built on {} \\\\1;31m(pre-release!)\\\\0m\\n\\\\1;4;34m{}\\\\0m\", tagline, version_string(), git_hash(), build_date(), url)\n }\n else {\n format!(\"{}\\nv{}\\n\\\\1;4;34m{}\\\\0m\", tagline, version_string(), url)\n };\n\n // We need to create these files in the Cargo output directory.\n let out = PathBuf::from(env::var(\"OUT_DIR\").unwrap());\n let path = &out.join(\"version_string.txt\");\n\n // Bland version text\n let mut f = File::create(path).unwrap_or_else(|_| { panic!(\"{}\", path.to_string_lossy().to_string()) });\n writeln!(f, \"{}\", strip_codes(&ver))?;\n\n Ok(())\n}\n\n/// Removes escape codes from a string.\nfn strip_codes(input: &str) -> String {\n input.replace(\"\\\\0m\", \"\")\n .replace(\"\\\\1;31m\", \"\")\n .replace(\"\\\\1;4;34m\", \"\")\n}\n\n/// Retrieve the project’s current Git hash, as a string.\nfn git_hash() -> String {\n use std::process::Command;\n\n String::from_utf8_lossy(\n &Command::new(\"git\")\n .args(&[\"rev-parse\", \"--short\", \"HEAD\"])\n .output().unwrap()\n .stdout).trim().to_string()\n}\n\n/// Whether we should show pre-release info in the version string.\n///\n/// Both weekly releases and actual releases are --release releases,\n/// but actual releases will have a proper version number.\nfn is_development_version() -> bool {\n cargo_version().ends_with(\"-pre\") || env::var(\"PROFILE\").unwrap() == \"debug\"\n}\n\n/// Whether we are building in debug mode.\nfn is_debug_build() -> bool {\n env::var(\"PROFILE\").unwrap() == \"debug\"\n}\n\n/// Retrieves the [package] version in Cargo.toml as a string.\nfn cargo_version() -> String {\n env::var(\"CARGO_PKG_VERSION\").unwrap()\n}\n\n/// Returns the version and build parameters string.\nfn version_string() -> String {\n let mut ver = cargo_version();\n\n let feats = nonstandard_features_string();\n if ! feats.is_empty() {\n ver.push_str(&format!(\" [{}]\", &feats));\n }\n\n ver\n}\n\n/// Finds whether a feature is enabled by examining the Cargo variable.\nfn feature_enabled(name: &str) -> bool {\n env::var(&format!(\"CARGO_FEATURE_{}\", name))\n .map(|e| ! e.is_empty())\n .unwrap_or(false)\n}\n\n/// A comma-separated list of non-standard feature choices.\nfn nonstandard_features_string() -> String {\n let mut s = Vec::new();\n\n if feature_enabled(\"GIT\") {\n s.push(\"+git\");\n }\n else {\n s.push(\"-git\");\n }\n\n s.join(\", \")\n}\n\n/// Formats the current date as an ISO 8601 string.\nfn build_date() -> String {\n let now = LocalDateTime::now();\n format!(\"{}\", now.date().iso())\n}\n" }, { "path": "completions/bash/exa", "content": "_exa()\n{\n cur=${COMP_WORDS[COMP_CWORD]}\n prev=${COMP_WORDS[COMP_CWORD-1]}\n\n case \"$prev\" in\n -'?'|--help|-v|--version)\n return\n ;;\n\n --colour)\n COMPREPLY=( $( compgen -W 'always auto never' -- \"$cur\" ) )\n return\n ;;\n\n -L|--level)\n COMPREPLY=( $( compgen -W '{0..9}' -- \"$cur\" ) )\n return\n ;;\n\n -s|--sort)\n COMPREPLY=( $( compgen -W 'name filename Name Filename size filesize extension Extension date time modified changed accessed created type inode oldest newest age none --' -- \"$cur\" ) )\n return\n ;;\n\n -t|--time)\n COMPREPLY=( $( compgen -W 'modified changed accessed created --' -- \"$cur\" ) )\n return\n ;;\n\n --time-style)\n COMPREPLY=( $( compgen -W 'default iso long-iso full-iso --' -- \"$cur\" ) )\n return\n ;;\n esac\n\n case \"$cur\" in\n # _parse_help doesn’t pick up short options when they are on the same line than long options\n --*)\n # colo[u]r isn’t parsed correctly so we filter these options out and add them by hand\n parse_help=$( exa --help | grep -oE ' (\\-\\-[[:alnum:]@-]+)' | tr -d ' ' | grep -v '\\-\\-colo' )\n completions=$( echo '--color --colour --color-scale --colour-scale' $parse_help )\n COMPREPLY=( $( compgen -W \"$completions\" -- \"$cur\" ) )\n ;;\n\n -*)\n completions=$( exa --help | grep -oE ' (\\-[[:alnum:]@])' | tr -d ' ' )\n COMPREPLY=( $( compgen -W \"$completions\" -- \"$cur\" ) )\n ;;\n\n *)\n _filedir\n ;;\n esac\n} &&\ncomplete -o filenames -o bashdefault -F _exa exa\n" }, { "path": "completions/fish/exa.fish", "content": "# Meta-stuff\ncomplete -c exa -s 'v' -l 'version' -d \"Show version of exa\"\ncomplete -c exa -s '?' -l 'help' -d \"Show list of command-line options\"\n\n# Display options\ncomplete -c exa -s '1' -l 'oneline' -d \"Display one entry per line\"\ncomplete -c exa -s 'l' -l 'long' -d \"Display extended file metadata as a table\"\ncomplete -c exa -s 'G' -l 'grid' -d \"Display entries in a grid\"\ncomplete -c exa -s 'x' -l 'across' -d \"Sort the grid across, rather than downwards\"\ncomplete -c exa -s 'R' -l 'recurse' -d \"Recurse into directories\"\ncomplete -c exa -s 'T' -l 'tree' -d \"Recurse into directories as a tree\"\ncomplete -c exa -s 'F' -l 'classify' -d \"Display type indicator by file names\"\ncomplete -c exa -l 'color' \\\n -l 'colour' -d \"When to use terminal colours\" -x -a \"\n always\\t'Always use colour'\n auto\\t'Use colour if standard output is a terminal'\n never\\t'Never use colour'\n\"\ncomplete -c exa -l 'color-scale' \\\n -l 'colour-scale' -d \"Highlight levels of file sizes distinctly\"\ncomplete -c exa -l 'icons' -d \"Display icons\"\ncomplete -c exa -l 'no-icons' -d \"Don't display icons\"\n\n# Filtering and sorting options\ncomplete -c exa -l 'group-directories-first' -d \"Sort directories before other files\"\ncomplete -c exa -l 'git-ignore' -d \"Ignore files mentioned in '.gitignore'\"\ncomplete -c exa -s 'a' -l 'all' -d \"Show hidden and 'dot' files\"\ncomplete -c exa -s 'd' -l 'list-dirs' -d \"List directories like regular files\"\ncomplete -c exa -s 'L' -l 'level' -d \"Limit the depth of recursion\" -x -a \"1 2 3 4 5 6 7 8 9\"\ncomplete -c exa -s 'r' -l 'reverse' -d \"Reverse the sort order\"\ncomplete -c exa -s 's' -l 'sort' -d \"Which field to sort by\" -x -a \"\n accessed\\t'Sort by file accessed time'\n age\\t'Sort by file modified time (newest first)'\n changed\\t'Sort by changed time'\n created\\t'Sort by file modified time'\n date\\t'Sort by file modified time'\n ext\\t'Sort by file extension'\n Ext\\t'Sort by file extension (uppercase first)'\n extension\\t'Sort by file extension'\n Extension\\t'Sort by file extension (uppercase first)'\n filename\\t'Sort by filename'\n Filename\\t'Sort by filename (uppercase first)'\n inode\\t'Sort by file inode'\n modified\\t'Sort by file modified time'\n name\\t'Sort by filename'\n Name\\t'Sort by filename (uppercase first)'\n newest\\t'Sort by file modified time (newest first)'\n none\\t'Do not sort files at all'\n oldest\\t'Sort by file modified time'\n size\\t'Sort by file size'\n time\\t'Sort by file modified time'\n type\\t'Sort by file type'\n\"\n\ncomplete -c exa -s 'I' -l 'ignore-glob' -d \"Ignore files that match these glob patterns\" -r\ncomplete -c exa -s 'D' -l 'only-dirs' -d \"List only directories\"\n\n# Long view options\ncomplete -c exa -s 'b' -l 'binary' -d \"List file sizes with binary prefixes\"\ncomplete -c exa -s 'B' -l 'bytes' -d \"List file sizes in bytes, without any prefixes\"\ncomplete -c exa -s 'g' -l 'group' -d \"List each file's group\"\ncomplete -c exa -s 'h' -l 'header' -d \"Add a header row to each column\"\ncomplete -c exa -s 'H' -l 'links' -d \"List each file's number of hard links\"\ncomplete -c exa -s 'i' -l 'inode' -d \"List each file's inode number\"\ncomplete -c exa -s 'S' -l 'blocks' -d \"List each file's number of filesystem blocks\"\ncomplete -c exa -s 't' -l 'time' -d \"Which timestamp field to list\" -x -a \"\n modified\\t'Display modified time'\n changed\\t'Display changed time'\n accessed\\t'Display accessed time'\n created\\t'Display created time'\n\"\ncomplete -c exa -s 'm' -l 'modified' -d \"Use the modified timestamp field\"\ncomplete -c exa -s 'n' -l 'numeric' -d \"List numeric user and group IDs.\"\ncomplete -c exa -l 'changed' -d \"Use the changed timestamp field\"\ncomplete -c exa -s 'u' -l 'accessed' -d \"Use the accessed timestamp field\"\ncomplete -c exa -s 'U' -l 'created' -d \"Use the created timestamp field\"\ncomplete -c exa -l 'time-style' -d \"How to format timestamps\" -x -a \"\n default\\t'Use the default time style'\n iso\\t'Display brief ISO timestamps'\n long-iso\\t'Display longer ISO timestaps, up to the minute'\n full-iso\\t'Display full ISO timestamps, up to the nanosecond'\n\"\ncomplete -c exa -l 'no-permissions' -d \"Suppress the permissions field\"\ncomplete -c exa -l 'octal-permissions' -d \"List each file's permission in octal format\"\ncomplete -c exa -l 'no-filesize' -d \"Suppress the filesize field\"\ncomplete -c exa -l 'no-user' -d \"Suppress the user field\"\ncomplete -c exa -l 'no-time' -d \"Suppress the time field\"\n\n# Optional extras\ncomplete -c exa -l 'git' -d \"List each file's Git status, if tracked\"\ncomplete -c exa -s '@' -l 'extended' -d \"List each file's extended attributes and sizes\"\n" }, { "path": "completions/zsh/_exa", "content": "#compdef exa\n\n# Save this file as _exa in /usr/local/share/zsh/site-functions or in any\n# other folder in $fpath. E.g. save it in a folder called ~/.zfunc and add a\n# line containing `fpath=(~/.zfunc $fpath)` somewhere before `compinit` in your\n# ~/.zshrc.\n\n__exa() {\n # Give completions using the `_arguments` utility function with\n # `-s` for option stacking like `exa -ab` for `exa -a -b` and\n # `-S` for delimiting options with `--` like in `exa -- -a`.\n _arguments -s -S \\\n \"(- *)\"{-v,--version}\"[Show version of exa]\" \\\n \"(- *)\"{-'\\?',--help}\"[Show list of command-line options]\" \\\n {-1,--oneline}\"[Display one entry per line]\" \\\n {-l,--long}\"[Display extended file metadata as a table]\" \\\n {-G,--grid}\"[Display entries as a grid]\" \\\n {-x,--across}\"[Sort the grid across, rather than downwards]\" \\\n {-R,--recurse}\"[Recurse into directories]\" \\\n {-T,--tree}\"[Recurse into directories as a tree]\" \\\n {-F,--classify}\"[Display type indicator by file names]\" \\\n --colo{,u}r=\"[When to use terminal colours]:(when):(always auto never)\" \\\n --colo{,u}r-scale\"[Highlight levels of file sizes distinctly]\" \\\n --icons\"[Display icons]\" \\\n --no-icons\"[Hide icons]\" \\\n --group-directories-first\"[Sort directories before other files]\" \\\n --git-ignore\"[Ignore files mentioned in '.gitignore']\" \\\n {-a,--all}\"[Show hidden and 'dot' files]\" \\\n {-d,--list-dirs}\"[List directories like regular files]\" \\\n {-D,--only-dirs}\"[List only directories]\" \\\n {-L,--level}\"+[Limit the depth of recursion]\" \\\n {-r,--reverse}\"[Reverse the sort order]\" \\\n {-s,--sort}=\"[Which field to sort by]:(sort field):(accessed age changed created date extension Extension filename Filename inode modified oldest name Name newest none size time type)\" \\\n {-I,--ignore-glob}\"[Ignore files that match these glob patterns]\" \\\n {-b,--binary}\"[List file sizes with binary prefixes]\" \\\n {-B,--bytes}\"[List file sizes in bytes, without any prefixes]\" \\\n --changed\"[Use the changed timestamp field]\" \\\n {-g,--group}\"[List each file's group]\" \\\n {-h,--header}\"[Add a header row to each column]\" \\\n {-H,--links}\"[List each file's number of hard links]\" \\\n {-i,--inode}\"[List each file's inode number]\" \\\n {-m,--modified}\"[Use the modified timestamp field]\" \\\n {-n,--numeric}\"[List numeric user and group IDs.]\" \\\n {-S,--blocks}\"[List each file's number of filesystem blocks]\" \\\n {-t,--time}=\"[Which time field to show]:(time field):(accessed changed created modified)\" \\\n --time-style=\"[How to format timestamps]:(time style):(default iso long-iso full-iso)\" \\\n --no-permissions\"[Suppress the permissions field]\" \\\n --octal-permissions\"[List each file's permission in octal format]\" \\\n --no-filesize\"[Suppress the filesize field]\" \\\n --no-user\"[Suppress the user field]\" \\\n --no-time\"[Suppress the time field]\" \\\n {-u,--accessed}\"[Use the accessed timestamp field]\" \\\n {-U,--created}\"[Use the created timestamp field]\" \\\n --git\"[List each file's Git status, if tracked]\" \\\n {-@,--extended}\"[List each file's extended attributes and sizes]\" \\\n '*:filename:_files'\n}\n\n__exa\n" }, { "path": "devtools/README.md", "content": "## exa › development tools\n\nThese scripts deal with things like packaging release-worthy versions of exa.\n\nThey are **not general-purpose scripts** that you’re able to run from your main computer! They’re intended to be run from the Vagrant machine.\n" }, { "path": "devtools/dev-bash.sh", "content": "# This file gets executed when a user starts a `bash` shell, usually because\n# they’ve just started a new Vagrant session with `vagrant ssh`. It configures\n# some (but not all) of the commands that you can use.\n\n\n# Display the installed versions of tools.\n# help banner\nbash /vagrant/devtools/dev-versions.sh\n\n\n# Configure the Cool Prompt™ (not actually trademarked).\n# The Cool Prompt tells you whether you’re in debug or strict mode, whether\n# you have colours configured, and whether your last command failed.\nnonzero_return() { RETVAL=$?; [ \"$RETVAL\" -ne 0 ] && echo \"$RETVAL \"; }\ndebug_mode() { [ \"$EXA_DEBUG\" == \"trace\" ] && echo -n \"trace-\"; [ -n \"$EXA_DEBUG\" ] && echo \"debug \"; }\nstrict_mode() { [ -n \"$EXA_STRICT\" ] && echo \"strict \"; }\nlsc_mode() { [ -n \"$LS_COLORS\" ] && echo \"lsc \"; }\nexac_mode() { [ -n \"$EXA_COLORS\" ] && echo \"exac \"; }\nexport PS1=\"\\[\\e[1;36m\\]\\h \\[\\e[32m\\]\\w \\[\\e[31m\\]\\`nonzero_return\\`\\[\\e[35m\\]\\`debug_mode\\`\\[\\e[32m\\]\\`lsc_mode\\`\\[\\e[1;32m\\]\\`exac_mode\\`\\[\\e[33m\\]\\`strict_mode\\`\\[\\e[36m\\]\\\\$\\[\\e[0m\\] \"\n\n\n# The ‘debug’ function lets you switch debug mode on and off.\n# Turn it on if you need to see exa’s debugging logs.\ndebug() {\n case \"$1\" in\n \"\"|\"on\") export EXA_DEBUG=1 ;;\n \"off\") export EXA_DEBUG= ;;\n \"trace\") export EXA_DEBUG=trace ;;\n \"status\") [ -n \"$EXA_DEBUG\" ] && echo \"debug on\" || echo \"debug off\" ;;\n *) echo \"Usage: debug on|off|trace|status\"; return 1 ;;\n esac;\n}\n\n# The ‘strict’ function lets you switch strict mode on and off.\n# Turn it on if you’d like exa’s command-line arguments checked.\nstrict() {\n case \"$1\" in\n \"on\") export EXA_STRICT=1 ;;\n \"off\") export EXA_STRICT= ;;\n \"\") [ -n \"$EXA_STRICT\" ] && echo \"strict on\" || echo \"strict off\" ;;\n *) echo \"Usage: strict on|off\"; return 1 ;;\n esac;\n}\n\n# The ‘colors’ function sets or unsets the ‘LS_COLORS’ and ‘EXA_COLORS’\n# environment variables. There’s also a ‘hacker’ theme which turns everything\n# green, which is usually used for checking that all colour codes work, and\n# for looking cool while you phreak some mainframes or whatever.\ncolors() {\n case \"$1\" in\n \"ls\")\n export LS_COLORS=\"di=34:ln=35:so=32:pi=33:ex=31:bd=34;46:cd=34;43:su=30;41:sg=30;46:tw=30;42:ow=30;43\"\n export EXA_COLORS=\"\" ;;\n \"hacker\")\n export LS_COLORS=\"di=32:ex=32:fi=32:pi=32:so=32:bd=32:cd=32:ln=32:or=32:mi=32\"\n export EXA_COLORS=\"ur=32:uw=32:ux=32:ue=32:gr=32:gw=32:gx=32:tr=32:tw=32:tx=32:su=32:sf=32:xa=32:sn=32:sb=32:df=32:ds=32:uu=32:un=32:gu=32:gn=32:lc=32:lm=32:ga=32:gm=32:gd=32:gv=32:gt=32:xx=32:da=32:in=32:bl=32:hd=32:lp=32:cc=32:\" ;;\n \"off\")\n export LS_COLORS=\n export EXA_COLORS= ;;\n \"\")\n [ -n \"$LS_COLORS\" ] && echo \"LS_COLORS=$LS_COLORS\" || echo \"ls-colors off\"\n [ -n \"$EXA_COLORS\" ] && echo \"EXA_COLORS=$EXA_COLORS\" || echo \"exa-colors off\" ;;\n *) echo \"Usage: ls-colors ls|hacker|off\"; return 1 ;;\n esac;\n}\n" }, { "path": "devtools/dev-create-test-filesystem.sh", "content": "#!/bin/bash\n# This script creates a bunch of awkward test case files. It gets\n# automatically run as part of Vagrant provisioning.\ntrap 'exit' ERR\n\nif [[ ! -d \"/vagrant\" ]]; then\n echo \"This script should be run in the Vagrant environment\"\n exit 1\nfi\n\nsource \"/vagrant/devtools/dev-fixtures.sh\"\n\n\n# Delete old testcases if they exist already, then create a\n# directory to house new ones.\nif [[ -d \"$TEST_ROOT\" ]]; then\n echo -e \"\\033[1m[ 0/13]\\033[0m Deleting existing test cases directory\"\n sudo rm -rf \"$TEST_ROOT\"\nfi\n\nsudo mkdir \"$TEST_ROOT\"\nsudo chmod 777 \"$TEST_ROOT\"\nsudo mkdir \"$TEST_ROOT/empty\"\n\n\n# Awkward file size testcases.\n# This needs sudo to set the files’ users at the very end.\nmkdir \"$TEST_ROOT/files\"\necho -e \"\\033[1m[ 1/13]\\033[0m Creating file size testcases\"\nfor i in {1..13}; do\n fallocate -l \"$i\" \"$TEST_ROOT/files/$i\"_bytes\n fallocate -l \"$i\"KiB \"$TEST_ROOT/files/$i\"_KiB\n fallocate -l \"$i\"MiB \"$TEST_ROOT/files/$i\"_MiB\ndone\n\ntouch -t $FIXED_DATE \"$TEST_ROOT/files/\"*\ntouch -t $FIXED_DATE \"$TEST_ROOT/files/\"\nchmod 644 \"$TEST_ROOT/files/\"*\nsudo chown $FIXED_USER:$FIXED_USER \"$TEST_ROOT/files/\"*\n\n\n# File name extension testcases.\n# These aren’t tested in details view, but we set timestamps on them to\n# test that various sort options work.\nmkdir \"$TEST_ROOT/file-names-exts\"\necho -e \"\\033[1m[ 2/13]\\033[0m Creating file name extension testcases\"\n\ntouch \"$TEST_ROOT/file-names-exts/Makefile\"\n\ntouch \"$TEST_ROOT/file-names-exts/IMAGE.PNG\"\ntouch \"$TEST_ROOT/file-names-exts/image.svg\"\n\ntouch \"$TEST_ROOT/file-names-exts/VIDEO.AVI\"\ntouch \"$TEST_ROOT/file-names-exts/video.wmv\"\n\ntouch \"$TEST_ROOT/file-names-exts/music.mp3\"\ntouch \"$TEST_ROOT/file-names-exts/MUSIC.OGG\"\n\ntouch \"$TEST_ROOT/file-names-exts/lossless.flac\"\ntouch \"$TEST_ROOT/file-names-exts/lossless.wav\"\n\ntouch \"$TEST_ROOT/file-names-exts/crypto.asc\"\ntouch \"$TEST_ROOT/file-names-exts/crypto.signature\"\n\ntouch \"$TEST_ROOT/file-names-exts/document.pdf\"\ntouch \"$TEST_ROOT/file-names-exts/DOCUMENT.XLSX\"\n\ntouch \"$TEST_ROOT/file-names-exts/COMPRESSED.ZIP\"\ntouch \"$TEST_ROOT/file-names-exts/compressed.tar.gz\"\ntouch \"$TEST_ROOT/file-names-exts/compressed.tgz\"\ntouch \"$TEST_ROOT/file-names-exts/compressed.tar.xz\"\ntouch \"$TEST_ROOT/file-names-exts/compressed.txz\"\ntouch \"$TEST_ROOT/file-names-exts/compressed.deb\"\n\ntouch \"$TEST_ROOT/file-names-exts/backup~\"\ntouch \"$TEST_ROOT/file-names-exts/#SAVEFILE#\"\ntouch \"$TEST_ROOT/file-names-exts/file.tmp\"\n\ntouch \"$TEST_ROOT/file-names-exts/compiled.class\"\ntouch \"$TEST_ROOT/file-names-exts/compiled.o\"\ntouch \"$TEST_ROOT/file-names-exts/compiled.js\"\ntouch \"$TEST_ROOT/file-names-exts/compiled.coffee\"\n\n\n# File name testcases.\n# bash really doesn’t want you to create a file with escaped characters\n# in its name, so we have to resort to the echo builtin and touch!\nmkdir \"$TEST_ROOT/file-names\"\necho -e \"\\033[1m[ 3/13]\\033[0m Creating file names testcases\"\n\necho -ne \"$TEST_ROOT/file-names/ascii: hello\" | xargs -0 touch\necho -ne \"$TEST_ROOT/file-names/emoji: [🆒]\" | xargs -0 touch\necho -ne \"$TEST_ROOT/file-names/utf-8: pâté\" | xargs -0 touch\n\necho -ne \"$TEST_ROOT/file-names/bell: [\\a]\" | xargs -0 touch\necho -ne \"$TEST_ROOT/file-names/backspace: [\\b]\" | xargs -0 touch\necho -ne \"$TEST_ROOT/file-names/form-feed: [\\f]\" | xargs -0 touch\necho -ne \"$TEST_ROOT/file-names/new-line: [\\n]\" | xargs -0 touch\necho -ne \"$TEST_ROOT/file-names/return: [\\r]\" | xargs -0 touch\necho -ne \"$TEST_ROOT/file-names/tab: [\\t]\" | xargs -0 touch\necho -ne \"$TEST_ROOT/file-names/vertical-tab: [\\v]\" | xargs -0 touch\n\necho -ne \"$TEST_ROOT/file-names/escape: [\\033]\" | xargs -0 touch\necho -ne \"$TEST_ROOT/file-names/ansi: [\\033[34mblue\\033[0m]\" | xargs -0 touch\n\necho -ne \"$TEST_ROOT/file-names/invalid-utf8-1: [\\xFF]\" | xargs -0 touch\necho -ne \"$TEST_ROOT/file-names/invalid-utf8-2: [\\xc3\\x28]\" | xargs -0 touch\necho -ne \"$TEST_ROOT/file-names/invalid-utf8-3: [\\xe2\\x82\\x28]\" | xargs -0 touch\necho -ne \"$TEST_ROOT/file-names/invalid-utf8-4: [\\xf0\\x28\\x8c\\x28]\" | xargs -0 touch\n\necho -ne \"$TEST_ROOT/file-names/new-line-dir: [\\n]\" | xargs -0 mkdir\necho -ne \"$TEST_ROOT/file-names/new-line-dir: [\\n]/subfile\" | xargs -0 touch\necho -ne \"$TEST_ROOT/file-names/new-line-dir: [\\n]/another: [\\n]\" | xargs -0 touch\necho -ne \"$TEST_ROOT/file-names/new-line-dir: [\\n]/broken\" | xargs -0 touch\n\nmkdir \"$TEST_ROOT/file-names/links\"\nln -s \"$TEST_ROOT/file-names/new-line-dir\"*/* \"$TEST_ROOT/file-names/links\"\n\necho -ne \"$TEST_ROOT/file-names/new-line-dir: [\\n]/broken\" | xargs -0 rm\n\n\n# Special file testcases.\nmkdir \"$TEST_ROOT/specials\"\necho -e \"\\033[1m[ 4/13]\\033[0m Creating special file kind testcases\"\n\nsudo mknod \"$TEST_ROOT/specials/block-device\" b 3 60\nsudo mknod \"$TEST_ROOT/specials/char-device\" c 14 40\nsudo mknod \"$TEST_ROOT/specials/named-pipe\" p\n\nsudo touch -t $FIXED_DATE \"$TEST_ROOT/specials/\"*\n\n\n# Awkward symlink testcases.\nmkdir \"$TEST_ROOT/links\"\necho -e \"\\033[1m[ 5/13]\\033[0m Creating symlink testcases\"\n\nln -s / \"$TEST_ROOT/links/root\"\nln -s /usr \"$TEST_ROOT/links/usr\"\nln -s nowhere \"$TEST_ROOT/links/broken\"\nln -s /proc/1/root \"$TEST_ROOT/links/forbidden\"\n\ntouch \"$TEST_ROOT/links/some_file\"\nln -s \"$TEST_ROOT/links/some_file\" \"$TEST_ROOT/links/some_file_absolute\"\n(cd \"$TEST_ROOT/links\"; ln -s \"some_file\" \"some_file_relative\")\n(cd \"$TEST_ROOT/links\"; ln -s \".\" \"current_dir\")\n(cd \"$TEST_ROOT/links\"; ln -s \"..\" \"parent_dir\")\n(cd \"$TEST_ROOT/links\"; ln -s \"itself\" \"itself\")\n\n\n# Awkward passwd testcases.\n# sudo is needed for these because we technically aren’t a member\n# of the groups (because they don’t exist), and chown and chgrp\n# are smart enough to disallow it!\nmkdir \"$TEST_ROOT/passwd\"\necho -e \"\\033[1m[ 6/13]\\033[0m Creating user and group testcases\"\n\ntouch -t $FIXED_DATE \"$TEST_ROOT/passwd/unknown-uid\"\nchmod 644 \"$TEST_ROOT/passwd/unknown-uid\"\nsudo chown $FIXED_BAD_UID:$FIXED_USER \"$TEST_ROOT/passwd/unknown-uid\"\n\ntouch -t $FIXED_DATE \"$TEST_ROOT/passwd/unknown-gid\"\nchmod 644 \"$TEST_ROOT/passwd/unknown-gid\"\nsudo chown $FIXED_USER:$FIXED_BAD_GID \"$TEST_ROOT/passwd/unknown-gid\"\n\n\n# Awkward permission testcases.\n# Differences in the way ‘chmod’ handles setting ‘setuid’ and ‘setgid’\n# when you don’t already own the file mean that we need to use ‘sudo’\n# to change permissions to those.\nmkdir \"$TEST_ROOT/permissions\"\necho -e \"\\033[1m[ 7/13]\\033[0m Creating file permission testcases\"\n\nmkdir \"$TEST_ROOT/permissions/forbidden-directory\"\nchmod 000 \"$TEST_ROOT/permissions/forbidden-directory\"\ntouch -t $FIXED_DATE \"$TEST_ROOT/permissions/forbidden-directory\"\nsudo chown $FIXED_USER:$FIXED_USER \"$TEST_ROOT/permissions/forbidden-directory\"\n\nfor perms in 000 001 002 004 010 020 040 100 200 400 644 755 777 1000 1001 2000 2010 4000 4100 7666 7777; do\n touch \"$TEST_ROOT/permissions/$perms\"\n sudo chown $FIXED_USER:$FIXED_USER \"$TEST_ROOT/permissions/$perms\"\n sudo chmod $perms \"$TEST_ROOT/permissions/$perms\"\n sudo touch -t $FIXED_DATE \"$TEST_ROOT/permissions/$perms\"\ndone\n\n\n# Awkward date and time testcases.\nmkdir \"$TEST_ROOT/dates\"\necho -e \"\\033[1m[ 8/13]\\033[0m Creating date and time testcases\"\n\n# created dates\n# there’s no way to touch the created date of a file...\n# so we have to do this the old-fashioned way!\n# (and make sure these don't actually get listed)\ntouch -t $FIXED_OLD_DATE \"$TEST_ROOT/dates/peach\"; sleep 1\ntouch -t $FIXED_MED_DATE \"$TEST_ROOT/dates/plum\"; sleep 1\ntouch -t $FIXED_NEW_DATE \"$TEST_ROOT/dates/pear\"\n\n# modified dates\ntouch -t $FIXED_OLD_DATE -m \"$TEST_ROOT/dates/pear\"\ntouch -t $FIXED_MED_DATE -m \"$TEST_ROOT/dates/peach\"\ntouch -t $FIXED_NEW_DATE -m \"$TEST_ROOT/dates/plum\"\n\n# accessed dates\ntouch -t $FIXED_OLD_DATE -a \"$TEST_ROOT/dates/plum\"\ntouch -t $FIXED_MED_DATE -a \"$TEST_ROOT/dates/pear\"\ntouch -t $FIXED_NEW_DATE -a \"$TEST_ROOT/dates/peach\"\n\nsudo chown $FIXED_USER:$FIXED_USER -R \"$TEST_ROOT/dates\"\n\nmkdir \"$TEST_ROOT/far-dates\"\ntouch -t $FIXED_PAST_DATE \"$TEST_ROOT/far-dates/the-distant-past\"\ntouch -t $FIXED_FUTURE_DATE \"$TEST_ROOT/far-dates/beyond-the-future\"\n\n\n# Awkward extended attribute testcases.\n# We need to test combinations of various numbers of files *and*\n# extended attributes in directories. Turns out, the easiest way to\n# do this is to generate all combinations of files with “one-xattr”\n# or “two-xattrs” in their name and directories with “empty” or\n# “one-file” in their name, then just give the right number of\n# xattrs and children to those.\nmkdir \"$TEST_ROOT/attributes\"\necho -e \"\\033[1m[ 9/13]\\033[0m Creating extended attribute testcases\"\n\nmkdir \"$TEST_ROOT/attributes/files\"\ntouch \"$TEST_ROOT/attributes/files/\"{no-xattrs,one-xattr,two-xattrs}{,_forbidden}\n\nmkdir \"$TEST_ROOT/attributes/dirs\"\nmkdir \"$TEST_ROOT/attributes/dirs/\"{no-xattrs,one-xattr,two-xattrs}_{empty,one-file,two-files}{,_forbidden}\n\nsetfattr -n user.greeting -v hello \"$TEST_ROOT/attributes\"/**/*{one-xattr,two-xattrs}*\nsetfattr -n user.another_greeting -v hi \"$TEST_ROOT/attributes\"/**/*two-xattrs*\n\nfor dir in \"$TEST_ROOT/attributes/dirs/\"*one-file*; do\n touch $dir/file-in-question\ndone\n\nfor dir in \"$TEST_ROOT/attributes/dirs/\"*two-files*; do\n touch $dir/this-file\n touch $dir/that-file\ndone\n\nfind \"$TEST_ROOT/attributes\" -exec touch {} -t $FIXED_DATE \\;\n\n# I want to use the following to test,\n# but it only works on macos:\n#chmod +a \"$FIXED_USER deny readextattr\" \"$TEST_ROOT/attributes\"/**/*_forbidden\n\nsudo chmod 000 \"$TEST_ROOT/attributes\"/**/*_forbidden\nsudo chown $FIXED_USER:$FIXED_USER -R \"$TEST_ROOT/attributes\"\n\n\n# A sample Git repository\n# This uses cd because it's easier than telling Git where to go each time\necho -e \"\\033[1m[10/13]\\033[0m Creating Git testcases (1/4)\"\nmkdir \"$TEST_ROOT/git\"\ncd \"$TEST_ROOT/git\"\ngit init >/dev/null\n\nmkdir edits additions moves\n\necho \"original content\" | tee edits/{staged,unstaged,both} >/dev/null\necho \"this file gets moved\" > moves/hither\n\ngit add edits moves\ngit config --global user.email \"exa@exa.exa\"\ngit config --global user.name \"Exa Exa\"\ngit commit -m \"Automated test commit\" >/dev/null\n\necho \"modifications!\" | tee edits/{staged,both} >/dev/null\ntouch additions/{staged,edited}\nmv moves/{hither,thither}\n\ngit add edits moves additions\necho \"more modifications!\" | tee edits/unstaged edits/both additions/edited >/dev/null\ntouch additions/unstaged\n\nfind \"$TEST_ROOT/git\" -exec touch {} -t $FIXED_DATE \\;\nsudo chown $FIXED_USER:$FIXED_USER -R \"$TEST_ROOT/git\"\n\n\n# A second Git repository\n# for testing two at once\necho -e \"\\033[1m[11/13]\\033[0m Creating Git testcases (2/4)\"\nmkdir -p \"$TEST_ROOT/git2/deeply/nested/directory\"\ncd \"$TEST_ROOT/git2\"\ngit init >/dev/null\n\ntouch \"deeply/nested/directory/upd8d\"\ngit add \"deeply/nested/directory/upd8d\"\ngit commit -m \"Automated test commit\" >/dev/null\n\necho \"Now with contents\" > \"deeply/nested/directory/upd8d\"\ntouch \"deeply/nested/directory/l8st\"\n\necho -e \"target\\n*.mp3\" > \".gitignore\"\nmkdir \"ignoreds\"\ntouch \"ignoreds/music.mp3\"\ntouch \"ignoreds/music.m4a\"\nmkdir \"ignoreds/nested\"\ntouch \"ignoreds/nested/70s grove.mp3\"\ntouch \"ignoreds/nested/funky chicken.m4a\"\nmkdir \"ignoreds/nested2\"\ntouch \"ignoreds/nested2/ievan polkka.mp3\"\n\nmkdir \"target\"\ntouch \"target/another ignored file\"\n\nmkdir \"deeply/nested/repository\"\ncd \"deeply/nested/repository\"\ngit init >/dev/null\ntouch subfile\n# This file, ‘subfile’, should _not_ be marked as a new file by exa, because\n# it’s in the sub-repository but hasn’t been added to it. Were the sub-repo not\n# present, it would be marked as a new file, as the top-level repo knows about\n# the ‘deeply’ directory.\n\nfind \"$TEST_ROOT/git2\" -exec touch {} -t $FIXED_DATE \\;\nsudo chown $FIXED_USER:$FIXED_USER -R \"$TEST_ROOT/git2\"\n\n\n# A third Git repository\n# Regression test for https://github.com/ogham/exa/issues/526\necho -e \"\\033[1m[12/13]\\033[0m Creating Git testcases (3/4)\"\nmkdir -p \"$TEST_ROOT/git3\"\ncd \"$TEST_ROOT/git3\"\ngit init >/dev/null\n\n# Create a symbolic link pointing to a non-existing file\nln -s aaa/aaa/a b\n\n# This normally fails with:\nfind \"$TEST_ROOT/git3\" -exec touch {} -h -t $FIXED_DATE \\;\nsudo chown $FIXED_USER:$FIXED_USER -R \"$TEST_ROOT/git3\"\n\n\n# A fourth Git repository\n# Regression test for https://github.com/ogham/exa/issues/698\necho -e \"\\033[1m[12/13]\\033[0m Creating Git testcases (4/4)\"\nmkdir -p \"$TEST_ROOT/git4\"\ncd \"$TEST_ROOT/git4\"\ngit init >/dev/null\n\n# Create a non UTF-8 file\ntouch 'P'$'\\b\\211''UUU'\n\nfind \"$TEST_ROOT/git4\" -exec touch {} -h -t $FIXED_DATE \\;\nsudo chown $FIXED_USER:$FIXED_USER -R \"$TEST_ROOT/git4\"\n\n\n# Hidden and dot file testcases.\n# We need to set the permissions of `.` and `..` because they actually\n# get displayed in the output here, so this has to come last.\necho -e \"\\033[1m[13/13]\\033[0m Creating hidden and dot file testcases\"\nshopt -u dotglob\nGLOBIGNORE=\".:..\"\n\nmkdir \"$TEST_ROOT/hiddens\"\ncd \"$TEST_ROOT/hiddens\"\ntouch \"$TEST_ROOT/hiddens/visible\"\ntouch \"$TEST_ROOT/hiddens/.hidden\"\ntouch \"$TEST_ROOT/hiddens/..extra-hidden\"\n\n# ./hiddens/\ntouch -t $FIXED_DATE \"$TEST_ROOT/hiddens/\"*\nchmod 644 \"$TEST_ROOT/hiddens/\"*\nsudo chown $FIXED_USER:$FIXED_USER \"$TEST_ROOT/hiddens/\"*\n\n# .\ntouch -t $FIXED_DATE \"$TEST_ROOT/hiddens\"\nchmod 755 \"$TEST_ROOT/hiddens\"\nsudo chown $FIXED_USER:$FIXED_USER \"$TEST_ROOT/hiddens\"\n\n# ..\nsudo touch -t $FIXED_DATE \"$TEST_ROOT\"\nsudo chmod 755 \"$TEST_ROOT\"\nsudo chown $FIXED_USER:$FIXED_USER \"$TEST_ROOT\"\n" }, { "path": "devtools/dev-fixtures.sh", "content": "#!/bin/bash\n# This file contains the text fixtures — the known, constant data — that are\n# used when setting up the environment that exa’s tests get run in.\n\n\n# The directory that all the test files are created under.\nexport TEST_ROOT=/testcases\n\n\n# Because the timestamps are formatted differently depending on whether\n# they’re in the current year or not (see `details.rs`), we have to make\n# sure that the files are created in the current year, so they get shown\n# in the format we expect.\nexport CURRENT_YEAR=$(date \"+%Y\")\nexport FIXED_DATE=\"${CURRENT_YEAR}01011234.56\" # 1st January, 12:34:56\n\n\n# We also need an UID and a GID that are guaranteed to not exist, to\n# test what happen when they don’t.\nexport FIXED_BAD_UID=666\nexport FIXED_BAD_GID=616\n\n\n# We create two users that own the test files.\n#\n# The first one just owns the ordinary ones, because we don’t want the\n# test outputs to depend on “vagrant” or “ubuntu” existing.\n#\n# The second one has a long name, to test that the file owner column\n# widens correctly. The benefit of Vagrant is that we don’t need to\n# set this up on the *actual* system!\nexport FIXED_USER=\"cassowary\"\nexport FIXED_LONG_USER=\"antidisestablishmentarienism\"\n\n\n# A couple of dates, for date-time testing.\nexport FIXED_OLD_DATE='200303030000.00'\nexport FIXED_MED_DATE='200606152314.29' # the june gets used for fr_FR locale tests\nexport FIXED_NEW_DATE='200912221038.53' # and the december for ja_JP local tests\n\n# Dates that extend beyond 32-bit timespace.\nexport FIXED_PAST_DATE='170001010000.00'\nexport FIXED_FUTURE_DATE='230001010000.00'\n" }, { "path": "devtools/dev-help.sh", "content": "# This file prints out some help text that says which commands are available\n# in the VM. It gets executed during Vagrant provisioning and its output gets\n# dumped into /etc/motd, to print it when a user starts a new Vagrant session.\n\n\necho -e \"\n\\033[1;33mThe exa development environment!\\033[0m\nexa's source is available at \\033[33m/vagrant\\033[0m.\nBinaries get built into \\033[33m/home/vagrant/target\\033[0m.\n\n\\033[4mCommands\\033[0m\n\\033[32;1mexa\\033[0m to run the built version of exa\n\\033[32;1mbuild-exa\\033[0m (or \\033[32;1mb\\033[0m) to run \\033[1mcargo build\\033[0m\n\\033[32;1mtest-exa\\033[0m (or \\033[32;1mt\\033[0m) to run \\033[1mcargo test\\033[0m\n\\033[32;1mrun-xtests\\033[0m (or \\033[32;1mx\\033[0m) to run the extended tests\n\\033[32;1mcompile-exa\\033[0m (or \\033[32;1mc\\033[0m) to run the above three\n\\033[32;1mdebug\\033[0m to toggle printing logs\n\\033[32;1mstrict\\033[0m to toggle strict mode\n\\033[32;1mcolors\\033[0m to toggle custom colours\n\\033[32;1mhalp\\033[0m to show all this again\n\"\n" }, { "path": "devtools/dev-package-for-linux.sh", "content": "set -e\n\n# This script builds a publishable release-worthy version of exa.\n# It gets the version number, builds exa using cargo, tests it, strips the\n# binary, compresses it into a zip, then puts it in /vagrant so it’s\n# accessible from the host machine.\n#\n# If you’re in the VM, you can run it using the ‘package-exa’ command.\n\n\n# Linux check!\nuname=$(uname -s)\nif [[ \"$uname\" != \"Linux\" ]]; then\n echo \"Gotta be on Linux to run this (detected '$uname')!\"\n exit 1\nfi\n\n# First, we need to get the version number to figure out what to call the zip.\n# We do this by getting the first line from the Cargo.toml that matches\n# /version/, removing its whitespace, and building a command out of it, so the\n# shell executes something like `exa_version=\"0.8.0\"`, which it understands as\n# a variable definition. Hey, it’s not a hack if it works.\ntoml_file=\"/vagrant/Cargo.toml\"\neval exa_$(grep version $toml_file | head -n 1 | sed \"s/ //g\")\nif [ -z \"$exa_version\" ]; then\n echo \"Failed to parse version number! Can't build exa!\"\n exit 1\nfi\n\n# Weekly builds have a bit more information in their version number (see build.rs).\nif [[ \"$1\" == \"--weekly\" ]]; then\n git_hash=$(GIT_DIR=/vagrant/.git git rev-parse --short --verify HEAD)\n date=$(date +\"%Y-%m-%d\")\n echo \"Building exa weekly v$exa_version, date $date, Git hash $git_hash\"\nelse\n echo \"Building exa v$exa_version\"\nfi\n\n# Compilation is done in --release mode, which takes longer but produces a\n# faster binary. This binary gets built to a different place, so the extended\n# tests script needs to be told which one to use.\necho -e \"\\n\\033[4mCompiling release version of exa...\\033[0m\"\nexa_linux_binary=\"/vagrant/exa-linux-x86_64\"\nrm -vf \"$exa_linux_binary\"\ncargo build --release --manifest-path \"$toml_file\"\ncargo test --release --manifest-path \"$toml_file\" --lib -- --quiet\n/vagrant/xtests/run.sh --release\ncp /home/vagrant/target/release/exa \"$exa_linux_binary\"\n\n# Stripping the binary before distributing it removes a bunch of debugging\n# symbols, saving some space.\necho -e \"\\n\\033[4mStripping binary...\\033[0m\"\nstrip -v \"$exa_linux_binary\"\n\n# Compress the binary for upload. The ‘-j’ flag is necessary to avoid the\n# /vagrant path being in the zip too. Only the zip gets the version number, so\n# the binaries can have consistent names, and it’s still possible to tell\n# different *downloads* apart.\necho -e \"\\n\\033[4mZipping binary...\\033[0m\"\nif [[ \"$1\" == \"--weekly\" ]]; then\n exa_linux_zip=\"/vagrant/exa-linux-x86_64-${exa_version}-${date}-${git_hash}.zip\"\nelse\n exa_linux_zip=\"/vagrant/exa-linux-x86_64.zip\"\nfi\nrm -vf \"$exa_linux_zip\"\nzip -j \"$exa_linux_zip\" \"$exa_linux_binary\"\n\n# There was a problem a while back where a library was getting unknowingly\n# *dynamically* linked, which broke the whole ‘self-contained binary’ concept.\n# So dump the linker table, in case anything unscrupulous shows up.\necho -e \"\\n\\033[4mLibraries linked:\\033[0m\"\nldd \"$exa_linux_binary\" | sed \"s/\\t//\"\n\n# Might as well use it to test itself, right?\necho -e \"\\n\\033[4mAll done! Files produced:\\033[0m\"\n\"$exa_linux_binary\" \"$exa_linux_binary\" \"$exa_linux_zip\" -lB\n" }, { "path": "devtools/dev-run-debug.sh", "content": "#!/bin/bash\nif [[ -f ~/target/debug/exa ]]; then\n ~/target/debug/exa \"$@\"\nelse\n echo -e \"Debug exa binary does not exist!\"\n echo -e \"Run \\033[32;1mb\\033[0m or \\033[32;1mbuild-exa\\033[0m to create it\"\nfi\n" }, { "path": "devtools/dev-run-release.sh", "content": "#!/bin/bash\nif [[ -f ~/target/release/exa ]]; then\n ~/target/release/exa \"$@\"\nelse\n echo -e \"Release exa binary does not exist!\"\n echo -e \"Run \\033[32;1mb --release\\033[0m or \\033[32;1mbuild-exa --release\\033[0m to create it\"\nfi\n" }, { "path": "devtools/dev-set-up-environment.sh", "content": "#!/bin/bash\n\nif [[ ! -d \"/vagrant\" ]]; then\n echo \"This script should be run in the Vagrant environment\"\n exit 1\nfi\n\nif [[ $EUID -ne 0 ]]; then\n echo \"This script should be run as root\"\n exit 1\nfi\n\nsource \"/vagrant/devtools/dev-fixtures.sh\"\n\n\n# create our test users\n\nif id -u $FIXED_USER &>/dev/null; then\n echo \"Normal user already exists\"\nelse\n echo \"Creating normal user\"\n useradd $FIXED_USER\nfi\n\nif id -u $FIXED_LONG_USER &>/dev/null; then\n echo \"Long user already exists\"\nelse\n echo \"Creating long user\"\n useradd $FIXED_LONG_USER\nfi\n\n\n# locale generation\n\n# remove most of this file, it slows down locale-gen\nif grep -F -q \"en_GB.UTF-8 UTF-8\" /var/lib/locales/supported.d/en; then\n echo \"Removing existing locales\"\n echo \"en_US.UTF-8 UTF-8\" > /var/lib/locales/supported.d/en\nfi\n\n# uncomment these from the config file\nif grep -F -q \"# fr_FR.UTF-8\" /etc/locale.gen; then\n sed -i '/fr_FR.UTF-8/s/^# //g' /etc/locale.gen\nfi\nif grep -F -q \"# ja_JP.UTF-8\" /etc/locale.gen; then\n sed -i '/ja_JP.UTF-8/s/^# //g' /etc/locale.gen\nfi\n\n# only regenerate locales if the config files are newer than the locale archive\nif [[ ( /var/lib/locales/supported.d/en -nt /usr/lib/locale/locale-archive ) || \\\n ( /etc/locale_gen -nt /usr/lib/locale/locale-archive ) ]]; then\n locale-gen\nelse\n echo \"Locales already generated\"\nfi\n" }, { "path": "devtools/dev-versions.sh", "content": "# Displays the installed versions of Rust and Cargo.\n# This gets run from ‘dev-bash.sh’, which gets run from ‘~/.bash_profile’, so\n# the versions gets displayed after the help text for a new Vagrant session.\n\necho -e \"\\\\033[4mVersions\\\\033[0m\"\nrustc --version\ncargo --version\necho\n" }, { "path": "devtools/local-package-for-macos.sh", "content": "set -e\n\n# This script builds a publishable release-worthy version of exa.\n# It gets the version number, builds exa using cargo, tests it, strips the\n# binary, and compresses it into a zip.\n#\n# It’s *mostly* the same as dev-package-for-linux.sh, except with some\n# Mach-specific things (otool instead of ldd), BSD-coreutils-specific things,\n# and it doesn’t run the xtests.\n\n\n# Virtualising macOS is a legal minefield, so this script is ‘local’ instead\n# of ‘dev’: I run it from my actual machine, rather than from a VM.\nuname=$(uname -s)\nif [[ \"$uname\" != \"Darwin\" ]]; then\n echo \"Gotta be on Darwin to run this (detected '$uname')!\"\n exit 1\nfi\n\n# First, we need to get the version number to figure out what to call the zip.\n# We do this by getting the first line from the Cargo.toml that matches\n# /version/, removing its whitespace, and building a command out of it, so the\n# shell executes something like `exa_version=\"0.8.0\"`, which it understands as\n# a variable definition. Hey, it’s not a hack if it works.\n#\n# Because this can’t use the absolute /vagrant path, this has to use what this\n# SO answer calls a “quoting disaster”: https://stackoverflow.com/a/20196098/3484614\n# You will also need GNU coreutils: https://stackoverflow.com/a/4031502/3484614\nexa_root=\"$(dirname \"$(dirname \"$(greadlink -fm \"$0\")\")\")\"\ntoml_file=\"$exa_root\"/Cargo.toml\neval exa_$(grep version $toml_file | head -n 1 | sed \"s/ //g\")\nif [ -z \"$exa_version\" ]; then\n echo \"Failed to parse version number! Can't build exa!\"\n exit 1\nfi\n\n# Weekly builds have a bit more information in their version number (see build.rs).\nif [[ \"$1\" == \"--weekly\" ]]; then\n git_hash=$(GIT_DIR=$exa_root/.git git rev-parse --short --verify HEAD)\n date=$(date +\"%Y-%m-%d\")\n echo \"Building exa weekly v$exa_version, date $date, Git hash $git_hash\"\nelse\n echo \"Building exa v$exa_version\"\nfi\n\n# Compilation is done in --release mode, which takes longer but produces a\n# faster binary.\necho -e \"\\n\\033[4mCompiling release version of exa...\\033[0m\"\nexa_macos_binary=\"$exa_root/exa-macos-x86_64\"\nrm -vf \"$exa_macos_binary\" | sed 's/^/removing /'\ncargo build --release --manifest-path \"$toml_file\"\ncargo test --release --manifest-path \"$toml_file\" --lib -- --quiet\n# we can’t run the xtests outside the VM!\n#/vagrant/xtests/run.sh --release\ncp \"$exa_root\"/target/release/exa \"$exa_macos_binary\"\n\n# Stripping the binary before distributing it removes a bunch of debugging\n# symbols, saving some space.\necho -e \"\\n\\033[4mStripping binary...\\033[0m\"\nstrip \"$exa_macos_binary\"\necho \"strip $exa_macos_binary\"\n\n# Compress the binary for upload. The ‘-j’ flag is necessary to avoid the\n# current path being in the zip too. Only the zip gets the version number, so\n# the binaries can have consistent names, and it’s still possible to tell\n# different *downloads* apart.\necho -e \"\\n\\033[4mZipping binary...\\033[0m\"\nif [[ \"$1\" == \"--weekly\" ]]; then\n exa_macos_zip=\"$exa_root/exa-macos-x86_64-${exa_version}-${date}-${git_hash}.zip\"\nelse\n exa_macos_zip=\"$exa_root/exa-macos-x86_64-${exa_version}.zip\"\nfi\nrm -vf \"$exa_macos_zip\" | sed 's/^/removing /'\nzip -j \"$exa_macos_zip\" \"$exa_macos_binary\"\n\n# There was a problem a while back where a library was getting unknowingly\n# *dynamically* linked, which broke the whole ‘self-contained binary’ concept.\n# So dump the linker table, in case anything unscrupulous shows up.\necho -e \"\\n\\033[4mLibraries linked:\\033[0m\"\notool -L \"$exa_macos_binary\" | sed 's/^[[:space:]]*//'\n\n# Might as well use it to test itself, right?\necho -e \"\\n\\033[4mAll done! Files produced:\\033[0m\"\n\"$exa_macos_binary\" \"$exa_macos_binary\" \"$exa_macos_zip\" -lB\n" }, { "path": "man/exa.1.md", "content": "% exa(1) v0.9.0\n\n\n\n\n\n\nNAME\n====\n\nexa — a modern replacement for ls\n\n\nSYNOPSIS\n========\n\n`exa [options] [files...]`\n\n**exa** is a modern replacement for `ls`.\nIt uses colours for information by default, helping you distinguish between many types of files, such as whether you are the owner, or in the owning group.\n\nIt also has extra features not present in the original `ls`, such as viewing the Git status for a directory, or recursing into directories with a tree view.\n\n\nEXAMPLES\n========\n\n`exa`\n: Lists the contents of the current directory in a grid.\n\n`exa --oneline --reverse --sort=size`\n: Displays a list of files with the largest at the top.\n\n`exa --long --header --inode --git`\n: Displays a table of files with a header, showing each file’s metadata, inode, and Git status.\n\n`exa --long --tree --level=3`\n: Displays a tree of files, three levels deep, as well as each file’s metadata.\n\n\nDISPLAY OPTIONS\n===============\n\n`-1`, `--oneline`\n: Display one entry per line.\n\n`-F`, `--classify`\n: Display file kind indicators next to file names.\n\n`-G`, `--grid`\n: Display entries as a grid (default).\n\n`-l`, `--long`\n: Display extended file metadata as a table.\n\n`-R`, `--recurse`\n: Recurse into directories.\n\n`-T`, `--tree`\n: Recurse into directories as a tree.\n\n`-x`, `--across`\n: Sort the grid across, rather than downwards.\n\n`--color`, `--colour=WHEN`\n: When to use terminal colours.\nValid settings are ‘`always`’, ‘`automatic`’, and ‘`never`’.\n\n`--color-scale`, `--colour-scale`\n: Colour file sizes on a scale.\n\n`--icons`\n: Display icons next to file names.\n\n`--no-icons`\n: Don't display icons. (Always overrides --icons)\n\n\nFILTERING AND SORTING OPTIONS\n=============================\n\n`-a`, `--all`\n: Show hidden and “dot” files.\nUse this twice to also show the ‘`.`’ and ‘`..`’ directories.\n\n`-d`, `--list-dirs`\n: List directories as regular files, rather than recursing and listing their contents.\n\n`-L`, `--level=DEPTH`\n: Limit the depth of recursion.\n\n`-r`, `--reverse`\n: Reverse the sort order.\n\n`-s`, `--sort=SORT_FIELD`\n: Which field to sort by.\n\nValid sort fields are ‘`name`’, ‘`Name`’, ‘`extension`’, ‘`Extension`’, ‘`size`’, ‘`modified`’, ‘`changed`’, ‘`accessed`’, ‘`created`’, ‘`inode`’, ‘`type`’, and ‘`none`’.\n\nThe `modified` sort field has the aliases ‘`date`’, ‘`time`’, and ‘`newest`’, and its reverse order has the aliases ‘`age`’ and ‘`oldest`’.\n\nSort fields starting with a capital letter will sort uppercase before lowercase: ‘A’ then ‘B’ then ‘a’ then ‘b’. Fields starting with a lowercase letter will mix them: ‘A’ then ‘a’ then ‘B’ then ‘b’.\n\n`-I`, `--ignore-glob=GLOBS`\n: Glob patterns, pipe-separated, of files to ignore.\n\n`--git-ignore` [if exa was built with git support]\n: Do not list files that are ignored by Git.\n\n`--group-directories-first`\n: List directories before other files.\n\n`-D`, `--only-dirs`\n: List only directories, not files.\n\n\nLONG VIEW OPTIONS\n=================\n\nThese options are available when running with `--long` (`-l`):\n\n`-b`, `--binary`\n: List file sizes with binary prefixes.\n\n`-B`, `--bytes`\n: List file sizes in bytes, without any prefixes.\n\n`--changed`\n: Use the changed timestamp field.\n\n`-g`, `--group`\n: List each file’s group.\n\n`-h`, `--header`\n: Add a header row to each column.\n\n`-H`, `--links`\n: List each file’s number of hard links.\n\n`-i`, `--inode`\n: List each file’s inode number.\n\n`-m`, `--modified`\n: Use the modified timestamp field.\n\n`-n`, `--numeric`\n: List numeric user and group IDs.\n\n`-S`, `--blocks`\n: List each file’s number of file system blocks.\n\n`-t`, `--time=WORD`\n: Which timestamp field to list.\n\n: Valid timestamp fields are ‘`modified`’, ‘`changed`’, ‘`accessed`’, and ‘`created`’.\n\n`--time-style=STYLE`\n: How to format timestamps.\n\n: Valid timestamp styles are ‘`default`’, ‘`iso`’, ‘`long-iso`’, and ‘`full-iso`’.\n\n`-u`, `--accessed`\n: Use the accessed timestamp field.\n\n`-U`, `--created`\n: Use the created timestamp field.\n\n`--no-permissions`\n: Suppress the permissions field.\n\n`--no-filesize`\n: Suppress the file size field.\n\n`--no-user`\n: Suppress the user field.\n\n`--no-time`\n: Suppress the time field.\n\n`-@`, `--extended`\n: List each file’s extended attributes and sizes.\n\n`--git` [if exa was built with git support]\n: List each file’s Git status, if tracked.\n\nThis adds a two-character column indicating the staged and unstaged statuses respectively. The status character can be ‘`-`’ for not modified, ‘`M`’ for a modified file, ‘`N`’ for a new file, ‘`D`’ for deleted, ‘`R`’ for renamed, ‘`T`’ for type-change, ‘`I`’ for ignored, and ‘`U`’ for conflicted.\n\nDirectories will be shown to have the status of their contents, which is how ‘deleted’ is possible: if a directory contains a file that has a certain status, it will be shown to have that status.\n\n\nENVIRONMENT VARIABLES\n=====================\n\nexa responds to the following environment variables:\n\n## `COLUMNS`\n\nOverrides the width of the terminal, in characters.\n\nFor example, ‘`COLUMNS=80 exa`’ will show a grid view with a maximum width of 80 characters.\n\nThis option won’t do anything when exa’s output doesn’t wrap, such as when using the `--long` view.\n\n## `EXA_STRICT`\n\nEnables _strict mode_, which will make exa error when two command-line options are incompatible.\n\nUsually, options can override each other going right-to-left on the command line, so that exa can be given aliases: creating an alias ‘`exa=exa --sort=ext`’ then running ‘`exa --sort=size`’ with that alias will run ‘`exa --sort=ext --sort=size`’, and the sorting specified by the user will override the sorting specified by the alias.\n\nIn strict mode, the two options will not co-operate, and exa will error.\n\nThis option is intended for use with automated scripts and other situations where you want to be certain you’re typing in the right command.\n\n## `EXA_GRID_ROWS`\n\nLimits the grid-details view (‘`exa --grid --long`’) so it’s only activated when at least the given number of rows of output would be generated.\n\nWith widescreen displays, it’s possible for the grid to look very wide and sparse, on just one or two lines with none of the columns lining up.\nBy specifying a minimum number of rows, you can only use the view if it’s going to be worth using.\n\n## `EXA_ICON_SPACING`\n\nSpecifies the number of spaces to print between an icon (see the ‘`--icons`’ option) and its file name.\n\nDifferent terminals display icons differently, as they usually take up more than one character width on screen, so there’s no “standard” number of spaces that exa can use to separate an icon from text. One space may place the icon too close to the text, and two spaces may place it too far away. So the choice is left up to the user to configure depending on their terminal emulator.\n\n## `NO_COLOR`\n\nDisables colours in the output (regardless of its value). Can be overridden by `--color` option.\n\nSee `https://no-color.org/` for details.\n\n## `LS_COLORS`, `EXA_COLORS`\n\nSpecifies the colour scheme used to highlight files based on their name and kind, as well as highlighting metadata and parts of the UI.\n\nFor more information on the format of these environment variables, see the `exa_colors(5)` manual page.\n\n\nEXIT STATUSES\n=============\n\n0\n: If everything goes OK.\n\n1\n: If there was an I/O error during operation.\n\n3\n: If there was a problem with the command-line arguments.\n\n\nAUTHOR\n======\n\nexa is maintained by Benjamin ‘ogham’ Sago and many other contributors.\n\n**Website:** `https://the.exa.website/` \\\n**Source code:** `https://github.com/ogham/exa` \\\n**Contributors:** `https://github.com/ogham/exa/graphs/contributors`\n\n\nSEE ALSO\n========\n\n- `exa_colors(5)`\n" }, { "path": "man/exa_colors.5.md", "content": "% exa_colors(5) v0.9.0\n\n\n\n\n\n\nNAME\n====\n\nexa_colors — customising the file and UI colours of exa\n\n\nSYNOPSIS\n========\n\nThe `EXA_COLORS` environment variable can be used to customise the colours that `exa` uses to highlight file names, file metadata, and parts of the UI.\n\nYou can use the `dircolors` program to generate a script that sets the variable from an input file, or if you don’t mind editing long strings of text, you can just type it out directly. These variables have the following structure:\n\n- A list of key-value pairs separated by ‘`=`’, such as ‘`*.txt=32`’.\n- Multiple ANSI formatting codes are separated by ‘`;`’, such as ‘`*.txt=32;1;4`’.\n- Finally, multiple pairs are separated by ‘`:`’, such as ‘`*.txt=32:*.mp3=1;35`’.\n\nThe key half of the pair can either be a two-letter code or a file glob, and anything that’s not a valid code will be treated as a glob, including keys that happen to be two letters long.\n\n\nEXAMPLES\n========\n\n`EXA_COLORS=\"uu=0:gu=0\"`\n: Disable the “current user” highlighting\n\n`EXA_COLORS=\"da=32\"`\n: Turn the date column green\n\n`EXA_COLORS=\"Vagrantfile=1;4;33\"`\n: Highlight Vagrantfiles\n\n`EXA_COLORS=\"*.zip=38;5;125\"`\n: Override the existing zip colour\n\n`EXA_COLORS=\"*.md=38;5;121:*.log=38;5;248\"`\n: Markdown files a shade of green, log files a shade of grey\n\n\nLIST OF CODES\n=============\n\n`LS_COLORS` can use these ten codes:\n\n`di`\n: directories\n\n`ex`\n: executable files\n\n`fi`\n: regular files\n\n`pi`\n: named pipes\n\n`so`\n: sockets\n\n`bd`\n: block devices\n\n`cd`\n: character devices\n\n`ln`\n: symlinks\n\n`or`\n: symlinks with no target\n\n\n`EXA_COLORS` can use many more:\n\n`ur`\n: the user-read permission bit\n\n`uw`\n: the user-write permission bit\n\n`ux`\n: the user-execute permission bit for regular files\n\n`ue`\n: the user-execute for other file kinds\n\n`gr`\n: the group-read permission bit\n\n`gw`\n: the group-write permission bit\n\n`gx`\n: the group-execute permission bit\n\n`tr`\n: the others-read permission bit\n\n`tw`\n: the others-write permission bit\n\n`tx`\n: the others-execute permission bit\n\n`su`\n: setuid, setgid, and sticky permission bits for files\n\n`sf`\n: setuid, setgid, and sticky for other file kinds\n\n`xa`\n: the extended attribute indicator\n\n`sn`\n: the numbers of a file’s size (sets `nb`, `nk`, `nm`, `ng` and `nh`)\n\n`nb`\n: the numbers of a file’s size if it is lower than 1 KB/Kib\n\n`nk`\n: the numbers of a file’s size if it is between 1 KB/KiB and 1 MB/MiB\n\n`nm`\n: the numbers of a file’s size if it is between 1 MB/MiB and 1 GB/GiB\n\n`ng`\n: the numbers of a file’s size if it is between 1 GB/GiB and 1 TB/TiB\n\n`nt`\n: the numbers of a file’s size if it is 1 TB/TiB or higher\n\n`sb`\n: the units of a file’s size (sets `ub`, `uk`, `um`, `ug` and `uh`)\n\n`ub`\n: the units of a file’s size if it is lower than 1 KB/Kib\n\n`uk`\n: the units of a file’s size if it is between 1 KB/KiB and 1 MB/MiB\n\n`um`\n: the units of a file’s size if it is between 1 MB/MiB and 1 GB/GiB\n\n`ug`\n: the units of a file’s size if it is between 1 GB/GiB and 1 TB/TiB\n\n`ut`\n: the units of a file’s size if it is 1 TB/TiB or higher\n\n`df`\n: a device’s major ID\n\n`ds`\n: a device’s minor ID\n\n`uu`\n: a user that’s you\n\n`un`\n: a user that’s someone else\n\n`gu`\n: a group that you belong to\n\n`gn`\n: a group you aren’t a member of\n\n`lc`\n: a number of hard links\n\n`lm`\n: a number of hard links for a regular file with at least two\n\n`ga`\n: a new flag in Git\n\n`gm`\n: a modified flag in Git\n\n`gd`\n: a deleted flag in Git\n\n`gv`\n: a renamed flag in Git\n\n`gt`\n: a modified metadata flag in Git\n\n`xx`\n: “punctuation”, including many background UI elements\n\n`da`\n: a file’s date\n\n`in`\n: a file’s inode number\n\n`bl`\n: a file’s number of blocks\n\n`hd`\n: the header row of a table\n\n`lp`\n: the path of a symlink\n\n`cc`\n: an escaped character in a filename\n\n`bO`\n: the overlay style for broken symlink paths\n\nValues in `EXA_COLORS` override those given in `LS_COLORS`, so you don’t need to re-write an existing `LS_COLORS` variable with proprietary extensions.\n\n\nLIST OF STYLES\n==============\n\nUnlike some versions of `ls`, the given ANSI values must be valid colour codes: exa won’t just print out whichever characters are given.\n\nThe codes accepted by exa are:\n\n`1`\n: for bold\n\n`4`\n: for underline\n\n`31`\n: for red text\n\n`32`\n: for green text\n\n`33`\n: for yellow text\n\n`34`\n: for blue text\n\n`35`\n: for purple text\n\n`36`\n: for cyan text\n\n`37`\n: for white text\n\n`38;5;nnn`\n: for a colour from 0 to 255 (replace the `nnn` part)\n\nMany terminals will treat bolded text as a different colour, or at least provide the option to.\n\nexa provides its own built-in set of file extension mappings that cover a large range of common file extensions, including documents, archives, media, and temporary files.\nAny mappings in the environment variables will override this default set: running exa with `LS_COLORS=\"*.zip=32\"` will turn zip files green but leave the colours of other compressed files alone.\n\nYou can also disable this built-in set entirely by including a `reset` entry at the beginning of `EXA_COLORS`.\nSo setting `EXA_COLORS=\"reset:*.txt=31\"` will highlight only text files; setting `EXA_COLORS=\"reset\"` will highlight nothing.\n\n\nAUTHOR\n======\n\nexa is maintained by Benjamin ‘ogham’ Sago and many other contributors.\n\n**Website:** `https://the.exa.website/` \\\n**Source code:** `https://github.com/ogham/exa` \\\n**Contributors:** `https://github.com/ogham/exa/graphs/contributors`\n\n\nSEE ALSO\n========\n\n- `exa(1)`\n" }, { "path": "rust-toolchain.toml", "content": "[toolchain]\nchannel = \"1.66.1\"\n" }, { "path": "snap/.gitignore", "content": ".snapcraft\n" }, { "path": "snap/snapcraft.yaml", "content": "name: exa\nversion: 'latest'\nsummary: Replacement for 'ls' written in Rust\ndescription: |\n It uses colours for information by default, helping you distinguish between\n many types of files, such as whether you are the owner, or in the owning\n group. It also has extra features not present in the original ls, such as\n viewing the Git status for a directory, or recursing into directories with a\n tree view. exa is written in Rust, so it’s small, fast, and portable.\n\ngrade: stable\nconfinement: classic\n\napps:\n exa:\n command: exa\n\nparts:\n exa:\n plugin: rust\n source: .\n stage-packages:\n - libgit2-24\n - cmake\n - libz-dev\n" }, { "path": "src/fs/dir.rs", "content": "use crate::fs::feature::git::GitCache;\nuse crate::fs::fields::GitStatus;\nuse std::io;\nuse std::fs;\nuse std::path::{Path, PathBuf};\nuse std::slice::Iter as SliceIter;\n\nuse log::*;\n\nuse crate::fs::File;\n\n\n/// A **Dir** provides a cached list of the file paths in a directory that’s\n/// being listed.\n///\n/// This object gets passed to the Files themselves, in order for them to\n/// check the existence of surrounding files, then highlight themselves\n/// accordingly. (See `File#get_source_files`)\npub struct Dir {\n\n /// A vector of the files that have been read from this directory.\n contents: Vec,\n\n /// The path that was read.\n pub path: PathBuf,\n}\n\nimpl Dir {\n\n /// Create a new Dir object filled with all the files in the directory\n /// pointed to by the given path. Fails if the directory can’t be read, or\n /// isn’t actually a directory, or if there’s an IO error that occurs at\n /// any point.\n ///\n /// The `read_dir` iterator doesn’t actually yield the `.` and `..`\n /// entries, so if the user wants to see them, we’ll have to add them\n /// ourselves after the files have been read.\n pub fn read_dir(path: PathBuf) -> io::Result {\n info!(\"Reading directory {:?}\", &path);\n\n let contents = fs::read_dir(&path)?\n .map(|result| result.map(|entry| entry.path()))\n .collect::>()?;\n\n Ok(Self { contents, path })\n }\n\n /// Produce an iterator of IO results of trying to read all the files in\n /// this directory.\n pub fn files<'dir, 'ig>(&'dir self, dots: DotFilter, git: Option<&'ig GitCache>, git_ignoring: bool) -> Files<'dir, 'ig> {\n Files {\n inner: self.contents.iter(),\n dir: self,\n dotfiles: dots.shows_dotfiles(),\n dots: dots.dots(),\n git,\n git_ignoring,\n }\n }\n\n /// Whether this directory contains a file with the given path.\n pub fn contains(&self, path: &Path) -> bool {\n self.contents.iter().any(|p| p.as_path() == path)\n }\n\n /// Append a path onto the path specified by this directory.\n pub fn join(&self, child: &Path) -> PathBuf {\n self.path.join(child)\n }\n}\n\n\n/// Iterator over reading the contents of a directory as `File` objects.\npub struct Files<'dir, 'ig> {\n\n /// The internal iterator over the paths that have been read already.\n inner: SliceIter<'dir, PathBuf>,\n\n /// The directory that begat those paths.\n dir: &'dir Dir,\n\n /// Whether to include dotfiles in the list.\n dotfiles: bool,\n\n /// Whether the `.` or `..` directories should be produced first, before\n /// any files have been listed.\n dots: DotsNext,\n\n git: Option<&'ig GitCache>,\n\n git_ignoring: bool,\n}\n\nimpl<'dir, 'ig> Files<'dir, 'ig> {\n fn parent(&self) -> PathBuf {\n // We can’t use `Path#parent` here because all it does is remove the\n // last path component, which is no good for us if the path is\n // relative. For example, while the parent of `/testcases/files` is\n // `/testcases`, the parent of `.` is an empty path. Adding `..` on\n // the end is the only way to get to the *actual* parent directory.\n self.dir.path.join(\"..\")\n }\n\n /// Go through the directory until we encounter a file we can list (which\n /// varies depending on the dotfile visibility flag)\n fn next_visible_file(&mut self) -> Option, (PathBuf, io::Error)>> {\n loop {\n if let Some(path) = self.inner.next() {\n let filename = File::filename(path);\n if ! self.dotfiles && filename.starts_with('.') {\n continue;\n }\n\n // Also hide _prefix files on Windows because it's used by old applications\n // as an alternative to dot-prefix files.\n #[cfg(windows)]\n if ! self.dotfiles && filename.starts_with('_') {\n continue;\n }\n\n if self.git_ignoring {\n let git_status = self.git.map(|g| g.get(path, false)).unwrap_or_default();\n if git_status.unstaged == GitStatus::Ignored {\n continue;\n }\n }\n\n return Some(File::from_args(path.clone(), self.dir, filename)\n .map_err(|e| (path.clone(), e)))\n }\n\n return None\n }\n }\n}\n\n/// The dot directories that need to be listed before actual files, if any.\n/// If these aren’t being printed, then `FilesNext` is used to skip them.\nenum DotsNext {\n\n /// List the `.` directory next.\n Dot,\n\n /// List the `..` directory next.\n DotDot,\n\n /// Forget about the dot directories and just list files.\n Files,\n}\n\nimpl<'dir, 'ig> Iterator for Files<'dir, 'ig> {\n type Item = Result, (PathBuf, io::Error)>;\n\n fn next(&mut self) -> Option {\n match self.dots {\n DotsNext::Dot => {\n self.dots = DotsNext::DotDot;\n Some(File::new_aa_current(self.dir)\n .map_err(|e| (Path::new(\".\").to_path_buf(), e)))\n }\n\n DotsNext::DotDot => {\n self.dots = DotsNext::Files;\n Some(File::new_aa_parent(self.parent(), self.dir)\n .map_err(|e| (self.parent(), e)))\n }\n\n DotsNext::Files => {\n self.next_visible_file()\n }\n }\n }\n}\n\n\n/// Usually files in Unix use a leading dot to be hidden or visible, but two\n/// entries in particular are “extra-hidden”: `.` and `..`, which only become\n/// visible after an extra `-a` option.\n#[derive(PartialEq, Eq, Debug, Copy, Clone)]\npub enum DotFilter {\n\n /// Shows files, dotfiles, and `.` and `..`.\n DotfilesAndDots,\n\n /// Show files and dotfiles, but hide `.` and `..`.\n Dotfiles,\n\n /// Just show files, hiding anything beginning with a dot.\n JustFiles,\n}\n\nimpl Default for DotFilter {\n fn default() -> Self {\n Self::JustFiles\n }\n}\n\nimpl DotFilter {\n\n /// Whether this filter should show dotfiles in a listing.\n fn shows_dotfiles(self) -> bool {\n match self {\n Self::JustFiles => false,\n Self::Dotfiles => true,\n Self::DotfilesAndDots => true,\n }\n }\n\n /// Whether this filter should add dot directories to a listing.\n fn dots(self) -> DotsNext {\n match self {\n Self::JustFiles => DotsNext::Files,\n Self::Dotfiles => DotsNext::Files,\n Self::DotfilesAndDots => DotsNext::Dot,\n }\n }\n}\n" }, { "path": "src/fs/dir_action.rs", "content": "//! What to do when encountering a directory?\n\n/// The action to take when trying to list a file that turns out to be a\n/// directory.\n///\n/// By default, exa will display the information about files passed in as\n/// command-line arguments, with one file per entry. However, if a directory\n/// is passed in, exa assumes that the user wants to see its contents, rather\n/// than the directory itself.\n///\n/// This can get annoying sometimes: if a user does `exa ~/Downloads/img-*`\n/// to see the details of every file starting with `img-`, any directories\n/// that happen to start with the same will be listed after the files at\n/// the end in a separate block. By listing directories as files, their\n/// directory status will be ignored, and both will be listed side-by-side.\n///\n/// These two modes have recursive analogues in the “recurse” and “tree”\n/// modes. Here, instead of just listing the directories, exa will descend\n/// into them and print out their contents. The recurse mode does this by\n/// having extra output blocks at the end, while the tree mode will show\n/// directories inline, with their contents immediately underneath.\n#[derive(PartialEq, Eq, Debug, Copy, Clone)]\npub enum DirAction {\n\n /// This directory should be listed along with the regular files, instead\n /// of having its contents queried.\n AsFile,\n\n /// This directory should not be listed, and should instead be opened and\n /// *its* files listed separately. This is the default behaviour.\n List,\n\n /// This directory should be listed along with the regular files, and then\n /// its contents should be listed afterward. The recursive contents of\n /// *those* contents are dictated by the options argument.\n Recurse(RecurseOptions),\n}\n\nimpl DirAction {\n\n /// Gets the recurse options, if this dir action has any.\n pub fn recurse_options(self) -> Option {\n match self {\n Self::Recurse(o) => Some(o),\n _ => None,\n }\n }\n\n /// Whether to treat directories as regular files or not.\n pub fn treat_dirs_as_files(self) -> bool {\n match self {\n Self::AsFile => true,\n Self::Recurse(o) => o.tree,\n Self::List => false,\n }\n }\n}\n\n\n/// The options that determine how to recurse into a directory.\n#[derive(PartialEq, Eq, Debug, Copy, Clone)]\npub struct RecurseOptions {\n\n /// Whether recursion should be done as a tree or as multiple individual\n /// views of files.\n pub tree: bool,\n\n /// The maximum number of times that recursion should descend to, if one\n /// is specified.\n pub max_depth: Option,\n}\n\nimpl RecurseOptions {\n\n /// Returns whether a directory of the given depth would be too deep.\n pub fn is_too_deep(self, depth: usize) -> bool {\n match self.max_depth {\n None => false,\n Some(d) => d <= depth\n }\n }\n}\n" }, { "path": "src/fs/feature/git.rs", "content": "//! Getting the Git status of files and directories.\n\nuse std::ffi::OsStr;\n#[cfg(target_family = \"unix\")]\nuse std::os::unix::ffi::OsStrExt;\nuse std::path::{Path, PathBuf};\nuse std::sync::Mutex;\n\nuse log::*;\n\nuse crate::fs::fields as f;\n\n\n/// A **Git cache** is assembled based on the user’s input arguments.\n///\n/// This uses vectors to avoid the overhead of hashing: it’s not worth it when the\n/// expected number of Git repositories per exa invocation is 0 or 1...\npub struct GitCache {\n\n /// A list of discovered Git repositories and their paths.\n repos: Vec,\n\n /// Paths that we’ve confirmed do not have Git repositories underneath them.\n misses: Vec,\n}\n\nimpl GitCache {\n pub fn has_anything_for(&self, index: &Path) -> bool {\n self.repos.iter().any(|e| e.has_path(index))\n }\n\n pub fn get(&self, index: &Path, prefix_lookup: bool) -> f::Git {\n self.repos.iter()\n .find(|e| e.has_path(index))\n .map(|repo| repo.search(index, prefix_lookup))\n .unwrap_or_default()\n }\n}\n\nuse std::iter::FromIterator;\nimpl FromIterator for GitCache {\n fn from_iter(iter: I) -> Self\n where I: IntoIterator\n {\n let iter = iter.into_iter();\n let mut git = Self {\n repos: Vec::with_capacity(iter.size_hint().0),\n misses: Vec::new(),\n };\n\n for path in iter {\n if git.misses.contains(&path) {\n debug!(\"Skipping {:?} because it already came back Gitless\", path);\n }\n else if git.repos.iter().any(|e| e.has_path(&path)) {\n debug!(\"Skipping {:?} because we already queried it\", path);\n }\n else {\n match GitRepo::discover(path) {\n Ok(r) => {\n if let Some(r2) = git.repos.iter_mut().find(|e| e.has_workdir(&r.workdir)) {\n debug!(\"Adding to existing repo (workdir matches with {:?})\", r2.workdir);\n r2.extra_paths.push(r.original_path);\n continue;\n }\n\n debug!(\"Discovered new Git repo\");\n git.repos.push(r);\n }\n Err(miss) => {\n git.misses.push(miss)\n }\n }\n }\n }\n\n git\n }\n}\n\n\n/// A **Git repository** is one we’ve discovered somewhere on the filesystem.\npub struct GitRepo {\n\n /// The queryable contents of the repository: either a `git2` repo, or the\n /// cached results from when we queried it last time.\n contents: Mutex,\n\n /// The working directory of this repository.\n /// This is used to check whether two repositories are the same.\n workdir: PathBuf,\n\n /// The path that was originally checked to discover this repository.\n /// This is as important as the extra_paths (it gets checked first), but\n /// is separate to avoid having to deal with a non-empty Vec.\n original_path: PathBuf,\n\n /// Any other paths that were checked only to result in this same\n /// repository.\n extra_paths: Vec,\n}\n\n/// A repository’s queried state.\nenum GitContents {\n\n /// All the interesting Git stuff goes through this.\n Before {\n repo: git2::Repository,\n },\n\n /// Temporary value used in `repo_to_statuses` so we can move the\n /// repository out of the `Before` variant.\n Processing,\n\n /// The data we’ve extracted from the repository, but only after we’ve\n /// actually done so.\n After {\n statuses: Git,\n },\n}\n\nimpl GitRepo {\n\n /// Searches through this repository for a path (to a file or directory,\n /// depending on the prefix-lookup flag) and returns its Git status.\n ///\n /// Actually querying the `git2` repository for the mapping of paths to\n /// Git statuses is only done once, and gets cached so we don’t need to\n /// re-query the entire repository the times after that.\n ///\n /// The temporary `Processing` enum variant is used after the `git2`\n /// repository is moved out, but before the results have been moved in!\n /// See \n fn search(&self, index: &Path, prefix_lookup: bool) -> f::Git {\n use std::mem::replace;\n\n let mut contents = self.contents.lock().unwrap();\n if let GitContents::After { ref statuses } = *contents {\n debug!(\"Git repo {:?} has been found in cache\", &self.workdir);\n return statuses.status(index, prefix_lookup);\n }\n\n debug!(\"Querying Git repo {:?} for the first time\", &self.workdir);\n let repo = replace(&mut *contents, GitContents::Processing).inner_repo();\n let statuses = repo_to_statuses(&repo, &self.workdir);\n let result = statuses.status(index, prefix_lookup);\n let _processing = replace(&mut *contents, GitContents::After { statuses });\n result\n }\n\n /// Whether this repository has the given working directory.\n fn has_workdir(&self, path: &Path) -> bool {\n self.workdir == path\n }\n\n /// Whether this repository cares about the given path at all.\n fn has_path(&self, path: &Path) -> bool {\n path.starts_with(&self.original_path) || self.extra_paths.iter().any(|e| path.starts_with(e))\n }\n\n /// Searches for a Git repository at any point above the given path.\n /// Returns the original buffer if none is found.\n fn discover(path: PathBuf) -> Result {\n info!(\"Searching for Git repository above {:?}\", path);\n let repo = match git2::Repository::discover(&path) {\n Ok(r) => r,\n Err(e) => {\n error!(\"Error discovering Git repositories: {:?}\", e);\n return Err(path);\n }\n };\n\n if let Some(workdir) = repo.workdir() {\n let workdir = workdir.to_path_buf();\n let contents = Mutex::new(GitContents::Before { repo });\n Ok(Self { contents, workdir, original_path: path, extra_paths: Vec::new() })\n }\n else {\n warn!(\"Repository has no workdir?\");\n Err(path)\n }\n }\n}\n\n\nimpl GitContents {\n /// Assumes that the repository hasn’t been queried, and extracts it\n /// (consuming the value) if it has. This is needed because the entire\n /// enum variant gets replaced when a repo is queried (see above).\n fn inner_repo(self) -> git2::Repository {\n if let Self::Before { repo } = self {\n repo\n }\n else {\n unreachable!(\"Tried to extract a non-Repository\")\n }\n }\n}\n\n/// Iterates through a repository’s statuses, consuming it and returning the\n/// mapping of files to their Git status.\n/// We will have already used the working directory at this point, so it gets\n/// passed in rather than deriving it from the `Repository` again.\nfn repo_to_statuses(repo: &git2::Repository, workdir: &Path) -> Git {\n let mut statuses = Vec::new();\n\n info!(\"Getting Git statuses for repo with workdir {:?}\", workdir);\n match repo.statuses(None) {\n Ok(es) => {\n for e in es.iter() {\n #[cfg(target_family = \"unix\")]\n let path = workdir.join(Path::new(OsStr::from_bytes(e.path_bytes())));\n // TODO: handle non Unix systems better:\n // https://github.com/ogham/exa/issues/698\n #[cfg(not(target_family = \"unix\"))]\n let path = workdir.join(Path::new(e.path().unwrap()));\n let elem = (path, e.status());\n statuses.push(elem);\n }\n }\n Err(e) => {\n error!(\"Error looking up Git statuses: {:?}\", e);\n }\n }\n\n Git { statuses }\n}\n\n// The `repo.statuses` call above takes a long time. exa debug output:\n//\n// 20.311276 INFO:exa::fs::feature::git: Getting Git statuses for repo with workdir \"/vagrant/\"\n// 20.799610 DEBUG:exa::output::table: Getting Git status for file \"./Cargo.toml\"\n//\n// Even inserting another logging line immediately afterwards doesn’t make it\n// look any faster.\n\n\n/// Container of Git statuses for all the files in this folder’s Git repository.\nstruct Git {\n statuses: Vec<(PathBuf, git2::Status)>,\n}\n\nimpl Git {\n\n /// Get either the file or directory status for the given path.\n /// “Prefix lookup” means that it should report an aggregate status of all\n /// paths starting with the given prefix (in other words, a directory).\n fn status(&self, index: &Path, prefix_lookup: bool) -> f::Git {\n if prefix_lookup { self.dir_status(index) }\n else { self.file_status(index) }\n }\n\n /// Get the user-facing status of a file.\n /// We check the statuses directly applying to a file, and for the ignored\n /// status we check if any of its parents directories is ignored by git.\n fn file_status(&self, file: &Path) -> f::Git {\n let path = reorient(file);\n\n let s = self.statuses.iter()\n .filter(|p| if p.1 == git2::Status::IGNORED {\n path.starts_with(&p.0)\n } else {\n p.0 == path\n })\n .fold(git2::Status::empty(), |a, b| a | b.1);\n\n let staged = index_status(s);\n let unstaged = working_tree_status(s);\n f::Git { staged, unstaged }\n }\n\n /// Get the combined, user-facing status of a directory.\n /// Statuses are aggregating (for example, a directory is considered\n /// modified if any file under it has the status modified), except for\n /// ignored status which applies to files under (for example, a directory\n /// is considered ignored if one of its parent directories is ignored).\n fn dir_status(&self, dir: &Path) -> f::Git {\n let path = reorient(dir);\n\n let s = self.statuses.iter()\n .filter(|p| if p.1 == git2::Status::IGNORED {\n path.starts_with(&p.0)\n } else {\n p.0.starts_with(&path)\n })\n .fold(git2::Status::empty(), |a, b| a | b.1);\n\n let staged = index_status(s);\n let unstaged = working_tree_status(s);\n f::Git { staged, unstaged }\n }\n}\n\n\n/// Converts a path to an absolute path based on the current directory.\n/// Paths need to be absolute for them to be compared properly, otherwise\n/// you’d ask a repo about “./README.md” but it only knows about\n/// “/vagrant/README.md”, prefixed by the workdir.\n#[cfg(unix)]\nfn reorient(path: &Path) -> PathBuf {\n use std::env::current_dir;\n\n // TODO: I’m not 100% on this func tbh\n let path = match current_dir() {\n Err(_) => Path::new(\".\").join(&path),\n Ok(dir) => dir.join(&path),\n };\n\n path.canonicalize().unwrap_or(path)\n}\n\n#[cfg(windows)]\nfn reorient(path: &Path) -> PathBuf {\n let unc_path = path.canonicalize().unwrap();\n // On Windows UNC path is returned. We need to strip the prefix for it to work.\n let normal_path = unc_path.as_os_str().to_str().unwrap().trim_left_matches(\"\\\\\\\\?\\\\\");\n return PathBuf::from(normal_path);\n}\n\n/// The character to display if the file has been modified, but not staged.\nfn working_tree_status(status: git2::Status) -> f::GitStatus {\n match status {\n s if s.contains(git2::Status::WT_NEW) => f::GitStatus::New,\n s if s.contains(git2::Status::WT_MODIFIED) => f::GitStatus::Modified,\n s if s.contains(git2::Status::WT_DELETED) => f::GitStatus::Deleted,\n s if s.contains(git2::Status::WT_RENAMED) => f::GitStatus::Renamed,\n s if s.contains(git2::Status::WT_TYPECHANGE) => f::GitStatus::TypeChange,\n s if s.contains(git2::Status::IGNORED) => f::GitStatus::Ignored,\n s if s.contains(git2::Status::CONFLICTED) => f::GitStatus::Conflicted,\n _ => f::GitStatus::NotModified,\n }\n}\n\n/// The character to display if the file has been modified and the change\n/// has been staged.\nfn index_status(status: git2::Status) -> f::GitStatus {\n match status {\n s if s.contains(git2::Status::INDEX_NEW) => f::GitStatus::New,\n s if s.contains(git2::Status::INDEX_MODIFIED) => f::GitStatus::Modified,\n s if s.contains(git2::Status::INDEX_DELETED) => f::GitStatus::Deleted,\n s if s.contains(git2::Status::INDEX_RENAMED) => f::GitStatus::Renamed,\n s if s.contains(git2::Status::INDEX_TYPECHANGE) => f::GitStatus::TypeChange,\n _ => f::GitStatus::NotModified,\n }\n}\n" }, { "path": "src/fs/feature/mod.rs", "content": "pub mod xattr;\n\n#[cfg(feature = \"git\")]\npub mod git;\n\n#[cfg(not(feature = \"git\"))]\npub mod git {\n use std::iter::FromIterator;\n use std::path::{Path, PathBuf};\n\n use crate::fs::fields as f;\n\n\n pub struct GitCache;\n\n impl FromIterator for GitCache {\n fn from_iter(_iter: I) -> Self\n where I: IntoIterator\n {\n Self\n }\n }\n\n impl GitCache {\n pub fn has_anything_for(&self, _index: &Path) -> bool {\n false\n }\n\n pub fn get(&self, _index: &Path, _prefix_lookup: bool) -> f::Git {\n unreachable!();\n }\n }\n}\n" }, { "path": "src/fs/feature/xattr.rs", "content": "//! Extended attribute support for Darwin and Linux systems.\n\n#![allow(trivial_casts)] // for ARM\n\nuse std::cmp::Ordering;\nuse std::io;\nuse std::path::Path;\n\n\npub const ENABLED: bool = cfg!(any(target_os = \"macos\", target_os = \"linux\"));\n\n\npub trait FileAttributes {\n fn attributes(&self) -> io::Result>;\n fn symlink_attributes(&self) -> io::Result>;\n}\n\n#[cfg(any(target_os = \"macos\", target_os = \"linux\"))]\nimpl FileAttributes for Path {\n fn attributes(&self) -> io::Result> {\n list_attrs(&lister::Lister::new(FollowSymlinks::Yes), self)\n }\n\n fn symlink_attributes(&self) -> io::Result> {\n list_attrs(&lister::Lister::new(FollowSymlinks::No), self)\n }\n}\n\n#[cfg(not(any(target_os = \"macos\", target_os = \"linux\")))]\nimpl FileAttributes for Path {\n fn attributes(&self) -> io::Result> {\n Ok(Vec::new())\n }\n\n fn symlink_attributes(&self) -> io::Result> {\n Ok(Vec::new())\n }\n}\n\n\n/// Attributes which can be passed to `Attribute::list_with_flags`\n#[cfg(any(target_os = \"macos\", target_os = \"linux\"))]\n#[derive(Copy, Clone)]\npub enum FollowSymlinks {\n Yes,\n No,\n}\n\n/// Extended attribute\n#[derive(Debug, Clone)]\npub struct Attribute {\n pub name: String,\n pub size: usize,\n}\n\n\n#[cfg(any(target_os = \"macos\", target_os = \"linux\"))]\npub fn list_attrs(lister: &lister::Lister, path: &Path) -> io::Result> {\n use std::ffi::CString;\n\n let c_path = match path.to_str().and_then(|s| CString::new(s).ok()) {\n Some(cstring) => cstring,\n None => {\n return Err(io::Error::new(io::ErrorKind::Other, \"Error: path somehow contained a NUL?\"));\n }\n };\n\n let bufsize = lister.listxattr_first(&c_path);\n match bufsize.cmp(&0) {\n Ordering::Less => return Err(io::Error::last_os_error()),\n Ordering::Equal => return Ok(Vec::new()),\n Ordering::Greater => {},\n }\n\n let mut buf = vec![0_u8; bufsize as usize];\n let err = lister.listxattr_second(&c_path, &mut buf, bufsize);\n\n match err.cmp(&0) {\n Ordering::Less => return Err(io::Error::last_os_error()),\n Ordering::Equal => return Ok(Vec::new()),\n Ordering::Greater => {},\n }\n\n let mut names = Vec::new();\n if err > 0 {\n // End indices of the attribute names\n // the buffer contains 0-terminated c-strings\n let idx = buf.iter().enumerate().filter_map(|(i, v)|\n if *v == 0 { Some(i) } else { None }\n );\n let mut start = 0;\n\n for end in idx {\n let c_end = end + 1; // end of the c-string (including 0)\n let size = lister.getxattr(&c_path, &buf[start..c_end]);\n\n if size > 0 {\n names.push(Attribute {\n name: lister.translate_attribute_name(&buf[start..end]),\n size: size as usize,\n });\n }\n\n start = c_end;\n }\n }\n\n Ok(names)\n}\n\n\n#[cfg(target_os = \"macos\")]\nmod lister {\n use super::FollowSymlinks;\n use libc::{c_int, size_t, ssize_t, c_char, c_void};\n use std::ffi::CString;\n use std::ptr;\n\n extern \"C\" {\n fn listxattr(\n path: *const c_char,\n namebuf: *mut c_char,\n size: size_t,\n options: c_int,\n ) -> ssize_t;\n\n fn getxattr(\n path: *const c_char,\n name: *const c_char,\n value: *mut c_void,\n size: size_t,\n position: u32,\n options: c_int,\n ) -> ssize_t;\n }\n\n pub struct Lister {\n c_flags: c_int,\n }\n\n impl Lister {\n pub fn new(do_follow: FollowSymlinks) -> Self {\n let c_flags: c_int = match do_follow {\n FollowSymlinks::Yes => 0x0001,\n FollowSymlinks::No => 0x0000,\n };\n\n Self { c_flags }\n }\n\n pub fn translate_attribute_name(&self, input: &[u8]) -> String {\n unsafe { std::str::from_utf8_unchecked(input).into() }\n }\n\n pub fn listxattr_first(&self, c_path: &CString) -> ssize_t {\n unsafe {\n listxattr(\n c_path.as_ptr(),\n ptr::null_mut(),\n 0,\n self.c_flags,\n )\n }\n }\n\n pub fn listxattr_second(&self, c_path: &CString, buf: &mut Vec, bufsize: ssize_t) -> ssize_t {\n unsafe {\n listxattr(\n c_path.as_ptr(),\n buf.as_mut_ptr().cast::(),\n bufsize as size_t,\n self.c_flags,\n )\n }\n }\n\n pub fn getxattr(&self, c_path: &CString, buf: &[u8]) -> ssize_t {\n unsafe {\n getxattr(\n c_path.as_ptr(),\n buf.as_ptr().cast::(),\n ptr::null_mut(),\n 0,\n 0,\n self.c_flags,\n )\n }\n }\n }\n}\n\n\n#[cfg(target_os = \"linux\")]\nmod lister {\n use std::ffi::CString;\n use libc::{size_t, ssize_t, c_char, c_void};\n use super::FollowSymlinks;\n use std::ptr;\n\n extern \"C\" {\n fn listxattr(\n path: *const c_char,\n list: *mut c_char,\n size: size_t,\n ) -> ssize_t;\n\n fn llistxattr(\n path: *const c_char,\n list: *mut c_char,\n size: size_t,\n ) -> ssize_t;\n\n fn getxattr(\n path: *const c_char,\n name: *const c_char,\n value: *mut c_void,\n size: size_t,\n ) -> ssize_t;\n\n fn lgetxattr(\n path: *const c_char,\n name: *const c_char,\n value: *mut c_void,\n size: size_t,\n ) -> ssize_t;\n }\n\n pub struct Lister {\n follow_symlinks: FollowSymlinks,\n }\n\n impl Lister {\n pub fn new(follow_symlinks: FollowSymlinks) -> Lister {\n Lister { follow_symlinks }\n }\n\n pub fn translate_attribute_name(&self, input: &[u8]) -> String {\n String::from_utf8_lossy(input).into_owned()\n }\n\n pub fn listxattr_first(&self, c_path: &CString) -> ssize_t {\n let listxattr = match self.follow_symlinks {\n FollowSymlinks::Yes => listxattr,\n FollowSymlinks::No => llistxattr,\n };\n\n unsafe {\n listxattr(\n c_path.as_ptr().cast(),\n ptr::null_mut(),\n 0,\n )\n }\n }\n\n pub fn listxattr_second(&self, c_path: &CString, buf: &mut Vec, bufsize: ssize_t) -> ssize_t {\n let listxattr = match self.follow_symlinks {\n FollowSymlinks::Yes => listxattr,\n FollowSymlinks::No => llistxattr,\n };\n\n unsafe {\n listxattr(\n c_path.as_ptr().cast(),\n buf.as_mut_ptr().cast(),\n bufsize as size_t,\n )\n }\n }\n\n pub fn getxattr(&self, c_path: &CString, buf: &[u8]) -> ssize_t {\n let getxattr = match self.follow_symlinks {\n FollowSymlinks::Yes => getxattr,\n FollowSymlinks::No => lgetxattr,\n };\n\n unsafe {\n getxattr(\n c_path.as_ptr().cast(),\n buf.as_ptr().cast(),\n ptr::null_mut(),\n 0,\n )\n }\n }\n }\n}\n" }, { "path": "src/fs/fields.rs", "content": "//! Wrapper types for the values returned from `File`s.\n//!\n//! The methods of `File` that return information about the entry on the\n//! filesystem -- size, modification date, block count, or Git status -- used\n//! to just return these as formatted strings, but this became inflexible once\n//! customisable output styles landed.\n//!\n//! Instead, they will return a wrapper type from this module, which tags the\n//! type with what field it is while containing the actual raw value.\n//!\n//! The `output::details` module, among others, uses these types to render and\n//! display the information as formatted strings.\n\n// C-style `blkcnt_t` types don’t follow Rust’s rules!\n#![allow(non_camel_case_types)]\n#![allow(clippy::struct_excessive_bools)]\n\n\n/// The type of a file’s block count.\npub type blkcnt_t = u64;\n\n/// The type of a file’s group ID.\npub type gid_t = u32;\n\n/// The type of a file’s inode.\npub type ino_t = u64;\n\n/// The type of a file’s number of links.\npub type nlink_t = u64;\n\n/// The type of a file’s timestamp (creation, modification, access, etc).\npub type time_t = i64;\n\n/// The type of a file’s user ID.\npub type uid_t = u32;\n\n\n/// The file’s base type, which gets displayed in the very first column of the\n/// details output.\n///\n/// This type is set entirely by the filesystem, rather than relying on a\n/// file’s contents. So “link” is a type, but “image” is just a type of\n/// regular file. (See the `filetype` module for those checks.)\n///\n/// Its ordering is used when sorting by type.\n#[derive(PartialEq, Eq, PartialOrd, Ord, Copy, Clone)]\npub enum Type {\n Directory,\n File,\n Link,\n Pipe,\n Socket,\n CharDevice,\n BlockDevice,\n Special,\n}\n\nimpl Type {\n pub fn is_regular_file(self) -> bool {\n matches!(self, Self::File)\n }\n}\n\n\n/// The file’s Unix permission bitfield, with one entry per bit.\n#[derive(Copy, Clone)]\npub struct Permissions {\n pub user_read: bool,\n pub user_write: bool,\n pub user_execute: bool,\n\n pub group_read: bool,\n pub group_write: bool,\n pub group_execute: bool,\n\n pub other_read: bool,\n pub other_write: bool,\n pub other_execute: bool,\n\n pub sticky: bool,\n pub setgid: bool,\n pub setuid: bool,\n}\n\n/// The file's FileAttributes field, available only on Windows.\n#[derive(Copy, Clone)]\npub struct Attributes {\n pub archive: bool,\n pub directory: bool,\n pub readonly: bool,\n pub hidden: bool,\n pub system: bool,\n pub reparse_point: bool,\n}\n\n/// The three pieces of information that are displayed as a single column in\n/// the details view. These values are fused together to make the output a\n/// little more compressed.\n#[derive(Copy, Clone)]\npub struct PermissionsPlus {\n pub file_type: Type,\n #[cfg(unix)]\n pub permissions: Permissions,\n #[cfg(windows)]\n pub attributes: Attributes,\n pub xattrs: bool,\n}\n\n\n/// The permissions encoded as octal values\n#[derive(Copy, Clone)]\npub struct OctalPermissions {\n pub permissions: Permissions,\n}\n\n/// A file’s number of hard links on the filesystem.\n///\n/// Under Unix, a file can exist on the filesystem only once but appear in\n/// multiple directories. However, it’s rare (but occasionally useful!) for a\n/// regular file to have a link count greater than 1, so we highlight the\n/// block count specifically for this case.\n#[derive(Copy, Clone)]\npub struct Links {\n\n /// The actual link count.\n pub count: nlink_t,\n\n /// Whether this file is a regular file with more than one hard link.\n pub multiple: bool,\n}\n\n\n/// A file’s inode. Every directory entry on a Unix filesystem has an inode,\n/// including directories and links, so this is applicable to everything exa\n/// can deal with.\n#[derive(Copy, Clone)]\npub struct Inode(pub ino_t);\n\n\n/// The number of blocks that a file takes up on the filesystem, if any.\n#[derive(Copy, Clone)]\npub enum Blocks {\n\n /// This file has the given number of blocks.\n Some(blkcnt_t),\n\n /// This file isn’t of a type that can take up blocks.\n None,\n}\n\n\n/// The ID of the user that owns a file. This will only ever be a number;\n/// looking up the username is done in the `display` module.\n#[derive(Copy, Clone)]\npub struct User(pub uid_t);\n\n/// The ID of the group that a file belongs to.\n#[derive(Copy, Clone)]\npub struct Group(pub gid_t);\n\n\n/// A file’s size, in bytes. This is usually formatted by the `number_prefix`\n/// crate into something human-readable.\n#[derive(Copy, Clone)]\npub enum Size {\n\n /// This file has a defined size.\n Some(u64),\n\n /// This file has no size, or has a size but we aren’t interested in it.\n ///\n /// Under Unix, directory entries that aren’t regular files will still\n /// have a file size. For example, a directory will just contain a list of\n /// its files as its “contents” and will be specially flagged as being a\n /// directory, rather than a file. However, seeing the “file size” of this\n /// data is rarely useful — I can’t think of a time when I’ve seen it and\n /// learnt something. So we discard it and just output “-” instead.\n ///\n /// See this answer for more: \n None,\n\n /// This file is a block or character device, so instead of a size, print\n /// out the file’s major and minor device IDs.\n ///\n /// This is what ls does as well. Without it, the devices will just have\n /// file sizes of zero.\n DeviceIDs(DeviceIDs),\n}\n\n/// The major and minor device IDs that gets displayed for device files.\n///\n/// You can see what these device numbers mean:\n/// - \n/// - \n#[derive(Copy, Clone)]\npub struct DeviceIDs {\n pub major: u8,\n pub minor: u8,\n}\n\n\n/// One of a file’s timestamps (created, accessed, or modified).\n#[derive(Copy, Clone, PartialEq, Eq, PartialOrd, Ord)]\npub struct Time {\n pub seconds: time_t,\n pub nanoseconds: time_t,\n}\n\n\n/// A file’s status in a Git repository. Whether a file is in a repository or\n/// not is handled by the Git module, rather than having a “null” variant in\n/// this enum.\n#[derive(PartialEq, Eq, Copy, Clone)]\npub enum GitStatus {\n\n /// This file hasn’t changed since the last commit.\n NotModified,\n\n /// This file didn’t exist for the last commit, and is not specified in\n /// the ignored files list.\n New,\n\n /// A file that’s been modified since the last commit.\n Modified,\n\n /// A deleted file. This can’t ever be shown, but it’s here anyway!\n Deleted,\n\n /// A file that Git has tracked a rename for.\n Renamed,\n\n /// A file that’s had its type (such as the file permissions) changed.\n TypeChange,\n\n /// A file that’s ignored (that matches a line in .gitignore)\n Ignored,\n\n /// A file that’s updated but unmerged.\n Conflicted,\n}\n\n\n/// A file’s complete Git status. It’s possible to make changes to a file, add\n/// it to the staging area, then make *more* changes, so we need to list each\n/// file’s status for both of these.\n#[derive(Copy, Clone)]\npub struct Git {\n pub staged: GitStatus,\n pub unstaged: GitStatus,\n}\n\nimpl Default for Git {\n\n /// Create a Git status for a file with nothing done to it.\n fn default() -> Self {\n Self {\n staged: GitStatus::NotModified,\n unstaged: GitStatus::NotModified,\n }\n }\n}\n" }, { "path": "src/fs/file.rs", "content": "//! Files, and methods and fields to access their metadata.\n\nuse std::io;\n#[cfg(unix)]\nuse std::os::unix::fs::{FileTypeExt, MetadataExt, PermissionsExt};\n#[cfg(windows)]\nuse std::os::windows::fs::MetadataExt;\nuse std::path::{Path, PathBuf};\nuse std::time::{Duration, SystemTime, UNIX_EPOCH};\n\nuse log::*;\n\nuse crate::fs::dir::Dir;\nuse crate::fs::fields as f;\n\n\n/// A **File** is a wrapper around one of Rust’s `PathBuf` values, along with\n/// associated data about the file.\n///\n/// Each file is definitely going to have its filename displayed at least\n/// once, have its file extension extracted at least once, and have its metadata\n/// information queried at least once, so it makes sense to do all this at the\n/// start and hold on to all the information.\npub struct File<'dir> {\n\n /// The filename portion of this file’s path, including the extension.\n ///\n /// This is used to compare against certain filenames (such as checking if\n /// it’s “Makefile” or something) and to highlight only the filename in\n /// colour when displaying the path.\n pub name: String,\n\n /// The file’s name’s extension, if present, extracted from the name.\n ///\n /// This is queried many times over, so it’s worth caching it.\n pub ext: Option,\n\n /// The path that begat this file.\n ///\n /// Even though the file’s name is extracted, the path needs to be kept\n /// around, as certain operations involve looking up the file’s absolute\n /// location (such as searching for compiled files) or using its original\n /// path (following a symlink).\n pub path: PathBuf,\n\n /// A cached `metadata` (`stat`) call for this file.\n ///\n /// This too is queried multiple times, and is *not* cached by the OS, as\n /// it could easily change between invocations — but exa is so short-lived\n /// it’s better to just cache it.\n pub metadata: std::fs::Metadata,\n\n /// A reference to the directory that contains this file, if any.\n ///\n /// Filenames that get passed in on the command-line directly will have no\n /// parent directory reference — although they technically have one on the\n /// filesystem, we’ll never need to look at it, so it’ll be `None`.\n /// However, *directories* that get passed in will produce files that\n /// contain a reference to it, which is used in certain operations (such\n /// as looking up compiled files).\n pub parent_dir: Option<&'dir Dir>,\n\n /// Whether this is one of the two `--all all` directories, `.` and `..`.\n ///\n /// Unlike all other entries, these are not returned as part of the\n /// directory’s children, and are in fact added specifically by exa; this\n /// means that they should be skipped when recursing.\n pub is_all_all: bool,\n}\n\nimpl<'dir> File<'dir> {\n pub fn from_args(path: PathBuf, parent_dir: PD, filename: FN) -> io::Result>\n where PD: Into>,\n FN: Into>\n {\n let parent_dir = parent_dir.into();\n let name = filename.into().unwrap_or_else(|| File::filename(&path));\n let ext = File::ext(&path);\n\n debug!(\"Statting file {:?}\", &path);\n let metadata = std::fs::symlink_metadata(&path)?;\n let is_all_all = false;\n\n Ok(File { name, ext, path, metadata, parent_dir, is_all_all })\n }\n\n pub fn new_aa_current(parent_dir: &'dir Dir) -> io::Result> {\n let path = parent_dir.path.clone();\n let ext = File::ext(&path);\n\n debug!(\"Statting file {:?}\", &path);\n let metadata = std::fs::symlink_metadata(&path)?;\n let is_all_all = true;\n let parent_dir = Some(parent_dir);\n\n Ok(File { path, parent_dir, metadata, ext, name: \".\".into(), is_all_all })\n }\n\n pub fn new_aa_parent(path: PathBuf, parent_dir: &'dir Dir) -> io::Result> {\n let ext = File::ext(&path);\n\n debug!(\"Statting file {:?}\", &path);\n let metadata = std::fs::symlink_metadata(&path)?;\n let is_all_all = true;\n let parent_dir = Some(parent_dir);\n\n Ok(File { path, parent_dir, metadata, ext, name: \"..\".into(), is_all_all })\n }\n\n /// A file’s name is derived from its string. This needs to handle directories\n /// such as `/` or `..`, which have no `file_name` component. So instead, just\n /// use the last component as the name.\n pub fn filename(path: &Path) -> String {\n if let Some(back) = path.components().next_back() {\n back.as_os_str().to_string_lossy().to_string()\n }\n else {\n // use the path as fallback\n error!(\"Path {:?} has no last component\", path);\n path.display().to_string()\n }\n }\n\n /// Extract an extension from a file path, if one is present, in lowercase.\n ///\n /// The extension is the series of characters after the last dot. This\n /// deliberately counts dotfiles, so the “.git” folder has the extension “git”.\n ///\n /// ASCII lowercasing is used because these extensions are only compared\n /// against a pre-compiled list of extensions which are known to only exist\n /// within ASCII, so it’s alright.\n fn ext(path: &Path) -> Option {\n let name = path.file_name().map(|f| f.to_string_lossy().to_string())?;\n\n name.rfind('.')\n .map(|p| name[p + 1 ..]\n .to_ascii_lowercase())\n }\n\n /// Whether this file is a directory on the filesystem.\n pub fn is_directory(&self) -> bool {\n self.metadata.is_dir()\n }\n\n /// Whether this file is a directory, or a symlink pointing to a directory.\n pub fn points_to_directory(&self) -> bool {\n if self.is_directory() {\n return true;\n }\n\n if self.is_link() {\n let target = self.link_target();\n if let FileTarget::Ok(target) = target {\n return target.points_to_directory();\n }\n }\n\n false\n }\n\n /// If this file is a directory on the filesystem, then clone its\n /// `PathBuf` for use in one of our own `Dir` values, and read a list of\n /// its contents.\n ///\n /// Returns an IO error upon failure, but this shouldn’t be used to check\n /// if a `File` is a directory or not! For that, just use `is_directory()`.\n pub fn to_dir(&self) -> io::Result {\n Dir::read_dir(self.path.clone())\n }\n\n /// Whether this file is a regular file on the filesystem — that is, not a\n /// directory, a link, or anything else treated specially.\n pub fn is_file(&self) -> bool {\n self.metadata.is_file()\n }\n\n /// Whether this file is both a regular file *and* executable for the\n /// current user. An executable file has a different purpose from an\n /// executable directory, so they should be highlighted differently.\n #[cfg(unix)]\n pub fn is_executable_file(&self) -> bool {\n let bit = modes::USER_EXECUTE;\n self.is_file() && (self.metadata.permissions().mode() & bit) == bit\n }\n\n /// Whether this file is a symlink on the filesystem.\n pub fn is_link(&self) -> bool {\n self.metadata.file_type().is_symlink()\n }\n\n /// Whether this file is a named pipe on the filesystem.\n #[cfg(unix)]\n pub fn is_pipe(&self) -> bool {\n self.metadata.file_type().is_fifo()\n }\n\n /// Whether this file is a char device on the filesystem.\n #[cfg(unix)]\n pub fn is_char_device(&self) -> bool {\n self.metadata.file_type().is_char_device()\n }\n\n /// Whether this file is a block device on the filesystem.\n #[cfg(unix)]\n pub fn is_block_device(&self) -> bool {\n self.metadata.file_type().is_block_device()\n }\n\n /// Whether this file is a socket on the filesystem.\n #[cfg(unix)]\n pub fn is_socket(&self) -> bool {\n self.metadata.file_type().is_socket()\n }\n\n\n /// Re-prefixes the path pointed to by this file, if it’s a symlink, to\n /// make it an absolute path that can be accessed from whichever\n /// directory exa is being run from.\n fn reorient_target_path(&self, path: &Path) -> PathBuf {\n if path.is_absolute() {\n path.to_path_buf()\n }\n else if let Some(dir) = self.parent_dir {\n dir.join(path)\n }\n else if let Some(parent) = self.path.parent() {\n parent.join(path)\n }\n else {\n self.path.join(path)\n }\n }\n\n /// Again assuming this file is a symlink, follows that link and returns\n /// the result of following it.\n ///\n /// For a working symlink that the user is allowed to follow,\n /// this will be the `File` object at the other end, which can then have\n /// its name, colour, and other details read.\n ///\n /// For a broken symlink, returns where the file *would* be, if it\n /// existed. If this file cannot be read at all, returns the error that\n /// we got when we tried to read it.\n pub fn link_target(&self) -> FileTarget<'dir> {\n\n // We need to be careful to treat the path actually pointed to by\n // this file — which could be absolute or relative — to the path\n // we actually look up and turn into a `File` — which needs to be\n // absolute to be accessible from any directory.\n debug!(\"Reading link {:?}\", &self.path);\n let path = match std::fs::read_link(&self.path) {\n Ok(p) => p,\n Err(e) => return FileTarget::Err(e),\n };\n\n let absolute_path = self.reorient_target_path(&path);\n\n // Use plain `metadata` instead of `symlink_metadata` - we *want* to\n // follow links.\n match std::fs::metadata(&absolute_path) {\n Ok(metadata) => {\n let ext = File::ext(&path);\n let name = File::filename(&path);\n let file = File { parent_dir: None, path, ext, metadata, name, is_all_all: false };\n FileTarget::Ok(Box::new(file))\n }\n Err(e) => {\n error!(\"Error following link {:?}: {:#?}\", &path, e);\n FileTarget::Broken(path)\n }\n }\n }\n\n /// This file’s number of hard links.\n ///\n /// It also reports whether this is both a regular file, and a file with\n /// multiple links. This is important, because a file with multiple links\n /// is uncommon, while you come across directories and other types\n /// with multiple links much more often. Thus, it should get highlighted\n /// more attentively.\n #[cfg(unix)]\n pub fn links(&self) -> f::Links {\n let count = self.metadata.nlink();\n\n f::Links {\n count,\n multiple: self.is_file() && count > 1,\n }\n }\n\n /// This file’s inode.\n #[cfg(unix)]\n pub fn inode(&self) -> f::Inode {\n f::Inode(self.metadata.ino())\n }\n\n /// This file’s number of filesystem blocks.\n ///\n /// (Not the size of each block, which we don’t actually report on)\n #[cfg(unix)]\n pub fn blocks(&self) -> f::Blocks {\n if self.is_file() || self.is_link() {\n f::Blocks::Some(self.metadata.blocks())\n }\n else {\n f::Blocks::None\n }\n }\n\n /// The ID of the user that own this file.\n #[cfg(unix)]\n pub fn user(&self) -> f::User {\n f::User(self.metadata.uid())\n }\n\n /// The ID of the group that owns this file.\n #[cfg(unix)]\n pub fn group(&self) -> f::Group {\n f::Group(self.metadata.gid())\n }\n\n /// This file’s size, if it’s a regular file.\n ///\n /// For directories, no size is given. Although they do have a size on\n /// some filesystems, I’ve never looked at one of those numbers and gained\n /// any information from it. So it’s going to be hidden instead.\n ///\n /// Block and character devices return their device IDs, because they\n /// usually just have a file size of zero.\n #[cfg(unix)]\n pub fn size(&self) -> f::Size {\n if self.is_directory() {\n f::Size::None\n }\n else if self.is_char_device() || self.is_block_device() {\n let device_ids = self.metadata.rdev().to_be_bytes();\n\n // In C-land, getting the major and minor device IDs is done with\n // preprocessor macros called `major` and `minor` that depend on\n // the size of `dev_t`, but we just take the second-to-last and\n // last bytes.\n f::Size::DeviceIDs(f::DeviceIDs {\n major: device_ids[6],\n minor: device_ids[7],\n })\n }\n else {\n f::Size::Some(self.metadata.len())\n }\n }\n\n #[cfg(windows)]\n pub fn size(&self) -> f::Size {\n if self.is_directory() {\n f::Size::None\n }\n else {\n f::Size::Some(self.metadata.len())\n }\n }\n\n /// This file’s last modified timestamp, if available on this platform.\n pub fn modified_time(&self) -> Option {\n self.metadata.modified().ok()\n }\n\n /// This file’s last changed timestamp, if available on this platform.\n #[cfg(unix)]\n pub fn changed_time(&self) -> Option {\n let (mut sec, mut nanosec) = (self.metadata.ctime(), self.metadata.ctime_nsec());\n\n if sec < 0 {\n if nanosec > 0 {\n sec += 1;\n nanosec -= 1_000_000_000;\n }\n\n let duration = Duration::new(sec.unsigned_abs(), nanosec.unsigned_abs() as u32);\n Some(UNIX_EPOCH - duration)\n }\n else {\n let duration = Duration::new(sec as u64, nanosec as u32);\n Some(UNIX_EPOCH + duration)\n }\n }\n\n #[cfg(windows)]\n pub fn changed_time(&self) -> Option {\n return self.modified_time()\n }\n\n /// This file’s last accessed timestamp, if available on this platform.\n pub fn accessed_time(&self) -> Option {\n self.metadata.accessed().ok()\n }\n\n /// This file’s created timestamp, if available on this platform.\n pub fn created_time(&self) -> Option {\n self.metadata.created().ok()\n }\n\n /// This file’s ‘type’.\n ///\n /// This is used a the leftmost character of the permissions column.\n /// The file type can usually be guessed from the colour of the file, but\n /// ls puts this character there.\n #[cfg(unix)]\n pub fn type_char(&self) -> f::Type {\n if self.is_file() {\n f::Type::File\n }\n else if self.is_directory() {\n f::Type::Directory\n }\n else if self.is_pipe() {\n f::Type::Pipe\n }\n else if self.is_link() {\n f::Type::Link\n }\n else if self.is_char_device() {\n f::Type::CharDevice\n }\n else if self.is_block_device() {\n f::Type::BlockDevice\n }\n else if self.is_socket() {\n f::Type::Socket\n }\n else {\n f::Type::Special\n }\n }\n\n #[cfg(windows)]\n pub fn type_char(&self) -> f::Type {\n if self.is_file() {\n f::Type::File\n }\n else if self.is_directory() {\n f::Type::Directory\n }\n else {\n f::Type::Special\n }\n }\n\n /// This file’s permissions, with flags for each bit.\n #[cfg(unix)]\n pub fn permissions(&self) -> f::Permissions {\n let bits = self.metadata.mode();\n let has_bit = |bit| bits & bit == bit;\n\n f::Permissions {\n user_read: has_bit(modes::USER_READ),\n user_write: has_bit(modes::USER_WRITE),\n user_execute: has_bit(modes::USER_EXECUTE),\n\n group_read: has_bit(modes::GROUP_READ),\n group_write: has_bit(modes::GROUP_WRITE),\n group_execute: has_bit(modes::GROUP_EXECUTE),\n\n other_read: has_bit(modes::OTHER_READ),\n other_write: has_bit(modes::OTHER_WRITE),\n other_execute: has_bit(modes::OTHER_EXECUTE),\n\n sticky: has_bit(modes::STICKY),\n setgid: has_bit(modes::SETGID),\n setuid: has_bit(modes::SETUID),\n }\n }\n\n #[cfg(windows)]\n pub fn attributes(&self) -> f::Attributes {\n let bits = self.metadata.file_attributes();\n let has_bit = |bit| bits & bit == bit;\n\n // https://docs.microsoft.com/en-us/windows/win32/fileio/file-attribute-constants\n f::Attributes {\n directory: has_bit(0x10),\n archive: has_bit(0x20),\n readonly: has_bit(0x1),\n hidden: has_bit(0x2),\n system: has_bit(0x4),\n reparse_point: has_bit(0x400),\n }\n }\n\n /// Whether this file’s extension is any of the strings that get passed in.\n ///\n /// This will always return `false` if the file has no extension.\n pub fn extension_is_one_of(&self, choices: &[&str]) -> bool {\n match &self.ext {\n Some(ext) => choices.contains(&&ext[..]),\n None => false,\n }\n }\n\n /// Whether this file’s name, including extension, is any of the strings\n /// that get passed in.\n pub fn name_is_one_of(&self, choices: &[&str]) -> bool {\n choices.contains(&&self.name[..])\n }\n}\n\n\nimpl<'a> AsRef> for File<'a> {\n fn as_ref(&self) -> &File<'a> {\n self\n }\n}\n\n\n/// The result of following a symlink.\npub enum FileTarget<'dir> {\n\n /// The symlink pointed at a file that exists.\n Ok(Box>),\n\n /// The symlink pointed at a file that does not exist. Holds the path\n /// where the file would be, if it existed.\n Broken(PathBuf),\n\n /// There was an IO error when following the link. This can happen if the\n /// file isn’t a link to begin with, but also if, say, we don’t have\n /// permission to follow it.\n Err(io::Error),\n\n // Err is its own variant, instead of having the whole thing be inside an\n // `io::Result`, because being unable to follow a symlink is not a serious\n // error — we just display the error message and move on.\n}\n\nimpl<'dir> FileTarget<'dir> {\n\n /// Whether this link doesn’t lead to a file, for whatever reason. This\n /// gets used to determine how to highlight the link in grid views.\n pub fn is_broken(&self) -> bool {\n matches!(self, Self::Broken(_) | Self::Err(_))\n }\n}\n\n\n/// More readable aliases for the permission bits exposed by libc.\n#[allow(trivial_numeric_casts)]\n#[cfg(unix)]\nmod modes {\n\n // The `libc::mode_t` type’s actual type varies, but the value returned\n // from `metadata.permissions().mode()` is always `u32`.\n pub type Mode = u32;\n\n pub const USER_READ: Mode = libc::S_IRUSR as Mode;\n pub const USER_WRITE: Mode = libc::S_IWUSR as Mode;\n pub const USER_EXECUTE: Mode = libc::S_IXUSR as Mode;\n\n pub const GROUP_READ: Mode = libc::S_IRGRP as Mode;\n pub const GROUP_WRITE: Mode = libc::S_IWGRP as Mode;\n pub const GROUP_EXECUTE: Mode = libc::S_IXGRP as Mode;\n\n pub const OTHER_READ: Mode = libc::S_IROTH as Mode;\n pub const OTHER_WRITE: Mode = libc::S_IWOTH as Mode;\n pub const OTHER_EXECUTE: Mode = libc::S_IXOTH as Mode;\n\n pub const STICKY: Mode = libc::S_ISVTX as Mode;\n pub const SETGID: Mode = libc::S_ISGID as Mode;\n pub const SETUID: Mode = libc::S_ISUID as Mode;\n}\n\n\n#[cfg(test)]\nmod ext_test {\n use super::File;\n use std::path::Path;\n\n #[test]\n fn extension() {\n assert_eq!(Some(\"dat\".to_string()), File::ext(Path::new(\"fester.dat\")))\n }\n\n #[test]\n fn dotfile() {\n assert_eq!(Some(\"vimrc\".to_string()), File::ext(Path::new(\".vimrc\")))\n }\n\n #[test]\n fn no_extension() {\n assert_eq!(None, File::ext(Path::new(\"jarlsberg\")))\n }\n}\n\n\n#[cfg(test)]\nmod filename_test {\n use super::File;\n use std::path::Path;\n\n #[test]\n fn file() {\n assert_eq!(\"fester.dat\", File::filename(Path::new(\"fester.dat\")))\n }\n\n #[test]\n fn no_path() {\n assert_eq!(\"foo.wha\", File::filename(Path::new(\"/var/cache/foo.wha\")))\n }\n\n #[test]\n fn here() {\n assert_eq!(\".\", File::filename(Path::new(\".\")))\n }\n\n #[test]\n fn there() {\n assert_eq!(\"..\", File::filename(Path::new(\"..\")))\n }\n\n #[test]\n fn everywhere() {\n assert_eq!(\"..\", File::filename(Path::new(\"./..\")))\n }\n\n #[test]\n #[cfg(unix)]\n fn topmost() {\n assert_eq!(\"/\", File::filename(Path::new(\"/\")))\n }\n}\n" }, { "path": "src/fs/filter.rs", "content": "//! Filtering and sorting the list of files before displaying them.\n\nuse std::cmp::Ordering;\nuse std::iter::FromIterator;\n#[cfg(unix)]\nuse std::os::unix::fs::MetadataExt;\n\nuse crate::fs::DotFilter;\nuse crate::fs::File;\n\n\n/// The **file filter** processes a list of files before displaying them to\n/// the user, by removing files they don’t want to see, and putting the list\n/// in the desired order.\n///\n/// Usually a user does not want to see *every* file in the list. The most\n/// common case is to remove files starting with `.`, which are designated\n/// as ‘hidden’ files.\n///\n/// The special files `.` and `..` files are not actually filtered out, but\n/// need to be inserted into the list, in a special case.\n///\n/// The filter also governs sorting the list. After being filtered, pairs of\n/// files are compared and sorted based on the result, with the sort field\n/// performing the comparison.\n#[derive(PartialEq, Eq, Debug, Clone)]\npub struct FileFilter {\n\n /// Whether directories should be listed first, and other types of file\n /// second. Some users prefer it like this.\n pub list_dirs_first: bool,\n\n /// The metadata field to sort by.\n pub sort_field: SortField,\n\n /// Whether to reverse the sorting order. This would sort the largest\n /// files first, or files starting with Z, or the most-recently-changed\n /// ones, depending on the sort field.\n pub reverse: bool,\n\n /// Whether to only show directories.\n pub only_dirs: bool,\n\n /// Which invisible “dot” files to include when listing a directory.\n ///\n /// Files starting with a single “.” are used to determine “system” or\n /// “configuration” files that should not be displayed in a regular\n /// directory listing, and the directory entries “.” and “..” are\n /// considered extra-special.\n ///\n /// This came about more or less by a complete historical accident,\n /// when the original `ls` tried to hide `.` and `..`:\n ///\n /// [Linux History: How Dot Files Became Hidden Files](https://linux-audit.com/linux-history-how-dot-files-became-hidden-files/)\n pub dot_filter: DotFilter,\n\n /// Glob patterns to ignore. Any file name that matches *any* of these\n /// patterns won’t be displayed in the list.\n pub ignore_patterns: IgnorePatterns,\n\n /// Whether to ignore Git-ignored patterns.\n pub git_ignore: GitIgnore,\n}\n\nimpl FileFilter {\n /// Remove every file in the given vector that does *not* pass the\n /// filter predicate for files found inside a directory.\n pub fn filter_child_files(&self, files: &mut Vec>) {\n files.retain(|f| ! self.ignore_patterns.is_ignored(&f.name));\n\n if self.only_dirs {\n files.retain(File::is_directory);\n }\n }\n\n /// Remove every file in the given vector that does *not* pass the\n /// filter predicate for file names specified on the command-line.\n ///\n /// The rules are different for these types of files than the other\n /// type because the ignore rules can be used with globbing. For\n /// example, running `exa -I='*.tmp' .vimrc` shouldn’t filter out the\n /// dotfile, because it’s been directly specified. But running\n /// `exa -I='*.ogg' music/*` should filter out the ogg files obtained\n /// from the glob, even though the globbing is done by the shell!\n pub fn filter_argument_files(&self, files: &mut Vec>) {\n files.retain(|f| {\n ! self.ignore_patterns.is_ignored(&f.name)\n });\n }\n\n /// Sort the files in the given vector based on the sort field option.\n pub fn sort_files<'a, F>(&self, files: &mut [F])\n where F: AsRef>\n {\n files.sort_by(|a, b| {\n self.sort_field.compare_files(a.as_ref(), b.as_ref())\n });\n\n if self.reverse {\n files.reverse();\n }\n\n if self.list_dirs_first {\n // This relies on the fact that `sort_by` is *stable*: it will keep\n // adjacent elements next to each other.\n files.sort_by(|a, b| {\n b.as_ref().points_to_directory()\n .cmp(&a.as_ref().points_to_directory())\n });\n }\n }\n}\n\n\n/// User-supplied field to sort by.\n#[derive(PartialEq, Eq, Debug, Copy, Clone)]\npub enum SortField {\n\n /// Don’t apply any sorting. This is usually used as an optimisation in\n /// scripts, where the order doesn’t matter.\n Unsorted,\n\n /// The file name. This is the default sorting.\n Name(SortCase),\n\n /// The file’s extension, with extensionless files being listed first.\n Extension(SortCase),\n\n /// The file’s size, in bytes.\n Size,\n\n /// The file’s inode, which usually corresponds to the order in which\n /// files were created on the filesystem, more or less.\n #[cfg(unix)]\n FileInode,\n\n /// The time the file was modified (the “mtime”).\n ///\n /// As this is stored as a Unix timestamp, rather than a local time\n /// instance, the time zone does not matter and will only be used to\n /// display the timestamps, not compare them.\n ModifiedDate,\n\n /// The time the file was accessed (the “atime”).\n ///\n /// Oddly enough, this field rarely holds the *actual* accessed time.\n /// Recording a read time means writing to the file each time it’s read\n /// slows the whole operation down, so many systems will only update the\n /// timestamp in certain circumstances. This has become common enough that\n /// it’s now expected behaviour!\n /// \n AccessedDate,\n\n /// The time the file was changed (the “ctime”).\n ///\n /// This field is used to mark the time when a file’s metadata\n /// changed — its permissions, owners, or link count.\n ///\n /// In original Unix, this was, however, meant as creation time.\n /// \n ChangedDate,\n\n /// The time the file was created (the “btime” or “birthtime”).\n CreatedDate,\n\n /// The type of the file: directories, links, pipes, regular, files, etc.\n ///\n /// Files are ordered according to the `PartialOrd` implementation of\n /// `fs::fields::Type`, so changing that will change this.\n FileType,\n\n /// The “age” of the file, which is the time it was modified sorted\n /// backwards. The reverse of the `ModifiedDate` ordering!\n ///\n /// It turns out that listing the most-recently-modified files first is a\n /// common-enough use case that it deserves its own variant. This would be\n /// implemented by just using the modified date and setting the reverse\n /// flag, but this would make reversing *that* output not work, which is\n /// bad, even though that’s kind of nonsensical. So it’s its own variant\n /// that can be reversed like usual.\n ModifiedAge,\n\n /// The file's name, however if the name of the file begins with `.`\n /// ignore the leading `.` and then sort as Name\n NameMixHidden(SortCase),\n}\n\n/// Whether a field should be sorted case-sensitively or case-insensitively.\n/// This determines which of the `natord` functions to use.\n///\n/// I kept on forgetting which one was sensitive and which one was\n/// insensitive. Would a case-sensitive sort put capital letters first because\n/// it takes the case of the letters into account, or intermingle them with\n/// lowercase letters because it takes the difference between the two cases\n/// into account? I gave up and just named these two variants after the\n/// effects they have.\n#[derive(PartialEq, Eq, Debug, Copy, Clone)]\npub enum SortCase {\n\n /// Sort files case-sensitively with uppercase first, with ‘A’ coming\n /// before ‘a’.\n ABCabc,\n\n /// Sort files case-insensitively, with ‘A’ being equal to ‘a’.\n AaBbCc,\n}\n\nimpl SortField {\n\n /// Compares two files to determine the order they should be listed in,\n /// depending on the search field.\n ///\n /// The `natord` crate is used here to provide a more *natural* sorting\n /// order than just sorting character-by-character. This splits filenames\n /// into groups between letters and numbers, and then sorts those blocks\n /// together, so `file10` will sort after `file9`, instead of before it\n /// because of the `1`.\n pub fn compare_files(self, a: &File<'_>, b: &File<'_>) -> Ordering {\n use self::SortCase::{ABCabc, AaBbCc};\n\n match self {\n Self::Unsorted => Ordering::Equal,\n\n Self::Name(ABCabc) => natord::compare(&a.name, &b.name),\n Self::Name(AaBbCc) => natord::compare_ignore_case(&a.name, &b.name),\n\n Self::Size => a.metadata.len().cmp(&b.metadata.len()),\n #[cfg(unix)]\n Self::FileInode => a.metadata.ino().cmp(&b.metadata.ino()),\n Self::ModifiedDate => a.modified_time().cmp(&b.modified_time()),\n Self::AccessedDate => a.accessed_time().cmp(&b.accessed_time()),\n Self::ChangedDate => a.changed_time().cmp(&b.changed_time()),\n Self::CreatedDate => a.created_time().cmp(&b.created_time()),\n Self::ModifiedAge => b.modified_time().cmp(&a.modified_time()), // flip b and a\n\n Self::FileType => match a.type_char().cmp(&b.type_char()) { // todo: this recomputes\n Ordering::Equal => natord::compare(&*a.name, &*b.name),\n order => order,\n },\n\n Self::Extension(ABCabc) => match a.ext.cmp(&b.ext) {\n Ordering::Equal => natord::compare(&*a.name, &*b.name),\n order => order,\n },\n\n Self::Extension(AaBbCc) => match a.ext.cmp(&b.ext) {\n Ordering::Equal => natord::compare_ignore_case(&*a.name, &*b.name),\n order => order,\n },\n\n Self::NameMixHidden(ABCabc) => natord::compare(\n Self::strip_dot(&a.name),\n Self::strip_dot(&b.name)\n ),\n Self::NameMixHidden(AaBbCc) => natord::compare_ignore_case(\n Self::strip_dot(&a.name),\n Self::strip_dot(&b.name)\n )\n }\n }\n\n fn strip_dot(n: &str) -> &str {\n match n.strip_prefix('.') {\n Some(s) => s,\n None => n,\n }\n }\n}\n\n\n/// The **ignore patterns** are a list of globs that are tested against\n/// each filename, and if any of them match, that file isn’t displayed.\n/// This lets a user hide, say, text files by ignoring `*.txt`.\n#[derive(PartialEq, Eq, Default, Debug, Clone)]\npub struct IgnorePatterns {\n patterns: Vec,\n}\n\nimpl FromIterator for IgnorePatterns {\n\n fn from_iter(iter: I) -> Self\n where I: IntoIterator\n {\n let patterns = iter.into_iter().collect();\n Self { patterns }\n }\n}\n\nimpl IgnorePatterns {\n\n /// Create a new list from the input glob strings, turning the inputs that\n /// are valid glob patterns into an `IgnorePatterns`. The inputs that\n /// don’t parse correctly are returned separately.\n pub fn parse_from_iter<'a, I: IntoIterator>(iter: I) -> (Self, Vec) {\n let iter = iter.into_iter();\n\n // Almost all glob patterns are valid, so it’s worth pre-allocating\n // the vector with enough space for all of them.\n let mut patterns = match iter.size_hint() {\n (_, Some(count)) => Vec::with_capacity(count),\n _ => Vec::new(),\n };\n\n // Similarly, assume there won’t be any errors.\n let mut errors = Vec::new();\n\n for input in iter {\n match glob::Pattern::new(input) {\n Ok(pat) => patterns.push(pat),\n Err(e) => errors.push(e),\n }\n }\n\n (Self { patterns }, errors)\n }\n\n /// Create a new empty set of patterns that matches nothing.\n pub fn empty() -> Self {\n Self { patterns: Vec::new() }\n }\n\n /// Test whether the given file should be hidden from the results.\n fn is_ignored(&self, file: &str) -> bool {\n self.patterns.iter().any(|p| p.matches(file))\n }\n}\n\n\n/// Whether to ignore or display files that Git would ignore.\n#[derive(PartialEq, Eq, Debug, Copy, Clone)]\npub enum GitIgnore {\n\n /// Ignore files that Git would ignore.\n CheckAndIgnore,\n\n /// Display files, even if Git would ignore them.\n Off,\n}\n\n\n\n#[cfg(test)]\nmod test_ignores {\n use super::*;\n\n #[test]\n fn empty_matches_nothing() {\n let pats = IgnorePatterns::empty();\n assert!(!pats.is_ignored(\"nothing\"));\n assert!(!pats.is_ignored(\"test.mp3\"));\n }\n\n #[test]\n fn ignores_a_glob() {\n let (pats, fails) = IgnorePatterns::parse_from_iter(vec![ \"*.mp3\" ]);\n assert!(fails.is_empty());\n assert!(!pats.is_ignored(\"nothing\"));\n assert!(pats.is_ignored(\"test.mp3\"));\n }\n\n #[test]\n fn ignores_an_exact_filename() {\n let (pats, fails) = IgnorePatterns::parse_from_iter(vec![ \"nothing\" ]);\n assert!(fails.is_empty());\n assert!(pats.is_ignored(\"nothing\"));\n assert!(!pats.is_ignored(\"test.mp3\"));\n }\n\n #[test]\n fn ignores_both() {\n let (pats, fails) = IgnorePatterns::parse_from_iter(vec![ \"nothing\", \"*.mp3\" ]);\n assert!(fails.is_empty());\n assert!(pats.is_ignored(\"nothing\"));\n assert!(pats.is_ignored(\"test.mp3\"));\n }\n}\n" }, { "path": "src/fs/mod.rs", "content": "mod dir;\npub use self::dir::{Dir, DotFilter};\n\nmod file;\npub use self::file::{File, FileTarget};\n\npub mod dir_action;\npub mod feature;\npub mod fields;\npub mod filter;\n" }, { "path": "src/info/filetype.rs", "content": "//! Tests for various types of file (video, image, compressed, etc).\n//!\n//! Currently this is dependent on the file’s name and extension, because\n//! those are the only metadata that we have access to without reading the\n//! file’s contents.\n\nuse ansi_term::Style;\n\nuse crate::fs::File;\nuse crate::output::icons::FileIcon;\nuse crate::theme::FileColours;\n\n\n#[derive(Debug, Default, PartialEq, Eq)]\npub struct FileExtensions;\n\nimpl FileExtensions {\n\n /// An “immediate” file is something that can be run or activated somehow\n /// in order to kick off the build of a project. It’s usually only present\n /// in directories full of source code.\n #[allow(clippy::case_sensitive_file_extension_comparisons)]\n fn is_immediate(&self, file: &File<'_>) -> bool {\n file.name.to_lowercase().starts_with(\"readme\") ||\n file.name.ends_with(\".ninja\") ||\n file.name_is_one_of( &[\n \"Makefile\", \"Cargo.toml\", \"SConstruct\", \"CMakeLists.txt\",\n \"build.gradle\", \"pom.xml\", \"Rakefile\", \"package.json\", \"Gruntfile.js\",\n \"Gruntfile.coffee\", \"BUILD\", \"BUILD.bazel\", \"WORKSPACE\", \"build.xml\", \"Podfile\",\n \"webpack.config.js\", \"meson.build\", \"composer.json\", \"RoboFile.php\", \"PKGBUILD\",\n \"Justfile\", \"Procfile\", \"Dockerfile\", \"Containerfile\", \"Vagrantfile\", \"Brewfile\",\n \"Gemfile\", \"Pipfile\", \"build.sbt\", \"mix.exs\", \"bsconfig.json\", \"tsconfig.json\",\n ])\n }\n\n fn is_image(&self, file: &File<'_>) -> bool {\n file.extension_is_one_of( &[\n \"png\", \"jfi\", \"jfif\", \"jif\", \"jpe\", \"jpeg\", \"jpg\", \"gif\", \"bmp\",\n \"tiff\", \"tif\", \"ppm\", \"pgm\", \"pbm\", \"pnm\", \"webp\", \"raw\", \"arw\",\n \"svg\", \"stl\", \"eps\", \"dvi\", \"ps\", \"cbr\", \"jpf\", \"cbz\", \"xpm\",\n \"ico\", \"cr2\", \"orf\", \"nef\", \"heif\", \"avif\", \"jxl\", \"j2k\", \"jp2\",\n \"j2c\", \"jpx\",\n ])\n }\n\n fn is_video(&self, file: &File<'_>) -> bool {\n file.extension_is_one_of( &[\n \"avi\", \"flv\", \"m2v\", \"m4v\", \"mkv\", \"mov\", \"mp4\", \"mpeg\",\n \"mpg\", \"ogm\", \"ogv\", \"vob\", \"wmv\", \"webm\", \"m2ts\", \"heic\",\n ])\n }\n\n fn is_music(&self, file: &File<'_>) -> bool {\n file.extension_is_one_of( &[\n \"aac\", \"m4a\", \"mp3\", \"ogg\", \"wma\", \"mka\", \"opus\",\n ])\n }\n\n // Lossless music, rather than any other kind of data...\n fn is_lossless(&self, file: &File<'_>) -> bool {\n file.extension_is_one_of( &[\n \"alac\", \"ape\", \"flac\", \"wav\",\n ])\n }\n\n fn is_crypto(&self, file: &File<'_>) -> bool {\n file.extension_is_one_of( &[\n \"asc\", \"enc\", \"gpg\", \"pgp\", \"sig\", \"signature\", \"pfx\", \"p12\",\n ])\n }\n\n fn is_document(&self, file: &File<'_>) -> bool {\n file.extension_is_one_of( &[\n \"djvu\", \"doc\", \"docx\", \"dvi\", \"eml\", \"eps\", \"fotd\", \"key\",\n \"keynote\", \"numbers\", \"odp\", \"odt\", \"pages\", \"pdf\", \"ppt\",\n \"pptx\", \"rtf\", \"xls\", \"xlsx\",\n ])\n }\n\n fn is_compressed(&self, file: &File<'_>) -> bool {\n file.extension_is_one_of( &[\n \"zip\", \"tar\", \"Z\", \"z\", \"gz\", \"bz2\", \"a\", \"ar\", \"7z\",\n \"iso\", \"dmg\", \"tc\", \"rar\", \"par\", \"tgz\", \"xz\", \"txz\",\n \"lz\", \"tlz\", \"lzma\", \"deb\", \"rpm\", \"zst\", \"lz4\", \"cpio\",\n ])\n }\n\n fn is_temp(&self, file: &File<'_>) -> bool {\n file.name.ends_with('~')\n || (file.name.starts_with('#') && file.name.ends_with('#'))\n || file.extension_is_one_of( &[ \"tmp\", \"swp\", \"swo\", \"swn\", \"bak\", \"bkp\", \"bk\" ])\n }\n\n fn is_compiled(&self, file: &File<'_>) -> bool {\n if file.extension_is_one_of( &[ \"class\", \"elc\", \"hi\", \"o\", \"pyc\", \"zwc\", \"ko\" ]) {\n true\n }\n else if let Some(dir) = file.parent_dir {\n file.get_source_files().iter().any(|path| dir.contains(path))\n }\n else {\n false\n }\n }\n}\n\nimpl FileColours for FileExtensions {\n fn colour_file(&self, file: &File<'_>) -> Option