LonamiWebs/Telethon
1
1
Fork 0
mirror of https://github.com/LonamiWebs/Telethon.git synced 2024-11-25 10:53:44 +03:00
Code Issues Packages Projects Releases Wiki Activity

Remove mentions to methods in generated TL ref

Browse Source 
Instead, consistently use the term request, to avoid confusion.
This commit is contained in:
Lonami Exo 2023-03-11 12:26:17 +01:00
parent b68c1f4f03
commit b87a8d0c1f
1 changed files with 12 additions and 12 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

24
telethon_generator/generators/docs.py
View File

@ -117,11 +117,11 @@ def _generate_index(folder, paths,
.replace(os.path.sep, '/').title()) .replace(os.path.sep, '/').title())
if bots_index: if bots_index:
docs.write_text('These are the methods that you may be able to ' docs.write_text('These are the requests that you may be able to '
'use as a bot. Click <a href="{}">here</a> to ' 'use as a bot. Click <a href="{}">here</a> to '
'view them all.'.format(INDEX)) 'view them all.'.format(INDEX))
else: else:
docs.write_text('Click <a href="{}">here</a> to view the methods ' docs.write_text('Click <a href="{}">here</a> to view the requests '
'that you can use as a bot.'.format(BOT_INDEX)) 'that you can use as a bot.'.format(BOT_INDEX))
if namespaces: if namespaces:
docs.write_title('Namespaces', level=3) docs.write_title('Namespaces', level=3)
@ -268,7 +268,7 @@ def _write_html_pages(tlobjects, methods, layer, input_res):
start = \ start = \
'Both users and bots <strong>may</strong> be able to' 'Both users and bots <strong>may</strong> be able to'
docs.write_text('{} use this method. <a href="#examples">' docs.write_text('{} use this request. <a href="#examples">'
'See code examples.</a>'.format(start)) 'See code examples.</a>'.format(start))
# Write the code definition for this TLObject # Write the code definition for this TLObject
@ -287,7 +287,7 @@ def _write_html_pages(tlobjects, methods, layer, input_res):
# We assume it's a function returning a generic type # We assume it's a function returning a generic type
generic_arg = next((arg.name for arg in tlobject.args generic_arg = next((arg.name for arg in tlobject.args
if arg.is_generic)) if arg.is_generic))
docs.write_text('This function returns the result of whatever ' docs.write_text('This request returns the result of whatever '
'the result from invoking the request passed ' 'the result from invoking the request passed '
'through <i>{}</i> is.'.format(generic_arg)) 'through <i>{}</i> is.'.format(generic_arg))
else: else:
@ -465,15 +465,15 @@ def _write_html_pages(tlobjects, methods, layer, input_res):
docs.end_table() docs.end_table()
# List all the methods which return this type # List all the methods which return this type
docs.write_title('Methods returning this type', level=3) docs.write_title('Requests returning this type', level=3)
functions = type_to_functions.get(t, []) functions = type_to_functions.get(t, [])
if not functions: if not functions:
docs.write_text('No method returns this type.') docs.write_text('No request returns this type.')
elif len(functions) == 1: elif len(functions) == 1:
docs.write_text('Only the following method returns this type.') docs.write_text('Only the following request returns this type.')
else: else:
docs.write_text( docs.write_text(
'The following %d methods return this type as a result.' % 'The following %d requests return this type as a result.' %
len(functions) len(functions)
) )
@ -484,7 +484,7 @@ def _write_html_pages(tlobjects, methods, layer, input_res):
docs.end_table() docs.end_table()
# List all the methods which take this type as input # List all the methods which take this type as input
docs.write_title('Methods accepting this type as input', level=3) docs.write_title('Requests accepting this type as input', level=3)
other_methods = sorted( other_methods = sorted(
(u for u in tlobjects (u for u in tlobjects
if any(a.type == t for a in u.args) and u.is_function), if any(a.type == t for a in u.args) and u.is_function),
@ -492,13 +492,13 @@ def _write_html_pages(tlobjects, methods, layer, input_res):
) )
if not other_methods: if not other_methods:
docs.write_text( docs.write_text(
'No methods accept this type as an input parameter.') 'No request accepts this type as an input parameter.')
elif len(other_methods) == 1: elif len(other_methods) == 1:
docs.write_text( docs.write_text(
'Only this method has a parameter with this type.') 'Only this request has a parameter with this type.')
else: else:
docs.write_text( docs.write_text(
'The following %d methods accept this type as an input ' 'The following %d requests accept this type as an input '
'parameter.' % len(other_methods)) 'parameter.' % len(other_methods))
docs.begin_table(2) docs.begin_table(2)