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.

Purpose

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.

Usage

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

$ idf-tags

idf-tags

Usage:
idf-tags idf-tags [–recursive | -r | <idf_path>] idf-tags -h | –help idf-tags -v | –version
Options:
-r –recursive Search for IDF files is recursive (includes subdirectories) -h –help Show this screen. -v –version Show version.
Examples:
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
Help:
For help using this tool, please open an issue on the Github repository: https://github.com/jmarrec/idf-tags

Developper

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 setup.py test

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

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

$ python setup.py 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

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page