You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@accumulo.apache.org by bu...@apache.org on 2015/01/26 18:15:46 UTC
accumulo git commit: ACCUMULO-3531 update japi-compliance-check
configs.
Repository: accumulo
Updated Branches:
refs/heads/master ec6a15e1f -> 6f14edac3
ACCUMULO-3531 update japi-compliance-check configs.
Project: http://git-wip-us.apache.org/repos/asf/accumulo/repo
Commit: http://git-wip-us.apache.org/repos/asf/accumulo/commit/6f14edac
Tree: http://git-wip-us.apache.org/repos/asf/accumulo/tree/6f14edac
Diff: http://git-wip-us.apache.org/repos/asf/accumulo/diff/6f14edac
Branch: refs/heads/master
Commit: 6f14edac3391aa448a184c103672572fe6193c48
Parents: ec6a15e
Author: Sean Busbey <bu...@cloudera.com>
Authored: Sun Jan 25 03:00:59 2015 -0600
Committer: Sean Busbey <bu...@cloudera.com>
Committed: Mon Jan 26 11:15:07 2015 -0600
----------------------------------------------------------------------
test/compat/japi-compliance/README | 25 +++++++++++++
test/compat/japi-compliance/exclude_classes.txt | 1 +
.../japi-compliance/japi-accumulo-1.5.0.xml | 36 ++++++++++++++++++
.../japi-compliance/japi-accumulo-1.5.1.xml | 36 ++++++++++++++++++
.../japi-compliance/japi-accumulo-1.5.2.xml | 36 ++++++++++++++++++
.../japi-compliance/japi-accumulo-1.5.xml | 36 ------------------
.../japi-compliance/japi-accumulo-1.6.0.xml | 38 +++++++++++++++++++
.../japi-compliance/japi-accumulo-1.6.1.xml | 38 +++++++++++++++++++
.../japi-compliance/japi-accumulo-1.6.2.xml | 38 +++++++++++++++++++
.../japi-compliance/japi-accumulo-1.6.xml | 39 --------------------
.../japi-compliance/japi-accumulo-master.xml | 38 +++++++++++++++++++
11 files changed, 286 insertions(+), 75 deletions(-)
----------------------------------------------------------------------
http://git-wip-us.apache.org/repos/asf/accumulo/blob/6f14edac/test/compat/japi-compliance/README
----------------------------------------------------------------------
diff --git a/test/compat/japi-compliance/README b/test/compat/japi-compliance/README
index 8715f98..0b77050 100644
--- a/test/compat/japi-compliance/README
+++ b/test/compat/japi-compliance/README
@@ -24,5 +24,30 @@ following command.
japi-compliance-checker.pl -skip-deprecated -old japi-accumulo-1.5.xml -new japi-accumulo-1.6.xml -l accumulo
+Optionally, you can use the --skip-classes argument with the provided exclude_classes.txt file to skip classes from
+org.apache.accumulo.core.data that aren't in the public API.
+
+This directory should have a library configuration file for each release on supported lines as well as an in-progress
+for whatever version is currently the master branch. The examples below all make use of version-specific library definitions.
+
+When looking at a patch release, you should verify that changes introduced are forwards and backwards compatible, per
+semver.
+
+ # Backwards compatibility from x.y.z to x.y.(z+1)
+ japi-compliance-checker.pl -old japi-accumulo-1.6.1.xml -new japi-accumulo-1.6.2.xml -l accumulo --skip-classes=exclude_classes.txt
+ # Forwards compatibility from x.y.z to x.y.(z+1). Note that the old / new arguments have been swapped.
+ japi-compliance-checker.pl -new japi-accumulo-1.6.1.xml -old japi-accumulo-1.6.2.xml -l accumulo --skip-classes=exclude_classes.txt
+
+When looking at a minor release, you should verify that change are backwards compatible, per semver.
+
+ # Backwards compatibility from x.y.z to x.(y+1).0
+ japi-compliance-checker.pl -old japi-accumulo-1.6.1.xml -new japi-accumulo-1.7.0.xml -l accumulo --skip-classes=exclude_classes.txt
+
+When looking at a major release, you should examine removals to make sure they are not capricious. Specifically, you should ensure that
+they have been deprecated for a full major version.
+
+ # Advisory backwards compatibility check from x.y.z to (x+1).0.0
+ japi-compliance-checker.pl -old japi-accumulo-1.7.0.xml -new japi-accumulo-2.0.0.xml -l accumulo --skip-classes=exclude_classes.txt
+
[1]: http://ispras.linuxbase.org/index.php/Java_API_Compliance_Checker
http://git-wip-us.apache.org/repos/asf/accumulo/blob/6f14edac/test/compat/japi-compliance/exclude_classes.txt
----------------------------------------------------------------------
diff --git a/test/compat/japi-compliance/exclude_classes.txt b/test/compat/japi-compliance/exclude_classes.txt
new file mode 100644
index 0000000..94356b7
--- /dev/null
+++ b/test/compat/japi-compliance/exclude_classes.txt
@@ -0,0 +1 @@
+org.apache.accumulo.core.data.KeyValue
http://git-wip-us.apache.org/repos/asf/accumulo/blob/6f14edac/test/compat/japi-compliance/japi-accumulo-1.5.0.xml
----------------------------------------------------------------------
diff --git a/test/compat/japi-compliance/japi-accumulo-1.5.0.xml b/test/compat/japi-compliance/japi-accumulo-1.5.0.xml
new file mode 100644
index 0000000..f49dbb5
--- /dev/null
+++ b/test/compat/japi-compliance/japi-accumulo-1.5.0.xml
@@ -0,0 +1,36 @@
+<!--
+ Licensed to the Apache Software Foundation (ASF) under one or more
+ contributor license agreements. See the NOTICE file distributed with
+ this work for additional information regarding copyright ownership.
+ The ASF licenses this file to You 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.
+-->
+<version>
+ 1.5.0
+</version>
+
+<archives>
+ CHANGEME/accumulo-1.5.0/lib/accumulo-core.jar
+ CHANGEME/accumulo-1.5.0/lib/accumulo-minicluster.jar
+</archives>
+
+<skip_packages>
+ org.apache.accumulo.core.client.impl
+ org.apache.accumulo.core.data.thrift
+</skip_packages>
+
+<packages>
+ org.apache.accumulo.core.client
+ org.apache.accumulo.core.data
+ org.apache.accumulo.minicluster
+</packages>
+
http://git-wip-us.apache.org/repos/asf/accumulo/blob/6f14edac/test/compat/japi-compliance/japi-accumulo-1.5.1.xml
----------------------------------------------------------------------
diff --git a/test/compat/japi-compliance/japi-accumulo-1.5.1.xml b/test/compat/japi-compliance/japi-accumulo-1.5.1.xml
new file mode 100644
index 0000000..ff92506
--- /dev/null
+++ b/test/compat/japi-compliance/japi-accumulo-1.5.1.xml
@@ -0,0 +1,36 @@
+<!--
+ Licensed to the Apache Software Foundation (ASF) under one or more
+ contributor license agreements. See the NOTICE file distributed with
+ this work for additional information regarding copyright ownership.
+ The ASF licenses this file to You 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.
+-->
+<version>
+ 1.5.1
+</version>
+
+<archives>
+ CHANGEME/accumulo-1.5.1/lib/accumulo-core.jar
+ CHANGEME/accumulo-1.5.1/lib/accumulo-minicluster.jar
+</archives>
+
+<skip_packages>
+ org.apache.accumulo.core.client.impl
+ org.apache.accumulo.core.data.thrift
+</skip_packages>
+
+<packages>
+ org.apache.accumulo.core.client
+ org.apache.accumulo.core.data
+ org.apache.accumulo.minicluster
+</packages>
+
http://git-wip-us.apache.org/repos/asf/accumulo/blob/6f14edac/test/compat/japi-compliance/japi-accumulo-1.5.2.xml
----------------------------------------------------------------------
diff --git a/test/compat/japi-compliance/japi-accumulo-1.5.2.xml b/test/compat/japi-compliance/japi-accumulo-1.5.2.xml
new file mode 100644
index 0000000..8d7a668
--- /dev/null
+++ b/test/compat/japi-compliance/japi-accumulo-1.5.2.xml
@@ -0,0 +1,36 @@
+<!--
+ Licensed to the Apache Software Foundation (ASF) under one or more
+ contributor license agreements. See the NOTICE file distributed with
+ this work for additional information regarding copyright ownership.
+ The ASF licenses this file to You 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.
+-->
+<version>
+ 1.5.2
+</version>
+
+<archives>
+ CHANGEME/accumulo-1.5.2/lib/accumulo-core.jar
+ CHANGEME/accumulo-1.5.2/lib/accumulo-minicluster.jar
+</archives>
+
+<skip_packages>
+ org.apache.accumulo.core.client.impl
+ org.apache.accumulo.core.data.thrift
+</skip_packages>
+
+<packages>
+ org.apache.accumulo.core.client
+ org.apache.accumulo.core.data
+ org.apache.accumulo.minicluster
+</packages>
+
http://git-wip-us.apache.org/repos/asf/accumulo/blob/6f14edac/test/compat/japi-compliance/japi-accumulo-1.5.xml
----------------------------------------------------------------------
diff --git a/test/compat/japi-compliance/japi-accumulo-1.5.xml b/test/compat/japi-compliance/japi-accumulo-1.5.xml
deleted file mode 100644
index f49dbb5..0000000
--- a/test/compat/japi-compliance/japi-accumulo-1.5.xml
+++ /dev/null
@@ -1,36 +0,0 @@
-<!--
- Licensed to the Apache Software Foundation (ASF) under one or more
- contributor license agreements. See the NOTICE file distributed with
- this work for additional information regarding copyright ownership.
- The ASF licenses this file to You 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.
--->
-<version>
- 1.5.0
-</version>
-
-<archives>
- CHANGEME/accumulo-1.5.0/lib/accumulo-core.jar
- CHANGEME/accumulo-1.5.0/lib/accumulo-minicluster.jar
-</archives>
-
-<skip_packages>
- org.apache.accumulo.core.client.impl
- org.apache.accumulo.core.data.thrift
-</skip_packages>
-
-<packages>
- org.apache.accumulo.core.client
- org.apache.accumulo.core.data
- org.apache.accumulo.minicluster
-</packages>
-
http://git-wip-us.apache.org/repos/asf/accumulo/blob/6f14edac/test/compat/japi-compliance/japi-accumulo-1.6.0.xml
----------------------------------------------------------------------
diff --git a/test/compat/japi-compliance/japi-accumulo-1.6.0.xml b/test/compat/japi-compliance/japi-accumulo-1.6.0.xml
new file mode 100644
index 0000000..cb1c22f
--- /dev/null
+++ b/test/compat/japi-compliance/japi-accumulo-1.6.0.xml
@@ -0,0 +1,38 @@
+<!--
+ Licensed to the Apache Software Foundation (ASF) under one or more
+ contributor license agreements. See the NOTICE file distributed with
+ this work for additional information regarding copyright ownership.
+ The ASF licenses this file to You 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.
+-->
+<version>
+ 1.6.0
+</version>
+
+<archives>
+ CHANGEME/accumulo-1.6.0/core/target/accumulo-core-1.6.0.jar
+ CHANGEME/accumulo-1.6.0/minicluster/target/accumulo-minicluster-1.6.0.jar
+</archives>
+
+<skip_packages>
+ org.apache.accumulo.core.client.impl
+ org.apache.accumulo.core.client.lexicoders.impl
+ org.apache.accumulo.core.client.mapreduce.lib.impl
+ org.apache.accumulo.core.data.thrift
+ org.apache.accumulo.minicluster.impl
+</skip_packages>
+
+<packages>
+ org.apache.accumulo.core.client
+ org.apache.accumulo.core.data
+ org.apache.accumulo.minicluster
+</packages>
http://git-wip-us.apache.org/repos/asf/accumulo/blob/6f14edac/test/compat/japi-compliance/japi-accumulo-1.6.1.xml
----------------------------------------------------------------------
diff --git a/test/compat/japi-compliance/japi-accumulo-1.6.1.xml b/test/compat/japi-compliance/japi-accumulo-1.6.1.xml
new file mode 100644
index 0000000..30e6068
--- /dev/null
+++ b/test/compat/japi-compliance/japi-accumulo-1.6.1.xml
@@ -0,0 +1,38 @@
+<!--
+ Licensed to the Apache Software Foundation (ASF) under one or more
+ contributor license agreements. See the NOTICE file distributed with
+ this work for additional information regarding copyright ownership.
+ The ASF licenses this file to You 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.
+-->
+<version>
+ 1.6.1
+</version>
+
+<archives>
+ CHANGEME/accumulo-1.6.1/core/target/accumulo-core-1.6.1.jar
+ CHANGEME/accumulo-1.6.1/minicluster/target/accumulo-minicluster-1.6.1.jar
+</archives>
+
+<skip_packages>
+ org.apache.accumulo.core.client.impl
+ org.apache.accumulo.core.client.lexicoders.impl
+ org.apache.accumulo.core.client.mapreduce.lib.impl
+ org.apache.accumulo.core.data.thrift
+ org.apache.accumulo.minicluster.impl
+</skip_packages>
+
+<packages>
+ org.apache.accumulo.core.client
+ org.apache.accumulo.core.data
+ org.apache.accumulo.minicluster
+</packages>
http://git-wip-us.apache.org/repos/asf/accumulo/blob/6f14edac/test/compat/japi-compliance/japi-accumulo-1.6.2.xml
----------------------------------------------------------------------
diff --git a/test/compat/japi-compliance/japi-accumulo-1.6.2.xml b/test/compat/japi-compliance/japi-accumulo-1.6.2.xml
new file mode 100644
index 0000000..8327206
--- /dev/null
+++ b/test/compat/japi-compliance/japi-accumulo-1.6.2.xml
@@ -0,0 +1,38 @@
+<!--
+ Licensed to the Apache Software Foundation (ASF) under one or more
+ contributor license agreements. See the NOTICE file distributed with
+ this work for additional information regarding copyright ownership.
+ The ASF licenses this file to You 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.
+-->
+<version>
+ 1.6.2
+</version>
+
+<archives>
+ CHANGEME/accumulo-1.6.2/core/target/accumulo-core-1.6.2.jar
+ CHANGEME/accumulo-1.6.2/minicluster/target/accumulo-minicluster-1.6.2.jar
+</archives>
+
+<skip_packages>
+ org.apache.accumulo.core.client.impl
+ org.apache.accumulo.core.client.lexicoders.impl
+ org.apache.accumulo.core.client.mapreduce.lib.impl
+ org.apache.accumulo.core.data.thrift
+ org.apache.accumulo.minicluster.impl
+</skip_packages>
+
+<packages>
+ org.apache.accumulo.core.client
+ org.apache.accumulo.core.data
+ org.apache.accumulo.minicluster
+</packages>
http://git-wip-us.apache.org/repos/asf/accumulo/blob/6f14edac/test/compat/japi-compliance/japi-accumulo-1.6.xml
----------------------------------------------------------------------
diff --git a/test/compat/japi-compliance/japi-accumulo-1.6.xml b/test/compat/japi-compliance/japi-accumulo-1.6.xml
deleted file mode 100644
index 0403a96..0000000
--- a/test/compat/japi-compliance/japi-accumulo-1.6.xml
+++ /dev/null
@@ -1,39 +0,0 @@
-<!--
- Licensed to the Apache Software Foundation (ASF) under one or more
- contributor license agreements. See the NOTICE file distributed with
- this work for additional information regarding copyright ownership.
- The ASF licenses this file to You 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.
--->
-<version>
- 1.6.0-SNAPSHOT
-</version>
-
-<archives>
- ../../../core/target/accumulo-core-1.6.0-SNAPSHOT.jar
- ../../../minicluster/target/accumulo-minicluster-1.6.0-SNAPSHOT.jar
-</archives>
-
-<skip_packages>
- org.apache.accumulo.core.client.impl
- org.apache.accumulo.core.client.lexicoders.impl
- org.apache.accumulo.core.client.mapreduce.lib.impl
- org.apache.accumulo.core.data.thrift
- org.apache.accumulo.minicluster.impl
-</skip_packages>
-
-<packages>
- org.apache.accumulo.core.client
- org.apache.accumulo.core.data
- org.apache.accumulo.minicluster
-</packages>
-
http://git-wip-us.apache.org/repos/asf/accumulo/blob/6f14edac/test/compat/japi-compliance/japi-accumulo-master.xml
----------------------------------------------------------------------
diff --git a/test/compat/japi-compliance/japi-accumulo-master.xml b/test/compat/japi-compliance/japi-accumulo-master.xml
new file mode 100644
index 0000000..2fc184e
--- /dev/null
+++ b/test/compat/japi-compliance/japi-accumulo-master.xml
@@ -0,0 +1,38 @@
+<!--
+ Licensed to the Apache Software Foundation (ASF) under one or more
+ contributor license agreements. See the NOTICE file distributed with
+ this work for additional information regarding copyright ownership.
+ The ASF licenses this file to You 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.
+-->
+<version>
+ 1.7.0-SNAPSHOT
+</version>
+
+<archives>
+ ../../../core/target/accumulo-core-1.7.0-SNAPSHOT.jar
+ ../../../minicluster/target/accumulo-minicluster-1.7.0-SNAPSHOT.jar
+</archives>
+
+<skip_packages>
+ org.apache.accumulo.core.client.impl
+ org.apache.accumulo.core.client.lexicoders.impl
+ org.apache.accumulo.core.client.mapreduce.lib.impl
+ org.apache.accumulo.core.data.thrift
+ org.apache.accumulo.minicluster.impl
+</skip_packages>
+
+<packages>
+ org.apache.accumulo.core.client
+ org.apache.accumulo.core.data
+ org.apache.accumulo.minicluster
+</packages>