The translation is temporarily closed for contributions due to maintenance, please come back later.
The translation was automatically locked due to following alerts: Could not merge the repository.
Zen

Source string Source string

341/10000 · 341
English Actions
https://www.python.org/dev/peps/pep-0020/
Indentation and formatting
4 spaces instead of tabs. PIL suggests using two spaces, but a programmer looks at code from 4 to 8 hours a day, so it's simpler to distinguish indentation with 4 spaces. Why spaces? Similar representation everywhere.
You can use vim modelines:
-- vim:ts=4 ss=4 sw=4 expandtab
A file should ends w/ one newline symbol, but shouldn't ends w/ blank line (two newline symbols).
Every do/while/for/if/function should indent 4 spaces.
Related ``or``/``and`` in ``if`` must be enclosed in the round brackets (). Example:
-- Good
if (a == true and b == false) or (a == false and b == true) then
<...>
end

-- Bad
if a == true and b == false or a == false and b == true then
<...>
end

-- Good but not explicit
if a ^ b == true then
end
Type conversion
Do not use concatenation to convert to string or addition to convert to number (use ``tostring``/``tonumber`` instead):
-- Bad
local a = 123
a = a .. ''

-- Good
local a = 123
a = tostring(a)

-- Bad
local a = '123'
a = a + 5 -- 128

-- Good
local a = '123'
a = tonumber(a) + 5 -- 128
Try to avoid multiple nested ``if``'s with common body:
-- Good
if (a == true and b == false) or (a == false and b == true) then
do_something()
end

-- Bad
if a == true then
if b == false then
do_something()
end
if b == true then
if a == false then
do_something()
end
end
Avoid multiple concatenations in one statement, use ``string.format`` instead:
-- Bad
function say_greeting(period, name)
local a = "good " .. period .. ", " .. name
end

-- Good
function say_greeting(period, name)
local a = string.format("good %s, %s", period, name)
end

-- Best
local say_greeting_fmt = "good %s, %s"
function say_greeting(period, name)
local a = say_greeting_fmt:format(period, name)
end
Use ``and``/``or`` for default variable values
-- Good
function(input)
input = input or 'default_value'
end

-- Ok but excessive
function(input)
if input == nil then
input = 'default_value'
end
end
``if``'s and return statements:
-- Good
if a == true then
return do_something()
end
do_other_thing()

-- Bad
if a == true then
return do_something()
else
do_other_thing()
end
Using spaces:
Don't use spaces between function name and opening round bracket. Split arguments with one whitespace character:
-- Bad
function name (arg1,arg2,...)
end

-- Good
function name(arg1, arg2, ...)
end
Add a space after comment markers:
while true do -- Inline comment
-- Comment
do_something()
end
--[[
Multiline
comment
]]--
Surrounding operators:
-- Bad
local thing=1
thing = thing-1
thing = thing*1
thing = 'string'..'s'

-- Good
local thing = 1
thing = thing - 1
thing = thing * 1
thing = 'string' .. 's'
Add a space after commas in tables:
-- Bad
local thing = {1,2,3}
thing = {1 , 2 , 3}
thing = {1 ,2 ,3}

-- Good
local thing = {1, 2, 3}
Add a space in map definitions after equals signs and commas:
-- Bad
return {1,2,3,4}
return {
key1 = val1,key2=val2
}

-- Good
return {1, 2, 3, 4}
return {
key1 = val1, key2 = val2,
key3 = val3
}

Loading…

User avatar None

New source string

testing_project / Documentation: dev_guide/lua_style_guide — English

-- Bad
function say_greeting(period, name)
local a = "good " .. period .. ", " .. name
end

-- Good
function say_greeting(period, name)
local a = string.format("good %s, %s", period, name)
end

-- Best
local say_greeting_fmt = "good %s, %s"
function say_greeting(period, name)
local a = say_greeting_fmt:format(period, name)
end
a year ago
Browse all string changes

Things to check

Multiple unnamed variables

There are multiple unnamed variables in the string, making it impossible for translators to reorder them

Reset

Glossary

English English
No related strings found in the glossary.

String information

Flags
python-format, read-only
String age
a year ago
Last updated
a year ago
Source string age
a year ago
Translation file
string 45