<commit_before><?xml version="1.0"?>

<document>

 <properties>
  <title>Joda Convert</title>
  <author><NAME></author>
 </properties>

 <body>

<section name="Joda Convert">

<p>
Joda-Convert provides a small set of classes to aid conversion between Objects and Strings.
It is not intended to tackle the wider problem of Object to Object transformation.
</p>
<div style="border:1px solid black; padding: 0px 6px; margin: 4px;"><pre>
// conversion to String
String str = StringConvert.INSTANCE.convertToString(foo);

// conversion from String
Foo bar = StringConvert.INSTANCE.convertFromString(Foo.class, str);
</pre></div>
<p>
Joda-Convert supports two mechanisms of extending the list of supported conversions.
The first is to write your own converter implementing an interface.
The second is to use annotations.
</p>
<p>
The ability of Joda-Convert to use annotations to define the conversion methods is a key difference from other projects.
For example, most value classes, like <code>Currency</code> or <code>TimeZone</code>, already have methods
to convert to and from a standard format String.
Consider a <code>Distance</code> class:
</p>
<div style="border:1px solid black; padding: 0px 6px; margin: 4px;"><pre>
public class Distance {

  @FromString
  public static Distance parse(String str) { ... }

  @ToString
  public String getStandardOutput() { ... }

}
</pre></div>
<p>
As shown, the two methods may have any name. They must simply fulfil the required method signatures for conversion.
The <code>FromString</code> annotation may also be applied to a constructor.
</p>
<p>
When Joda-Convert is asked to convert between an object and a String, if there is no registered converter
then the annotations are checked. If they are found, then the methods are called by reflection.
</p>
<p>
Joda-Convert is licensed under the business-friendly <a href="license.html">Apache 2.0 licence</a>.
</p>

</section>

<section name="Documentation">
<p>
Various documentation is available:
<ul>
<li>The helpful <a href="userguide.html">user guide</a></li>
<li>The javadoc for the <a href="api-release/index.html">current release</a></li>
<li>The javadoc for the <a href="apidocs/index.html">latest SVN</a></li>
<!--li>A <a href="faq.html">FAQ</a> list</li-->
<!--li>Information on <a href="installation.html">downloading and installing</a> Joda-Convert</li-->
<li>The <a href="http://joda-convert.svn.sourceforge.net/viewvc/joda-convert/trunk/">SVN repository</a></li>
</ul>
</p>
</section>

<section name="Releases">
<p>
<a href="http://sourceforge.net/projects/joda-convert/files/joda-convert/1.1/">Release 1.1</a>
is the current latest release.
This release is considered stable and worthy of the 1.x tag.
It depends on JDK 1.5 or later.
</p>
</section>

<section name="Contact">
<p>
If you have any questions, or want to volunteer to help, just email <NAME>
via scolebourne.at.users.sourceforge.net.
</p>
<p>
<br />
<br />
<br />
<br />
<br />
</p>
</section>
</body>
</document>
<commit_msg>Change svn repo to github repo<commit_after><?xml version="1.0"?>

<document>

 <properties>
  <title>Joda Convert</title>
  <author><NAME></author>
 </properties>

 <body>

<section name="Joda Convert">

<p>
Joda-Convert provides a small set of classes to aid conversion between Objects and Strings.
It is not intended to tackle the wider problem of Object to Object transformation.
</p>
<div style="border:1px solid black; padding: 0px 6px; margin: 4px;"><pre>
// conversion to String
String str = StringConvert.INSTANCE.convertToString(foo);

// conversion from String
Foo bar = StringConvert.INSTANCE.convertFromString(Foo.class, str);
</pre></div>
<p>
Joda-Convert supports two mechanisms of extending the list of supported conversions.
The first is to write your own converter implementing an interface.
The second is to use annotations.
</p>
<p>
The ability of Joda-Convert to use annotations to define the conversion methods is a key difference from other projects.
For example, most value classes, like <code>Currency</code> or <code>TimeZone</code>, already have methods
to convert to and from a standard format String.
Consider a <code>Distance</code> class:
</p>
<div style="border:1px solid black; padding: 0px 6px; margin: 4px;"><pre>
public class Distance {

  @FromString
  public static Distance parse(String str) { ... }

  @ToString
  public String getStandardOutput() { ... }

}
</pre></div>
<p>
As shown, the two methods may have any name. They must simply fulfil the required method signatures for conversion.
The <code>FromString</code> annotation may also be applied to a constructor.
</p>
<p>
When Joda-Convert is asked to convert between an object and a String, if there is no registered converter
then the annotations are checked. If they are found, then the methods are called by reflection.
</p>
<p>
Joda-Convert is licensed under the business-friendly <a href="license.html">Apache 2.0 licence</a>.
</p>

</section>

<section name="Documentation">
<p>
Various documentation is available:
<ul>
<li>The helpful <a href="userguide.html">user guide</a></li>
<li>The javadoc for the <a href="api-release/index.html">current release</a></li>
<li>The javadoc for the <a href="apidocs/index.html">latest source code</a></li>
<!--li>A <a href="faq.html">FAQ</a> list</li-->
<!--li>Information on <a href="installation.html">downloading and installing</a> Joda-Convert</li-->
<li>The <a href="https://github.com/JodaOrg/joda-convert">GitHub</a> source repository</li>
</ul>
</p>
</section>

<section name="Releases">
<p>
<a href="http://sourceforge.net/projects/joda-convert/files/joda-convert/1.1/">Release 1.1</a>
is the current latest release.
This release is considered stable and worthy of the 1.x tag.
It depends on JDK 1.5 or later.
</p>
</section>

<section name="Contact">
<p>
If you have any questions, or want to volunteer to help, just email <NAME>
via scolebourne.at.users.sourceforge.net.
</p>
<p>
<br />
<br />
<br />
<br />
<br />
</p>
</section>
</body>
</document>

{'fraction_non_alphanumeric': 0.13351630610268, 'fraction_numerical': 0.006134969325153374, 'mean_word_length': 3.920571882446386, 'pattern_counts': {'":': 0, '<': 187, '<?xml version=': 2, '>': 187, 'https://': 1, 'lorem ipsum': 0, 'www.': 0, 'xml': 2}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 2, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '2815119', 'n_tokens_mistral': 1985, 'n_tokens_neox': 1972, 'n_words': 707}