001/*******************************************************************************
002 * This software is provided as a supplement to the authors' textbooks on digital
003 * image processing published by Springer-Verlag in various languages and editions.
004 * Permission to use and distribute this software is granted under the BSD 2-Clause
005 * "Simplified" License (see http://opensource.org/licenses/BSD-2-Clause).
006 * Copyright (c) 2006-2023 Wilhelm Burger, Mark J. Burge. All rights reserved.
007 * Visit https://imagingbook.com for additional details.
008 ******************************************************************************/
009
010package imagingbook.core;
011
012import java.util.jar.Attributes;
013import java.util.jar.Manifest;
014
015/**
016 * This class provides version information for this library.
017 *
018 * @author WB
019 */
020public abstract class Info {
021        // see https://stackoverflow.com/questions/3697449/retrieve-version-from-maven-pom-xml-in-code for alternatives
022        private Info() {}
023
024        /**
025         * Reads version information from the MANIFEST.MF file of the JAR file from which this class was loaded.
026         *
027         * @return A string with the version information. "UNKNOWN" is returned if the library was not loaded from a JAR
028         * file or if the version information could not be determined.
029         */
030        public static String getVersionInfo() {
031                Manifest mf = FileUtils.getJarManifest(Info.class);
032                if (mf == null) {
033                        return "UNKNOWN";
034                }
035                //IJ.log("listing attributes");
036                Attributes attr = mf.getMainAttributes();
037                String version = null;
038                String buildTime = null;
039                try {
040                        version = attr.getValue("Implementation-Version");
041                        buildTime = attr.getValue("Build-Time");
042                } catch (IllegalArgumentException e) { }
043                return version + " (" + buildTime + ")";
044        }
045
046}