feat: add auto-generated enums for HIPO schema (#1205)

* add script to generate enums from bank schema

* add resulting enums

* cleanup

* update package name

* update bank package path

* remove auto-generated bank schema enums

* rename

* remove auto-generated bank enums (again?)

* gitignore auto-generated bank enums

* add schema-enum-cleaning to mvn clean

* add bank schema enum generation to maven validation phase

* switch to single underscore

* move enum build to clas-io

Author: baltzell

.gitignore

@@ -6,6 +6,7 @@ target
 /docs/javadoc/*
 /clara-home
 tmp
+/common-tools/clas-io/src/main/java/org/jlab/io/banks
 
 # deployment
 /myLocalMvnRepo

common-tools/clas-io/bank-schema-enums

@@ -0,0 +1,18 @@
+#!/usr/bin/env python3
+import os,glob,json
+top = os.path.normpath(os.path.dirname(os.path.abspath(__file__))+'/../..')
+idir = 'etc/bankdefs/hipo4'
+odir = 'common-tools/clas-io/src/main/java/org/jlab/io/banks'
+print(f'INFO:  Creating schema enums at {odir}')
+os.makedirs(f'{top}/{odir}', exist_ok=True)
+for x in glob.glob(f'{top}/{idir}/*.json'):
+    for bank in json.load(open(x,'r')):
+        class_name = bank['name'].replace('::','_').replace(':','_')
+        with open(f'{top}/{odir}/{class_name}.java','w') as f:
+            f.write('package org.jlab.io.banks;\n')
+            f.write(f'public class {class_name} {{\n')
+            for i,entry in enumerate(bank['entries']):
+                var_name = entry['name']
+                f.write(f'    public static final short {var_name} = {i};\n')
+            f.write('}\n')
+            f.close()

common-tools/clas-io/pom.xml

@@ -55,4 +55,45 @@
 
   </dependencies>
 
+  <build>
+    <plugins>
+      <plugin>
+        <groupId>org.apache.maven.plugins</groupId>
+        <artifactId>maven-antrun-plugin</artifactId>
+        <version>3.1.0</version>
+        <executions>
+          <execution>
+            <id>bank-schema-enums</id>
+            <phase>validate</phase>
+            <goals>
+              <goal>run</goal>
+            </goals>
+            <inherited>false</inherited>
+            <configuration>
+              <target>
+                <exec executable="python3">
+                    <arg value="./bank-schema-enums"/>
+                </exec>
+              </target>
+            </configuration>
+          </execution>
+        </executions>
+      </plugin>
+      <plugin>
+        <artifactId>maven-clean-plugin</artifactId>
+        <version>3.4.0</version>
+        <configuration>
+          <filesets>
+            <fileset>
+              <directory>src/main/java/org/jlab/io/banks</directory>
+              <includes>
+                <include>**/*.java</include>
+              </includes>
+            </fileset>
+          </filesets>
+        </configuration>
+      </plugin>
+    </plugins>
+  </build>
+
 </project>