Tableau Xray was going to be a high-level parser for a tableau workbook. Under the hood, a tableau workbook is usually just an XML file, and it might be in a zipfile with the .hyper file. So this library opens the tableau workbook for you however it is stored and and loads the file into a bs4.BeautifulSoup object with an XML parser. At first I wanted to make a high-level parser for the XML structure, but then I discovered the official TableauServerClient, which ended up meeting my needs. I recommend using that, if you can. Feel free to fork this for your own needs though.
from tableau_xray import Workbook
bs4_object = Worbook.open_and_parse("[THE XML CONTENTS HERE AS A STRING]")
# or
bs4_object = Worbook.open_and_parse("[A PATH TO A .TWB OR .TWBX FILE]")If the file is a .twbx file, I call tempfile.mkdtemp to create a library to unzip the file to. It doesn't delete itself once the script is done running, in case you wanted to use the unzipped contents in other ways.
You would then use the outputs just like any other BS4/BeautifulSoup object.