RAT (Release Audit Tool) results

The following document contains the results of RAT (Release Audit Tool).

*****************************************************
Summary
-------
Generated at: 2014-12-17T10:29:16+01:00
Notes: 0
Binaries: 2
Archives: 0
Standards: 67

Apache Licensed: 63
Generated Documents: 0

JavaDocs are generated and so license header is optional
Generated files do not required license headers

4 Unknown Licenses

*******************************

Unapproved licenses:

  .gitignore
  pom.xml
  src/site/fml/faq.fml
  src/test/java/org/apache/commons/inject/util/ExceptionsTest.java

*******************************

Archives:

*****************************************************
  Files with Apache License headers will be marked AL
  Binary files (which do not require AL headers) will be marked B
  Compressed archives will be marked A
  Notices, licenses etc will be marked N
 !????? .gitignore
 !????? pom.xml
  AL    src/main/java/org/apache/commons/inject/api/AbstractLoggerInjectingModule.java
  AL    src/main/java/org/apache/commons/inject/api/bind/IAnnotatedBindingBuilder.java
  AL    src/main/java/org/apache/commons/inject/api/bind/IBinder.java
  AL    src/main/java/org/apache/commons/inject/api/bind/ILinkedBindingBuilder.java
  AL    src/main/java/org/apache/commons/inject/api/bind/IModule.java
  AL    src/main/java/org/apache/commons/inject/api/bind/IScopedBindingBuilder.java
  AL    src/main/java/org/apache/commons/inject/api/bind/Scopes.java
  AL    src/main/java/org/apache/commons/inject/api/CommonsInject.java
  AL    src/main/java/org/apache/commons/inject/api/CommonsLoggingLoggerModule.java
  AL    src/main/java/org/apache/commons/inject/api/IBinding.java
  AL    src/main/java/org/apache/commons/inject/api/IInjector.java
  AL    src/main/java/org/apache/commons/inject/api/IInjectorBuilder.java
  AL    src/main/java/org/apache/commons/inject/api/IKey.java
  AL    src/main/java/org/apache/commons/inject/api/ILifecycleController.java
  AL    src/main/java/org/apache/commons/inject/api/ILifecycleListener.java
  AL    src/main/java/org/apache/commons/inject/api/InjLogger.java
  AL    src/main/java/org/apache/commons/inject/api/IPoint.java
  AL    src/main/java/org/apache/commons/inject/api/IProvider.java
  AL    src/main/java/org/apache/commons/inject/api/Key.java
  AL    src/main/java/org/apache/commons/inject/api/Log4j2LoggerModule.java
  AL    src/main/java/org/apache/commons/inject/api/Log4jLoggerModule.java
  AL    src/main/java/org/apache/commons/inject/api/NoSuchBindingException.java
  AL    src/main/java/org/apache/commons/inject/api/PostConstructModule.java
  AL    src/main/java/org/apache/commons/inject/api/Slf4JLoggerModule.java
  AL    src/main/java/org/apache/commons/inject/impl/AbstractBaseProvider.java
  AL    src/main/java/org/apache/commons/inject/impl/AbstractBindingSet.java
  AL    src/main/java/org/apache/commons/inject/impl/AbstractInjector.java
  AL    src/main/java/org/apache/commons/inject/impl/AbstractScopedProvider.java
  AL    src/main/java/org/apache/commons/inject/impl/bind/DefaultBinding.java
  AL    src/main/java/org/apache/commons/inject/impl/bind/DefaultBindingBuilder.java
  AL    src/main/java/org/apache/commons/inject/impl/bind/EagerSingletonProvider.java
  AL    src/main/java/org/apache/commons/inject/impl/bind/LazySingletonProvider.java
  AL    src/main/java/org/apache/commons/inject/impl/bind/PerCallProvider.java
  AL    src/main/java/org/apache/commons/inject/impl/BindingProxy.java
  AL    src/main/java/org/apache/commons/inject/impl/DefaultInjector.java
  AL    src/main/java/org/apache/commons/inject/impl/DefaultInjectorBuilder.java
  AL    src/main/java/org/apache/commons/inject/impl/DefaultLifecycleController.java
  AL    src/main/java/org/apache/commons/inject/impl/DefaultProvider.java
  AL    src/main/java/org/apache/commons/inject/impl/FactoryMethodProvider.java
  AL    src/main/java/org/apache/commons/inject/impl/FieldPoint.java
  AL    src/main/java/org/apache/commons/inject/impl/IInjectorAware.java
  AL    src/main/java/org/apache/commons/inject/impl/ImmutableBindingSet.java
  AL    src/main/java/org/apache/commons/inject/impl/IMutableBindingSource.java
  AL    src/main/java/org/apache/commons/inject/impl/Introspector.java
  AL    src/main/java/org/apache/commons/inject/impl/ListPoint.java
  AL    src/main/java/org/apache/commons/inject/impl/MethodPoint.java
  AL    src/main/java/org/apache/commons/inject/impl/MutableBindingSet.java
  AL    src/main/java/org/apache/commons/inject/impl/ResolvableBindingSet.java
  AL    src/main/java/org/apache/commons/inject/util/Exceptions.java
  AL    src/main/java/org/apache/commons/inject/util/Generics.java
  AL    src/site/apt/building.apt
  AL    src/site/apt/download.apt
  AL    src/site/apt/index.apt
  AL    src/site/apt/lifecycle.apt
  AL    src/site/apt/loggerInjection.apt
  AL    src/site/apt/using.apt
 !????? src/site/fml/faq.fml
  B     src/site/resources/images/commons-logo.png
  B     src/site/resources/images/feather-small.gif
  AL    src/site/site.xml
  AL    src/test/java/org/apache/commons/inject/impl/InitializableObject.java
  AL    src/test/java/org/apache/commons/inject/impl/ListenerTest.java
  AL    src/test/java/org/apache/commons/inject/impl/Log4jLoggerModuleTest.java
  AL    src/test/java/org/apache/commons/inject/impl/SimpleInjectorTest.java
  AL    src/test/java/org/apache/commons/inject/impl/TckTest.java
  AL    src/test/java/org/apache/commons/inject/impl/TimeRecordingObject.java
 !????? src/test/java/org/apache/commons/inject/util/ExceptionsTest.java
 
 *****************************************************
 Printing headers for files without AL header...
 
 
 =======================================================================
 ==.gitignore
 =======================================================================
/target/

 =======================================================================
 ==pom.xml
 =======================================================================
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
  <modelVersion>4.0.0</modelVersion>
  <parent>
    <groupId>org.apache.commons</groupId>
    <artifactId>commons-sandbox-parent</artifactId>
    <version>10</version>
  </parent>
  <groupId>org.apache.commons.inject</groupId>
  <artifactId>commons-inject</artifactId>
  <version>0.0.1-SNAPSHOT</version>
  <name>Apache Commons Inject</name>
  <description>A JSR 330 compliant dependency injection framework.</description>
  <scm>
    <connection>scm:svn:https://svn.apache.org/repos/asf/commons/sandbox/commons-inject/trunk/</connection>
    <developerConnection>scm:svn:https://svn.apache.org/repos/asf/commons/sandbox/commons-inject/trunk/</developerConnection>
    <url>http://svn.apache.org/viewvc/commons/sandbox/commons-inject/trunk/</url>
  </scm>
  <build>
  	<pluginManagement>
  		<plugins>
  			<!--This plugin's configuration is used to store Eclipse m2e settings only. It has no influence on the Maven build itself.-->
  			<plugin>
  				<groupId>org.eclipse.m2e</groupId>
  				<artifactId>lifecycle-mapping</artifactId>
  				<version>1.0.0</version>
  				<configuration>
  					<lifecycleMappingMetadata>
  						<pluginExecutions>
  							<pluginExecution>
  								<pluginExecutionFilter>
  									<groupId>
  										org.apache.felix
  									</groupId>
  									<artifactId>
  										maven-bundle-plugin
  									</artifactId>
  									<versionRange>
  										[2.3.7,)
  									</versionRange>
  									<goals>
  										<goal>manifest</goal>
  									</goals>
  								</pluginExecutionFilter>
  								<action>
  									<execute/>
  								</action>
  							</pluginExecution>
  							<pluginExecution>
  								<pluginExecutionFilter>
  									<groupId>

 =======================================================================
 ==src/site/fml/faq.fml
 =======================================================================
<?xml version="1.0" encoding="UTF-8"?>
<faqs xmlns="http://maven.apache.org/FML/1.0.1"
  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  xsi:schemaLocation="http://maven.apache.org/FML/1.0.1 http://maven.apache.org/xsd/fml-1.0.1.xsd"
  title="Frequently Asked Questions"
  toplink="false">

  <part id="general">
    <title>General</title>

    <faq id="whats-commons-inject">
      <question>
        What is Commons Inject?
      </question>
      <answer>
        <p>Commons Inject is an implementation of
        <a href="https://jcp.org/en/jsr/detail?id=330">JSR 330 (Dependency Injection for Java)</a>.
        Or, in other words: It is a dependency injection framework, like
        <a href="https://github.com/google">Google Guice</a>, the
        core part of the <a href="http://projects.spring.io/spring-framework/">Spring Framework</a>,
        <a href="http://square.github.io/dagger/">Dagger</a>, or several others.</p>
      </answer>
    </faq>

    <faq id="standard-compliance">
      <question>
        Does Commons Inject really comply to the JSR 330 standard?
      </question>
      <answer>
        <p>Yes, it passes the JSR 330 TCK, with and without static injection.</p>
        <p>This means, if you have got an application, which is based on an
          alternative implementation of JSR 330, then it should be really easy,
          to port that application over to Commons Inject. In general, the only
          obvious thing to do would be to rewrite the configuration part.
          However, as Commons Injects configuration closely follows the
          configuration concepts from Guice, that should be really easy.</p>
      </answer>
    </faq>

    <faq id="comparison">
      <question>
        How does Commons Inject compare to other JSR 330 implementations?
      </question>
      <answer>
        <p>The author of Commons Inject believes that the framework has the
        following advantages over its competitors:</p>
          <ul>
            <li>It is very small, and lightweight. (As of this writing, it contains
            only 56 Java classes with 3833 lines of code, including test sources. The
            complete source distribution will have about only 1MB of data, without

 =======================================================================
 ==src/test/java/org/apache/commons/inject/util/ExceptionsTest.java
 =======================================================================
package org.apache.commons.inject.util;

import static org.junit.Assert.*;

import java.lang.reflect.UndeclaredThrowableException;

import org.junit.Assert;
import org.junit.Test;

public class ExceptionsTest {
	@Test
	public void testShowRTE() {
		final NullPointerException npe = new NullPointerException();
		Throwable th = null;
		try {
			throw Exceptions.show(npe);
		} catch (Throwable t) {
			th = t;
		}
		Assert.assertNotNull(th);
		Assert.assertSame(npe, th);
	}

	@Test
	public void testShowError() {
		final OutOfMemoryError oome = new OutOfMemoryError();
		Throwable th = null;
		try {
			throw Exceptions.show(oome);
		} catch (Throwable t) {
			th = t;
		}
		Assert.assertNotNull(th);
		Assert.assertSame(oome, th);
	}

	@Test
	public void testShowThrowable() {
		final Throwable t0 = new Throwable("Some throwable"){
		};
		Throwable th = null;
		try {
			throw Exceptions.show(t0);
		} catch (UndeclaredThrowableException ute) {
			th = ute.getCause();
		}
		Assert.assertNotNull(th);
		Assert.assertSame(t0, th);	}
	
}