Skip to main content

A ViM-usable tags file generator for EnergyPlus IDF files.

Project description

A ViM-usable tags file generator for EnergyPlus IDF files.


EnergyPlus IDF files can be huge, and you’ve probably wanted a way to jump to another object that the object you’re looking at references.

For example jump from one object that references a schedule to a schedule itself.

If you use ViM, you’ve probably been using tags files. This utility is a tags generator for EnergyPlus IDF files.

It also comes with a Command Line Interface (CLI) for easy generation of said tags.

Note that because tags expects proper variables names, and EnergyPlus doesn’t enforce such rules for the Name of objects, we have to create a new IDF file where the name doesn’t include any spaces or other special characters.


It installs a CLI idf-tags. Here’s the output of idf-tags

$ idf-tags


idf-tags idf-tags [–recursive | -r | <idf_path>] idf-tags -h | –help idf-tags -v | –version
-r –recursive Search for IDF files is recursive (includes subdirectories) -h –help Show this screen. -v –version Show version.
idf-tags Generates a tag file for all files in current directory idf-tags -r Tag file including subdirectories idf-tags in.idf Tag file for a specific IDF file
For help using this tool, please open an issue on the Github repository:


If you’ve cloned this project, and want to install the library (and all development dependencies), the command you’ll want to run is:

$ pip install -e .[test]

If you’d like to run all tests for this project, against Python 2.7 and 3.6, I have implemented tox, and you can just run:

$ tox

or, for only your current environment:

$ python test

Both will trigger py.test, along with its popular coverage plugin.

Uploading a new version to PyPi, the Python Package Index (PyPI):

$ python sdist bdist_wheel
$ twine upload dist/*

This will build both a source tarball of your CLI tool, as well as a newer wheel build (and this will, by default, run on all platforms). You need twine

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for idf-tags, version 0.1.1
Filename, size File type Python version Upload date Hashes
Filename, size idf_tags-0.1.1-py2.py3-none-any.whl (8.7 kB) File type Wheel Python version py2.py3 Upload date Hashes View
Filename, size idf-tags-0.1.1.tar.gz (485.9 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page