Table of Contents

Acknowledgments

Thanks for providing very useful CLI for cloud storage tree output🤩🎉

⭐orangekame3/stree

⭐owlinux1000/gcstree

gtree packeage has been utilized for other tools as well🚀

Web

$gtree web

CLI

Installation

etc

Usage

$gtree --helpNAME:   gtree - This CLI uses Markdown to generate directory trees and directories itself, and also verifies directories.           The symbols that can be used in Markdown are '-', '+', '*', and '#'.           Within Markdown, indentation represents hierarchy. The indentation can be whatever you specify, but use the same pattern.USAGE:   gtree [global options] command [command options] [arguments...]VERSION:   1.10.2 / revision 85520a1COMMANDS:   output, o, out     Outputs tree from markdown.                      Let's try 'gtree template | gtree output'.   mkdir, m           Makes directories and files from markdown. It is possible to dry run.                      Let's try 'gtree template | gtree mkdir -e .go -e .md -e Makefile'.   verify, vf         Verifies tree structure represented in markdown by comparing it with existing directories.                      Let's try 'gtree template | gtree verify'.   template, t, tmpl  Outputs markdown template. Use it to try out gtree CLI.   web, w, www        Opens "Tree Maker" in your browser and shows the URL in terminal.   version, v         Prints the version.   help, h            Shows a list of commands or help for one commandGLOBAL OPTIONS:   --help, -h     show help   --version, -v  print the version

Output subcommand

$gtree output --helpNAME:   gtree output - Outputs tree from markdown.                  Let's try 'gtree template | gtree output'.USAGE:   gtree output [command options] [arguments...]OPTIONS:   --file value, -f value               specify the path to markdown file. (default: stdin)   --massive, -m                        set this option when there are very many blocks of markdown. (default: false)   --massive-timeout value, --mt value  set this option if you want to set a timeout. (default: 0s)   --format value                       set this option when specifying output format. "json", "yaml", "toml"   --watch, -w                          follow changes in markdown file. (default: false)   --help, -h                           show help

Try it!

$gtree template- gtree        - cmd                - gtree                        - main.go        - testdata                - sample1.md                - sample2.md        - Makefile        - tree.go$gtree template| gtree outputgtree├── cmd│   └── gtree│       └── main.go├── testdata│   ├── sample1.md│   └── sample2.md├── Makefile└── tree.go

├── gtree output -f testdata/sample1.md├── cat testdata/sample1.md | gtree output -f -└── cat testdata/sample1.md | gtree output

Usage other than representing a directory.

$cat testdata/sample2.md| gtree outputk8s_resources├── (Tier3)│   └── (Tier2)│       └── (Tier1)│           └── (Tier0)├── Deployment│   └── ReplicaSet│       └── Pod│           └── container(s)├── CronJob│   └── Job│       └── Pod│           └── container(s)└── (empty)    ├── DaemonSet    │   └── Pod    │       └── container(s)    └── StatefulSet        └── Pod            └── container(s)

Multiple roots

$cat testdata/sample6.md| gtree outputArtiodactyla├── Artiofabula│   ├── Cetruminantia│   │   ├── Whippomorpha│   │   │   ├── Hippopotamidae│   │   │   └── Cetacea│   │   └── Ruminantia│   └── Suina└── TylopodaCarnivora├── Feliformia└── Caniformia    ├── Canidae    └── Arctoidea        ├── Ursidae        └── x            ├── Pinnipedia            └── Musteloidea                ├── Ailuridae                └── x                    ├── Mephitidae                    └── x                        ├── Procyonidae                        └── Mustelidae

Output JSON

Output YAML

Output TOML

Mkdir subcommand

$gtree mkdir --helpNAME:   gtree mkdir - Makes directories and files from markdown. It is possible to dry run.                 Let's try 'gtree template | gtree mkdir -e .go -e .md -e Makefile'.USAGE:   gtree mkdir [command options] [arguments...]OPTIONS:   --file value, -f value                                       specify the path to markdown file. (default: stdin)   --dry-run, -d                                                dry run. detects node that is invalid for directory generation. the order of the output and made directories does not always match. (default: false)   --extension value, -e value [ --extension value, -e value ]  set this option if you want to create file instead of directory. for example, if you want to generate files with ".go" extension: "-e .go"   --target-dir value                                           set this option if you want to specify the directory you want to make directory. (default: current directory)   --help, -h                                                   show help

Try it!

$gtree template- gtree        - cmd                - gtree                        - main.go        - testdata                - sample1.md                - sample2.md        - Makefile        - tree.go$gtree template| gtree mkdir$tree gtree/gtree/├── cmd│   └── gtree│       └── main.go├── Makefile├── testdata│   ├── sample1.md│   └── sample2.md└── tree.go8 directories, 0 files

make directories and files

$gtree template- gtree        - cmd                - gtree                        - main.go        - testdata                - sample1.md                - sample2.md        - Makefile        - tree.go$gtree template| gtree mkdir -e .go -e .md -e Makefile$tree gtree/gtree/├── cmd│   └── gtree│       └── main.go├── Makefile├── testdata│   ├── sample1.md│   └── sample2.md└── tree.go3 directories, 5 files

dry run

$gtree template| gtree mkdir --dry-run -e .go -e .md -e Makefilegtree├── cmd│   └── gtree│       └── main.go├── testdata│   ├── sample1.md│   └── sample2.md├── Makefile└── tree.go4 directories, 5 files

$gtree mkdir --dry-run<<EOS- root  - aa  - bb    - b/bEOSinvalid node name: b/b

$gtree mkdir --dry-run<<EOS- /root  - aa  - bb    - bbEOSinvalid node name: /root

Verify subcommand

$gtree verify --helpNAME:   gtree verify - Verifies tree structure represented in markdown by comparing it with existing directories.                  Let's try 'gtree template | gtree verify'.USAGE:   gtree verify [command options] [arguments...]OPTIONS:   --file value, -f value  specify the path to markdown file. (default: stdin)   --target-dir value      set this option if you want to specify the directory you want to verify. (default: current directory)   --strict                set this option if you want strict directory match validation. (default: non strict)   --help, -h              show help

Try it!

$tree exampleexample├── README.md├── find_pipe_programmable-gtree│   ├── README.md│   ├── go.mod│   ├── go.sum│   └── main.go├── go-list_pipe_programmable-gtree│   ├── README.md│   ├── go.mod│   ├── go.sum│   └── main.go├── like_cli│   ├── adapter│   │   ├── executor.go│   │   └── indentation.go│   └── main.go├── noexist│   └── xxx└── programmable    └── main.go6 directories, 14 files$cat testdata/sample9.md- example        - README.md        - find_pipe_programmable-gtree                - README.md                - go.mod                - go.sum                - main.go        - go-list_pipe_programmable-gtree                - README.md                - go.mod                - go.sum                - main.go        - like_cli                - adapter                        - executor.go                        - indentation.go                - main.go                - kkk        - programmable                - main.go$cat testdata/sample9.md| gtree verify --strictExtra paths exist:        example/noexist        example/noexist/xxxRequired paths does not exist:        example/like_cli/kkk

Library - Markdown to tree structure

Installation

$go get github.com/ddddddO/gtree

Usage

Library - Programmable tree structure

Note

There are sample repositories that use gtree library.
Seehere for details.

Installation

$go get github.com/ddddddO/gtree

Usage

Process

Note

This process is for the Massive Roots mode.

e.g.gtree/pipeline_tree.go

Performance

Documents

English

Japanese

Test coverage

Stargazers over time