rovr


Namerovr JSON
Version 0.3.0 PyPI version JSON
download
home_pageNone
SummaryA post-modern terminal file explorer
upload_time2025-09-07 01:40:38
maintainerNone
docs_urlNone
authorNSPC911
requires_python>=3.13
licenseMIT
keywords filemanager fs python textual tui
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            <div align="center">
  <h1>rovr</h1>
  <img alt="Python Version" src="https://img.shields.io/pypi/pyversions/rovr?style=for-the-badge&logo=python&logoColor=white&color=yellow">
  <img alt="Made with Textual" src="https://img.shields.io/badge/made_with-textual-0b171d?style=for-the-badge&logoColor=white">
  <!--python -c "import toml;print(len(toml.load('uv.lock')['package']))"-->
  <img alt="Dependencies" src="https://img.shields.io/badge/Dependencies-85-purple?style=for-the-badge">
  <br>
  <a href="https://nspc911.github.io/discord"><img alt="Discord" src="https://img.shields.io/discord/1110189201313513552?style=for-the-badge&logo=discord&logoColor=white&color=%235865f2"></a>
  <img alt="PyPI - Downloads" src="https://img.shields.io/pypi/dw/rovr?style=for-the-badge&logo=pypi&logoColor=white&color=darkgreen">
  <br>
  <img alt="GitHub Actions Docs Build Status" src="https://img.shields.io/github/actions/workflow/status/nspc911/rovr/.github%2Fworkflows%2Fdeploy.yml?style=for-the-badge&label=docs">
  <img alt="GitHub Actions Formatting Status" src="https://img.shields.io/github/actions/workflow/status/nspc911/rovr/.github%2Fworkflows%2Fformatting.yml?style=for-the-badge&label=style">
</div>

> [!warning]
> This project is in its very early stages. While this can be daily driven, expect some issues here and there.

<!--toc:start-->

- [Screenshot](#screenshot)
- [Installation](#installation)
- [Running from source](#running-from-source)
- [FAQ](#faq)
- [Stargazers](#stargazers)
<!--toc:end-->

### Screenshot

![image](https://github.com/NSPC911/rovr/blob/master/img%2F0.1.0%2Frovr_main.png?raw=true)

### Installation

```pwsh
# Test the main branch
uvx git+https://github.com/NSPC911/rovr.git
# Install
## uv (my fav)
uv tool install rovr
## or pipx
pipx install rovr
## or plain old pip
pip install rovr
```

### Running from source

```pwsh
uv run poe run
```

Running in dev mode to see debug outputs and logs
```pwsh
# Runs it in development mode, allowing a connected console
# to capture the output of its print statements
uv run poe dev
# Runs a separate console to capture print statements
uv run poe log
# capture everything
uv run textual console
```
For more info on Textual's console, refer to https://textual.textualize.io/guide/devtools/#console

### FAQ

1. There isn't X theme/Why isn't Y theme available?

- Textual's currently available themes are limited. However, extra themes can be added via the config file in the format below
- You can take a look at what each color represents in https://textual.textualize.io/guide/design/#base-colors<br>Inheriting themes will **not** be added.

```toml
[[custom_theme]]
name = "<str>"
primary = "<hex>"
secondary = "<hex>"
success = "<hex>"
warning = "<hex>"
error = "<hex>"
accent = "<hex>"
foreground = "<hex>"
background = "<hex>"
surface = "<hex>"
panel = "<hex>"
is_dark = "<bool>"
variables = {
  "<key>" = "<value>"
}
```

2. Why is it considered post-modern?

- Parody to my current editor, [helix](https://helix-editor.com)
  - If neovim is considered modern, then helix is post-modern
  - If superfile is considered modern, then rovr is post-modern

3. What can I contribute?

- Themes, and features can be contributed.
- Refactors will be frowned on, and may take a longer time before merging.

4. I want to add a feature/theme/etc! How do I do so?

- You need [uv](https://docs.astral.sh/uv) at minimum. [pre-commit](https://pre-commit.com/) and [ruff](https://docs.astral.sh/ruff) are recommended to be installed.
- Clone the repo, and inside it, run `uv sync` and `pre-commit install`.
- Make your changes, ensure that your changes are properly formatted (via the pre-commit hook), before pushing to a **custom** branch on your fork.
- For more info, check the [how to contribute](https://nspc911.github.io/rovr/contributing/how-to-contribute) page.

5. How do I make a feature suggestion?

- Open an issue using the `feature-request` tag, with an estimated difficulty as an optional difficulty level label

6. Why not ratatui or bubbletea??? <sub><i>angry noises</i></sub>

- I like python.


### Stargazers
Thank you so much for starring this repo! Each star pushes me more to make even more amazing features for you!
<a href="https://www.star-history.com/#nspc911/rovr&Date">
 <picture>
   <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=nspc911/rovr&type=Date&theme=dark" />
   <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=nspc911/rovr&type=Date" />
   <img alt="Star History Chart" src="https://api.star-history.com/svg?repos=nspc911/rovr&type=Date" />
 </picture>
</a>

```
 _ ___  ___ __   _ˍ_ ___
/\`'__\/ __`\ \ /\ \`'__\
\ \ \_/\ \_\ \ V_/ /\ \_/
 \ \_\\ \____/\___/\ \_\
  \/_/ \/___/\/__/  \/_/ by NSPC911
```

            

Raw data

            {
    "_id": null,
    "home_page": null,
    "name": "rovr",
    "maintainer": null,
    "docs_url": null,
    "requires_python": ">=3.13",
    "maintainer_email": null,
    "keywords": "filemanager, fs, python, textual, tui",
    "author": "NSPC911",
    "author_email": null,
    "download_url": "https://files.pythonhosted.org/packages/67/ff/af4c907cc5d458c4f390ca3c77fd0a53819be3eccaccacabe7b16cbe05b6/rovr-0.3.0.tar.gz",
    "platform": null,
    "description": "<div align=\"center\">\n  <h1>rovr</h1>\n  <img alt=\"Python Version\" src=\"https://img.shields.io/pypi/pyversions/rovr?style=for-the-badge&logo=python&logoColor=white&color=yellow\">\n  <img alt=\"Made with Textual\" src=\"https://img.shields.io/badge/made_with-textual-0b171d?style=for-the-badge&logoColor=white\">\n  <!--python -c \"import toml;print(len(toml.load('uv.lock')['package']))\"-->\n  <img alt=\"Dependencies\" src=\"https://img.shields.io/badge/Dependencies-85-purple?style=for-the-badge\">\n  <br>\n  <a href=\"https://nspc911.github.io/discord\"><img alt=\"Discord\" src=\"https://img.shields.io/discord/1110189201313513552?style=for-the-badge&logo=discord&logoColor=white&color=%235865f2\"></a>\n  <img alt=\"PyPI - Downloads\" src=\"https://img.shields.io/pypi/dw/rovr?style=for-the-badge&logo=pypi&logoColor=white&color=darkgreen\">\n  <br>\n  <img alt=\"GitHub Actions Docs Build Status\" src=\"https://img.shields.io/github/actions/workflow/status/nspc911/rovr/.github%2Fworkflows%2Fdeploy.yml?style=for-the-badge&label=docs\">\n  <img alt=\"GitHub Actions Formatting Status\" src=\"https://img.shields.io/github/actions/workflow/status/nspc911/rovr/.github%2Fworkflows%2Fformatting.yml?style=for-the-badge&label=style\">\n</div>\n\n> [!warning]\n> This project is in its very early stages. While this can be daily driven, expect some issues here and there.\n\n<!--toc:start-->\n\n- [Screenshot](#screenshot)\n- [Installation](#installation)\n- [Running from source](#running-from-source)\n- [FAQ](#faq)\n- [Stargazers](#stargazers)\n<!--toc:end-->\n\n### Screenshot\n\n![image](https://github.com/NSPC911/rovr/blob/master/img%2F0.1.0%2Frovr_main.png?raw=true)\n\n### Installation\n\n```pwsh\n# Test the main branch\nuvx git+https://github.com/NSPC911/rovr.git\n# Install\n## uv (my fav)\nuv tool install rovr\n## or pipx\npipx install rovr\n## or plain old pip\npip install rovr\n```\n\n### Running from source\n\n```pwsh\nuv run poe run\n```\n\nRunning in dev mode to see debug outputs and logs\n```pwsh\n# Runs it in development mode, allowing a connected console\n# to capture the output of its print statements\nuv run poe dev\n# Runs a separate console to capture print statements\nuv run poe log\n# capture everything\nuv run textual console\n```\nFor more info on Textual's console, refer to https://textual.textualize.io/guide/devtools/#console\n\n### FAQ\n\n1. There isn't X theme/Why isn't Y theme available?\n\n- Textual's currently available themes are limited. However, extra themes can be added via the config file in the format below\n- You can take a look at what each color represents in https://textual.textualize.io/guide/design/#base-colors<br>Inheriting themes will **not** be added.\n\n```toml\n[[custom_theme]]\nname = \"<str>\"\nprimary = \"<hex>\"\nsecondary = \"<hex>\"\nsuccess = \"<hex>\"\nwarning = \"<hex>\"\nerror = \"<hex>\"\naccent = \"<hex>\"\nforeground = \"<hex>\"\nbackground = \"<hex>\"\nsurface = \"<hex>\"\npanel = \"<hex>\"\nis_dark = \"<bool>\"\nvariables = {\n  \"<key>\" = \"<value>\"\n}\n```\n\n2. Why is it considered post-modern?\n\n- Parody to my current editor, [helix](https://helix-editor.com)\n  - If neovim is considered modern, then helix is post-modern\n  - If superfile is considered modern, then rovr is post-modern\n\n3. What can I contribute?\n\n- Themes, and features can be contributed.\n- Refactors will be frowned on, and may take a longer time before merging.\n\n4. I want to add a feature/theme/etc! How do I do so?\n\n- You need [uv](https://docs.astral.sh/uv) at minimum. [pre-commit](https://pre-commit.com/) and [ruff](https://docs.astral.sh/ruff) are recommended to be installed.\n- Clone the repo, and inside it, run `uv sync` and `pre-commit install`.\n- Make your changes, ensure that your changes are properly formatted (via the pre-commit hook), before pushing to a **custom** branch on your fork.\n- For more info, check the [how to contribute](https://nspc911.github.io/rovr/contributing/how-to-contribute) page.\n\n5. How do I make a feature suggestion?\n\n- Open an issue using the `feature-request` tag, with an estimated difficulty as an optional difficulty level label\n\n6. Why not ratatui or bubbletea??? <sub><i>angry noises</i></sub>\n\n- I like python.\n\n\n### Stargazers\nThank you so much for starring this repo! Each star pushes me more to make even more amazing features for you!\n<a href=\"https://www.star-history.com/#nspc911/rovr&Date\">\n <picture>\n   <source media=\"(prefers-color-scheme: dark)\" srcset=\"https://api.star-history.com/svg?repos=nspc911/rovr&type=Date&theme=dark\" />\n   <source media=\"(prefers-color-scheme: light)\" srcset=\"https://api.star-history.com/svg?repos=nspc911/rovr&type=Date\" />\n   <img alt=\"Star History Chart\" src=\"https://api.star-history.com/svg?repos=nspc911/rovr&type=Date\" />\n </picture>\n</a>\n\n```\n _ ___  ___ __   _\u02cd_ ___\n/\\`'__\\/ __`\\ \\ /\\ \\`'__\\\n\\ \\ \\_/\\ \\_\\ \\ V_/ /\\ \\_/\n \\ \\_\\\\ \\____/\\___/\\ \\_\\\n  \\/_/ \\/___/\\/__/  \\/_/ by NSPC911\n```\n",
    "bugtrack_url": null,
    "license": "MIT",
    "summary": "A post-modern terminal file explorer",
    "version": "0.3.0",
    "project_urls": {
        "Documentation": "https://nspc911.github.io/rovr",
        "Issues": "https://github.com/NSPC911/rovr/issues",
        "Source": "https://github.com/NSPC911/rovr"
    },
    "split_keywords": [
        "filemanager",
        " fs",
        " python",
        " textual",
        " tui"
    ],
    "urls": [
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "d6b8454e86252eb25ef708beb8a07f6bf2e6e1dc41fc5210c6e103f1697f9775",
                "md5": "26a3d89bf56a309a44f68c5d8cf2f21f",
                "sha256": "1d60e194c67a9e46722a5adf975242ad47e240de59eb63539f0fb9bf618c5d26"
            },
            "downloads": -1,
            "filename": "rovr-0.3.0-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "26a3d89bf56a309a44f68c5d8cf2f21f",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.13",
            "size": 92428,
            "upload_time": "2025-09-07T01:40:35",
            "upload_time_iso_8601": "2025-09-07T01:40:35.310428Z",
            "url": "https://files.pythonhosted.org/packages/d6/b8/454e86252eb25ef708beb8a07f6bf2e6e1dc41fc5210c6e103f1697f9775/rovr-0.3.0-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "67ffaf4c907cc5d458c4f390ca3c77fd0a53819be3eccaccacabe7b16cbe05b6",
                "md5": "81b0460452e16d83f6934053b23c36f9",
                "sha256": "d85ab4a4f384143ae5f59551cbd0a59827d545bc3384f3fa9f6205d1bba50dbd"
            },
            "downloads": -1,
            "filename": "rovr-0.3.0.tar.gz",
            "has_sig": false,
            "md5_digest": "81b0460452e16d83f6934053b23c36f9",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.13",
            "size": 4613024,
            "upload_time": "2025-09-07T01:40:38",
            "upload_time_iso_8601": "2025-09-07T01:40:38.456585Z",
            "url": "https://files.pythonhosted.org/packages/67/ff/af4c907cc5d458c4f390ca3c77fd0a53819be3eccaccacabe7b16cbe05b6/rovr-0.3.0.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2025-09-07 01:40:38",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "NSPC911",
    "github_project": "rovr",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": true,
    "requirements": [],
    "lcname": "rovr"
}
        
Elapsed time: 0.44113s