X-Git-Url: http://git.nikiroo.be/?a=blobdiff_plain;f=src%2Fbe%2Fnikiroo%2Futils%2Fresources%2FMeta.java;h=d50664da74f0828e3465383a9bb828222cd29ea9;hb=e8aa5bf9227a0d6a6d0bb6a8bc0cc04d0f4d601a;hp=3e14557ba85a3c9c899297abc43c0847e04fb9c9;hpb=ec1f3444e9f238ce1559d5fff32eb5a7ab8aba53;p=nikiroo-utils.git

diff --git a/src/be/nikiroo/utils/resources/Meta.java b/src/be/nikiroo/utils/resources/Meta.java
index 3e14557..d50664d 100644
--- a/src/be/nikiroo/utils/resources/Meta.java
+++ b/src/be/nikiroo/utils/resources/Meta.java
@@ -15,32 +15,102 @@ import java.lang.annotation.Target;
 @Target(ElementType.FIELD)
 public @interface Meta {
 	/**
-	 * What kind of item this key represent (a Key, a Label text, a format to
-	 * use for something else...).
+	 * The format of an item (the values it is expected to be of).
+	 * <p>
+	 * Note that the INI file can contain arbitrary data, but it is expected to
+	 * be valid.
+	 * 
+	 * @author niki
+	 */
+	public enum Format {
+		/** An integer value, can be negative. */
+		INT,
+		/** true or false. */
+		BOOLEAN,
+		/** Any text String. */
+		STRING,
+		/** A password field. */
+		PASSWORD,
+		/** A colour (either by name or #rrggbb or #aarrggbb). */
+		COLOR,
+		/** A locale code (e.g., fr-BE, en-GB, es...). */
+		LOCALE,
+		/** A path to a file. */
+		FILE,
+		/** A path to a directory. */
+		DIRECTORY,
+		/** A fixed list of values (see {@link Meta#list()} for the values). */
+		FIXED_LIST,
+		/**
+		 * A fixed list of values (see {@link Meta#list()} for the values) OR a
+		 * custom String value (basically, a {@link Format#FIXED_LIST} with an
+		 * option to enter a not accounted for value).
+		 */
+		COMBO_LIST
+	}
+
+	/**
+	 * A description of this item.
 	 * 
 	 * @return what it is
 	 */
-	String what();
+	String description() default "";
 
 	/**
-	 * Where in the application will this key appear (in the action keys, in a
-	 * menu, in a message...).
+	 * This item is only used as a group, not as an option.
+	 * <p>
+	 * For instance, you could have LANGUAGE_CODE as a group for which you won't
+	 * use the value in the program, and LANGUAGE_CODE_FR, LANGUAGE_CODE_EN
+	 * inside for which the value must be set.
 	 * 
-	 * @return where it is
+	 * @return TRUE if it is a group
 	 */
-	String where();
+	boolean group() default false;
 
 	/**
 	 * What format should/must this key be in.
 	 * 
 	 * @return the format it is in
 	 */
-	String format();
+	Format format() default Format.STRING;
+
+	/**
+	 * The list of fixed values this item can be (either for
+	 * {@link Format#FIXED_LIST} or {@link Format#COMBO_LIST}).
+	 * 
+	 * @return the list of values
+	 */
+	String[] list() default {};
+
+	/**
+	 * This item can be left unspecified.
+	 * 
+	 * @return TRUE if it can
+	 */
+	boolean nullable() default true;
+
+	/**
+	 * The default value of this item.
+	 * 
+	 * @return the value
+	 */
+	String def() default "";
+
+	/**
+	 * This item is a comma-separated list of values instead of a single value.
+	 * 
+	 * @return TRUE if it is
+	 */
+	boolean array() default false;
 
 	/**
-	 * Free info text to help translate.
+	 * An addition to the format.
+	 * <p>
+	 * Free info text to help translate, for instance the parameters order and
+	 * type for String translations (i.e., %s = input file name, %d = file size
+	 * in MB).
 	 * 
 	 * @return some info
 	 */
-	String info();
+	String info() default "";
 }