Replace generic record interfaces with specific ones

This commit is contained in:
Shivam Mathur
2026-01-21 02:46:20 +05:30
parent 6300a313a9
commit 46cb5030ab
3 changed files with 376 additions and 230 deletions

View File

@@ -1,40 +1,33 @@
import * as fs from 'fs'; import * as fs from 'fs';
import * as tools from '../src/tools'; import * as tools from '../src/tools';
import {ToolData, ToolInput} from '../src/tools';
interface IData { function getData(data: Partial<ToolData>): ToolData {
tool: string; const tool = data.tool || 'tool';
version?: string; const version = data.version || '';
domain?: string;
extension?: string;
os?: string;
php_version?: string;
release?: string;
repository?: string;
scope?: string;
type?: string;
fetch_latest?: string;
version_parameter?: string;
version_prefix?: string;
}
function getData(data: IData): Record<string, string> {
return { return {
tool: data.tool, tool,
version: data.version || '', version,
url: data.url || '',
domain: data.domain || 'https://example.com', domain: data.domain || 'https://example.com',
extension: data.extension || '.phar', extension: data.extension || '.phar',
os: data.os || 'linux', os: data.os || 'linux',
php_version: data.php_version || '7.4', php_version: data.php_version || '7.4',
release: data.release || [data.tool, data.version].join(':'), release: data.release || [tool, version].join(':'),
repository: data.repository || '', repository: data.repository || '',
scope: data.scope || 'global', scope: data.scope || 'global',
type: data.type || 'phar', type: data.type || 'phar',
fetch_latest: data.fetch_latest || 'false', fetch_latest: data.fetch_latest || 'false',
version_parameter: data.version_parameter || '-V', version_parameter: data.version_parameter || '-V',
version_prefix: data.version_prefix || '', version_prefix: data.version_prefix || '',
github: 'https://github.com', github: data.github || 'https://github.com',
prefix: 'releases', prefix: data.prefix || 'releases',
verb: 'download' verb: data.verb || 'download',
packagist: data.packagist || data.repository || '',
function: data.function,
alias: data.alias,
uri: data.uri,
error: data.error
}; };
} }
@@ -161,6 +154,18 @@ describe('Tools tests', () => {
} }
); );
it('checking getLatestVersion with fetch_latest=true but no repository', async () => {
expect(
await tools.getLatestVersion(
getData({
tool: 'tool',
repository: '',
fetch_latest: 'true'
})
)
).toBe('latest');
});
it.each` it.each`
version | tool | type | expected version | tool | type | expected
${'latest'} | ${'tool'} | ${'phar'} | ${'latest'} ${'latest'} | ${'tool'} | ${'phar'} | ${'latest'}
@@ -245,13 +250,15 @@ describe('Tools tests', () => {
); );
it('checking getUrl handles undefined version without double slash', async () => { it('checking getUrl handles undefined version without double slash', async () => {
const data = getData({ const data: ToolInput = {
tool: 'cs2pr', ...getData({
repository: 'staabm/annotate-pull-request-from-checkstyle', tool: 'cs2pr',
domain: 'https://github.com' repository: 'staabm/annotate-pull-request-from-checkstyle',
}); domain: 'https://github.com'
data['extension'] = ''; }),
delete data['version']; version: undefined
};
data.extension = '';
expect(await tools.getUrl(data)).toBe( expect(await tools.getUrl(data)).toBe(
'https://github.com/staabm/annotate-pull-request-from-checkstyle/releases/download/cs2pr' 'https://github.com/staabm/annotate-pull-request-from-checkstyle/releases/download/cs2pr'
); );
@@ -284,9 +291,9 @@ describe('Tools tests', () => {
tool: 'tool', tool: 'tool',
version: 'latest', version: 'latest',
version_parameter: JSON.stringify('-v'), version_parameter: JSON.stringify('-v'),
os: os os: os,
url: 'https://example.com/tool.phar'
}); });
data['url'] = 'https://example.com/tool.phar';
expect(await tools.addArchive(data)).toContain(script); expect(await tools.addArchive(data)).toContain(script);
}); });
@@ -649,14 +656,43 @@ describe('Tools tests', () => {
expect(await tools.addTools(tools_csv, '7.4', 'linux')).toContain(script); expect(await tools.addTools(tools_csv, '7.4', 'linux')).toContain(script);
}); });
it.each` it('checking error when custom-function tool is missing function field', async () => {
tools_csv | token | script const brokenToolsJson = JSON.stringify({
${'cs2pr:1.2'} | ${'invalid_token'} | ${'add_log "$cross" "cs2pr" "Invalid token"'} composer: {
${'phpunit:1.2'} | ${'invalid_token'} | ${'add_log "$cross" "phpunit" "Invalid token"'} type: 'custom-function',
${'phpunit:0.1'} | ${'no_data'} | ${'add_log "$cross" "phpunit" "No version found with prefix 0.1."'} domain: 'https://getcomposer.org',
`('checking error: $tools_csv', async ({tools_csv, token, script}) => { repository: 'composer/composer',
process.env['GITHUB_TOKEN'] = token; function: 'composer'
expect(await tools.addTools(tools_csv, '7.4', 'linux')).toContain(script); },
'broken-tool': {
type: 'custom-function'
}
});
let result: string = '';
await jest.isolateModulesAsync(async () => {
jest.doMock('fs', () => ({
...jest.requireActual('fs'),
readFileSync: (
filePath: fs.PathOrFileDescriptor,
options?: unknown
) => {
if (String(filePath).includes('tools.json')) {
return brokenToolsJson;
}
return (jest.requireActual('fs') as typeof fs).readFileSync(
filePath,
options as fs.ObjectEncodingOptions & {flag?: string}
);
}
}));
const isolatedTools = await import('../src/tools');
result = await isolatedTools.addTools('broken-tool', '7.4', 'linux');
});
expect(result).toContain(
'add_log "$cross" "broken-tool" "broken-tool has no function defined. Please report this issue."'
);
}); });
it.each` it.each`

2
dist/index.js vendored

File diff suppressed because one or more lines are too long

View File

@@ -5,14 +5,94 @@ import * as fetch from './fetch';
import * as packagist from './packagist'; import * as packagist from './packagist';
import * as utils from './utils'; import * as utils from './utils';
type RS = Record<string, string>; /**
type RSRS = Record<string, RS>; * Valid function names for custom tool handlers
*/
type ToolFunction =
| 'castor'
| 'composer'
| 'deployer'
| 'dev_tools'
| 'phive'
| 'blackfire_player'
| 'pecl'
| 'phing'
| 'phpunit'
| 'phpcpd'
| 'wp_cli';
interface IRef { /**
* Tool data interface containing all properties for tool installation
*/
export interface ToolData {
tool: string;
version: string;
os: string;
php_version: string;
github: string;
domain: string;
extension: string;
repository: string;
prefix: string;
verb: string;
fetch_latest: 'true' | 'false';
scope: string;
version_parameter: string;
version_prefix: string;
release: string;
packagist: string;
type?: string;
function?: ToolFunction;
alias?: string;
url: string;
uri?: string;
error?: string;
}
/**
* Input type for functions that may receive partial/unresolved tool data
* Used by getUrl, getLatestVersion etc. before version is fully resolved
*/
export type ToolInput = Omit<ToolData, 'version' | 'url'> & {version?: string};
/**
* Partial tool data from tools.json configuration
*/
interface ToolConfig {
tool?: string;
repository?: string;
type?: string;
function?: ToolFunction;
alias?: string;
domain?: string;
extension?: string;
fetch_latest?: 'true' | 'false';
scope?: string;
version_parameter?: string;
version_prefix?: string;
packagist?: string;
}
/**
* GitHub reference object from API response
*/
interface GitHubRef {
ref: string; ref: string;
node_id: string; node_id: string;
url: string; url: string;
object: RS; object: {
sha: string;
type: string;
url: string;
};
}
/**
* Deployer manifest entry
*/
interface DeployerManifestEntry {
version: string;
url: string;
} }
/** /**
@@ -20,7 +100,7 @@ interface IRef {
* *
* @param data * @param data
*/ */
export async function getSemverVersion(data: RS): Promise<string> { export async function getSemverVersion(data: ToolData): Promise<string> {
const fixSemver = (t: string): string => { const fixSemver = (t: string): string => {
if (/^\d+\.\d+\.\d+(-|$)/.test(t)) return t; if (/^\d+\.\d+\.\d+(-|$)/.test(t)) return t;
const m = t.match(/^(\d+\.\d+\.\d+)([A-Za-z]+[0-9A-Za-z.]+)$/); const m = t.match(/^(\d+\.\d+\.\d+)([A-Za-z]+[0-9A-Za-z.]+)$/);
@@ -31,14 +111,16 @@ export async function getSemverVersion(data: RS): Promise<string> {
const github_token: string = const github_token: string =
(await utils.readEnv('GITHUB_TOKEN')) || (await utils.readEnv('GITHUB_TOKEN')) ||
(await utils.readEnv('COMPOSER_TOKEN')); (await utils.readEnv('COMPOSER_TOKEN'));
const response: RS = await fetch.fetch(url, github_token); const response = await fetch.fetch(url, github_token);
if (response.error || response.data === '[]') { if (response.error || response.data === '[]') {
data['error'] = response.error ?? `No version found with prefix ${search}.`; data.error = response.error ?? `No version found with prefix ${search}.`;
return data['version']; return data.version;
} else { } else {
const refs: IRef[] = JSON.parse(response['data']); const refs: GitHubRef[] = JSON.parse(response.data);
const tags = refs const tags = refs
.map((i: IRef) => (i.ref?.split('/').pop() ?? '').replace(/^v(?=\d)/, '')) .map((i: GitHubRef) =>
(i.ref?.split('/').pop() ?? '').replace(/^v(?=\d)/, '')
)
.filter((t: string) => t.length > 0); .filter((t: string) => t.length > 0);
const fixedToOriginal = new Map<string, string>(); const fixedToOriginal = new Map<string, string>();
const fixed = tags.map(t => { const fixed = tags.map(t => {
@@ -62,16 +144,19 @@ export async function getSemverVersion(data: RS): Promise<string> {
* *
* @param data * @param data
*/ */
export async function getLatestVersion(data: RS): Promise<string> { export async function getLatestVersion(data: ToolInput): Promise<string> {
if (!data['version'] && data['fetch_latest'] === 'false') { if (!data.version && data.fetch_latest === 'false') {
return 'latest'; return 'latest';
} }
const resp: Record<string, string> = await fetch.fetch( if (data.fetch_latest === 'true' && !data.repository) {
`${data['github']}/${data['repository']}/releases.atom` return 'latest';
}
const resp = await fetch.fetch(
`${data.github}/${data.repository}/releases.atom`
); );
if (resp['data']) { if (resp.data) {
const releases: string[] = [ const releases: string[] = [
...resp['data'].matchAll(/releases\/tag\/([a-zA-Z]*)?(\d+.\d+.\d+)"/g) ...resp.data.matchAll(/releases\/tag\/([a-zA-Z]*)?(\d+\.\d+\.\d+)"/g)
].map(match => match[2]); ].map(match => match[2]);
const sorted = releases.toSorted((a: string, b: string) => const sorted = releases.toSorted((a: string, b: string) =>
@@ -88,26 +173,29 @@ export async function getLatestVersion(data: RS): Promise<string> {
* @param version * @param version
* @param data * @param data
*/ */
export async function getVersion(version: string, data: RS): Promise<string> { export async function getVersion(
version: string,
data: ToolData
): Promise<string> {
// semver_regex - https://semver.org/ // semver_regex - https://semver.org/
const semver_regex = const semver_regex =
/^(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)(?:-((?:0|[1-9]\d*|\d*[a-zA-Z-][0-9a-zA-Z-]*)(?:\.(?:0|[1-9]\d*|\d*[a-zA-Z-][0-9a-zA-Z-]*))*))?(?:\+([0-9a-zA-Z-]+(?:\.[0-9a-zA-Z-]+)*))?$/; /^(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)(?:-((?:0|[1-9]\d*|\d*[a-zA-Z-][0-9a-zA-Z-]*)(?:\.(?:0|[1-9]\d*|\d*[a-zA-Z-][0-9a-zA-Z-]*))*))?(?:\+([0-9a-zA-Z-]+(?:\.[0-9a-zA-Z-]+)*))?$/;
const composer_regex = /^composer:(stable|preview|snapshot|[1|2])$/; const composer_regex = /^composer:(stable|preview|snapshot|[12])$/;
const constraint_regex = /[><=^~]+.*/; const constraint_regex = /[><=^~]+.*/;
const major_minor_regex = /^\d+(\.\d+)?$/; const major_minor_regex = /^\d+(\.\d+)?$/;
data['version'] = version.replace(/v?(\d)/, '$1').replace(/\.x/, ''); data.version = version.replace(/v?(\d)/, '$1').replace(/\.x/, '');
switch (true) { switch (true) {
case composer_regex.test(data['release']): case composer_regex.test(data.release):
case semver_regex.test(data['version']): case semver_regex.test(data.version):
case constraint_regex.test(data['version']) && data['type'] === 'composer': case constraint_regex.test(data.version) && data.type === 'composer':
return data['version']; return data.version;
case major_minor_regex.test(data['version']) && data['type'] === 'composer': case major_minor_regex.test(data.version) && data.type === 'composer':
data['release'] = `${data['tool']}:${data['version']}.*`; data.release = `${data.tool}:${data.version}.*`;
return `${data['version']}.*`; return `${data.version}.*`;
case data['repository'] && major_minor_regex.test(data['version']): case !!data.repository && major_minor_regex.test(data.version):
return await getSemverVersion(data); return await getSemverVersion(data);
default: default:
return data['version'].replace(/[><=^~]*/, ''); return data.version.replace(/[><=^~]*/, '');
} }
} }
@@ -117,11 +205,14 @@ export async function getVersion(version: string, data: RS): Promise<string> {
* @param release * @param release
* @param data * @param data
*/ */
export async function getRelease(release: string, data: RS): Promise<string> { export async function getRelease(
release: string,
data: ToolData
): Promise<string> {
release = release.includes('/') ? release.split('/')[1] : release; release = release.includes('/') ? release.split('/')[1] : release;
return release.includes(':') return release.includes(':')
? [data['tool'], release.split(':')[1]].join(':') ? [data.tool, release.split(':')[1]].join(':')
: data['tool']; : data.tool;
} }
/** /**
@@ -152,26 +243,26 @@ export async function filterList(tools_list: string[]): Promise<string[]> {
* *
* @param data * @param data
*/ */
export async function getUrl(data: RS): Promise<string> { export async function getUrl(data: ToolInput): Promise<string> {
if ((data['version'] ?? 'latest') === 'latest') { if ((data.version ?? 'latest') === 'latest') {
return [ return [
data['domain'], data.domain,
data['repository'], data.repository,
data['prefix'], data.prefix,
data['version'], data.version,
data['verb'], data.verb,
data['tool'] + data['extension'] data.tool + data.extension
] ]
.filter(Boolean) .filter(Boolean)
.join('/'); .join('/');
} else { } else {
return [ return [
data['domain'], data.domain,
data['repository'], data.repository,
data['prefix'], data.prefix,
data['verb'], data.verb,
data['version_prefix'] + data['version'], data.version_prefix + data.version,
data['tool'] + data['extension'] data.tool + data.extension
] ]
.filter(Boolean) .filter(Boolean)
.join('/'); .join('/');
@@ -183,17 +274,17 @@ export async function getUrl(data: RS): Promise<string> {
* *
* @param data * @param data
*/ */
export async function getPharUrl(data: RS): Promise<string> { export async function getPharUrl(data: ToolData): Promise<string> {
if (data['version'] === 'latest') { if (data.version === 'latest') {
return data['domain'] + '/' + data['tool'] + '.phar'; return data.domain + '/' + data.tool + '.phar';
} else { } else {
return ( return (
data['domain'] + data.domain +
'/' + '/' +
data['tool'] + data.tool +
'-' + '-' +
data['version_prefix'] + data.version_prefix +
data['version'] + data.version +
'.phar' '.phar'
); );
} }
@@ -204,10 +295,10 @@ export async function getPharUrl(data: RS): Promise<string> {
* *
* @param data * @param data
*/ */
export async function addArchive(data: RS): Promise<string> { export async function addArchive(data: ToolData): Promise<string> {
return ( return (
(await utils.getCommand(data['os'], 'tool')) + (await utils.getCommand(data.os, 'tool')) +
(await utils.joins(data['url'], data['tool'], data['version_parameter'])) (await utils.joins(data.url, data.tool, data.version_parameter))
); );
} }
@@ -216,14 +307,14 @@ export async function addArchive(data: RS): Promise<string> {
* *
* @param data * @param data
*/ */
export async function addPackage(data: RS): Promise<string> { export async function addPackage(data: ToolData): Promise<string> {
const command = await utils.getCommand(data['os'], 'composer_tool'); const command = await utils.getCommand(data.os, 'composer_tool');
const parts: string[] = data['repository'].split('/'); const parts: string[] = data.repository.split('/');
const args: string = await utils.joins( const args: string = await utils.joins(
parts[1], parts[1],
data['release'], data.release,
parts[0] + '/', parts[0] + '/',
data['scope'] data.scope
); );
return command + args; return command + args;
} }
@@ -233,24 +324,24 @@ export async function addPackage(data: RS): Promise<string> {
* *
* @param data * @param data
*/ */
export async function addBlackfirePlayer(data: RS): Promise<string> { export async function addBlackfirePlayer(data: ToolData): Promise<string> {
switch (data['os']) { switch (data.os) {
case 'win32': case 'win32':
return await utils.addLog( return await utils.addLog(
'$cross', '$cross',
data['tool'], data.tool,
data['tool'] + ' is not a windows tool', data.tool + ' is not a windows tool',
'win32' 'win32'
); );
default: default:
if (data['version'] == 'latest') { if (data.version == 'latest') {
if (/5\.[5-6]|7\.0/.test(data['php_version'])) { if (/5\.[5-6]|7\.0/.test(data.php_version)) {
data['version'] = '1.9.3'; data.version = '1.9.3';
} else if (/7\.[1-4]|8\.0/.test(data['php_version'])) { } else if (/7\.[1-4]|8\.0/.test(data.php_version)) {
data['version'] = '1.22.0'; data.version = '1.22.0';
} }
} }
data['url'] = await getPharUrl(data); data.url = await getPharUrl(data);
return addArchive(data); return addArchive(data);
} }
} }
@@ -260,12 +351,12 @@ export async function addBlackfirePlayer(data: RS): Promise<string> {
* *
* @param data * @param data
*/ */
export async function addCastor(data: RS): Promise<string> { export async function addCastor(data: ToolData): Promise<string> {
data['tool'] = 'castor.' + data['os'].replace('win32', 'windows') + '-amd64'; data.tool = 'castor.' + data.os.replace('win32', 'windows') + '-amd64';
data['url'] = await getUrl(data); data.url = await getUrl(data);
data['tool'] = 'castor'; data.tool = 'castor';
data['version_parameter'] = fs.existsSync('castor.php') data.version_parameter = fs.existsSync('castor.php')
? data['version_parameter'] ? data.version_parameter
: ''; : '';
return await addArchive(data); return await addArchive(data);
} }
@@ -275,18 +366,18 @@ export async function addCastor(data: RS): Promise<string> {
* *
* @param data * @param data
*/ */
export async function addComposer(data: RS): Promise<string> { export async function addComposer(data: ToolData): Promise<string> {
const channel = data['version'].replace('latest', 'stable'); const channel = data.version.replace('latest', 'stable');
const github = data['github']; const github = data.github;
const getcomposer = data['domain']; const getcomposer = data.domain;
const cds = 'https://dl.cloudsmith.io'; const cds = 'https://dl.cloudsmith.io';
const spc = 'https://artifacts.setup-php.com'; const spc = 'https://artifacts.setup-php.com';
const filename = `composer-${data['php_version']}-${channel}.phar`; const filename = `composer-${data.php_version}-${channel}.phar`;
const releases_url = `${github}/shivammathur/composer-cache/releases/latest/download/${filename}`; const releases_url = `${github}/shivammathur/composer-cache/releases/latest/download/${filename}`;
const cds_url = `${cds}/public/shivammathur/composer-cache/raw/files/${filename}`; const cds_url = `${cds}/public/shivammathur/composer-cache/raw/files/${filename}`;
const spc_url = `${spc}/composer/${filename}`; const spc_url = `${spc}/composer/${filename}`;
const lts_url = `${getcomposer}/download/latest-2.2.x/composer.phar`; const lts_url = `${getcomposer}/download/latest-2.2.x/composer.phar`;
const is_lts = /^5\.[3-6]$|^7\.[0-1]$/.test(data['php_version']); const is_lts = /^5\.[3-6]$|^7\.[0-1]$/.test(data.php_version);
const channel_source_url = `${getcomposer}/composer-${channel}.phar`; const channel_source_url = `${getcomposer}/composer-${channel}.phar`;
const version_source_url = `${getcomposer}/download/${channel}/composer.phar`; const version_source_url = `${getcomposer}/download/${channel}/composer.phar`;
let cache_url = `${releases_url},${spc_url},${cds_url}`; let cache_url = `${releases_url},${spc_url},${cds_url}`;
@@ -301,16 +392,16 @@ export async function addComposer(data: RS): Promise<string> {
case /^1$/.test(channel): case /^1$/.test(channel):
source_url = channel_source_url; source_url = channel_source_url;
break; break;
case /^\d+\.\d+\.\d+[\w-]*$/.test(data['version']): case /^\d+\.\d+\.\d+[\w-]*$/.test(data.version):
cache_url = `${github}/${data['repository']}/releases/download/${data['version']}/composer.phar`; cache_url = `${github}/${data.repository}/releases/download/${data.version}/composer.phar`;
source_url = version_source_url; source_url = version_source_url;
break; break;
default: default:
source_url = is_lts ? lts_url : channel_source_url; source_url = is_lts ? lts_url : channel_source_url;
} }
const use_cache: boolean = (await utils.readEnv('NO_TOOLS_CACHE')) !== 'true'; const use_cache: boolean = (await utils.readEnv('NO_TOOLS_CACHE')) !== 'true';
data['url'] = use_cache ? `${cache_url},${source_url}` : source_url; data.url = use_cache ? `${cache_url},${source_url}` : source_url;
data['version_parameter'] = data['version']; data.version_parameter = data.version;
return await addArchive(data); return await addArchive(data);
} }
@@ -319,27 +410,27 @@ export async function addComposer(data: RS): Promise<string> {
* *
* @param data * @param data
*/ */
export async function addDeployer(data: RS): Promise<string> { export async function addDeployer(data: ToolData): Promise<string> {
if (data['version'] === 'latest') { if (data.version === 'latest') {
data['url'] = data['domain'] + '/deployer.phar'; data.url = data.domain + '/deployer.phar';
} else { } else {
const manifest: RS = await fetch.fetch( const manifest = await fetch.fetch('https://deployer.org/manifest.json');
'https://deployer.org/manifest.json' const version_data: Record<string, DeployerManifestEntry> = JSON.parse(
manifest.data
); );
const version_data: RSRS = JSON.parse(manifest.data);
const version_key: string | undefined = Object.keys(version_data).find( const version_key: string | undefined = Object.keys(version_data).find(
(key: string) => { (key: string) => {
return version_data[key]['version'] === data['version']; return version_data[key].version === data.version;
} }
); );
if (version_key) { if (version_key) {
data['url'] = version_data[version_key]['url']; data.url = version_data[version_key].url;
} else { } else {
return await utils.addLog( return await utils.addLog(
'$cross', '$cross',
'deployer', 'deployer',
'Version missing in deployer manifest', 'Version missing in deployer manifest',
data['os'] data.os
); );
} }
} }
@@ -351,22 +442,22 @@ export async function addDeployer(data: RS): Promise<string> {
* *
* @param data * @param data
*/ */
export async function addDevTools(data: RS): Promise<string> { export async function addDevTools(data: ToolData): Promise<string> {
switch (data['os']) { switch (data.os) {
case 'linux': case 'linux':
case 'darwin': case 'darwin':
return 'add_devtools ' + data['tool']; return 'add_devtools ' + data.tool;
case 'win32': case 'win32':
return await utils.addLog( return await utils.addLog(
'$tick', '$tick',
data['tool'], data.tool,
data['tool'] + ' is not a windows tool', data.tool + ' is not a windows tool',
'win32' 'win32'
); );
default: default:
return await utils.log( return await utils.log(
'Platform ' + data['os'] + ' is not supported', 'Platform ' + data.os + ' is not supported',
data['os'], data.os,
'error' 'error'
); );
} }
@@ -377,8 +468,8 @@ export async function addDevTools(data: RS): Promise<string> {
* *
* @param data * @param data
*/ */
export async function addPECL(data: RS): Promise<string> { export async function addPECL(data: ToolData): Promise<string> {
return await utils.getCommand(data['os'], 'pecl'); return await utils.getCommand(data.os, 'pecl');
} }
/** /**
@@ -386,14 +477,13 @@ export async function addPECL(data: RS): Promise<string> {
* *
* @param data * @param data
*/ */
export async function addPhing(data: RS): Promise<string> { export async function addPhing(data: ToolData): Promise<string> {
data['url'] = data.url = data.domain + '/get/phing-' + data.version + data.extension;
data['domain'] + '/get/phing-' + data['version'] + data['extension']; if (data.version != 'latest') {
if (data['version'] != 'latest') { [data.prefix, data.verb] = ['releases', 'download'];
[data['prefix'], data['verb']] = ['releases', 'download']; data.domain = data.github;
data['domain'] = data['github']; data.extension = '-' + data.version + data.extension;
data['extension'] = '-' + data['version'] + data['extension']; data.url += ',' + (await getUrl(data));
data['url'] += ',' + (await getUrl(data));
} }
return await addArchive(data); return await addArchive(data);
} }
@@ -403,33 +493,33 @@ export async function addPhing(data: RS): Promise<string> {
* *
* @param data * @param data
*/ */
export async function addPhive(data: RS): Promise<string> { export async function addPhive(data: ToolData): Promise<string> {
switch (true) { switch (true) {
case /5\.[3-5]/.test(data['php_version']): case /5\.[3-5]/.test(data.php_version):
return await utils.addLog( return await utils.addLog(
'$cross', '$cross',
'phive', 'phive',
'Phive is not supported on PHP ' + data['php_version'], 'Phive is not supported on PHP ' + data.php_version,
data['os'] data.os
); );
case /5\.6|7\.0/.test(data['php_version']): case /5\.6|7\.0/.test(data.php_version):
data['version'] = '0.12.1'; data.version = '0.12.1';
break; break;
case /7\.1/.test(data['php_version']): case /7\.1/.test(data.php_version):
data['version'] = '0.13.5'; data.version = '0.13.5';
break; break;
case /7\.2/.test(data['php_version']): case /7\.2/.test(data.php_version):
data['version'] = '0.14.5'; data.version = '0.14.5';
break; break;
case /7\.3|7\.4/.test(data['php_version']): case /7\.3|7\.4/.test(data.php_version):
data['version'] = '0.15.3'; data.version = '0.15.3';
break; break;
case /^latest$/.test(data['version']): case /^latest$/.test(data.version):
data['version'] = await getLatestVersion(data); data.version = await getLatestVersion(data);
break; break;
} }
data['extension'] = '-' + data['version'] + data['extension']; data.extension = '-' + data.version + data.extension;
data['url'] = await getUrl(data); data.url = await getUrl(data);
return await addArchive(data); return await addArchive(data);
} }
@@ -438,16 +528,15 @@ export async function addPhive(data: RS): Promise<string> {
* *
* @param data * @param data
*/ */
export async function addPHPUnitTools(data: RS): Promise<string> { export async function addPHPUnitTools(data: ToolData): Promise<string> {
/* istanbul ignore next */ /* istanbul ignore next */
if (data['version'] === 'latest') { if (data.version === 'latest') {
data['version'] = data.version =
(await packagist.search(data['packagist'], data['php_version'])) ?? (await packagist.search(data.packagist, data.php_version)) ?? 'latest';
'latest';
} }
data['url'] = await getPharUrl(data); data.url = await getPharUrl(data);
if (data['url'].match(/-\d+/)) { if (data.url.match(/-\d+/)) {
data['url'] += ',' + data['url'].replace(/-(\d+)\.\d+\.\d+/, '-$1'); data.url += ',' + data.url.replace(/-(\d+)\.\d+\.\d+/, '-$1');
} }
return await addArchive(data); return await addArchive(data);
} }
@@ -457,13 +546,13 @@ export async function addPHPUnitTools(data: RS): Promise<string> {
* *
* @param data * @param data
*/ */
export async function addWPCLI(data: RS): Promise<string> { export async function addWPCLI(data: ToolData): Promise<string> {
if (data['version'] === 'latest') { if (data.version === 'latest') {
data['uri'] = 'wp-cli/builds/blob/gh-pages/phar/wp-cli.phar?raw=true'; data.uri = 'wp-cli/builds/blob/gh-pages/phar/wp-cli.phar?raw=true';
data['url'] = [data['domain'], data['uri']].join('/'); data.url = [data.domain, data.uri].join('/');
} else { } else {
data['extension'] = '-' + data['version'] + data['extension']; data.extension = '-' + data.version + data.extension;
data['url'] = await getUrl(data); data.url = await getUrl(data);
} }
return await addArchive(data); return await addArchive(data);
} }
@@ -479,56 +568,74 @@ export async function getData(
release: string, release: string,
php_version: string, php_version: string,
os: string os: string
): Promise<RS> { ): Promise<ToolData> {
const json_file_path = path.join(__dirname, '../src/configs/tools.json'); const json_file_path = path.join(__dirname, '../src/configs/tools.json');
const json_file: string = fs.readFileSync(json_file_path, 'utf8'); const json_file: string = fs.readFileSync(json_file_path, 'utf8');
const json_objects: RSRS = JSON.parse(json_file); const json_objects: Record<string, ToolConfig> = JSON.parse(json_file);
release = release.replace(/\s+/g, ''); release = release.replace(/\s+/g, '');
const parts: string[] = release.split(':'); const parts: string[] = release.split(':');
const tool = parts[0]; const tool = parts[0];
const version = parts[1]; const version = parts[1];
let data: RS; let config: ToolConfig & {tool: string};
if (Object.hasOwn(json_objects, tool)) { if (Object.hasOwn(json_objects, tool)) {
data = json_objects[tool]; config = {...json_objects[tool], tool};
data['tool'] = tool;
} else { } else {
const key: string | undefined = Object.keys(json_objects).find( const key: string | undefined = Object.keys(json_objects).find(
(key: string) => { (key: string) => {
return json_objects[key]['alias'] == tool; return json_objects[key].alias == tool;
} }
); );
if (key) { if (key) {
data = json_objects[key]; config = {...json_objects[key], tool: key};
data['tool'] = key; } else if (tool.includes('/')) {
} else { config = {
data = {
tool: tool.split('/')[1], tool: tool.split('/')[1],
repository: tool, repository: tool,
type: 'composer' type: 'composer'
}; };
data = !tool.includes('/') ? {tool: tool} : data; } else {
config = {tool};
} }
} }
data['github'] = 'https://github.com'; const github = 'https://github.com';
data['domain'] ??= data['github']; const domain = config.domain ?? github;
data['extension'] ??= '.phar'; const data: ToolData = {
data['os'] = os; tool: config.tool,
data['php_version'] = php_version; version: '',
data['packagist'] ??= data['repository']; url: '',
data['prefix'] = data['github'] === data['domain'] ? 'releases' : ''; os,
data['verb'] = data['github'] === data['domain'] ? 'download' : ''; php_version,
data['fetch_latest'] ??= 'false'; github,
data['scope'] ??= 'global'; domain,
data['version_parameter'] = JSON.stringify(data['version_parameter']) || ''; extension: config.extension ?? '.phar',
data['version_prefix'] ??= ''; repository: config.repository ?? '',
data['release'] = await getRelease(release, data); prefix: domain === github ? 'releases' : '',
data['version'] = version verb: domain === github ? 'download' : '',
fetch_latest: config.fetch_latest ?? 'false',
scope: config.scope ?? 'global',
version_parameter:
config.version_parameter != null
? JSON.stringify(config.version_parameter)
: '',
version_prefix: config.version_prefix ?? '',
release: '',
packagist: config.packagist ?? config.repository ?? '',
type: config.type,
function: config.function,
alias: config.alias
};
data.release = await getRelease(release, data);
data.version = version
? await getVersion(version, data) ? await getVersion(version, data)
: await getLatestVersion(data); : await getLatestVersion(data);
data.url = await getUrl(data);
return data; return data;
} }
export const functionRecord: Record<string, (data: RS) => Promise<string>> = { export const functionRecord: Record<
ToolFunction,
(data: ToolData) => Promise<string>
> = {
castor: addCastor, castor: addCastor,
composer: addComposer, composer: addComposer,
deployer: addDeployer, deployer: addDeployer,
@@ -562,43 +669,46 @@ export async function addTools(
} }
const tools_list = await filterList(await utils.CSVArray(tools_csv)); const tools_list = await filterList(await utils.CSVArray(tools_csv));
await utils.asyncForEach(tools_list, async function (release: string) { await utils.asyncForEach(tools_list, async function (release: string) {
const data: RS = await getData(release, php_version, os); const data: ToolData = await getData(release, php_version, os);
script += '\n'; script += '\n';
switch (true) { switch (true) {
case data['error'] !== undefined: case data.error !== undefined:
script += await utils.addLog( script += await utils.addLog('$cross', data.tool, data.error, data.os);
'$cross',
data['tool'],
data['error'],
data['os']
);
break; break;
case 'phar' === data['type']: case 'phar' === data.type:
data['url'] = await getUrl(data);
script += await addArchive(data); script += await addArchive(data);
break; break;
case 'composer' === data['type']: case 'composer' === data.type:
script += await addPackage(data); script += await addPackage(data);
break; break;
case 'custom-package' === data['type']: case 'custom-package' === data.type:
script += await utils.customPackage( script += await utils.customPackage(
data['tool'].split('-')[0], data.tool.split('-')[0],
'tools', 'tools',
data['version'], data.version,
data['os'] data.os
); );
break; break;
case 'custom-function' === data['type']: case 'custom-function' === data.type:
script += await functionRecord[data['function']](data); if (!data.function) {
script += await utils.addLog(
'$cross',
data.tool,
data.tool + ' has no function defined. Please report this issue.',
data.os
);
} else {
script += await functionRecord[data.function](data);
}
break; break;
case /^none$/.test(data['tool']): case /^none$/.test(data.tool):
break; break;
default: default:
script += await utils.addLog( script += await utils.addLog(
'$cross', '$cross',
data['tool'], data.tool,
'Tool ' + data['tool'] + ' is not supported', 'Tool ' + data.tool + ' is not supported',
data['os'] data.os
); );
break; break;
} }