Skip to content

Latest commit

 

History

History
 
 

usd_searcher

Folders and files

NameName
Last commit message
Last commit date

parent directory

..
 
 
 
 
 
 

Sometimes, you just have to search a USD file for some text. Most of the time, if you're looking for something specific, you can open up usdview and dig around until you find what you need. But if, for example, you need to find every relationship containing the phrase "foo" or "bar", you're in for some trouble.

USD files can refer anywhere on-disk. In studio pipelines, it's very common for Asset paths to be URIs referring to completely different folder locations or even refer to files in a database.

To search USD files, you must also traverse its dependencies (wherever those dependencies may be) and search the dependency's contents. usd-search a command-line utility / Python module that searches through USD files, recursively.

Features

  • Search through USD Layers, even crate files
  • Optionally searches through Asset paths
  • Supports regex matching

How To Use

PYTHONPATH=$USD_INSTALL_ROOT/lib/python:$PWD/python:$PYTHONPATH ./bin/usd-search foo /some/usd/file.usda

Requirements

  • USD must be importable in Python
  • (Optional) Your environment should be set up however it needs to be in order to resolve paths correctly