ramus
A cross-platform tree/find-style CLI for exploring directory structures.
pip install ramus
Why
Windows' built-in tree command only supports /F (list files) and /A (ASCII characters) — no depth limit, no filtering, nothing else. Linux's tree/find cover that gap; ramus brings the same behavior to a pip install-able package.
$ ramus
.
├── README.md
├── src
│ ├── app.py
│ └── app.pyc
└── tests
└── test_app.py
2 directories, 4 files
Usage
$ ramus -I "*.pyc"
.
├── README.md
├── src
│ └── app.py
└── tests
└── test_app.py
2 directories, 3 files
| Flag | ||
|---|---|---|
-L N |
--level |
Limit recursion to N levels |
-I PATTERN |
--exclude |
Exclude entries matching a glob pattern (repeatable) |
-P PATTERN |
--pattern |
Include only entries matching a glob pattern (directories are always shown so matching descendants stay reachable) |
-a |
--all |
Include hidden files and directories |
-d |
--dirs-only |
List directories only |
-f |
--full-path |
Print each entry's full path instead of just its name |
Symlinked directories are listed but not followed. Plain text output, no color.
Development
uv sync --dev
uv run pytest
uv run ruff format .
uv run ruff check .
uv run mypy .
Releases (versioning, changelog, and PyPI publish) are automated via release-please in CD.
License
Licensed under the MIT License.
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file ramus-1.0.0.tar.gz.
File metadata
- Download URL: ramus-1.0.0.tar.gz
- Upload date:
- Size: 37.2 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
uv/0.12.10 {"installer":{"name":"uv","version":"0.12.10","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
4f6ca1f9232f0c8142d346839553ab5a04e497dde8776b823d78ab0c6b6b8c55
|
|
| MD5 |
48241a4b6f496e740e22ebe3173d9113
|
|
| BLAKE2b-256 |
02eaef3cb093b526a5a652e8bb433318623f7c505e56b8d93a420152890cd157
|
File details
Details for the file ramus-1.0.0-py3-none-any.whl.
File metadata
- Download URL: ramus-1.0.0-py3-none-any.whl
- Upload date:
- Size: 6.0 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
uv/0.12.10 {"installer":{"name":"uv","version":"0.12.10","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
3414c8a93c00020d55cfbd28a5e355033f8d61b141a6871a38702068328f6d56
|
|
| MD5 |
fc1bd68df46e9c8b7512cd46ea02416d
|
|
| BLAKE2b-256 |
159a7c0d59522d4a64e11936f2189314c5c2b9e71c1354cb5f1be8e2961a1067
|
