Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/aprilandjan/vscode-ascii-tree-generator
Generate ASCII tree of directories or format selected text into its corresponding "tree string" representation.
https://github.com/aprilandjan/vscode-ascii-tree-generator
ascii-tree ascii-tree-generator extension tree-strings vscode
Last synced: 9 days ago
JSON representation
Generate ASCII tree of directories or format selected text into its corresponding "tree string" representation.
- Host: GitHub
- URL: https://github.com/aprilandjan/vscode-ascii-tree-generator
- Owner: aprilandjan
- License: mit
- Created: 2019-01-04T11:52:37.000Z (almost 6 years ago)
- Default Branch: master
- Last Pushed: 2023-03-04T04:10:26.000Z (over 1 year ago)
- Last Synced: 2024-08-01T19:55:05.861Z (3 months ago)
- Topics: ascii-tree, ascii-tree-generator, extension, tree-strings, vscode
- Language: TypeScript
- Homepage:
- Size: 10.5 MB
- Stars: 71
- Watchers: 3
- Forks: 8
- Open Issues: 6
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
- my-awesome-list - vscode-ascii-tree-generator
README
# [VSCode ASCII Tree Generator](https://marketplace.visualstudio.com/items?itemName=aprilandjan.ascii-tree-generator)
[](https://dev.azure.com/merlinye/ascii-tree-generator/_build/latest?definitionId=1?branchName=master)
[](https://marketplace.visualstudio.com/items?itemName=aprilandjan.ascii-tree-generator)
[](https://marketplace.visualstudio.com/items?itemName=aprilandjan.ascii-tree-generator)
Generate ASCII tree of directories or format selected text into its corresponding "tree string" representation.
## Usage
Generate ASCII "tree strings" for any directory in the workspace explorer. Aside from that, you can also select pre-formatted text in the explorer and format it to its corresponding "tree string" easily.
### Format Selected Text to Tree String
Using the `#` (octothorpe/hash) character, you can specify the depth of the current element. After writing a few lines (see example below), select the targetted pre-formatted lines, right-click on the highlighted text selection, and click `Format to Tree String` menu option. This will replace the selected, pre-formatted text, into its corresponding "tree string" representation.
For clarity, each line of your target tree structure should begin with at least a single `#` (octothorpe/hash) character. At most, each line can only have one more additional `#` than any line above it. This will ensure proper formatting. By placing multiple `#` symbols, it is possible to designate the depth of a certain element.
#### Demonstration
**Pre-Formatted Tree String**
```txt
# public
# dist
## index.d.ts
## index.js
# src
## index.ts
```
**Formatted Tree String**
```txt
.
├── public
├── dist
│ ├── index.d.ts
│ └── index.js
└── src
└── index.ts
```
#### Addendum
In cases where you would like to undo the formatting operation, simply use VSCode's editor `undo` option (`Edit`→`Undo`). You can optionally use the keybindings for undo as well (⌘+Z on Mac or CTRL+Z on Windows). However, this option will fail in cases where the `undo` operation is invalid (e.g. text inside downloaded materials).
In all cases, you can revert formatting tree strings back to their preformatted versions by selecting the formatted tree string, heading to the VSCode Command Pallete (⌘+SHIFT+P on Mac or CTRL+SHIFT+P on Windows), and executing `Revert Tree String to Text`. As long as the matching lines up, this should provide back your intended pre-formatted tree string.
### Generate Tree String for Directory
In addition to being able to format pre-formatted tree strings, you may also generate tree strings for directories inside your current workspace (directories appearing in `Explorer` tab). To do so, right-click on any directory, or empty space, within the `Explorer` tab and select the `Generate Tree String for Directory` menu option. An example is shown below.
#### Addendum
The walking process through files is performed asynchronously. Therefore, selecting heavily-nested folders (e.g. `node_modules`) will directly affect performance speed.
By default, `node_modules` and `.git` are ignored while generating tree string for directories. However, this can be customized by setting `asciiTreeGenerator.directoryIgnore` in configurations. Also, setting `asciiTreeGenerator.directoryMaxDepth` can limit the depth of directory walking-through.
## Configuration
Each tree string character can be defined by its ASCII code representation (UTF character code, more generally). As such, the theorectical range for character codes is `0` to `65535` (two bytes). However, and important to note, is that not every character code is printable and/or may cause formatting issues.
The available parameters are:
| Property (Setting) Name | Default Character Code | Default Character | Description |
| ---------------------------------- | :--------------------: | :----------------: | ---------------------------- |
| `asciiTreeGenerator.rootElement` | `46` | . | For root elements |
| `asciiTreeGenerator.parentElement` | `9474` | │ | For vertical parent elements |
| `asciiTreeGenerator.childElement` | `9500` | ├ | For child elements |
| `asciiTreeGenerator.lastElement` | `9492` | └ | For last elements of paths |
| `asciiTreeGenerator.dashElement` | `9472` | ─ | For horizontal dash elements |
| `asciiTreeGenerator.blankElement` | `32` | | For blank / space elements |
### Sample Configurations
Commonly used configurations that you can manually enable by entering the values for each of the aforementioned property names above (perfom these changes inside a `settings.json` file).
| Configuration | Root | Parent | Child | Last | Dash | Blank |
| :---------------: | :-----------------------: | :-----------------------: | :-----------------------: | :-----------------------: | :-----------------------: | :-------------------: |
| Default | `46` . | `9474` │ | `9500` ├ | `9492` └ | `9472` ─ | `32` |
| Double Line | `9559` ╗ | `9553` ║ | `9568` ╠ | `9562` ╚ | `9552` ═ | `32` |
| Classic | `43` + | `124` | | `124` | | `43` + | `45` - | `32` |
| Classic Rounded | `43` + | `124` | | `124` | | `96` ` | `45` - | `32` |
| Exclamation Marks | `35` # | `33` ! | `35` # | `42` * | `61` = | `32` |
## Issues and Contribution
Please feel free to submit any issues or bugs you find with the extension. More generally, please reach out if you have any questions on how to use the extension.
Finally, contribution or ideas are humbly welcomed so please check us out on GitHub :) !