dir2 2.0.1

There is a newer version of this package available.
See the version list below for details.

dotnet tool install --global dir2 --version 2.0.1

This package contains a .NET tool you can call from the shell/command line.

dotnet new tool-manifest # if you are setting up this repo
dotnet tool install --local dir2 --version 2.0.1

This package contains a .NET tool you can call from the shell/command line.

#tool dotnet:?package=dir2&version=2.0.1

The NuGet Team does not provide support for this client. Please contact its maintainers for support.

nuke :add-package dir2 --version 2.0.1

The NuGet Team does not provide support for this client. Please contact its maintainers for support.

Dir2

v2.0.1

Syntax:

dir2 [DIR] [WILD ..] [OPT ..]

Example:

dir2 bin -s *.exe *.dll --within 10m

Syntax:

dir2 DIR/WILD [OPT ..]

Example:

dir2 obj/*.dll -s

Example as Unix ls:

dir2 obj/*.dll --show mode,owner

Link to example

Options:

Shortcut	Description	Example
-?	Short help
-s	Show on all sub-dir
-b	Show filename only
-o	Sort	-o size,ext
-x	Exclude some specified file	-x .dll;.lib
-X	Exclude some specified dir	-X bin;obj;.vs
-w	Specify selection condition	-w 14day
		-w 100k
-W	Specify selection condition	-W 7day
		-W 50k
-k	Keep specified dir name

--within -w

Option '--within' (shortcut '-w') select files as follows.

Postfix	Example	Example Description
k,m,g	-w 100k	Show file if its size is smaller than 100 Kb.
	-w 10m	Show file if its size is smaller than 10 Mb.
min	-w 20min	Show file if its last write-time is within 10 minutes.
hour	-w 3hour	Show file if its last write-time is within 3 hours.
day	-w 14day	Show file if its last write-time is within 14 days.
	-w 2022-12-25	Show file if its last write-time is NOT before X'Mas.
	-w 13:30	Show file if its last write-time is NOT before today 13:30.
	-w 2019-06-12T15:20

--not-within -W

Option '--not-within' (shortcut '-W' upper case) select files as follows.

Postfix	Example	Example Description
k,m,g	-W 90k	Show file if its size is bigger than 90 Kb.
	-W 2m	Show file if its size is bigger than 2 Mb.
min	-W 15min	Show file if its last write-time is before 15 minutes.
hour	-W 2hour	Show file if its last write-time is before 2 hours.
day	-W 7day	Show file if its last write-time is before 7 days.
	-W 2022-12-25	Show file if its last write-time is before X'Mas.
	-W 13:30	Show file if its last write-time is before today 13:30.
	-W 2019-06-12T15:20

To exclude some files by '--excl' (shortcut -x)

dir2 -x *.obj
dir2 -x *.tmp -x *.user
dir2 -x *.tmp,*.user

To exclude some dir by '--excl-dir' (shortcut -X)

dir2 -X .vs
dir2 -X .vs -X obj*
dir2 -X .vs,obj*

Sum-up by File Extension, or, Dir Name

Option	Description
--sum ext	Sum up by file extension (current dir only)
-s --sum ext	Sum up by file extension from all sub dir.
-s --sum dir	Sum up by dir.
-s --sum +dir	Sum up by dir including "no file found".

Sum-up Dir Usage

List all dir which has no any '.cs' file.

dir2 *.cs -s --sum +dir -o count --take 1

Provide '--files-from' on pipeline operation

Store '.cs' files from all sub dir on 'my_proj' into a new tar file, or, a new zip file.

dir2 my_proj *.cs -bks | tar -cf ..\backup\today.tar --files-from -
dir2 my_proj *.cs -bks | zip2 -cf ..\backup\today.zip -T -

Complete Option List by --HELP

Shortcut	Option	Available Value	Example
-?	--help
-? cfg	--help cfg
-v	--version
	--dir	both, only, off, tree
	--cfg-off
	--utf8
-w	--within	DATE or SIZE	-w 12m -w 3day
-W	--not-within	DATE or SIZE	-W 10k -W 2hour
	--regex
-c	--case-sensitive
	--creation-date
-k	--keep-dir
	--no-ext	incl, excl, both
	--hidden	incl, excl, both
	--size-format	INTEGER, commna, short	--size-format 12,comma
			--size-format short
	--count-format	INTEGER, commna, short	--size-format 6,comma
			--size-format
	--date-format	u, yyyy-MMM-ddTHH:mm:ss
	--total	off, only
	--hide	date,size,cout,mode,owner,link
	--show	date,size,cout,mode,owner,link
-o	--sort	off,name,size,date,ext,count,last	-o date
	--take	INTEGER,SIZE
	--sum	ext,dir,+dir
-x	--excl	--excl-file *.pdb	-x *.pdb
-X	--excl-dir	--excl-dir obj	-X obj

Options is renamed

Old Option	New Name, and, new short-cut
--size-within	--within -w
--date-within	--within -w
--size-beyond	--not-within -W
--date-beyond	--not-within -W

Daily Shortcut:

Shortcut	Stand for	Description
-s	--dir sub	Recursively sub-directory
-f	--dir off	List file only
-d	--dir only	List dir name only
-R	--dir tree	List dir tree
-c	--case-sensitive
-b	--total off	List filename (with path) only
	--hide date,size,count,mode,owner,link
-t	--total only	Display total line only

Setup by Config File & Environment

Config file "dir2.opt" will be referred before envir var "dir2".

Environment "dir2" will be referred before command line parameters.

See:

dir2 -? cfg

Yung, Chun Kau

yung.chun.kau@gmail.com

2023 Feb

Product	Compatible and additional computed target framework versions.
.NET	net7.0 is compatible. net7.0-android was computed. net7.0-ios was computed. net7.0-maccatalyst was computed. net7.0-macos was computed. net7.0-tvos was computed. net7.0-windows was computed. net8.0 was computed. net8.0-android was computed. net8.0-browser was computed. net8.0-ios was computed. net8.0-maccatalyst was computed. net8.0-macos was computed. net8.0-tvos was computed. net8.0-windows was computed.

Product

.NET

Compatible target framework(s)

Included target framework(s) (in package)

Learn more about Target Frameworks and .NET Standard.

This package has no dependencies.

Version	Downloads	Last updated
2.2.0	135	2/1/2024
2.1.1	165	1/1/2024
2.1.0	178	11/15/2023
2.0.1	289	2/8/2023
2.0.0	358	1/1/2023
1.1.6	272	12/30/2021
1.1.5	355	12/14/2021
1.1.4	336	11/8/2021
1.1.3	339	10/27/2021
1.1.2	339	10/26/2021
1.1.1	400	10/24/2021
1.1.0	369	10/24/2021
1.0.1	369	10/16/2021

Migrate to the common syntax of command-line argument.