directory-to-object
(placeholder -- more documentation coming)