<commit_before><html>
<head>
<title>Status File for Jakarta Commons "Lang" Component</title>
</head>
<body bgcolor="white">


<div align="center">
<h1>The Jakarta Commons <em>Lang</em> Component</h1>
$Id: STATUS.html,v 1.14 2002/09/17 10:58:37 bayard Exp $<br />
<a href="#Introduction">[Introduction]</a>
<a href="#Dependencies">[Dependencies]</a>
<a href="#Release Info">[Release Info]</a>
<a href="#Known Issues">[Known Issues]</a>
<a href="#Action Items">[Action Items]</a>
<a href="#Committers">[Committers]</a>
<br /><br />
</div>


<a name="Introduction"></a>
<h3>1.  INTRODUCTION</h3>

<p>The <em>Lang</em> Component contains a set of Java classes that provide
helper methods for standard Java classes, especially those found in the 
java.lang package in the Sun JDK.
The following classes are included:</p>
<ul>
<li><strong>StringUtils</strong> - Helper for java.lang.String.</li>
<li><strong>CharSetUtils</strong> - Methods for dealing with CharSets, which are sets of characters such as [a-z] and [abcdez].</li>
<li><strong>RandomStringUtils</strong> - Helper for creating randomised Strings.</li>
<li><strong>NumberUtils</strong> - Helper for java.lang.Number and its subclasses.</li>
<li><strong>NumberRange</strong> - A range of numbers with an upper and lower bound.</li>
<li><strong>ObjectUtils</strong> - Helper for creating any Object.</li>
<li><strong>SerializationUtils</strong> - Helper for serializing Objects.</li>
<li><strong>SystemUtils</strong> - Utility class defining the Java system properties.</li>
<li><strong>NestedException package</strong> - A sub-package for the creation of nested exceptions.</li>
<li><strong>Enum package</strong> - A sub-package for the creation of enumerated types.</li>
<li><strong>Builder package</strong> - A sub-package for the creation of equals, hashCode and compareTo methods.</li>
</ul>


<a name="Dependencies"></a>
<h3>2.  DEPENDENCIES</h3>

<p>The <em>Lang</em> component is dependent upon the following external
components for development and use:</p>
<ul>
<li><a href="http://java.sun.com/j2se">Java Development Kit</a>
    (Version 1.2 or later)</li>
<li><a href="http://www.junit.org">JUnit Testing Framework</a>
    (Version 3.7 or later) - for unit tests only, not required
    for deployment</li>
</ul>


<a name="Release Info"></a>
<h3>3.  RELEASE INFO</h3>

<p>Current Release: 
<a href="http://jakarta.apache.org/builds/jakarta-commons/release/commons-lang/v1.0-b1">Version 1.0 - Beta 1</a>
</p>

<p>Planned Next Release:  
An rc1 and then a full release are planned in early Autumn/Fall 2002.
</p>


<a name="Known Issues"></a>
<h3>4.  KNOWN ISSUES</h3>
<p>
<ul>
<li>Exception tests - Don't compile at present</li>
<li>SystemUtils - Details of this new class need to be finalised</li>
</ul>
</p>


<a name="Action Items"></a>
<h3>5.  ACTION ITEMS</h3>

<p>Want to help?  Here's some "to do" items the team has identified. Note that all are
still under discussion, so please mail the list before actioning.</p>
<ul>
<li>Reflection utilities - new sub-package to deal with reflection</li>
<li>Operating system information - maybe part of SystemUtils, maybe another project</li>
<li>ToStringBuilder - Helper to build a good toString method</li>
<li>NullObject - Singleton object to use as a placeholder when null is not accepted</li>
<li>ObjectUtils identityToString method - replicating the original toString of an object (from <NAME>)</li>
<li>MathUtils - possible addition of mathmatics helper. Could go in NumberUtils</li>
<li>CalendarUtils - possible addition of a calendar utility class (from Serge Knystautas)</li>
<li>CloneUtils - utility class to enable cloning via various different mechanisms</li>
<li>StringUtils containsOnly method - proposed new method to check if a string contains only certain chars</li>
<li>StringUtils truncateNicely method - A substring with some extra power to choose where to cut off. It was in Avalon and was added separately to String Taglib from a code submission. This suggests it may have some comonality</li>
<li>StringUtils parseBoolean method - This method is in OSCore's TextUtils and seems very reusable. It could go in a BooleanUtils if such a need was seen</li>
<li>StringUtils uncapitaliseAllWords method - String Taglib has shown that this method is missing from StringUtils. </li>
<li>StringUtils unescape method - String Taglib has shown that this method is missing from StringUtils. It would take a String with "\n" in and convert it to the Java character. unescape and escape should be symmetric. </li>
</ul>


<a name="Committers"></a>
<h3>6.  COMMITTERS</h3>

<p>The following individuals are the primary developers and maintainers of this
component.  Developers who plan to use <em>Lang</em> in their own
projects are encouraged to collaborate on the future development of this
component to ensure that it continues to meet a variety of needs.</p>
<ul>
<li><a href="mailto:<EMAIL>"><NAME></a></li>
<li><a href="mailto:<EMAIL>"><NAME></a></li>
<li><a href="mailto:<EMAIL>"><NAME></a></li>
<li><a href="mailto:<EMAIL>"><NAME></a></li>
</ul>

</body>
</html>
<commit_msg>Update for checked in ToStringBuilder<commit_after><html>
<head>
<title>Status File for Jakarta Commons "Lang" Component</title>
</head>
<body bgcolor="white">


<div align="center">
<h1>The Jakarta Commons <em>Lang</em> Component</h1>
$Id: STATUS.html,v 1.15 2002/09/17 22:10:47 scolebourne Exp $<br />
<a href="#Introduction">[Introduction]</a>
<a href="#Dependencies">[Dependencies]</a>
<a href="#Release Info">[Release Info]</a>
<a href="#Known Issues">[Known Issues]</a>
<a href="#Action Items">[Action Items]</a>
<a href="#Committers">[Committers]</a>
<br /><br />
</div>


<a name="Introduction"></a>
<h3>1.  INTRODUCTION</h3>

<p>The <em>Lang</em> Component contains a set of Java classes that provide
helper methods for standard Java classes, especially those found in the 
java.lang package in the Sun JDK.
The following classes are included:</p>
<ul>
<li><strong>StringUtils</strong> - Helper for java.lang.String.</li>
<li><strong>CharSetUtils</strong> - Methods for dealing with CharSets, which are sets of characters such as [a-z] and [abcdez].</li>
<li><strong>RandomStringUtils</strong> - Helper for creating randomised Strings.</li>
<li><strong>NumberUtils</strong> - Helper for java.lang.Number and its subclasses.</li>
<li><strong>NumberRange</strong> - A range of numbers with an upper and lower bound.</li>
<li><strong>ObjectUtils</strong> - Helper for creating any Object.</li>
<li><strong>SerializationUtils</strong> - Helper for serializing Objects.</li>
<li><strong>SystemUtils</strong> - Utility class defining the Java system properties.</li>
<li><strong>NestedException package</strong> - A sub-package for the creation of nested exceptions.</li>
<li><strong>Enum package</strong> - A sub-package for the creation of enumerated types.</li>
<li><strong>Builder package</strong> - A sub-package for the creation of equals, hashCode, compareTo and toString methods.</li>
</ul>


<a name="Dependencies"></a>
<h3>2.  DEPENDENCIES</h3>

<p>The <em>Lang</em> component is dependent upon the following external
components for development and use:</p>
<ul>
<li><a href="http://java.sun.com/j2se">Java Development Kit</a>
    (Version 1.2 or later)</li>
<li><a href="http://www.junit.org">JUnit Testing Framework</a>
    (Version 3.7 or later) - for unit tests only, not required
    for deployment</li>
</ul>


<a name="Release Info"></a>
<h3>3.  RELEASE INFO</h3>

<p>Current Release: 
<a href="http://jakarta.apache.org/builds/jakarta-commons/release/commons-lang/v1.0-b1">Version 1.0 - Beta 1</a>
</p>

<p>Planned Next Release:  
An rc1 and then a full release are planned in early Autumn/Fall 2002.
</p>


<a name="Known Issues"></a>
<h3>4.  KNOWN ISSUES</h3>
<p>
<ul>
<li>Exception tests - Don't compile at present</li>
<li>SystemUtils - Details of this new class need to be finalised</li>
</ul>
</p>


<a name="Action Items"></a>
<h3>5.  ACTION ITEMS</h3>

<p>Want to help?  Here's some "to do" items the team has identified. Note that all are
still under discussion, so please mail the list before actioning.</p>
<ul>
<li>Reflection utilities - new sub-package to deal with reflection</li>
<li>Operating system information - maybe part of SystemUtils, maybe another project</li>
<li>NullObject - Singleton object to use as a placeholder when null is not accepted</li>
<li>ObjectUtils identityToString method - replicating the original toString of an object (from John Yu)</li>
<li>MathUtils - possible addition of mathmatics helper. Could go in NumberUtils</li>
<li>CalendarUtils - possible addition of a calendar utility class (from Serge Knystautas)</li>
<li>CloneUtils - utility class to enable cloning via various different mechanisms</li>
<li>StringUtils containsOnly method - proposed new method to check if a string contains only certain chars</li>
<li>StringUtils truncateNicely method - A substring with some extra power to choose where to cut off. It was in Avalon and was added separately to String Taglib from a code submission. This suggests it may have some comonality</li>
<li>StringUtils parseBoolean method - This method is in OSCore's TextUtils and seems very reusable. It could go in a BooleanUtils if such a need was seen</li>
<li>StringUtils uncapitaliseAllWords method - String Taglib has shown that this method is missing from StringUtils. </li>
<li>StringUtils unescape method - String Taglib has shown that this method is missing from StringUtils. It would take a String with "\n" in and convert it to the Java character. unescape and escape should be symmetric. </li>
</ul>


<a name="Committers"></a>
<h3>6.  COMMITTERS</h3>

<p>The following individuals are the primary developers and maintainers of this
component.  Developers who plan to use <em>Lang</em> in their own
projects are encouraged to collaborate on the future development of this
component to ensure that it continues to meet a variety of needs.</p>
<ul>
<li><a href="mailto:<EMAIL>"><NAME></a></li>
<li><a href="mailto:<EMAIL>"><NAME></a></li>
<li><a href="mailto:<EMAIL>"><NAME></a></li>
<li><a href="mailto:<EMAIL>"><NAME></a></li>
</ul>

</body>
</html>

{'fraction_non_alphanumeric': 0.13804283749263116, 'fraction_numerical': 0.010414619768127334, 'mean_word_length': 4.959601873536299, 'pattern_counts': {'":': 0, '<': 384, '<?xml version=': 0, '>': 384, 'https://': 0, 'lorem ipsum': 0, 'www.': 2, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 4, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '4278193', 'n_tokens_mistral': 3263, 'n_tokens_neox': 3134, 'n_words': 1174}