("maven") {
from(components["java"])
pom {
name.set("${project.group}:${project.name}")
description.set("@API Guardian")
url.set("https://github.com/apiguardian-team/apiguardian")
scm {
connection.set("scm:git:git://github.com/apiguardian-team/apiguardian.git")
developerConnection.set("scm:git:git://github.com/apiguardian-team/apiguardian.git")
url.set("https://github.com/apiguardian-team/apiguardian")
}
licenses {
license {
name.set("The Apache License, Version 2.0")
url.set("http://www.apache.org/licenses/LICENSE-2.0.txt")
}
}
developers {
developer {
id.set("apiguardian")
name.set("@API Guardian Team")
email.set("team@apiguardian.org")
}
}
}
}
}
}
gitPublish {
repoUri.set("https://github.com/apiguardian-team/apiguardian.git")
branch.set("gh-pages")
contents {
from(docsDir)
into("docs")
}
preserve {
include("**/*")
exclude("docs/$docsVersion/**")
if (replaceCurrentDocs) {
exclude("docs/current/**")
}
}
}
apiguardian-r1.1.2/gradle.properties 0000664 0000000 0000000 00000000165 14066072240 0017540 0 ustar 00root root 0000000 0000000 group = org.apiguardian
version = 1.1.2
defaultBuiltBy = @API Guardian Team
releaseBranch = master
apiguardian-r1.1.2/gradlew 0000775 0000000 0000000 00000013216 14066072240 0015540 0 ustar 00root root 0000000 0000000 #!/usr/bin/env sh
#
# Copyright 2015 the original author or authors.
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
# https://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.
#
##############################################################################
##
## Gradle start up script for UN*X
##
##############################################################################
# Attempt to set APP_HOME
# Resolve links: $0 may be a link
PRG="$0"
# Need this for relative symlinks.
while [ -h "$PRG" ] ; do
ls=`ls -ld "$PRG"`
link=`expr "$ls" : '.*-> \(.*\)$'`
if expr "$link" : '/.*' > /dev/null; then
PRG="$link"
else
PRG=`dirname "$PRG"`"/$link"
fi
done
SAVED="`pwd`"
cd "`dirname \"$PRG\"`/" >/dev/null
APP_HOME="`pwd -P`"
cd "$SAVED" >/dev/null
APP_NAME="Gradle"
APP_BASE_NAME=`basename "$0"`
# Add default JVM options here. You can also use JAVA_OPTS and GRADLE_OPTS to pass JVM options to this script.
DEFAULT_JVM_OPTS='"-Xmx64m" "-Xms64m"'
# Use the maximum available, or set MAX_FD != -1 to use that value.
MAX_FD="maximum"
warn () {
echo "$*"
}
die () {
echo
echo "$*"
echo
exit 1
}
# OS specific support (must be 'true' or 'false').
cygwin=false
msys=false
darwin=false
nonstop=false
case "`uname`" in
CYGWIN* )
cygwin=true
;;
Darwin* )
darwin=true
;;
MSYS* | MINGW* )
msys=true
;;
NONSTOP* )
nonstop=true
;;
esac
CLASSPATH=$APP_HOME/gradle/wrapper/gradle-wrapper.jar
# Determine the Java command to use to start the JVM.
if [ -n "$JAVA_HOME" ] ; then
if [ -x "$JAVA_HOME/jre/sh/java" ] ; then
# IBM's JDK on AIX uses strange locations for the executables
JAVACMD="$JAVA_HOME/jre/sh/java"
else
JAVACMD="$JAVA_HOME/bin/java"
fi
if [ ! -x "$JAVACMD" ] ; then
die "ERROR: JAVA_HOME is set to an invalid directory: $JAVA_HOME
Please set the JAVA_HOME variable in your environment to match the
location of your Java installation."
fi
else
JAVACMD="java"
which java >/dev/null 2>&1 || die "ERROR: JAVA_HOME is not set and no 'java' command could be found in your PATH.
Please set the JAVA_HOME variable in your environment to match the
location of your Java installation."
fi
# Increase the maximum file descriptors if we can.
if [ "$cygwin" = "false" -a "$darwin" = "false" -a "$nonstop" = "false" ] ; then
MAX_FD_LIMIT=`ulimit -H -n`
if [ $? -eq 0 ] ; then
if [ "$MAX_FD" = "maximum" -o "$MAX_FD" = "max" ] ; then
MAX_FD="$MAX_FD_LIMIT"
fi
ulimit -n $MAX_FD
if [ $? -ne 0 ] ; then
warn "Could not set maximum file descriptor limit: $MAX_FD"
fi
else
warn "Could not query maximum file descriptor limit: $MAX_FD_LIMIT"
fi
fi
# For Darwin, add options to specify how the application appears in the dock
if $darwin; then
GRADLE_OPTS="$GRADLE_OPTS \"-Xdock:name=$APP_NAME\" \"-Xdock:icon=$APP_HOME/media/gradle.icns\""
fi
# For Cygwin or MSYS, switch paths to Windows format before running java
if [ "$cygwin" = "true" -o "$msys" = "true" ] ; then
APP_HOME=`cygpath --path --mixed "$APP_HOME"`
CLASSPATH=`cygpath --path --mixed "$CLASSPATH"`
JAVACMD=`cygpath --unix "$JAVACMD"`
# We build the pattern for arguments to be converted via cygpath
ROOTDIRSRAW=`find -L / -maxdepth 1 -mindepth 1 -type d 2>/dev/null`
SEP=""
for dir in $ROOTDIRSRAW ; do
ROOTDIRS="$ROOTDIRS$SEP$dir"
SEP="|"
done
OURCYGPATTERN="(^($ROOTDIRS))"
# Add a user-defined pattern to the cygpath arguments
if [ "$GRADLE_CYGPATTERN" != "" ] ; then
OURCYGPATTERN="$OURCYGPATTERN|($GRADLE_CYGPATTERN)"
fi
# Now convert the arguments - kludge to limit ourselves to /bin/sh
i=0
for arg in "$@" ; do
CHECK=`echo "$arg"|egrep -c "$OURCYGPATTERN" -`
CHECK2=`echo "$arg"|egrep -c "^-"` ### Determine if an option
if [ $CHECK -ne 0 ] && [ $CHECK2 -eq 0 ] ; then ### Added a condition
eval `echo args$i`=`cygpath --path --ignore --mixed "$arg"`
else
eval `echo args$i`="\"$arg\""
fi
i=`expr $i + 1`
done
case $i in
0) set -- ;;
1) set -- "$args0" ;;
2) set -- "$args0" "$args1" ;;
3) set -- "$args0" "$args1" "$args2" ;;
4) set -- "$args0" "$args1" "$args2" "$args3" ;;
5) set -- "$args0" "$args1" "$args2" "$args3" "$args4" ;;
6) set -- "$args0" "$args1" "$args2" "$args3" "$args4" "$args5" ;;
7) set -- "$args0" "$args1" "$args2" "$args3" "$args4" "$args5" "$args6" ;;
8) set -- "$args0" "$args1" "$args2" "$args3" "$args4" "$args5" "$args6" "$args7" ;;
9) set -- "$args0" "$args1" "$args2" "$args3" "$args4" "$args5" "$args6" "$args7" "$args8" ;;
esac
fi
# Escape application args
save () {
for i do printf %s\\n "$i" | sed "s/'/'\\\\''/g;1s/^/'/;\$s/\$/' \\\\/" ; done
echo " "
}
APP_ARGS=`save "$@"`
# Collect all arguments for the java command, following the shell quoting and substitution rules
eval set -- $DEFAULT_JVM_OPTS $JAVA_OPTS $GRADLE_OPTS "\"-Dorg.gradle.appname=$APP_BASE_NAME\"" -classpath "\"$CLASSPATH\"" org.gradle.wrapper.GradleWrapperMain "$APP_ARGS"
exec "$JAVACMD" "$@"
apiguardian-r1.1.2/gradlew.bat 0000664 0000000 0000000 00000005313 14066072240 0016301 0 ustar 00root root 0000000 0000000 @rem
@rem Copyright 2015 the original author or authors.
@rem
@rem Licensed under the Apache License, Version 2.0 (the "License");
@rem you may not use this file except in compliance with the License.
@rem You may obtain a copy of the License at
@rem
@rem https://www.apache.org/licenses/LICENSE-2.0
@rem
@rem Unless required by applicable law or agreed to in writing, software
@rem distributed under the License is distributed on an "AS IS" BASIS,
@rem WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
@rem See the License for the specific language governing permissions and
@rem limitations under the License.
@rem
@if "%DEBUG%" == "" @echo off
@rem ##########################################################################
@rem
@rem Gradle startup script for Windows
@rem
@rem ##########################################################################
@rem Set local scope for the variables with windows NT shell
if "%OS%"=="Windows_NT" setlocal
set DIRNAME=%~dp0
if "%DIRNAME%" == "" set DIRNAME=.
set APP_BASE_NAME=%~n0
set APP_HOME=%DIRNAME%
@rem Resolve any "." and ".." in APP_HOME to make it shorter.
for %%i in ("%APP_HOME%") do set APP_HOME=%%~fi
@rem Add default JVM options here. You can also use JAVA_OPTS and GRADLE_OPTS to pass JVM options to this script.
set DEFAULT_JVM_OPTS="-Xmx64m" "-Xms64m"
@rem Find java.exe
if defined JAVA_HOME goto findJavaFromJavaHome
set JAVA_EXE=java.exe
%JAVA_EXE% -version >NUL 2>&1
if "%ERRORLEVEL%" == "0" goto execute
echo.
echo ERROR: JAVA_HOME is not set and no 'java' command could be found in your PATH.
echo.
echo Please set the JAVA_HOME variable in your environment to match the
echo location of your Java installation.
goto fail
:findJavaFromJavaHome
set JAVA_HOME=%JAVA_HOME:"=%
set JAVA_EXE=%JAVA_HOME%/bin/java.exe
if exist "%JAVA_EXE%" goto execute
echo.
echo ERROR: JAVA_HOME is set to an invalid directory: %JAVA_HOME%
echo.
echo Please set the JAVA_HOME variable in your environment to match the
echo location of your Java installation.
goto fail
:execute
@rem Setup the command line
set CLASSPATH=%APP_HOME%\gradle\wrapper\gradle-wrapper.jar
@rem Execute Gradle
"%JAVA_EXE%" %DEFAULT_JVM_OPTS% %JAVA_OPTS% %GRADLE_OPTS% "-Dorg.gradle.appname=%APP_BASE_NAME%" -classpath "%CLASSPATH%" org.gradle.wrapper.GradleWrapperMain %*
:end
@rem End local scope for the variables with windows NT shell
if "%ERRORLEVEL%"=="0" goto mainEnd
:fail
rem Set variable GRADLE_EXIT_CONSOLE if you need the _script_ return code instead of
rem the _cmd.exe /c_ return code!
if not "" == "%GRADLE_EXIT_CONSOLE%" exit 1
exit /b 1
:mainEnd
if "%OS%"=="Windows_NT" endlocal
:omega
apiguardian-r1.1.2/settings.gradle.kts 0000664 0000000 0000000 00000000272 14066072240 0020003 0 ustar 00root root 0000000 0000000 rootProject.name = "apiguardian-api"
require(JavaVersion.current().isJava11) {
"The @API Guardian build requires Java 11. Currently executing with Java ${JavaVersion.current()}."
}
apiguardian-r1.1.2/src/ 0000775 0000000 0000000 00000000000 14066072240 0014751 5 ustar 00root root 0000000 0000000 apiguardian-r1.1.2/src/main/ 0000775 0000000 0000000 00000000000 14066072240 0015675 5 ustar 00root root 0000000 0000000 apiguardian-r1.1.2/src/main/java/ 0000775 0000000 0000000 00000000000 14066072240 0016616 5 ustar 00root root 0000000 0000000 apiguardian-r1.1.2/src/main/java/org/ 0000775 0000000 0000000 00000000000 14066072240 0017405 5 ustar 00root root 0000000 0000000 apiguardian-r1.1.2/src/main/java/org/apiguardian/ 0000775 0000000 0000000 00000000000 14066072240 0021671 5 ustar 00root root 0000000 0000000 apiguardian-r1.1.2/src/main/java/org/apiguardian/api/ 0000775 0000000 0000000 00000000000 14066072240 0022442 5 ustar 00root root 0000000 0000000 apiguardian-r1.1.2/src/main/java/org/apiguardian/api/API.java 0000664 0000000 0000000 00000010116 14066072240 0023715 0 ustar 00root root 0000000 0000000 /*
* Copyright 2002-2017 the original author or authors.
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
package org.apiguardian.api;
import static java.lang.annotation.ElementType.CONSTRUCTOR;
import static java.lang.annotation.ElementType.FIELD;
import static java.lang.annotation.ElementType.METHOD;
import static java.lang.annotation.ElementType.PACKAGE;
import static java.lang.annotation.ElementType.TYPE;
import static java.lang.annotation.RetentionPolicy.RUNTIME;
import java.lang.annotation.Documented;
import java.lang.annotation.Retention;
import java.lang.annotation.Target;
/**
* {@code @API} is used to annotate public types, methods, constructors, and
* fields within a framework or application in order to publish their
* {@link #status} and level of stability and to indicate how they are intended
* to be used by {@link #consumers} of the API.
*
* If {@code @API} is present on a type, it is considered to hold for all
* public members of the type as well. However, a member of such an annotated
* type is allowed to declare a {@link Status} of lower stability. For example,
* a class annotated with {@code @API(status = STABLE)} may declare a constructor
* for internal usage that is annotated with {@code @API(status = INTERNAL)}.
*
*
If {@code @API} is present on a package, it is considered to hold for all
* public types in its package. The same rules for lowered stability apply as
* if they were specified on a type.
*
* @since 1.0
*/
@Target({ TYPE, METHOD, CONSTRUCTOR, FIELD, PACKAGE })
@Retention(RUNTIME)
@Documented
public @interface API {
/**
* The current {@linkplain Status status} of the API.
*/
Status status();
/**
* The version of the API when the {@link #status} was last changed.
*
*
Defaults to an empty string, signifying that the since
* version is unknown.
*/
String since() default "";
/**
* List of packages belonging to intended consumers.
*
*
The supplied packages can be fully qualified package names or
* patterns containing asterisks that will be used as wildcards.
*
*
Defaults to {@code "*"}, signifying that the API is intended to be
* consumed by any package.
*/
String[] consumers() default "*";
/**
* Indicates the status of an API element and therefore its level of
* stability as well.
*/
enum Status {
/**
* Must not be used by any external code. Might be removed without prior
* notice.
*/
INTERNAL,
/**
* Should no longer be used. Might disappear in the next minor release.
*
*
This status is usually used in combination with the standard annotation
* {@link Deprecated @Deprecated} because that annotation is recognized by
* IDEs and the compiler. However, there are also cases where this status
* can be used on its own, for example when transitioning a {@link #MAINTAINED}
* feature to an {@link #INTERNAL} one.
*/
DEPRECATED,
/**
* Intended for new, experimental features where the publisher of the
* API is looking for feedback.
*
*
Use with caution. Might be promoted to {@link #MAINTAINED} or
* {@link #STABLE} in the future, but might also be removed without
* prior notice.
*/
EXPERIMENTAL,
/**
* Intended for features that will not be changed in a backwards-incompatible
* way for at least the next minor release of the current major version.
* If scheduled for removal, such a feature will be demoted to
* {@link #DEPRECATED} first.
*/
MAINTAINED,
/**
* Intended for features that will not be changed in a backwards-incompatible
* way in the current major version.
*/
STABLE;
}
}
apiguardian-r1.1.2/src/module/ 0000775 0000000 0000000 00000000000 14066072240 0016236 5 ustar 00root root 0000000 0000000 apiguardian-r1.1.2/src/module/java/ 0000775 0000000 0000000 00000000000 14066072240 0017157 5 ustar 00root root 0000000 0000000 apiguardian-r1.1.2/src/module/java/org.apiguardian.api/ 0000775 0000000 0000000 00000000000 14066072240 0023001 5 ustar 00root root 0000000 0000000 apiguardian-r1.1.2/src/module/java/org.apiguardian.api/module-info.java 0000664 0000000 0000000 00000000076 14066072240 0026065 0 ustar 00root root 0000000 0000000 module org.apiguardian.api {
exports org.apiguardian.api;
}