--depth flag

[mottosso]

Add the option of limiting how many levels within a hierarchy a query can be made.

[mottosso]

Sorry , I know we said you (who?) were going to have a look at this, but I was in a situation where I needed it and made a quick implementation. Not tested much yet so let me know if you run into any issues.

Example

$ cd /projects/spiderman/assets
$ cquery .Asset
# /projects/spiderman/assets/Peter
# /projects/spiderman/assets/Peter/anim/rigHigh
# /projects/spiderman/assets/Mary
# /projects/spiderman/assets/Mary/anim/rigHigh
$ cquery .Asset --depth=0
# /projects/spiderman/assets/Peter
# /projects/spiderman/assets/Mary
$ cquery .Asset --depth=1
# /projects/spiderman/assets/Peter
# /projects/spiderman/assets/Mary
$ cquery .Asset --depth=2
# /projects/spiderman/assets/Peter
# /projects/spiderman/assets/Peter/anim/rigHigh
# /projects/spiderman/assets/Mary
# /projects/spiderman/assets/Mary/anim/rigHigh
$ # Up upwards queries
$ cd assets/Peter/anim/rigHigh
$ cquery .Asset --direction=up
# /projects/spiderman/assets/Peter/anim/rigHigh
# /projects/spiderman/assets/Peter
$ cquery .Asset --direction=up --depth=0
# /projects/spiderman/assets/Peter/anim/rigHigh
$ cquery .Asset --direction=up --depth=2
# /projects/spiderman/assets/Peter/anim/rigHigh
# /projects/spiderman/assets/Peter