Add EOL API

[iliajie]

Hey Jamie,

As discussed here I created an API to return an object of EOL related data for the current system.

Returned EOL object looks like this:

{
  '_eol' => {
    'daymonth' => 'Wednesday, June 10',
    'month' => 'June',
    'short' => '06/10/2026',
    'timestamp' => 1781038800,
    'year' => '2026'
  },
  '_eol_in' => {
    'days' => 791,
    'months' => 25,
    'weeks' => 113,
    'years' => 2
  },
  '_eol_sec' => {
    'daymonth' => 'Saturday, June 10',
    'month' => 'June',
    'short' => '06/10/2028',
    'timestamp' => 1844197200,
    'year' => '2028'
  },
  '_eol_sec_in' => {
    'days' => 1522,
    'months' => 50,
    'weeks' => 217,
    'years' => 4
  },
  '_os' => 'Debian Linux',
  'codename' => 'Bookworm',
  'cycle' => '12',
  'eol' => '2026-06-10',
  'extendedSupport' => '2028-06-10',
  'latest' => '12.5',
  'latestReleaseDate' => '2024-02-10',
  'link' => 'https://www.debian.org/News/2023/20230610',
  'lts' => 1,
  'releaseDate' => '2023-06-10'
}

We can later use it in alert message, and table row to be show on the dashboard depending on configurable options.

The EOL data is cached for 5 days by default.

Have a look please!

[jcameron]

Why not just return a timestamp and have the caller of this API format it as they want?

[iliajie]

It's better call it once and make object just ready.

[jcameron]

An internal API like this shouldn't contain a lot of presentation logic - it should be up to the caller to format the dates for display.

[iliajie]

Agreed! I have factored this logic out. Nevertheless, there is still a lot to do to prevent multiple callers from having to reimplement this logic - there has to be a dedicated subroutine for this.

[iliajie]

Alright, all fixed!

[iliajie]

Jamie, all done this time! Please have another look!

[jcameron]

Is this just the file that the API provides?

[iliajie]

The API doesn't provide this. I made it as a reference to remember what the data structures are like and what Webmin thinks about OSes.

[jcameron]

So is this file used by any Webmin code? I'm confused as to why we need to check it in ..

[iliajie]

No, this is just a .map file. It won't go to the package itself. I checked it in for the reference!

[jcameron]

I think we should remove it, as it's kind of confusing.

[iliajie]

Alright, it's done. I just wanted to make it easier for future support.

[iliajie]

Yeah, I know. But it's much more simple to compare miniserv server version, as it's always getting updated on Webmin upgrade.

[jcameron]

It's not 30 days anymore is it?

[iliajie]

It's not 30 days anymore is it?

It isn't, just an old comment. Fixed now.