-
Notifications
You must be signed in to change notification settings - Fork 6
/
README
104 lines (77 loc) · 2.56 KB
/
README
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
NAME:
Java API Tracker - visualize API changes timeline of a Java library.
The tool requires input profile of the library in JSON format. It can be created manually or automatically generated by the Java API Monitor.
Sample report: https://abi-laboratory.pro/java/tracker/timeline/slf4j/
The tool is developed by Andrey Ponomarenko: https://abi-laboratory.pro/
INSTALL:
sudo make install prefix=/usr
REQUIRES:
Perl 5
Java API Compliance Checker (2.4 or newer)
Java API Monitor (1.3 or newer)
PkgDiff (1.6.4 or newer)
USAGE:
japi-tracker [options] [profile]
The input profile can be generated by the API Monitor tool. All manual edits in the profile will be preserved after re-generating it by the API Monitor.
The home page of the output report is: timeline/LIB_NAME/index.html
EXAMPLES:
japi-tracker -build slf4j.json
CRON JOB:
japi-monitor -get -build-new [profile]
japi-tracker -build [profile]
PROFILE FORMAT:
{
"Name": "SHORT LIBRARY NAME",
"SourceUrl": "URL TO DOWNLOAD PACKAGES",
"Maintainer": "MAINTAINER NAME",
"Versions": [
{
"Number": "VERSION NUMBER",
"Installed": "INSTALL TREE PATH",
"Source": "SOURCE PACKAGE PATH",
"Changelog": "CHANGELOG: On/Off",
"PkgDiff": "PACKAGE DIFF: On/Off"
},
...
{
...
}]
}
PROFILE EXAMPLE:
{
"Name": "slf4j",
"SourceUrl": "http://www.slf4j.org/dist/",
"Maintainer": "Andrey P.",
"Versions": [
{
"Number": "1.7.19",
"Installed": "installed/slf4j/1.7.19",
"Source": "src/slf4j/1.7.19/slf4j-1.7.19.zip",
"Changelog": "Off",
"PkgDiff": "Off"
},
{
"Number": "1.7.18",
"Installed": "installed/slf4j/1.7.18",
"Source": "src/slf4j/1.7.18/slf4j-1.7.18.zip",
"Changelog": "Off",
"PkgDiff": "Off"
},
...
{
"Number": "1.6.0",
"Installed": "installed/slf4j/1.6.0",
"Source": "src/slf4j/1.6.0/slf4j-1.6.0.zip",
"Changelog": "Off",
"PkgDiff": "Off"
}]
}
ADV. OPTIONS:
If you want to allow users to connect the maintainer of the tracker then you can set "MaintainerUrl" option.
To skip checking of some archives in the install tree of a library please define "SkipArchives": ["A1", ..., "An"] option.
The name of the analysed library in the title can be changed by "Title" option.
ADV. OPTIONS OF A VERSION:
To hide some version in the report you can define "Deleted" option.
ADV. USAGE:
For advanced usage, see output of --help option.
Enjoy!