API changes reports

classic Classic list List threaded Threaded
2 messages Options
Reply | Threaded
Open this post in threaded view
|  
Report Content as Inappropriate

API changes reports

Ponomarenko Andrey
Hello,

The reports for Saxon-HE libraries have been added to the API tracker project: http://abi-laboratory.pro/java/tracker/timeline/saxon-he/

So one can look at the recent changes in the API and navigate over the history of API changes. The reports are generated daily by japi-compliance-checker and japi-tracker tools: https://github.com/lvc/japi-tracker

Hope this will help maintainers and developers of the library to maintain backward compatibility.

Thanks for your feedback.

------------------------------------------------------------------------------
Mobile security can be enabling, not merely restricting. Employees who
bring their own devices (BYOD) to work are irked by the imposition of MDM
restrictions. Mobile Device Manager Plus allows you to control only the
apps on BYO-devices by containerizing them, leaving personal data untouched!
https://ad.doubleclick.net/ddm/clk/304595813;131938128;j
_______________________________________________
saxon-help mailing list archived at http://saxon.markmail.org/
[hidden email]
https://lists.sourceforge.net/lists/listinfo/saxon-help 
Reply | Threaded
Open this post in threaded view
|  
Report Content as Inappropriate

Re: API changes reports

Michael Kay
Fascinating.

What do "BC" and "SC" mean? (Binary and Source perhaps?)

I guess this is looking at all public methods in the JAR file, rather than only those which constitute the documented API. It's good to see some tooling looking at this area: I have for a long time had on my wish-list the idea of a Java annotation where I can mark certain classes or methods as stable, and have my IDE give an "are you sure" prompt if anyone tries to change them.

(Even better, I remember on VME we were in effect able to distinguish functions that were public within the issued JAR file from those that were public outside it; we're exposing far too many methods than we should be.)

I'm still a little surpised by the volume of change between major releases. It would be nice to understand the metrics better. It must somehow be telling us that a lot of things have changed in very small ways.

And of course, a tool like this can only measure syntactic compatibility, not semantic compatibility. A lot of problems arise with semantic compatibility, e.g. passing null where we used to pass a zero-length string.

Michael Kay
Saxonica


> On 11 May 2016, at 14:16, Ponomarenko Andrey <[hidden email]> wrote:
>
> Hello,
>
> The reports for Saxon-HE libraries have been added to the API tracker project: http://abi-laboratory.pro/java/tracker/timeline/saxon-he/
>
> So one can look at the recent changes in the API and navigate over the history of API changes. The reports are generated daily by japi-compliance-checker and japi-tracker tools: https://github.com/lvc/japi-tracker
>
> Hope this will help maintainers and developers of the library to maintain backward compatibility.
>
> Thanks for your feedback.
>
> ------------------------------------------------------------------------------
> Mobile security can be enabling, not merely restricting. Employees who
> bring their own devices (BYOD) to work are irked by the imposition of MDM
> restrictions. Mobile Device Manager Plus allows you to control only the
> apps on BYO-devices by containerizing them, leaving personal data untouched!
> https://ad.doubleclick.net/ddm/clk/304595813;131938128;j
> _______________________________________________
> saxon-help mailing list archived at http://saxon.markmail.org/
> [hidden email]
> https://lists.sourceforge.net/lists/listinfo/saxon-help 



------------------------------------------------------------------------------
Mobile security can be enabling, not merely restricting. Employees who
bring their own devices (BYOD) to work are irked by the imposition of MDM
restrictions. Mobile Device Manager Plus allows you to control only the
apps on BYO-devices by containerizing them, leaving personal data untouched!
https://ad.doubleclick.net/ddm/clk/304595813;131938128;j
_______________________________________________
saxon-help mailing list archived at http://saxon.markmail.org/
[hidden email]
https://lists.sourceforge.net/lists/listinfo/saxon-help 
Loading...