Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/zikani03/groupby

Group files into directories by year, month or day created
https://github.com/zikani03/groupby

cli go golang groupby

Last synced: 21 days ago
JSON representation

Group files into directories by year, month or day created

Host: GitHub
URL: https://github.com/zikani03/groupby
Owner: zikani03
License: mit
Created: 2017-01-19T15:28:31.000Z (about 8 years ago)
Default Branch: master
Last Pushed: 2022-05-11T18:50:27.000Z (over 2 years ago)
Last Synced: 2024-06-20T03:43:09.048Z (7 months ago)
Topics: cli, go, golang, groupby
Language: Go
Homepage: https://labs.zikani.me/groupby/
Size: 46.9 KB
Stars: 66
Watchers: 5
Forks: 2
Open Issues: 0
Metadata Files:
- Readme: README.md
- License: LICENSE

Awesome Lists containing this project

README

Group By
========

A simple CLI program to group files into directories by year, month or day created (or modified).

## Usage

### Download it

Download an already compiled executable for your operating system from the [releases page](https://github.com/zikani03/groupby/releases)

### Example Usage

Use the `groupby` command as in the example below:

```bash
$ groupby -day -d=./groupby
```

This will group your files into year, month and then day subdirectories
so that it looks like This

```
./groupby
└── 2017
├── July
└── 15
└── LICENSE
└── August
└── 21
├── README.md
└── groupby.go
```

### Command-line options

```text
groupby [OPTIONS]

Usage of groupby:
-a Include hidden files and directories (starting with .)
-copy-only
Only copy files, do not move them
-created
Group files by the date they were created (default)
-d DIRECTORY
Directory containing files to group
-day
Group by year, month and then day
-dry-run
Only show the output of how the files will be grouped
-flatten
Flatten the created directory tree folders
-ignore-directories
Ignore directories and only group files
-modified
Group files by the date they were modified (default true)
-month
Group by year, and then month
-o DIRECTORY
Directory to move grouped files to
-p Only show the output of how the files will be grouped (shorthand)
-preview
Only show the output of how the files will be grouped
-v Show verbose output
-verbose
Show verbose output
-version
Show the program version and exit
-year
Group by year only
```

## Building from source

Use the following steps if you would like to build the binary from the source code.

`groupby` doesn't have any other dependencies besides Go itself, so building it is
as simple as cloning it and running go build.

You must have [Go](https://golang.org) installed

```bash
$ git clone https://github.com/zikani03/groupby
$ cd groupby
$ go build
```

This will create a `groupby` binary in the directory (`groupby.exe` on Windows)

## LICENSE

MIT

---