<?xml version="1.0"?>
<feed xmlns="http://www.w3.org/2005/Atom" xml:lang="ru">
	<id>https://wiki.iccup.org/index.php?action=history&amp;feed=atom&amp;title=%D0%9C%D0%BE%D0%B4%D1%83%D0%BB%D1%8C%3ACommon%2FApi</id>
	<title>Модуль:Common/Api - История изменений</title>
	<link rel="self" type="application/atom+xml" href="https://wiki.iccup.org/index.php?action=history&amp;feed=atom&amp;title=%D0%9C%D0%BE%D0%B4%D1%83%D0%BB%D1%8C%3ACommon%2FApi"/>
	<link rel="alternate" type="text/html" href="https://wiki.iccup.org/index.php?title=%D0%9C%D0%BE%D0%B4%D1%83%D0%BB%D1%8C:Common/Api&amp;action=history"/>
	<updated>2026-05-31T06:08:18Z</updated>
	<subtitle>История изменений этой страницы в вики</subtitle>
	<generator>MediaWiki 1.42.3</generator>
	<entry>
		<id>https://wiki.iccup.org/index.php?title=%D0%9C%D0%BE%D0%B4%D1%83%D0%BB%D1%8C:Common/Api&amp;diff=141&amp;oldid=prev</id>
		<title>DarkMuse: Новая страница: «local common = {}   --- Checks if the provided data structure is valid --- @param table data --- @param string key local function structureValid( data, key ) 	key = key or nil 	 	if type( data ) ~= &#039;table&#039; then 		return false 	end 	 	if key ~= nil then 		return data[key] ~= nil 	end 	 	return true end   --- @param table data --- @return string|nil function common.getManufacturerName( data ) 	if not structureValid( data, &#039;manufacturer&#039; ) then 		return nil 	en...»</title>
		<link rel="alternate" type="text/html" href="https://wiki.iccup.org/index.php?title=%D0%9C%D0%BE%D0%B4%D1%83%D0%BB%D1%8C:Common/Api&amp;diff=141&amp;oldid=prev"/>
		<updated>2024-08-31T15:33:31Z</updated>

		<summary type="html">&lt;p&gt;Новая страница: «local common = {}   --- Checks if the provided data structure is valid --- @param table data --- @param string key local function structureValid( data, key ) 	key = key or nil 	 	if type( data ) ~= &amp;#039;table&amp;#039; then 		return false 	end 	 	if key ~= nil then 		return data[key] ~= nil 	end 	 	return true end   --- @param table data --- @return string|nil function common.getManufacturerName( data ) 	if not structureValid( data, &amp;#039;manufacturer&amp;#039; ) then 		return nil 	en...»&lt;/p&gt;
&lt;p&gt;&lt;b&gt;Новая страница&lt;/b&gt;&lt;/p&gt;&lt;div&gt;local common = {}&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
--- Checks if the provided data structure is valid&lt;br /&gt;
--- @param table data&lt;br /&gt;
--- @param string key&lt;br /&gt;
local function structureValid( data, key )&lt;br /&gt;
	key = key or nil&lt;br /&gt;
	&lt;br /&gt;
	if type( data ) ~= &amp;#039;table&amp;#039; then&lt;br /&gt;
		return false&lt;br /&gt;
	end&lt;br /&gt;
	&lt;br /&gt;
	if key ~= nil then&lt;br /&gt;
		return data[key] ~= nil&lt;br /&gt;
	end&lt;br /&gt;
	&lt;br /&gt;
	return true&lt;br /&gt;
end&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
--- @param table data&lt;br /&gt;
--- @return string|nil&lt;br /&gt;
function common.getManufacturerName( data )&lt;br /&gt;
	if not structureValid( data, &amp;#039;manufacturer&amp;#039; ) then&lt;br /&gt;
		return nil&lt;br /&gt;
	end&lt;br /&gt;
	&lt;br /&gt;
    local manufacturerName = data.manufacturer_description or data.manufacturer.name or nil&lt;br /&gt;
&lt;br /&gt;
    if manufacturerName ~= nil then&lt;br /&gt;
        manufacturerName = mw.ustring.gsub( manufacturerName, &amp;#039;%[PH%]&amp;#039;, &amp;#039;&amp;#039; )&lt;br /&gt;
        manufacturerName = mw.ustring.gsub( manufacturerName, &amp;#039;PH &amp;#039;, &amp;#039;&amp;#039; )&lt;br /&gt;
    end&lt;br /&gt;
&lt;br /&gt;
    if manufacturerName == &amp;#039;@LOC_PLACEHOLDER&amp;#039; or manufacturerName == &amp;#039;@LOC PLACEHOLDER&amp;#039; or manufacturerName == &amp;#039;Unknown Manufacturer&amp;#039; then&lt;br /&gt;
        manufacturerName = &amp;#039;Unbekannter Hersteller&amp;#039;&lt;br /&gt;
    end&lt;br /&gt;
&lt;br /&gt;
	if manufacturerName == &amp;#039;Virgil&amp;#039; then&lt;br /&gt;
		manufacturerName = &amp;#039;Virgil Ltd&amp;#039;&lt;br /&gt;
	end&lt;br /&gt;
&lt;br /&gt;
	if manufacturerName == &amp;#039;Vanduul Components - Generic&amp;#039; then&lt;br /&gt;
		manufacturerName = &amp;#039;Vanduul&amp;#039;&lt;br /&gt;
	end&lt;br /&gt;
&lt;br /&gt;
	return manufacturerName&lt;br /&gt;
end&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
--- Returns the volume of an item converted to µSCU&lt;br /&gt;
--- @param table data&lt;br /&gt;
--- @return string|nil&lt;br /&gt;
function common.getVolume( data )&lt;br /&gt;
	if not structureValid( data, &amp;#039;dimension&amp;#039; ) then&lt;br /&gt;
		return nil&lt;br /&gt;
	end&lt;br /&gt;
&lt;br /&gt;
	local volume = data.dimension.volume or nil&lt;br /&gt;
	if volume ~= nil then&lt;br /&gt;
		volume = volume * (10^6)&lt;br /&gt;
	end&lt;br /&gt;
&lt;br /&gt;
	return volume&lt;br /&gt;
end&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
--- Returns carrying capacity of an item converted to µSCU&lt;br /&gt;
--- @param table data&lt;br /&gt;
--- @return string|nil&lt;br /&gt;
function common.getFormattedCarryingCapacity( data )&lt;br /&gt;
	if not structureValid( data, &amp;#039;inventory&amp;#039; ) then&lt;br /&gt;
		return nil&lt;br /&gt;
	end&lt;br /&gt;
&lt;br /&gt;
	return data.inventory.scu_converted .. data.inventory.unit&lt;br /&gt;
end&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
--- Sets Base Information data on the smw set object&lt;br /&gt;
--- @param table data&lt;br /&gt;
function common.setBaseObject( data, setObj )&lt;br /&gt;
	if not structureValid( data, &amp;#039;base_version&amp;#039; ) then&lt;br /&gt;
    	setObj[&amp;#039;Ist Basisversion&amp;#039;] = 1&lt;br /&gt;
	else&lt;br /&gt;
	    setObj[ &amp;#039;Ist Basisversion&amp;#039; ] = 0&lt;br /&gt;
    	setObj[ &amp;#039;Basisversion UUID&amp;#039; ] = data.base_version.uuid&lt;br /&gt;
    	setObj[ &amp;#039;Basisversion&amp;#039; ] = data.base_version.name&lt;br /&gt;
	end&lt;br /&gt;
&lt;br /&gt;
	return setObj&lt;br /&gt;
end&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
--- Checks if Api Request was successful and if the Response is valid&lt;br /&gt;
--- @param response table&lt;br /&gt;
--- @param errorOnData boolean&lt;br /&gt;
--- @param errorOnData boolean&lt;br /&gt;
--- @return boolean&lt;br /&gt;
function common.checkResponseStructure( response, errorOnStatus, errorOnData )&lt;br /&gt;
    if response[ &amp;#039;status_code&amp;#039; ] ~= nil and response[ &amp;#039;status_code&amp;#039; ] ~= 200 then&lt;br /&gt;
        if errorOnStatus == nil or errorOnStatus == true then&lt;br /&gt;
            error( &amp;#039;API Anfrage resultierte in Fehlercode &amp;#039; .. response[ &amp;#039;status_code&amp;#039; ] .. &amp;#039;(&amp;#039; .. response[ &amp;#039;message&amp;#039; ] .. &amp;#039;)&amp;#039;, 0 )&lt;br /&gt;
        end&lt;br /&gt;
        return false&lt;br /&gt;
    end&lt;br /&gt;
&lt;br /&gt;
    if response[ &amp;#039;data&amp;#039; ] == nil then&lt;br /&gt;
        if errorOnData == nil or errorOnData == true then&lt;br /&gt;
            error( &amp;#039;API Daten entalten kein &amp;quot;data&amp;quot; Feld&amp;#039;, 0 )&lt;br /&gt;
        end&lt;br /&gt;
        return false&lt;br /&gt;
    end&lt;br /&gt;
    return true&lt;br /&gt;
end&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
--- Maps an array from the api to monolingual text format&lt;br /&gt;
--- @param input table - Form of { &amp;quot;de_DE&amp;quot; = &amp;quot;...&amp;quot;, &amp;quot;en_EN&amp;quot; = &amp;quot;...&amp;quot; } or table of tables&lt;br /&gt;
--- @param ucFirst boolean - Whether to uppercase the first character&lt;br /&gt;
--- @return table&lt;br /&gt;
function common.mapTranslation( input, ucFirst )&lt;br /&gt;
    input = input or {}&lt;br /&gt;
    ucFirst = ucFirst or false&lt;br /&gt;
&lt;br /&gt;
    if type( input ) ~= &amp;#039;table&amp;#039; then&lt;br /&gt;
        return input&lt;br /&gt;
    end&lt;br /&gt;
&lt;br /&gt;
    local out = {}&lt;br /&gt;
&lt;br /&gt;
    local function add( msg, locale )&lt;br /&gt;
        if ucFirst then&lt;br /&gt;
            msg = mw.language.getContentLanguage():ucfirst( msg )&lt;br /&gt;
        end&lt;br /&gt;
&lt;br /&gt;
        table.insert( out, msg .. &amp;#039;@&amp;#039; .. string.sub( locale, 1, 2 ) )&lt;br /&gt;
    end&lt;br /&gt;
&lt;br /&gt;
    for locale, translation in pairs( input ) do&lt;br /&gt;
        if type( translation ) == &amp;#039;table&amp;#039; then&lt;br /&gt;
            for locale, msg in pairs( translation ) do&lt;br /&gt;
                add( msg, locale )&lt;br /&gt;
            end&lt;br /&gt;
        elseif type( translation ) == &amp;#039;string&amp;#039; then&lt;br /&gt;
            add( translation, locale )&lt;br /&gt;
        end&lt;br /&gt;
    end&lt;br /&gt;
&lt;br /&gt;
    return out&lt;br /&gt;
end&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
--- Formats a game version to a ref link&lt;br /&gt;
--- @param version string - Version string&lt;br /&gt;
--- @param lang string - Target language de or en&lt;br /&gt;
--- @return table&lt;br /&gt;
function common.getVersionInfoRef( version, lang )&lt;br /&gt;
	if version == nil or type( version ) ~= &amp;#039;string&amp;#039; or #version == 0 then&lt;br /&gt;
		return &amp;#039;&amp;#039;&lt;br /&gt;
	end&lt;br /&gt;
&lt;br /&gt;
	return mw.getCurrentFrame():extensionTag{&lt;br /&gt;
        name = &amp;#039;ref&amp;#039;,&lt;br /&gt;
        content = require( &amp;#039;Module:Translate&amp;#039; ):new().formatInLanguage( lang, &amp;#039;Module:Common/i18n.json&amp;#039;, &amp;#039;msg_version_info&amp;#039;, version, &amp;#039;[https://github.com/StarCitizenWiki/scunpacked-data GitHub]&amp;#039; )&lt;br /&gt;
    }&lt;br /&gt;
end&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
--- Sets the table to return nil for unknown keys instead of erroring out&lt;br /&gt;
--- For deep nested tables use apiData:get( &amp;#039;table1.table2.table3&amp;#039; ) etc.&lt;br /&gt;
--- @param apiData table - The json decoded data from the api&lt;br /&gt;
--- @return table&lt;br /&gt;
function common.makeAccessSafe( apiData )&lt;br /&gt;
	local function set( data )&lt;br /&gt;
		setmetatable( data, {&lt;br /&gt;
			__index = function(self, key)&lt;br /&gt;
				return nil&lt;br /&gt;
			end&lt;br /&gt;
		} )&lt;br /&gt;
	end&lt;br /&gt;
	&lt;br /&gt;
	local function iterSet( data )&lt;br /&gt;
		set( data )&lt;br /&gt;
&lt;br /&gt;
		for _, v in pairs( data ) do&lt;br /&gt;
			if type( v ) == &amp;#039;table&amp;#039; then&lt;br /&gt;
				iterSet( v )&lt;br /&gt;
			end&lt;br /&gt;
		end&lt;br /&gt;
	end&lt;br /&gt;
	&lt;br /&gt;
	iterSet( apiData )&lt;br /&gt;
&lt;br /&gt;
	apiData.get = function( self, key )&lt;br /&gt;
		local parts = mw.text.split( key, &amp;#039;.&amp;#039;, true )&lt;br /&gt;
&lt;br /&gt;
		local val = self&lt;br /&gt;
		for _, part in ipairs( parts ) do&lt;br /&gt;
			local success, conv = pcall( tonumber, part, 10 )&lt;br /&gt;
			if success and conv ~= nil then&lt;br /&gt;
				part = conv&lt;br /&gt;
			end&lt;br /&gt;
&lt;br /&gt;
			if val[ part ] == nil then&lt;br /&gt;
				return nil&lt;br /&gt;
			end&lt;br /&gt;
&lt;br /&gt;
			val = val[ part ]&lt;br /&gt;
		end&lt;br /&gt;
&lt;br /&gt;
		if val == nil or ( type( val ) == &amp;#039;table&amp;#039; and #val == 0 ) or type( val ) == &amp;#039;function&amp;#039; then&lt;br /&gt;
			return nil&lt;br /&gt;
		end&lt;br /&gt;
&lt;br /&gt;
		return val&lt;br /&gt;
	end&lt;br /&gt;
&lt;br /&gt;
	return apiData&lt;br /&gt;
end&lt;br /&gt;
&lt;br /&gt;
&lt;br /&gt;
return common&lt;/div&gt;</summary>
		<author><name>DarkMuse</name></author>
	</entry>
</feed>