https://github.com/artrz/vsc-unix-file-stats

https://github.com/artrz/vsc-unix-file-stats

Last synced: 4 months ago
JSON representation

• Host: GitHub
• URL: https://github.com/artrz/vsc-unix-file-stats
• Owner: artrz
• License: gpl-3.0
• Created: 2023-11-12T06:04:02.000Z (over 1 year ago)
• Default Branch: main
• Last Pushed: 2025-01-20T18:02:57.000Z (6 months ago)
• Last Synced: 2025-01-29T04:45:02.261Z (6 months ago)
• Language: TypeScript
• Size: 789 KB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 2
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • License: LICENSE.md

Awesome Lists containing this project

README

        
# unix-file-stats

Add file stats information in your editor status bar in Unix and Unix-like operating systems (tested on macOS Sonoma & Debian Sid).

## Features

 - Shows file permissions (file mode)

 - Shows file size

 - Allow to change file permissions (with sudo retry support)

After installing, the file size and permissions for the current file will appear as a new statusbar item ![Preview](resources/stats_1.png). If file is readonly, the item background will change ![Preview](resources/stats_2.png).

You can change the file permissions by clicking on the status item.

![Preview](resources/change_prompt.png)

It's also possible to change the file permissions from the explorer tree by clicking in the added menu item 'Change file permissions'. This function supports multiple files. Directories are ignored.

![Preview](resources/explorer_item.png)

If changing permissions require superuser privileges, it's possible to try again with sudo.

![Preview](resources/sudo_retry.png)

![Preview](resources/sudo_prompt.png)

## Extension Settings

This extension contributes the following settings:

* `fileStats.size.enabled`:             Displays the file size on the status bar.

* `fileStats.size.position`:            Sets the position (left or right) of the file size status item.

* `fileStats.size.priority`:            A higher number means nearer to the left.

* `fileStats.permissions.enabled`:      Displays the file permissions on the status bar.

* `fileStats.permissions.position`:     Sets the position (left or right) of the file permissions status item.

* `fileStats.permissions.priority`:     A higher number means nearer to the left.

* `fileStats.permissions.format`:       Sets the permissions format (numeric or letters/-).

* `fileStats.permissions.warnReadonly`: Shows the permissions menu item with a warning background when file in not writeable.

* `fileStats.hints.basenameOnly`:       Displays only the resource's basename when requesting the permissions.

* `fileStats.hints.maxNames`:           The maximum names to display when requesting the permissions. If more items than this value are selected, they will appear as ' and X more'

## Release Notes

See the [changelog](./CHANGELOG.md).

## Contributing

First of, thanks for your interest in helping out!

This repository uses ESLint and [Stylistic](https://eslint.style/) to ensure the code quality. Lefthook is configured to automatically perform tasks on pre-commit and pre-push hooks. Execute `npm run prepare` to install the git hooks in your cloned repo. [Commitlint](https://commitlint.js.org/) is integrated as a github workflow to ensure consistent commit messages on PRs.

### Pre-commit

Before committing, eslint will run on staged files. If everything is ok, the commit messages will be linted too using the default conventional configuration. See [commitlint.config.mjs](./commitlint.config.mjs) for a cheat sheet on how to use the types or [https://cheatsheets.zip/conventional-commits](https://cheatsheets.zip/conventional-commits) for a detailed explanation.

### Pre-push

Before pushing, a package audit is going to be performed to verify there are no risky packages as dependencies.

## License

See the [license](./LICENSE.md).