Skip to content
Draft
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
284 commits
Select commit Hold shift + click to select a range
6c13956
Test that an Error thrown by a refresh during polling is reported and…
jwrosewell Nov 14, 2026
9051b19
Treat an Error from a check by polling or the file watcher as any oth…
jwrosewell Nov 14, 2026
0623e68
Test that Evidence keys ignore case in the whitelist filter and in th…
jwrosewell Nov 14, 2026
7f74f14
Compare Evidence keys ignoring case in the whitelist filter, and give…
jwrosewell Nov 14, 2026
20cadd0
Name the properties wanted on the cloud Pipeline builders, and test a…
jwrosewell Nov 14, 2026
32b3784
Share a header named Cookies by default, as only the Cookie header is…
jwrosewell Nov 14, 2026
576615e
Test that the examples write numbers a machine reads in the root locale
jwrosewell Nov 14, 2026
d6263a2
Write the numbers the examples give a machine in the root locale
jwrosewell Nov 14, 2026
bb1d8da
Merge remote-tracking branch 'origin/rc' into fix/root-locale
jwrosewell Nov 15, 2026
4de92f6
Cache the client-side endpoints' answers as the specification and RFC…
jwrosewell Nov 15, 2026
80ff50f
Log a data update download cut short, and every other HTTP failure, a…
jwrosewell Nov 15, 2026
4985c27
End every Device Detection and IP Intelligence example with a Find ou…
jwrosewell Nov 15, 2026
fcde776
End every Pipeline developer and Location console example with a Find…
jwrosewell Nov 15, 2026
de74c8c
Supply server.request-query in the web integration (#144)
jwrosewell Nov 15, 2026
c8df4bb
Test that Comparer runs with no settings on the free data file
jwrosewell Nov 14, 2026
1a95140
Run Comparer on the free data file, and say what the Enterprise data …
jwrosewell Nov 14, 2026
2eebbff
Write a no-value Property as null in the JSON, and refuse a bad proto…
jwrosewell Nov 15, 2026
7c22ff3
Test that every cloud example with no resource key ends cleanly
jwrosewell Nov 15, 2026
746df8c
End every cloud example cleanly when it has no resource key
jwrosewell Nov 15, 2026
67a4e56
Compare 51Did factor words ignoring case, and name the version of a s…
jwrosewell Nov 15, 2026
30e8df6
Build and run the examples from a fresh clone on the runner's own JDK…
jwrosewell Nov 15, 2026
94c2f53
Test that each warning in a cloud response is logged, with any licens…
jwrosewell Nov 15, 2026
b82d807
Log each warning in a cloud response, with any license key masked
jwrosewell Nov 15, 2026
c69350b
Remove the Enterprise file name Comparer no longer reads
jwrosewell Nov 15, 2026
206e9e9
Test the positions of the elements the web integration adds (#155)
jwrosewell Nov 15, 2026
50e63e4
Test that FodId keeps the byte layout, the payload version and its co…
jwrosewell Nov 15, 2026
8e53055
Say at start-up what the Enterprise data file adds in the IP Intellig…
jwrosewell Nov 15, 2026
c2d982a
Keep the configured interval test's update check from running before …
jwrosewell Nov 15, 2026
665aaa0
Read the watched file into memory in the check failure tests, as Wind…
jwrosewell Nov 15, 2026
74dd66f
Test that the JavaScript Builder passes on query Evidence whatever th…
jwrosewell Nov 15, 2026
9634d9d
Match the query prefix and the excluded keys ignoring case in the Jav…
jwrosewell Nov 15, 2026
4e537d3
Throw for a cloud property the response leaves out, as Location does …
jwrosewell Nov 15, 2026
8e4244e
Write the usage sharing record as the specification's Processing sect…
jwrosewell Nov 15, 2026
e2472ee
Stop sending usage data and discard the rest when closing has waited …
jwrosewell Nov 15, 2026
79dee49
Merge rc into examples/cloud-no-key
jwrosewell Nov 15, 2026
f8edc5f
Merge rc into fix/cloud-response-warnings
jwrosewell Nov 15, 2026
4c38482
Match the Location Find out more tests to the no-key message, and say…
jwrosewell Nov 15, 2026
b1e01f4
Build the warning text on one line in the masked warning test
jwrosewell Nov 15, 2026
2b84a80
Test: only one thread at a time reads the native results of finished …
jwrosewell Nov 15, 2026
8e1a1fc
Fix: hold one lock for every read of the native results in device data
jwrosewell Nov 15, 2026
3e252ca
Test: the engine adds metadata for each match metric, as the table gi…
jwrosewell Nov 15, 2026
56b1acf
Fix: give each match metric the Metrics component, and Method a singl…
jwrosewell Nov 15, 2026
aa549c4
Test: the engine's components include Metrics
jwrosewell Nov 15, 2026
4f5ab52
Fix: add the Metrics component to the engine's components
jwrosewell Nov 15, 2026
17a3469
Test: the engine gives the ids of the profiles that hold a value of a…
jwrosewell Nov 15, 2026
b627d35
Test: the usage sharing example has a unit test
jwrosewell Nov 15, 2026
a657a4f
Fix: give the profiles for a property value, and an Indexed Propertie…
jwrosewell Nov 15, 2026
ccce971
Test: every Device Detection engine populates Aspect Data
jwrosewell Nov 15, 2026
fe870d7
Test: on-premise and cloud engines return interface compatible data
jwrosewell Nov 15, 2026
5288ee6
Test: the engine reads the evidence keys again when the data is refre…
jwrosewell Nov 15, 2026
1ce6add
Test: device data reads a property from the native results only when …
jwrosewell Nov 15, 2026
57ecdd2
Fix: the usage sharing example can send to an endpoint it is given, s…
jwrosewell Nov 15, 2026
d71666f
Test: an engine configured with no property names is created with none
jwrosewell Nov 15, 2026
f234c41
Test: each example runs with no arguments or settings, as from a fres…
jwrosewell Nov 15, 2026
4c15cff
Test: the published Device Detection packages hold no tests or examples
jwrosewell Nov 15, 2026
84f79fa
Fix: the cloud examples end without an error when no resource key is …
jwrosewell Nov 15, 2026
c4f644a
Test: the comparison runs out of the box with the free data file
jwrosewell Nov 15, 2026
234d9ee
Fix: keep the test helpers out of the published device-detection.shar…
jwrosewell Nov 15, 2026
a15e255
Test: a read of a property the engine was created with goes by positi…
jwrosewell Nov 15, 2026
23783e5
Fix: find a property by its position, not by a native lookup of its name
jwrosewell Nov 15, 2026
7f5a917
Test: the engine reads what changes only on refresh from native code …
jwrosewell Nov 15, 2026
b157f26
Fix: the comparison uses the free Lite data file when there is no Ent…
jwrosewell Nov 15, 2026
ed5c951
Test: the comparison shows what only the Enterprise data file can do
jwrosewell Nov 15, 2026
74985cd
Test: the cloud Device Detection engine leaves processing to the shar…
jwrosewell Nov 15, 2026
5c440dc
Fix: let the shared Cloud Aspect Engine logic process for cloud Devic…
jwrosewell Nov 15, 2026
a4f3217
Test: the hardware profile cloud engine processes through the shared …
jwrosewell Nov 15, 2026
6ca2304
Fix: the comparison shows the properties it found, says which need th…
jwrosewell Nov 15, 2026
fdbb543
Test: there is an example for the Derived Property Element that runs …
jwrosewell Nov 15, 2026
fd0aaf9
Fix: add the Derived Property Element, reading scripts in format 1, a…
jwrosewell Nov 15, 2026
4d4998a
Test: the Derived Property Element example shows a script in code, a …
jwrosewell Nov 15, 2026
4829a19
Fix: the Derived Property Element example reads a script from a file …
jwrosewell Nov 15, 2026
90198fa
Test: the Derived Property Element example shows a source property th…
jwrosewell Nov 15, 2026
97a7a5b
Fix: the Derived Property Element example shows a reading with no hum…
jwrosewell Nov 15, 2026
92dbd8e
Test: the on-premise web example sets and documents suppressing proce…
jwrosewell Nov 15, 2026
85adf05
Test: the console examples make pipelines from options files for on-p…
jwrosewell Nov 15, 2026
f9eb229
Test: configuration files give a list as a comma-separated string and…
jwrosewell Nov 15, 2026
51569ef
Test: the same code reads the results of the cloud engine and the on-…
jwrosewell Nov 15, 2026
2566fe8
Fix: split a configured property list at each comma and set an enumer…
jwrosewell Nov 15, 2026
99ffe2e
Test: an Element Data key is compared without regard to case (PR-3)
jwrosewell Nov 15, 2026
07b0874
Test: the client-side element example builds, runs in a Pipeline and …
jwrosewell Nov 15, 2026
a7b03e3
Fix: the client-side element example compares dates of birth by day a…
jwrosewell Nov 15, 2026
b638246
Test: each cloud example run with no resource key ends without an err…
jwrosewell Nov 15, 2026
f4062c0
Test: the link to the configurator itself, not another link, is tagge…
jwrosewell Nov 15, 2026
10d2de7
Fix: find Element Data by its key without regard to case (PR-3)
jwrosewell Nov 15, 2026
e1f17c3
Fix: time the cached Pipeline overhead after the one call the cache m…
jwrosewell Nov 15, 2026
682d273
Fix: each cloud example given no resource key says which variable to …
jwrosewell Nov 15, 2026
a816cd7
Test: the data update example illustrates a programmatic update, aski…
jwrosewell Nov 15, 2026
7002189
Test: a data file and a temporary folder may be given as relative pat…
jwrosewell Nov 15, 2026
e9e98cd
Fix: the data update example illustrates a programmatic update, askin…
jwrosewell Nov 15, 2026
3c61c50
Test: the web examples illustrate obtaining high entropy values by th…
jwrosewell Nov 15, 2026
0dd259f
Test: a configuration file with the names the .NET sample uses builds…
jwrosewell Nov 15, 2026
e89a0ee
Fix: the web examples' pages say how they obtain high entropy values,…
jwrosewell Nov 15, 2026
ffb3dc8
Test: every Flow Element in the repository is made by its builder cla…
jwrosewell Nov 15, 2026
3d978c3
Fix: read SetAutoDisposeElements, the name other languages use, for s…
jwrosewell Nov 15, 2026
1ba2d24
Test: close usage sharing within its 5 second wait when the service s…
jwrosewell Nov 15, 2026
6c3c550
Test: every Hash engine Property has a description and data tiers (PR…
jwrosewell Nov 15, 2026
294688b
Test: the string stored for a Property can be read as well as the par…
jwrosewell Nov 15, 2026
ed039e9
Fix: the translation engines' base class is abstract, so a translatio…
jwrosewell Nov 15, 2026
117cf46
Test: the on-premise getting started console example adds no Usage Sh…
jwrosewell Nov 15, 2026
bbef6e4
Test: finish closing usage sharing within 5 seconds of its start
jwrosewell Nov 15, 2026
bcdb06b
Fix: finish closing usage sharing within 5 seconds of its start
jwrosewell Nov 15, 2026
c0203ce
Fix: the on-premise getting started console example turns usage shari…
jwrosewell Nov 15, 2026
61a505c
Fix: offer the stored string of an on-premise Property through Provid…
jwrosewell Nov 15, 2026
02a4d28
Test: each missing Property message has the text of the specification…
jwrosewell Nov 15, 2026
df84ae1
Fix: give each missing Property message the specification's text (PR-17)
jwrosewell Nov 15, 2026
f9b48b7
Test: the reason a Property is missing is decided in the specificatio…
jwrosewell Nov 15, 2026
efc7b8c
Fix: put the note that the translation engines' base class is abstrac…
jwrosewell Nov 15, 2026
ebaf75b
Say in AGENTS.md that a test failing on timing is fixed (#122)
jwrosewell Nov 16, 2026
1c59f13
Fix: decide the reason a Property is missing in the specification's o…
jwrosewell Nov 16, 2026
6ad767f
Test: element data keys hold only alphanumeric characters, full stop …
jwrosewell Nov 16, 2026
b157ff8
Test: element data keys are lower-case (PR-2)
jwrosewell Nov 16, 2026
3195f5d
Fix: leave an enumeration with its own parse method to that method wh…
jwrosewell Nov 16, 2026
20f9089
Specification conformance, 51degrees-java, section 15 (#175)
jwrosewell Nov 16, 2026
f957fff
Merge rc into the section 6 conformance work
jwrosewell Nov 16, 2026
8a48c33
Set the close time limit from every runner's measurements
jwrosewell Nov 16, 2026
39d527d
Merge rc into the JDK 25 build change
jwrosewell Nov 16, 2026
901de63
Merge rc into the section 10 conformance work
jwrosewell Nov 16, 2026
9ff3ff4
Merge rc into the section 11 conformance work
jwrosewell Nov 16, 2026
dc71201
Merge rc into the section 5 conformance work
jwrosewell Nov 16, 2026
464d294
Take rc's cloud aspect engine base, whose own way of reporting a fail…
jwrosewell Nov 16, 2026
3b3a671
Fix: list the new web example test as reading the old data file name,…
jwrosewell Nov 16, 2026
343baac
Build the Device Detection example tests from a fresh clone (#187)
jwrosewell Nov 16, 2026
402ab9c
Run the usage sharing builder tests, which JUnit 5 passed over (#142)
jwrosewell Nov 16, 2026
81e3d4a
Describe the examples as they run today in AGENTS.md and the example …
jwrosewell Nov 16, 2026
f17fd53
Build every example and its tests against the published packages
jwrosewell Nov 16, 2026
79de9f2
Merge rc into the usage sharing close time work
jwrosewell Nov 16, 2026
77a0e5e
Assert the specification's 5 second bound on closing
jwrosewell Nov 16, 2026
dbc6c8d
Merge rc into the Device Detection engine work
jwrosewell Nov 16, 2026
4c60460
Merge rc into the Property metadata work
jwrosewell Nov 16, 2026
cdd4138
Take the Device Detection test files off the deprecated FileUtils
jwrosewell Nov 16, 2026
3472227
Take the property metadata test off the deprecated FileUtils
jwrosewell Nov 16, 2026
7a8ae6d
Merge rc into the examples work
jwrosewell Nov 16, 2026
8a20d1e
Use the examples' own key check in hasResourceKey
jwrosewell Nov 16, 2026
77914ce
Take Comparer and its test off the deprecated FileUtils
jwrosewell Nov 16, 2026
d8877db
Merge rc into the JDK 25 build work
jwrosewell Nov 16, 2026
db2907a
Merge rc into the IP Intelligence weightings work
jwrosewell Nov 16, 2026
effb54f
Test that a missing Property is answered in plain text with the tagge…
jwrosewell Nov 16, 2026
3afe55c
Answer a missing Property with the tagged contact link in plain text
jwrosewell Nov 16, 2026
88c03aa
Keep rc's getNamedKey and isInvalidKey, which the merge of rc gave th…
jwrosewell Nov 16, 2026
a52f006
Keep rc's missing property service tests, which an earlier merge of r…
jwrosewell Nov 16, 2026
c441d14
Merge rc into examples/comparer-free-file
jwrosewell Nov 16, 2026
0955829
Merge rc into examples/cloud-no-key
jwrosewell Nov 16, 2026
bd93f86
Leave the Derived Property Element, Comparer and the cloud examples w…
jwrosewell Nov 16, 2026
4c75843
Test that a Promise of Full made at run time gives the script its pro…
jwrosewell Nov 16, 2026
7fd9ea0
Compare the Promise value as text, so Full read from a data file give…
jwrosewell Nov 16, 2026
49e8960
Merge rc into fix/data-update-check-failures
jwrosewell Nov 16, 2026
d4122b2
Merge rc into fix/evidence-key-case
jwrosewell Nov 16, 2026
0bf566c
Use the examples' own key check, as rc's examples no longer import Ke…
jwrosewell Nov 16, 2026
e8c2559
Keep FileUtils and KeyUtils in the published jar, deprecated, as rc h…
jwrosewell Nov 16, 2026
60d509f
Let the published jar keep the two deprecated test helpers, and nothi…
jwrosewell Nov 16, 2026
6d4454c
Read cloud Device Detection values when the Property metadata is empt…
jwrosewell Nov 16, 2026
820a544
Minify the JavaScript with a third-party library, and test the JSON e…
jwrosewell Nov 16, 2026
56c21f5
Build the IP Intelligence API example on this repository's JSON Build…
jwrosewell Nov 16, 2026
12c0e79
Merge rc into the Device Detection engine work
jwrosewell Nov 16, 2026
d0362dc
Test: run-fresh-clone-example.ps1 takes -ExpectDownload as typed with…
jwrosewell Nov 16, 2026
075ffb8
Fix: run-fresh-clone-example.ps1 takes -ExpectDownload as a switch
jwrosewell Nov 16, 2026
06ac80d
Read each options file from the example's own resources in the config…
jwrosewell Nov 16, 2026
3276aab
Quote the specification's cleanup sentence in the close limit test
jwrosewell Nov 16, 2026
3384bec
Merge rc into fix/evidence-key-case
jwrosewell Nov 16, 2026
c218e23
Read the script as written in the query prefix test, as rc now minifi…
jwrosewell Nov 16, 2026
4e01032
Merge rc into fix/cloud-response-warnings
jwrosewell Nov 16, 2026
b6c613f
Merge rc into fix/promise-full-equals
jwrosewell Nov 16, 2026
b4d6f50
Test that a watcher check whose refresh throws an Error leaves a poll…
jwrosewell Nov 16, 2026
115197b
Register a watched data file again however its refresh ends, so an Er…
jwrosewell Nov 16, 2026
c1e7424
Process through the engine's public process in the empty metadata tes…
jwrosewell Nov 16, 2026
e2d9a01
Share every query value by default, and no cookie but 51D_ ones even …
jwrosewell Nov 16, 2026
933e424
Lock every read of IP Intelligence native results, type Latitude and …
jwrosewell Nov 16, 2026
c54795a
Log the data update errors table's rows as the specification gives th…
jwrosewell Nov 16, 2026
0b07ef0
Merge rc into fix/data-update-check-failures
jwrosewell Nov 16, 2026
fd2bda3
Split a property list given as one string at every comma (#166)
jwrosewell Nov 16, 2026
46115d7
Find Element Data by its key whatever the case (#167)
jwrosewell Nov 16, 2026
5cae01c
Merge rc into the Property metadata work
jwrosewell Nov 16, 2026
9af6ee0
Keep rc's TypedKeyMapBuilder, which #167 brought
jwrosewell Nov 16, 2026
96a04e4
Say in the empty metadata tests that the cloud request ran, as the sh…
jwrosewell Nov 16, 2026
91b52ae
Let the published jar keep the folder entry of the two deprecated tes…
jwrosewell Nov 16, 2026
1353220
Test that the web docs and examples say a Flow Data is used by one th…
jwrosewell Nov 17, 2026
88b8bff
Test that usage sharing runs last and is refused anywhere else
jwrosewell Nov 18, 2026
51d40de
Test the Pipeline builder's check for a Flow Element that runs last
jwrosewell Nov 18, 2026
3d29fb3
Run usage sharing last and refuse it anywhere else
jwrosewell Nov 18, 2026
51119b9
Say and show in the web docs and examples that a Flow Data is used by…
jwrosewell Nov 18, 2026
72f1186
Test that a parallel group member adds its Element Data without waiting
jwrosewell Nov 18, 2026
6541cc3
Add Element Data with one compare and swap, and take no lock to add it
jwrosewell Nov 18, 2026
3cb282b
Test that each on-premise builder adds usage sharing after caller ele…
jwrosewell Nov 18, 2026
49cb34c
Test that a refused on-premise builder closes what it made
jwrosewell Nov 18, 2026
5fde454
Close what a refused on-premise builder made
jwrosewell Nov 18, 2026
6a0290d
Test that parallel group members add their errors under a lock
jwrosewell Nov 18, 2026
93589da
Add parallel group members' errors under a lock while the group runs
jwrosewell Nov 18, 2026
ce10eaf
Merge pull request #140 from 51Degrees/fix/pmd-jdk25
jwrosewell Nov 18, 2026
7b5aa6e
Merge pull request #180 from 51Degrees/remote/java-06
ben51degrees Nov 18, 2026
0aef389
Merge pull request #196 from 51Degrees/remote/java-expectdownload
ben51degrees Nov 18, 2026
a9ec006
Merge pull request #203 from 51Degrees/parallel/usage-sharing-last
ben51degrees Nov 18, 2026
cfc7f0b
Merge pull request #204 from 51Degrees/parallel/web-flow-data-one-thread
ben51degrees Nov 18, 2026
a21a2df
Merge pull request #206 from 51Degrees/parallel/element-data-no-lock
ben51degrees Nov 18, 2026
59eaa6d
Merge pull request #169 from 51Degrees/fix/evidence-key-case
ben51degrees Nov 19, 2026
6980ed0
Merge pull request #53 from 51Degrees/fix/seo-doxyfile-noindex-titles
jwrosewell Nov 19, 2026
eb6a79e
Merge pull request #56 from 51Degrees/bug/did-live-test-another-address
jwrosewell Nov 19, 2026
07a94dd
Merge pull request #163 from 51Degrees/examples/cloud-no-key
ben51degrees Nov 19, 2026
c52cdbc
Merge pull request #165 from 51Degrees/fix/cloud-response-warnings
ben51degrees Nov 19, 2026
49bc431
Merge pull request #168 from 51Degrees/test/usage-sharing-untested
ben51degrees Nov 19, 2026
59d11e4
Merge rc into the Property metadata work
jwrosewell Nov 19, 2026
6998871
Read the stored string with no lock on the results instance
jwrosewell Nov 19, 2026
9d5db0e
Check that the IP Intelligence example prints each value's weighting
jwrosewell Nov 19, 2026
4bb1bbe
Test: Device Detection data reads its native results with no lock
jwrosewell Nov 19, 2026
bcac3b8
Fix: read Device Detection's native results with no lock
jwrosewell Nov 19, 2026
bfc08ce
Keep cloud Device Detection's own processing, as released
jwrosewell Nov 19, 2026
7014ac9
Test: TranslationEngineBase stays a concrete public class
jwrosewell Nov 19, 2026
f34859b
Fix: keep TranslationEngineBase concrete, as released
jwrosewell Nov 19, 2026
f2e9f4f
Merge rc into the IP Intelligence weightings work
jwrosewell Nov 19, 2026
1166f45
Read each IP Intelligence value by name, so the example prints its we…
jwrosewell Nov 19, 2026
69de988
Keep the released ComparerTest
jwrosewell Nov 19, 2026
1442b1d
Merge rc into the root locale work
jwrosewell Nov 19, 2026
e9852a1
Merge rc into the cloud host lookup work
jwrosewell Nov 19, 2026
3b95ce0
Merge pull request #158 from 51Degrees/examples/comparer-free-file
jwrosewell Nov 19, 2026
c31e733
Merge pull request #173 from 51Degrees/remote/java-05
ben51degrees Nov 19, 2026
3bb6e71
Merge pull request #179 from 51Degrees/remote/java-10
ben51degrees Nov 19, 2026
9b1fa72
Merge rc into the work that builds every example in the fresh clone c…
jwrosewell Nov 19, 2026
ebe5997
Merge pull request #135 from 51Degrees/fix/root-locale
jwrosewell Nov 19, 2026
d340e1b
Merge pull request #148 from 51Degrees/examples/ipi-weightings
ben51degrees Nov 19, 2026
5a4caf5
Test that the cloud IP Intelligence page credits OpenStreetMap for it…
51DTechResponse Nov 19, 2026
fd2b13c
Credit OpenStreetMap, not CARTO, on the cloud IP Intelligence page
51DTechResponse Nov 19, 2026
4c1dfa7
Describe the repository to Context7
jwrosewell Nov 19, 2026
06a7d13
Merge pull request #211 from 51Degrees/docs/context7-one-commit
jwrosewell Nov 19, 2026
0f89937
Merge pull request #55 from 51Degrees/feature/switch-leaflet-to-osm-t…
jwrosewell Nov 19, 2026
a90bdd4
Stop reading the deprecated environment variable names
jwrosewell Nov 19, 2026
6de8e0f
Stop reading the old endpoint name in the client test
Tracy51D Nov 19, 2026
b0134b8
Merge pull request #213 from 51Degrees/env/remove-old-names
ben51degrees Nov 19, 2026
905c8bc
Merge pull request #146 from 51Degrees/fix/data-update-check-failures
ben51degrees Nov 19, 2026
6503c27
Merge pull request #193 from 51Degrees/examples/missing-property-plai…
ben51degrees Nov 19, 2026
dd4c53f
Merge pull request #194 from 51Degrees/fix/promise-full-equals
ben51degrees Nov 19, 2026
5269b68
Merge pull request #192 from 51Degrees/remote/java-fresh-clone
ben51degrees Nov 19, 2026
1364548
Merge pull request #123 from 51Degrees/feature/cloud-host-lookup-with…
ben51degrees Nov 19, 2026
4ff58d8
Merge pull request #174 from 51Degrees/remote/java-11
ben51degrees Nov 19, 2026
bf86d3e
Make the cloud mixed web example pass the shared browser tests (#58)
ben51degrees Nov 19, 2026
fc6f28a
Run one refresh of an on-premise engine at a time (#214)
ben51degrees Nov 20, 2026
4dc7a39
Context7 description written for this library (#212)
jwrosewell Nov 20, 2026
d50a748
Document the Sequence Element must not run in a parallel group (#195)
jwrosewell Nov 20, 2026
4afa278
Write usage sharing invariant values hourly, tied by a ProcessId
jwrosewell Nov 20, 2026
3fec0a5
Fail every write to a Flow Data that has finished processing (#201)
jwrosewell Nov 20, 2026
03328ec
Listen on port 5151 by default in the web examples (#216)
51DTechResponse Nov 20, 2026
fe21818
Close an on-premise engine only after a running refresh ends, and ref…
51DTechResponse Nov 21, 2026
8d29d01
Specification conformance, 51degrees-java, section 13 (#171)
jwrosewell Nov 21, 2026
da70593
Share a query or form parameter only when 51D_ or the Pipeline uses i…
jwrosewell Nov 21, 2026
712b03a
Add the Derived Property Element and its example (#156)
jwrosewell Nov 21, 2026
fe37e1b
Nine fixes the specification asks for, in usage sharing, data updates…
jwrosewell Nov 21, 2026
11aa49f
Read each test key only under its _51DEGREES_ name, and skip without …
51DTechResponse Nov 21, 2026
021bd02
Fail a write to Element Data once its Flow Element has finished, and …
jwrosewell Nov 21, 2026
eee3c93
Wait longer in tests for macOS file watchers and the live cloud service
51DTechResponse Nov 21, 2026
c1e9e70
Make the cloud response a lazy task, so the Cloud Request Engine retu…
jwrosewell Nov 21, 2026
87d1b6b
Reuse Element Data through an object pool (#207)
jwrosewell Nov 21, 2026
7b17e4c
Let a cloud result replace one the cache will never serve (#219)
jwrosewell Nov 21, 2026
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
The table of contents is too big for display.
Diff view
Diff view
  •  
  •  
  •  
47 changes: 47 additions & 0 deletions .github/workflows/ci-script-tests.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,47 @@
name: CI script tests

# Runs the Pester tests of the scripts in ci on Linux and Windows, where the
# builds run them. The environment variable names workflow runs its own test.
# The test of run-fresh-clone-example.ps1 also runs the calls in
# examples-fresh-clone.yml, so a change to that workflow runs the tests too.

on:
pull_request:
paths:
- 'ci/**'
- '.github/workflows/ci-script-tests.yml'
# run-fresh-clone-example.Tests.ps1 runs the calls this workflow makes.
- '.github/workflows/examples-fresh-clone.yml'
push:
branches:
- main
- rc
paths:
- 'ci/**'
- '.github/workflows/ci-script-tests.yml'
- '.github/workflows/examples-fresh-clone.yml'
workflow_dispatch:

permissions:
contents: read

jobs:
ci-script-tests:
name: Test the CI scripts on ${{ matrix.os }}
strategy:
fail-fast: false
matrix:
os: [ubuntu-latest, windows-latest]
runs-on: ${{ matrix.os }}
steps:
- name: Checkout repository
uses: actions/checkout@v4
with:
persist-credentials: false

- name: Run the tests
shell: pwsh
run: |
$tests = Get-ChildItem ./ci -Filter *.Tests.ps1 |
Where-Object Name -ne 'check-environment-variable-names.Tests.ps1'
Invoke-Pester -Path $tests.FullName -CI -Output Detailed
50 changes: 39 additions & 11 deletions .github/workflows/cloud-51did.yml
Original file line number Diff line number Diff line change
Expand Up @@ -7,6 +7,12 @@ name: Cloud 51Did Tests
# the cloud for a 51Did and fail, saying so, when a key gets an answer with no
# identifier in it. That is entitlement working rather than a fault.
#
# Each run also runs the Cloud Request Engine's live test on a license key
# alone (pipeline/pipeline.cloudrequestengine, CloudRequestEngineLiveTests),
# with the cloud license in _51DEGREES_LICENSE_KEY_BESPOKE. Without one that
# test skips. _51DEGREES_LICENSE_KEY holds the license for the data files, so
# it is not set here.
#
# The secrets are named one by one rather than passed as toJSON(secrets).
# GitHub marks a workflow that hands every secret to a step as possibly
# malicious and holds each run for manual approval, so the nightly never ran.
Expand All @@ -29,9 +35,10 @@ on:
schedule:
- cron: '10 5 * * *'
pull_request:
branches: [main]
branches: [main, rc]
paths:
- 'pipeline/pipeline.did/**'
- 'pipeline/pipeline.cloudrequestengine/**'
- 'pipeline/owid-java/**'
- '.github/workflows/cloud-51did.yml'

Expand All @@ -55,13 +62,29 @@ jobs:
shell: pwsh
env:
_51DEGREES_RESOURCE_KEY_BESPOKE: ${{ secrets._51DEGREES_RESOURCE_KEY_BESPOKE }}
_51DEGREES_RESOURCE_KEY_51DID: ${{ vars._51DEGREES_RESOURCE_KEY_51DID }}
_51DEGREES_RESOURCE_KEY_51DID: ${{ secrets._51DEGREES_RESOURCE_KEY_51DID }}
# Without a license key the tests that redeem a sealed verdict skip.
# The service only redeems with a license key of the resource key's
# own account, so each one is paired by suffix with the resource
# key it belongs to.
# own account, so each resource key is paired by suffix with the
# license key it belongs to. Only the 51DID pass gets this one.
_51DEGREES_LICENSE_KEY_51DID: ${{ secrets._51DEGREES_LICENSE_KEY_51DID }}
# The license for the cloud products, for the test on a license key
# alone.
_51DEGREES_LICENSE_KEY_BESPOKE: ${{ secrets._51DEGREES_LICENSE_KEY_BESPOKE }}
run: |
# A license key whose resource key of the same suffix is empty means
# that secret is missing. Its licensed tests would then never run,
# and the job would still pass, so it fails here, naming it.
$missing = Get-ChildItem env: |
Where-Object { $_.Name -like '_51DEGREES_LICENSE_KEY_*' -and $_.Value } |
ForEach-Object { $_.Name -replace '^_51DEGREES_LICENSE_KEY', '_51DEGREES_RESOURCE_KEY' } |
Where-Object { -not [Environment]::GetEnvironmentVariable($_) }
if ($missing) {
throw ("The secret $($missing -join ', ') is empty or missing, " +
'but the license key of the same suffix is set. Add the ' +
'organization secret, a resource key of the same account as ' +
'that license key.')
}
$keys = Get-ChildItem env: |
Where-Object { $_.Name -like '_51DEGREES_RESOURCE_KEY*' -and $_.Value }
if (-not $keys) {
Expand All @@ -71,22 +94,27 @@ jobs:
'from a fork gets no secrets, so run this workflow from a ' +
'branch in this repository.')
}
# The 51Did tests redeem with _51DEGREES_LICENSE_KEY_51DID. A pass
# whose resource key is not paired with it by suffix redeems with no
# license, so those tests skip rather than come back unreadable.
$didLicense = $env:_51DEGREES_LICENSE_KEY_51DID
$failed = $false
foreach ($k in $keys) {
Write-Host "::group::DidClientLiveTests with $($k.Name)"
Write-Host "::group::Live tests with $($k.Name)"
$env:_51DEGREES_RESOURCE_KEY = $k.Value
$licenseName = $k.Name -replace '^_51DEGREES_RESOURCE_KEY', '_51DEGREES_LICENSE_KEY'
$license = [Environment]::GetEnvironmentVariable($licenseName)
if ($license) {
if ($licenseName -eq '_51DEGREES_LICENSE_KEY_51DID' -and $didLicense) {
Write-Host "License key: $licenseName"
$env:_51DEGREES_LICENSE_KEY = $license
$env:_51DEGREES_LICENSE_KEY_51DID = $didLicense
} else {
Write-Host 'License key: none'
Remove-Item Env:_51DEGREES_LICENSE_KEY -ErrorAction SilentlyContinue
Remove-Item Env:_51DEGREES_LICENSE_KEY_51DID -ErrorAction SilentlyContinue
}
# Only the Pipeline API tree is built, as in its own repository.
mvn -B -f pipeline/pom.xml -pl pipeline.did -am test `
-Dtest=DidClientLiveTests -DfailIfNoTests=false
mvn -B -f pipeline/pom.xml `
-pl pipeline.did,pipeline.cloudrequestengine -am test `
'-Dtest=DidClientLiveTests,CloudRequestEngineLiveTests#build_Process_LicenseKeyAlone*' `
-DfailIfNoTests=false
if ($LASTEXITCODE -ne 0) { $failed = $true }
Write-Host '::endgroup::'
}
Expand Down
5 changes: 1 addition & 4 deletions .github/workflows/data-file-change.yml
Original file line number Diff line number Diff line change
Expand Up @@ -23,7 +23,4 @@ jobs:
org-name: ${{ github.event.repository.owner.login }}
dryrun: ${{ inputs.dryrun || false }}
common-ci-ref: ${{ inputs.common-ci-ref || '' }}
secrets:
token: ${{ secrets.ACCESS_TOKEN }}
data-key: ${{ secrets.DEVICE_DETECTION_KEY }}
data-url: ${{ secrets.DEVICE_DETECTION_URL }}
secrets: inherit
3 changes: 1 addition & 2 deletions .github/workflows/example-assets-update.yml
Original file line number Diff line number Diff line change
Expand Up @@ -22,5 +22,4 @@ jobs:
with:
repo-name: ${{ github.event.repository.name }}
common-ci-ref: ${{ inputs.common-ci-ref || '' }}
secrets:
token: ${{ secrets.ACCESS_TOKEN }}
secrets: inherit
145 changes: 145 additions & 0 deletions .github/workflows/examples-fresh-clone.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,145 @@
name: Examples from a fresh clone

# Builds each product's console examples as AGENTS.md says, from a clone
# with its submodules, against the packages published on Maven Central, with
# the JDK and Maven the runner has. Then runs the getting started example
# from the repository root with no settings. A fresh clone holds only a link
# for each free data file. On Ubuntu the example downloads its file, which
# tests the download, and the job keeps the file in the cache. The other
# systems take it from there, so each file is downloaded once a run. The
# Ubuntu job also builds every example module, with its tests compiled,
# against the published packages.

on:
pull_request:
paths:
- 'examples/**'
- 'cxx'
- '.github/workflows/examples-fresh-clone.yml'
- 'ci/run-fresh-clone-example.ps1'
push:
branches:
- main
- rc
schedule:
- cron: '30 4 * * *'
workflow_dispatch:

permissions:
contents: read

jobs:
download:
name: ${{ matrix.product }} on ubuntu-latest, downloading its data file
strategy:
fail-fast: false
matrix:
include:
- product: device-detection
example: fiftyone.devicedetection.examples.console.GettingStartedOnPrem
file: cxx/data/device-detection/51Degrees-LiteV4.1.hash
expect: ''
- product: ip-intelligence
example: fiftyone.ipintelligence.examples.console.GettingStartedOnPrem
file: cxx/data/ip-intelligence/51Degrees-LiteV41.ipi
# Each IP Intelligence value is printed with its weighting.
expect: '(weighting '
runs-on: ubuntu-latest
steps:
- name: Clone the repository with its submodules
uses: actions/checkout@v4
with:
submodules: recursive
persist-credentials: false

- name: The runner's Java and Maven
shell: pwsh
run: |
java -version
mvn -v

- name: Build the console examples against the published packages
working-directory: examples/${{ matrix.product }}
shell: pwsh
run: mvn -B --no-transfer-progress -pl console -am package -DskipTests

- name: Run the getting started example from the repository root
shell: pwsh
run: >-
./ci/run-fresh-clone-example.ps1 -Product '${{ matrix.product }}'
-Example '${{ matrix.example }}' -ExpectDownload
-Expect '${{ matrix.expect }}'

# The key follows the link, so a new free file gets a new entry, and
# the same file is kept once rather than once a run.
- name: Keep the data file for the other systems
uses: actions/cache/save@v4
with:
path: ${{ matrix.file }}
key: fresh-clone-${{ matrix.product }}-${{ hashFiles(format('{0}.link', matrix.file)) }}
enableCrossOsArchive: true

# The console build above compiles the console examples and their
# tests. This builds every example module, the web examples too, with
# its tests compiled, against the published packages, so a test that
# uses a class the published packages lack fails here. It comes after
# the cache is saved, so the other systems still get the data file. The
# tests are not run here, as the pull request build runs them.
- name: Build every example and its tests against the published packages
working-directory: examples/${{ matrix.product }}
shell: pwsh
run: mvn -B --no-transfer-progress package -DskipTests

other-systems:
name: ${{ matrix.product }} on ${{ matrix.os }}
needs: download
strategy:
fail-fast: false
matrix:
# macOS runners are shared by the whole organisation, so pull
# requests leave them out and the pushes and the daily run use them.
os: ${{ fromJSON(github.event_name == 'pull_request' && '["windows-latest"]' || '["windows-latest", "macos-latest"]') }}
product: [device-detection, ip-intelligence]
include:
- product: device-detection
example: fiftyone.devicedetection.examples.console.GettingStartedOnPrem
file: cxx/data/device-detection/51Degrees-LiteV4.1.hash
expect: ''
- product: ip-intelligence
example: fiftyone.ipintelligence.examples.console.GettingStartedOnPrem
file: cxx/data/ip-intelligence/51Degrees-LiteV41.ipi
# Each IP Intelligence value is printed with its weighting.
expect: '(weighting '
runs-on: ${{ matrix.os }}
steps:
- name: Clone the repository with its submodules
uses: actions/checkout@v4
with:
submodules: recursive
persist-credentials: false

- name: Take the data file the Ubuntu job downloaded
uses: actions/cache/restore@v4
with:
path: ${{ matrix.file }}
key: fresh-clone-${{ matrix.product }}-${{ hashFiles(format('{0}.link', matrix.file)) }}
enableCrossOsArchive: true
fail-on-cache-miss: true

- name: The runner's Java and Maven
shell: pwsh
run: |
java -version
mvn -v

- name: Build the console examples against the published packages
working-directory: examples/${{ matrix.product }}
shell: pwsh
run: mvn -B --no-transfer-progress -pl console -am package -DskipTests

- name: Run the getting started example from the repository root
shell: pwsh
run: >-
./ci/run-fresh-clone-example.ps1 -Product '${{ matrix.product }}'
-Example '${{ matrix.example }}' -ExpectDownload:$false
-Expect '${{ matrix.expect }}'
3 changes: 1 addition & 2 deletions .github/workflows/monthly-copyright-update.yml
Original file line number Diff line number Diff line change
Expand Up @@ -17,5 +17,4 @@ jobs:
repo-name: ${{ github.event.repository.name }}
org-name: ${{ github.event.repository.owner.login }}
dryrun: ${{ inputs.dryrun || false }}
secrets:
token: ${{ secrets.ACCESS_TOKEN }}
secrets: inherit
Loading
Loading