<commit_before>/*
 * $Id$
 */
package org.xins.util.sd;

import org.xins.util.collections.PropertyReader;

/**
 * Builder that can build a <code>Descriptor</code> object based on a set of
 * properties.
 *
 * @version $Revision$ $Date$
 * @author <NAME> (<a href="mailto:<EMAIL>"><EMAIL></a>)
 *
 * @since XINS 0.105
 */
public final class DescriptorBuilder extends Object {

   //-------------------------------------------------------------------------
   // Class fields
   //-------------------------------------------------------------------------

   //-------------------------------------------------------------------------
   // Class functions
   //-------------------------------------------------------------------------

   //-------------------------------------------------------------------------
   // Constructors
   //-------------------------------------------------------------------------

   /**
    * Constructs a new <code>DescriptorBuilder</code>.
    */
   public DescriptorBuilder() {
      // empty
   }


   //-------------------------------------------------------------------------
   // Fields
   //-------------------------------------------------------------------------

   //-------------------------------------------------------------------------
   // Methods
   //-------------------------------------------------------------------------

   /**
    * Builds a <code>Descriptor</code> based on the specified set of
    * properties.
    *
    * @param properties
    *    the properties to read from, cannot be <code>null</code>.
    *
    * @param propertyName
    *    the base for the property names, cannot be <code>null</code>.
    *
    * @return
    *    the {@link Descriptor} that was built, never <code>null</code>.
    *
    * @throws IllegalArgumentException
    *    if <code>properties == null || propertyName == null</code>.
    */
   public Descriptor build(PropertyReader properties, String propertyName)
   throws IllegalArgumentException, DescriptorBuilder.Exception {
      return null; // TODO
   }


   //-------------------------------------------------------------------------
   // Inner classes
   //-------------------------------------------------------------------------

   /**
    * Exception thrown if a descriptor could not be built.
    *
    * @version $Revision$ $Date$
    * @author <NAME> (<a href="mailto:<EMAIL>"><EMAIL></a>)
    *
    * @since XINS 0.105
    */
   public static final class Exception extends java.lang.Exception {

      //----------------------------------------------------------------------
      // Constructor
      //----------------------------------------------------------------------

      public Exception(String message) {<commit_msg>Added Javadoc comments.<commit_after>/*
 * $Id$
 */
package org.xins.util.sd;

import org.xins.util.collections.PropertyReader;

/**
 * Builder that can build a <code>Descriptor</code> object based on a set of
 * properties.
 *
 * @version $Revision$ $Date$
 * @author <NAME> (<a href="mailto:<EMAIL>"><EMAIL></a>)
 *
 * @since XINS 0.105
 */
public final class DescriptorBuilder extends Object {

   //-------------------------------------------------------------------------
   // Class fields
   //-------------------------------------------------------------------------

   //-------------------------------------------------------------------------
   // Class functions
   //-------------------------------------------------------------------------

   //-------------------------------------------------------------------------
   // Constructors
   //-------------------------------------------------------------------------

   /**
    * Constructs a new <code>DescriptorBuilder</code>.
    */
   public DescriptorBuilder() {
      // empty
   }


   //-------------------------------------------------------------------------
   // Fields
   //-------------------------------------------------------------------------

   //-------------------------------------------------------------------------
   // Methods
   //-------------------------------------------------------------------------

   /**
    * Builds a <code>Descriptor</code> based on the specified set of
    * properties.
    *
    * @param properties
    *    the properties to read from, cannot be <code>null</code>.
    *
    * @param propertyName
    *    the base for the property names, cannot be <code>null</code>.
    *
    * @return
    *    the {@link Descriptor} that was built, never <code>null</code>.
    *
    * @throws IllegalArgumentException
    *    if <code>properties == null || propertyName == null</code>.
    */
   public Descriptor build(PropertyReader properties, String propertyName)
   throws IllegalArgumentException, DescriptorBuilder.Exception {
      return null; // TODO
   }


   //-------------------------------------------------------------------------
   // Inner classes
   //-------------------------------------------------------------------------

   /**
    * Exception thrown if a descriptor could not be built.
    *
    * @version $Revision$ $Date$
    * @author <NAME> (<a href="mailto:<EMAIL>"><EMAIL></a>)
    *
    * @since XINS 0.105
    */
   public static final class Exception extends java.lang.Exception {

      //----------------------------------------------------------------------
      // Constructor
      //----------------------------------------------------------------------

      /**
       * Constructs a new <code>DescriptorBuilder.Exception</code> with the
       * spedified detail message.
       *
       * @param message
       *    the detail message, can be <code>null</code>.
       */
      Exception(String message) {
{'fraction_non_alphanumeric': 0.44413358978842454, 'fraction_numerical': 0.002797691904179052, 'mean_word_length': 0.7835983785469286, 'pattern_counts': {'":': 0, '<': 55, '<?xml version=': 0, '>': 55, 'https://': 0, 'lorem ipsum': 0, 'www.': 0, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 0, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '6716691', 'n_tokens_mistral': 1181, 'n_tokens_neox': 1127, 'n_words': 302}