2017-08-18 18:10:30 +02:00
< ? php
2018-02-24 17:54:13 +01:00
Merge alpha into master (async, huge bugfixes and more) (#546)
* Implement async and lots of bugfixes
* Implement more async
* Implement async, implement bugfixes for the connection module, for the datacenter module, huge bugfixes, huge perfomance improvements, media DCs for https, advanced selecting, custom var_dump, totally rewritten IOLoop and response mechanism, promises, improvements to the TL parser, custom mb_substr
* Apply fixes from StyleCI
* Bugfixes
* Apply fixes from StyleCI
* Bugfixes, implement combined promises
* Apply fixes from StyleCI
* Support passing method arguments as callable
* Starting to write async upload logic
* Apply fixes from StyleCI
* Start implementing async file upload
* Apply fixes from StyleCI
* bugfix
* Apply fixes from StyleCI
* Start rewriting connection module
* Add PHP file docblocks for all classes
* Start working on new async stream API
* Finish writing stream API
* More stream API fixes
* Apply fixes from StyleCI
* Rewrite DataCenter and Connection modules
* Clean up stream API documentation
* Fixes
* Apply fixes from StyleCI
* Add referenced parameter to get length of buffer to read in getReadBuffer API
* Moved all MessageHandler code in the Connection module, added a PHP version warning in the phar
* Start fixing reads
* Fix all protocol stream wrappers
* Apply fixes from StyleCI
* Implement disconnection, and remove end function
* Working async RPC
* Implement async file upload
* Bugfix
* Method recall bugfixes
* Bugfixes
* Trait bugfixes
* Fix FIFO buffer
* Bugfixes and speedtests
* Async logging
* Implement websocket streams
* Implement loop API, signal API, clean closing and start changing layer
* Small magna, websocket and HTTP fixes
* Clean up loop API
* Improved stack traces, 2FA and async
* Login fixes
* Added instructions for manual verification
* Small fixes
* More app info improvements
* More app info improvements
* TL and 2FA fixes
* Update to layer 89
* More bugfixes
* Implement broken media reporting
* Remove debug comments
* PHP 7.2 backwards compatibility
* Bugfixes
* Async key generation
* Some simplifications
* Transport fixes
* Cleanup
* async API
* Performance fixes
* Fixes to async API
* Bugfixes
* Implement one-time async loop
* Authorization and logging fixes
* Update to layer 91
* 7to5 fix
* Null coalesce conversion
* Implement socks5 proxy
* Implement HTTP proxy
* Fixes to HTTP proxy
* MTProxy and socks5 fixes
* Disable PHP 5 conversion
* Proxies have higher priority
* Avoid error handling in vendor
* Override composer dependencies
* Fix travis build
* Final composer fixes
* Proxy logic fixes
* Fix get_updates update handling
* Do not use parallel file driver if not supported
* Refactor loader and implement HTTP fixes
* Suppress errors in loader
* HTTP and authorization fixes
* HTTP fixes
* Improved peer management
* Use HTTP protocol on altervista
* Small bugfixes
* Minor fixes
* Docufix
* Docufix
* Legacy fixes
* Fix message queue
* Avoid updating if using MTProxy
* Improve logs and examples
* Trim final newlines while converting parse mode
* Reimplement noResponse flag
* Async combined event handler and APIFactory fixes
* Actually return config
* Case-insensitive methods
* Bugfix
* Apply fixes from StyleCI (#545)
* MTProxy fixes
* PHP 5 warning
* Improved PHP 5 warning
* Use <br> along with newlines in web logs
* Update docs
2018-12-26 20:51:14 +01:00
/**
* Methods module .
*
* This file is part of MadelineProto .
* MadelineProto is free software : you can redistribute it and / or modify it under the terms of the GNU Affero General Public License as published by the Free Software Foundation , either version 3 of the License , or ( at your option ) any later version .
* MadelineProto is distributed in the hope that it will be useful , but WITHOUT ANY WARRANTY ; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE .
* See the GNU Affero General Public License for more details .
* You should have received a copy of the GNU General Public License along with MadelineProto .
* If not , see < http :// www . gnu . org / licenses />.
*
* @ author Daniil Gentili < daniil @ daniil . it >
2020-02-17 14:13:46 +01:00
* @ copyright 2016 - 2020 Daniil Gentili < daniil @ daniil . it >
Merge alpha into master (async, huge bugfixes and more) (#546)
* Implement async and lots of bugfixes
* Implement more async
* Implement async, implement bugfixes for the connection module, for the datacenter module, huge bugfixes, huge perfomance improvements, media DCs for https, advanced selecting, custom var_dump, totally rewritten IOLoop and response mechanism, promises, improvements to the TL parser, custom mb_substr
* Apply fixes from StyleCI
* Bugfixes
* Apply fixes from StyleCI
* Bugfixes, implement combined promises
* Apply fixes from StyleCI
* Support passing method arguments as callable
* Starting to write async upload logic
* Apply fixes from StyleCI
* Start implementing async file upload
* Apply fixes from StyleCI
* bugfix
* Apply fixes from StyleCI
* Start rewriting connection module
* Add PHP file docblocks for all classes
* Start working on new async stream API
* Finish writing stream API
* More stream API fixes
* Apply fixes from StyleCI
* Rewrite DataCenter and Connection modules
* Clean up stream API documentation
* Fixes
* Apply fixes from StyleCI
* Add referenced parameter to get length of buffer to read in getReadBuffer API
* Moved all MessageHandler code in the Connection module, added a PHP version warning in the phar
* Start fixing reads
* Fix all protocol stream wrappers
* Apply fixes from StyleCI
* Implement disconnection, and remove end function
* Working async RPC
* Implement async file upload
* Bugfix
* Method recall bugfixes
* Bugfixes
* Trait bugfixes
* Fix FIFO buffer
* Bugfixes and speedtests
* Async logging
* Implement websocket streams
* Implement loop API, signal API, clean closing and start changing layer
* Small magna, websocket and HTTP fixes
* Clean up loop API
* Improved stack traces, 2FA and async
* Login fixes
* Added instructions for manual verification
* Small fixes
* More app info improvements
* More app info improvements
* TL and 2FA fixes
* Update to layer 89
* More bugfixes
* Implement broken media reporting
* Remove debug comments
* PHP 7.2 backwards compatibility
* Bugfixes
* Async key generation
* Some simplifications
* Transport fixes
* Cleanup
* async API
* Performance fixes
* Fixes to async API
* Bugfixes
* Implement one-time async loop
* Authorization and logging fixes
* Update to layer 91
* 7to5 fix
* Null coalesce conversion
* Implement socks5 proxy
* Implement HTTP proxy
* Fixes to HTTP proxy
* MTProxy and socks5 fixes
* Disable PHP 5 conversion
* Proxies have higher priority
* Avoid error handling in vendor
* Override composer dependencies
* Fix travis build
* Final composer fixes
* Proxy logic fixes
* Fix get_updates update handling
* Do not use parallel file driver if not supported
* Refactor loader and implement HTTP fixes
* Suppress errors in loader
* HTTP and authorization fixes
* HTTP fixes
* Improved peer management
* Use HTTP protocol on altervista
* Small bugfixes
* Minor fixes
* Docufix
* Docufix
* Legacy fixes
* Fix message queue
* Avoid updating if using MTProxy
* Improve logs and examples
* Trim final newlines while converting parse mode
* Reimplement noResponse flag
* Async combined event handler and APIFactory fixes
* Actually return config
* Case-insensitive methods
* Bugfix
* Apply fixes from StyleCI (#545)
* MTProxy fixes
* PHP 5 warning
* Improved PHP 5 warning
* Use <br> along with newlines in web logs
* Update docs
2018-12-26 20:51:14 +01:00
* @ license https :// opensource . org / licenses / AGPL - 3.0 AGPLv3
*
2019-10-31 15:07:35 +01:00
* @ link https :// docs . madelineproto . xyz MadelineProto documentation
Merge alpha into master (async, huge bugfixes and more) (#546)
* Implement async and lots of bugfixes
* Implement more async
* Implement async, implement bugfixes for the connection module, for the datacenter module, huge bugfixes, huge perfomance improvements, media DCs for https, advanced selecting, custom var_dump, totally rewritten IOLoop and response mechanism, promises, improvements to the TL parser, custom mb_substr
* Apply fixes from StyleCI
* Bugfixes
* Apply fixes from StyleCI
* Bugfixes, implement combined promises
* Apply fixes from StyleCI
* Support passing method arguments as callable
* Starting to write async upload logic
* Apply fixes from StyleCI
* Start implementing async file upload
* Apply fixes from StyleCI
* bugfix
* Apply fixes from StyleCI
* Start rewriting connection module
* Add PHP file docblocks for all classes
* Start working on new async stream API
* Finish writing stream API
* More stream API fixes
* Apply fixes from StyleCI
* Rewrite DataCenter and Connection modules
* Clean up stream API documentation
* Fixes
* Apply fixes from StyleCI
* Add referenced parameter to get length of buffer to read in getReadBuffer API
* Moved all MessageHandler code in the Connection module, added a PHP version warning in the phar
* Start fixing reads
* Fix all protocol stream wrappers
* Apply fixes from StyleCI
* Implement disconnection, and remove end function
* Working async RPC
* Implement async file upload
* Bugfix
* Method recall bugfixes
* Bugfixes
* Trait bugfixes
* Fix FIFO buffer
* Bugfixes and speedtests
* Async logging
* Implement websocket streams
* Implement loop API, signal API, clean closing and start changing layer
* Small magna, websocket and HTTP fixes
* Clean up loop API
* Improved stack traces, 2FA and async
* Login fixes
* Added instructions for manual verification
* Small fixes
* More app info improvements
* More app info improvements
* TL and 2FA fixes
* Update to layer 89
* More bugfixes
* Implement broken media reporting
* Remove debug comments
* PHP 7.2 backwards compatibility
* Bugfixes
* Async key generation
* Some simplifications
* Transport fixes
* Cleanup
* async API
* Performance fixes
* Fixes to async API
* Bugfixes
* Implement one-time async loop
* Authorization and logging fixes
* Update to layer 91
* 7to5 fix
* Null coalesce conversion
* Implement socks5 proxy
* Implement HTTP proxy
* Fixes to HTTP proxy
* MTProxy and socks5 fixes
* Disable PHP 5 conversion
* Proxies have higher priority
* Avoid error handling in vendor
* Override composer dependencies
* Fix travis build
* Final composer fixes
* Proxy logic fixes
* Fix get_updates update handling
* Do not use parallel file driver if not supported
* Refactor loader and implement HTTP fixes
* Suppress errors in loader
* HTTP and authorization fixes
* HTTP fixes
* Improved peer management
* Use HTTP protocol on altervista
* Small bugfixes
* Minor fixes
* Docufix
* Docufix
* Legacy fixes
* Fix message queue
* Avoid updating if using MTProxy
* Improve logs and examples
* Trim final newlines while converting parse mode
* Reimplement noResponse flag
* Async combined event handler and APIFactory fixes
* Actually return config
* Case-insensitive methods
* Bugfix
* Apply fixes from StyleCI (#545)
* MTProxy fixes
* PHP 5 warning
* Improved PHP 5 warning
* Use <br> along with newlines in web logs
* Update docs
2018-12-26 20:51:14 +01:00
*/
2018-02-24 17:54:39 +01:00
2017-08-18 18:10:30 +02:00
namespace danog\MadelineProto\DocsBuilder ;
2020-06-16 17:52:55 +02:00
use danog\MadelineProto\StrTools ;
2019-10-31 15:06:25 +01:00
use danog\MadelineProto\Tools ;
2017-08-18 18:10:30 +02:00
trait Methods
{
2020-10-01 21:03:25 +02:00
public function mkMethods () : void
2017-08-18 18:11:04 +02:00
{
2019-06-29 14:54:12 +02:00
static $bots ;
2019-09-02 17:08:36 +02:00
if ( ! $bots ) {
$bots = \json_decode ( \file_get_contents ( 'https://rpc.madelineproto.xyz/bot.json' ), true )[ 'result' ];
}
2019-06-29 14:54:12 +02:00
static $errors ;
2019-09-02 17:08:36 +02:00
if ( ! $errors ) {
$errors = \json_decode ( \file_get_contents ( 'https://rpc.madelineproto.xyz/v1.json' ), true );
}
2019-06-29 14:54:12 +02:00
$new = [ 'result' => []];
foreach ( $errors [ 'result' ] as $code => $suberrors ) {
foreach ( $suberrors as $method => $suberrors ) {
if ( ! isset ( $new [ $method ])) {
$new [ $method ] = [];
}
foreach ( $suberrors as $error ) {
$new [ 'result' ][ $method ][] = [ $error , $code ];
}
}
}
2020-04-05 22:22:47 +02:00
foreach ( \glob ( 'methods/' . $this -> any ) as $unlink ) {
2019-09-02 17:08:36 +02:00
\unlink ( $unlink );
2017-08-18 18:10:30 +02:00
}
2019-09-02 17:08:36 +02:00
if ( \file_exists ( 'methods' )) {
\rmdir ( 'methods' );
2017-08-18 18:10:30 +02:00
}
2019-09-02 17:08:36 +02:00
\mkdir ( 'methods' );
2017-08-18 18:10:30 +02:00
$this -> docs_methods = [];
2018-03-23 17:44:33 +01:00
$this -> human_docs_methods = [];
2018-04-08 19:53:30 +02:00
$this -> logger -> logger ( 'Generating methods documentation...' , \danog\MadelineProto\Logger :: NOTICE );
2019-10-31 20:48:06 +01:00
foreach ( $this -> TL -> getMethods ( $this -> td ) -> by_id as $id => $data ) {
2019-10-29 22:41:31 +01:00
$method = $data [ 'method' ];
2020-06-16 17:52:55 +02:00
$phpMethod = StrTools :: methodEscape ( $method );
2019-12-27 18:26:47 +01:00
$type = \str_replace ([ '<' , '>' ], [ '_of_' , '' ], $data [ 'type' ]);
2019-09-02 17:08:36 +02:00
$php_type = \preg_replace ( '/.*_of_/' , '' , $type );
2017-08-18 18:10:30 +02:00
if ( ! isset ( $this -> types [ $php_type ])) {
$this -> types [ $php_type ] = [ 'methods' => [], 'constructors' => []];
}
2019-09-02 17:08:36 +02:00
if ( ! \in_array ( $data , $this -> types [ $php_type ][ 'methods' ])) {
2017-08-18 18:10:30 +02:00
$this -> types [ $php_type ][ 'methods' ][] = $data ;
}
$params = '' ;
foreach ( $data [ 'params' ] as $param ) {
2019-09-02 17:08:36 +02:00
if ( \in_array ( $param [ 'name' ], [ 'flags' , 'random_id' , 'random_bytes' ])) {
2017-08-18 18:10:30 +02:00
continue ;
}
2017-09-28 19:38:43 +02:00
if ( $param [ 'name' ] === 'data' && $type === 'messages_SentEncryptedMessage' && ! isset ( $this -> settings [ 'td' ])) {
2017-08-18 18:10:30 +02:00
$param [ 'name' ] = 'message' ;
$param [ 'type' ] = 'DecryptedMessage' ;
}
2020-06-16 17:52:55 +02:00
if ( $param [ 'name' ] === 'chat_id' && $method !== 'messages.discardEncryption' && ! isset ( $this -> settings [ 'td' ])) {
2017-08-18 18:10:30 +02:00
$param [ 'type' ] = 'InputPeer' ;
}
$type_or_subtype = isset ( $param [ 'subtype' ]) ? 'subtype' : 'type' ;
2019-10-31 15:06:25 +01:00
$type_or_bare_type = \ctype_upper ( Tools :: end ( \explode ( '.' , $param [ $type_or_subtype ]))[ 0 ]) || \in_array ( $param [ $type_or_subtype ], [ '!X' , 'X' , 'bytes' , 'true' , 'false' , 'double' , 'string' , 'Bool' , 'int' , 'long' , 'int128' , 'int256' , 'int512' , 'int53' ]) ? 'types' : 'constructors' ;
2019-10-29 22:41:31 +01:00
$param [ $type_or_subtype ] = \str_replace ([ 'true' , 'false' ], [ 'Bool' , 'Bool' ], $param [ $type_or_subtype ]);
2020-06-16 17:52:55 +02:00
$param [ $type_or_subtype ] = '[' . StrTools :: markdownEscape ( $param [ $type_or_subtype ]) . '](../' . $type_or_bare_type . '/' . $param [ $type_or_subtype ] . '.md)' ;
2020-04-05 22:22:47 +02:00
$params .= " ' " . $param [ 'name' ] . " ' => " . ( isset ( $param [ 'subtype' ]) ? '\\[' . $param [ $type_or_subtype ] . '\\]' : $param [ $type_or_subtype ]) . ', ' ;
2017-08-18 18:10:30 +02:00
}
2020-06-16 17:52:55 +02:00
if ( ! isset ( $this -> td_descriptions [ 'methods' ][ $method ])) {
$this -> addToLang ( 'method_' . $method );
if ( \danog\MadelineProto\Lang :: $lang [ 'en' ][ 'method_' . $method ] !== '' ) {
$this -> td_descriptions [ 'methods' ][ $method ][ 'description' ] = \danog\MadelineProto\Lang :: $lang [ 'en' ][ 'method_' . $method ];
2018-03-23 17:48:12 +01:00
}
}
2020-06-16 17:52:55 +02:00
$md_method = '[' . $phpMethod . '](' . $method . '.md)' ;
$this -> docs_methods [ $method ] = '$MadelineProto->' . $md_method . '(\\[' . $params . '\\]) === [$' . StrTools :: markdownEscape ( $type ) . '](../types/' . $php_type . '.md)<a name="' . $method . ' " ></a>
2018-03-23 17:44:33 +01:00
2017-08-18 18:10:30 +02:00
' ;
2020-06-16 17:52:55 +02:00
if ( isset ( $this -> td_descriptions [ 'methods' ][ $method ])) {
$desc = \Parsedown :: instance () -> line ( \trim ( \explode ( " \n " , $this -> td_descriptions [ 'methods' ][ $method ][ 'description' ])[ 0 ], '.' ));
2019-12-27 18:26:47 +01:00
$dom = new \DOMDocument ();
$dom -> loadHTML ( \mb_convert_encoding ( $desc , 'HTML-ENTITIES' , 'UTF-8' ));
$desc = $dom -> textContent ;
2020-06-16 17:52:55 +02:00
$this -> human_docs_methods [ $this -> td_descriptions [ 'methods' ][ $method ][ 'description' ] . ': ' . $method ] = '* <a href="' . $method . '.html" name="' . $method . '">' . $desc . ': ' . $method . ' </ a >
2019-09-04 18:33:27 +02:00
' ;
2019-09-13 16:55:48 +02:00
}
2017-08-18 18:10:30 +02:00
$params = '' ;
$lua_params = '' ;
$pwr_params = '' ;
$json_params = '' ;
$table = empty ( $data [ 'params' ]) ? '' : ' ### Parameters:
| Name | Type | Required |
2017-08-20 11:05:56 +02:00
|----------|---------------|----------|
2017-08-18 18:10:30 +02:00
' ;
2020-06-16 17:52:55 +02:00
if ( isset ( $this -> td_descriptions [ 'methods' ][ $method ]) && ! empty ( $data [ 'params' ])) {
Documentation rework (#349)
* Documentation rework
* Apply fixes from StyleCI
* Documentation fixes
* Login as bot through web/cli API, allow using invite links in joinChannel, full invite links in importChatInvite and checkChatInvite, non-invite links in importChatInvite
* Apply fixes from StyleCI
* Logging fixes
* Build docs
* Add methods to modify start template, bugfix to logging and keyboard conversion
* Add TL documentator
* Document MTProto methods
* Documenting methods...
* 7% documented
* Bugfixes
* Update docs
* Update docs
* Simplify file management
* Implement automatic object conversion for media, and more awesome stuff
* Implement automatic object conversion for media, and more awesome stuff
* Implement event update handler and file upload/download callback
* Auto-detect mime type, duration, width and height of media
* Update docs
* Document new file functions
* Fix links
* Fix links
* Update bot.php to use event loop
* Implement webhook update handler and forking in main loop
* Build docs
* Better docs
* Fixes to secret chats
* Almost finished updating docs
* Bugfixes, implemented infinite loop for loop() method, almost finished docs
* Finish writing docs
* Add automatic documentation builder script
* Finished writing docs
2018-03-20 12:48:05 +01:00
$table = ' ### Parameters:
2017-08-18 18:10:30 +02:00
2018-08-29 11:25:49 +02:00
| Name | Type | Description | Required |
|----------|---------------|-------------|----------|
2017-08-18 18:10:30 +02:00
' ;
}
$hasentities = false ;
$hasreplymarkup = false ;
$hasmessage = false ;
foreach ( $data [ 'params' ] as $param ) {
2019-09-02 17:08:36 +02:00
if ( \in_array ( $param [ 'name' ], [ 'flags' , 'random_id' , 'random_bytes' ])) {
2017-08-18 18:10:30 +02:00
continue ;
}
2017-09-28 19:38:43 +02:00
if ( $param [ 'name' ] === 'data' && $type === 'messages_SentEncryptedMessage' && ! isset ( $this -> settings [ 'td' ])) {
2017-08-18 18:10:30 +02:00
$param [ 'name' ] = 'message' ;
$param [ 'type' ] = 'DecryptedMessage' ;
}
2020-06-16 17:52:55 +02:00
if ( $param [ 'name' ] === 'chat_id' && $method !== 'messages.discardEncryption' && ! isset ( $this -> settings [ 'td' ])) {
2017-08-18 18:10:30 +02:00
$param [ 'type' ] = 'InputPeer' ;
}
2018-08-29 17:16:38 +02:00
if ( $param [ 'name' ] === 'hash' && $param [ 'type' ] === 'int' ) {
$param [ 'pow' ] = 'hi' ;
$param [ 'type' ] = 'Vector t' ;
$param [ 'subtype' ] = 'int' ;
}
2019-10-29 22:41:31 +01:00
$ptype = $param [ $type_or_subtype = isset ( $param [ 'subtype' ]) ? 'subtype' : 'type' ];
2017-08-18 18:10:30 +02:00
switch ( $ptype ) {
case 'true' :
case 'false' :
$ptype = 'Bool' ;
}
2018-03-27 14:41:50 +02:00
$human_ptype = $ptype ;
2019-09-02 17:08:36 +02:00
if ( \in_array ( $ptype , [ 'InputDialogPeer' , 'DialogPeer' , 'NotifyPeer' , 'InputNotifyPeer' , 'User' , 'InputUser' , 'Chat' , 'InputChannel' , 'Peer' , 'InputPeer' ]) && ! isset ( $this -> settings [ 'td' ])) {
2020-04-05 22:22:47 +02:00
$human_ptype = 'Username, chat ID, Update, Message or ' . $ptype ;
Documentation rework (#349)
* Documentation rework
* Apply fixes from StyleCI
* Documentation fixes
* Login as bot through web/cli API, allow using invite links in joinChannel, full invite links in importChatInvite and checkChatInvite, non-invite links in importChatInvite
* Apply fixes from StyleCI
* Logging fixes
* Build docs
* Add methods to modify start template, bugfix to logging and keyboard conversion
* Add TL documentator
* Document MTProto methods
* Documenting methods...
* 7% documented
* Bugfixes
* Update docs
* Update docs
* Simplify file management
* Implement automatic object conversion for media, and more awesome stuff
* Implement automatic object conversion for media, and more awesome stuff
* Implement event update handler and file upload/download callback
* Auto-detect mime type, duration, width and height of media
* Update docs
* Document new file functions
* Fix links
* Fix links
* Update bot.php to use event loop
* Implement webhook update handler and forking in main loop
* Build docs
* Better docs
* Fixes to secret chats
* Almost finished updating docs
* Bugfixes, implemented infinite loop for loop() method, almost finished docs
* Finish writing docs
* Add automatic documentation builder script
* Finished writing docs
2018-03-20 12:48:05 +01:00
}
2019-09-02 17:08:36 +02:00
if ( \in_array ( $ptype , [ 'InputMedia' , 'InputPhoto' , 'InputDocument' ]) && ! isset ( $this -> settings [ 'td' ])) {
2020-04-05 22:22:47 +02:00
$human_ptype = 'MessageMedia, Update, Message or ' . $ptype ;
Documentation rework (#349)
* Documentation rework
* Apply fixes from StyleCI
* Documentation fixes
* Login as bot through web/cli API, allow using invite links in joinChannel, full invite links in importChatInvite and checkChatInvite, non-invite links in importChatInvite
* Apply fixes from StyleCI
* Logging fixes
* Build docs
* Add methods to modify start template, bugfix to logging and keyboard conversion
* Add TL documentator
* Document MTProto methods
* Documenting methods...
* 7% documented
* Bugfixes
* Update docs
* Update docs
* Simplify file management
* Implement automatic object conversion for media, and more awesome stuff
* Implement automatic object conversion for media, and more awesome stuff
* Implement event update handler and file upload/download callback
* Auto-detect mime type, duration, width and height of media
* Update docs
* Document new file functions
* Fix links
* Fix links
* Update bot.php to use event loop
* Implement webhook update handler and forking in main loop
* Build docs
* Better docs
* Fixes to secret chats
* Almost finished updating docs
* Bugfixes, implemented infinite loop for loop() method, almost finished docs
* Finish writing docs
* Add automatic documentation builder script
* Finished writing docs
2018-03-20 12:48:05 +01:00
}
2019-09-02 17:08:36 +02:00
if ( \in_array ( $ptype , [ 'InputMessage' ]) && ! isset ( $this -> settings [ 'td' ])) {
2020-04-05 22:22:47 +02:00
$human_ptype = 'Message ID or ' . $ptype ;
Documentation rework (#349)
* Documentation rework
* Apply fixes from StyleCI
* Documentation fixes
* Login as bot through web/cli API, allow using invite links in joinChannel, full invite links in importChatInvite and checkChatInvite, non-invite links in importChatInvite
* Apply fixes from StyleCI
* Logging fixes
* Build docs
* Add methods to modify start template, bugfix to logging and keyboard conversion
* Add TL documentator
* Document MTProto methods
* Documenting methods...
* 7% documented
* Bugfixes
* Update docs
* Update docs
* Simplify file management
* Implement automatic object conversion for media, and more awesome stuff
* Implement automatic object conversion for media, and more awesome stuff
* Implement event update handler and file upload/download callback
* Auto-detect mime type, duration, width and height of media
* Update docs
* Document new file functions
* Fix links
* Fix links
* Update bot.php to use event loop
* Implement webhook update handler and forking in main loop
* Build docs
* Better docs
* Fixes to secret chats
* Almost finished updating docs
* Bugfixes, implemented infinite loop for loop() method, almost finished docs
* Finish writing docs
* Add automatic documentation builder script
* Finished writing docs
2018-03-20 12:48:05 +01:00
}
2019-09-02 17:08:36 +02:00
if ( \in_array ( $ptype , [ 'InputEncryptedChat' ]) && ! isset ( $this -> settings [ 'td' ])) {
2020-04-05 22:22:47 +02:00
$human_ptype = 'Secret chat ID, Update, EncryptedMessage or ' . $ptype ;
Documentation rework (#349)
* Documentation rework
* Apply fixes from StyleCI
* Documentation fixes
* Login as bot through web/cli API, allow using invite links in joinChannel, full invite links in importChatInvite and checkChatInvite, non-invite links in importChatInvite
* Apply fixes from StyleCI
* Logging fixes
* Build docs
* Add methods to modify start template, bugfix to logging and keyboard conversion
* Add TL documentator
* Document MTProto methods
* Documenting methods...
* 7% documented
* Bugfixes
* Update docs
* Update docs
* Simplify file management
* Implement automatic object conversion for media, and more awesome stuff
* Implement automatic object conversion for media, and more awesome stuff
* Implement event update handler and file upload/download callback
* Auto-detect mime type, duration, width and height of media
* Update docs
* Document new file functions
* Fix links
* Fix links
* Update bot.php to use event loop
* Implement webhook update handler and forking in main loop
* Build docs
* Better docs
* Fixes to secret chats
* Almost finished updating docs
* Bugfixes, implemented infinite loop for loop() method, almost finished docs
* Finish writing docs
* Add automatic documentation builder script
* Finished writing docs
2018-03-20 12:48:05 +01:00
}
2019-09-02 17:08:36 +02:00
if ( \in_array ( $ptype , [ 'InputFile' ]) && ! isset ( $this -> settings [ 'td' ])) {
2020-04-05 22:22:47 +02:00
$human_ptype = 'File path or ' . $ptype ;
Documentation rework (#349)
* Documentation rework
* Apply fixes from StyleCI
* Documentation fixes
* Login as bot through web/cli API, allow using invite links in joinChannel, full invite links in importChatInvite and checkChatInvite, non-invite links in importChatInvite
* Apply fixes from StyleCI
* Logging fixes
* Build docs
* Add methods to modify start template, bugfix to logging and keyboard conversion
* Add TL documentator
* Document MTProto methods
* Documenting methods...
* 7% documented
* Bugfixes
* Update docs
* Update docs
* Simplify file management
* Implement automatic object conversion for media, and more awesome stuff
* Implement automatic object conversion for media, and more awesome stuff
* Implement event update handler and file upload/download callback
* Auto-detect mime type, duration, width and height of media
* Update docs
* Document new file functions
* Fix links
* Fix links
* Update bot.php to use event loop
* Implement webhook update handler and forking in main loop
* Build docs
* Better docs
* Fixes to secret chats
* Almost finished updating docs
* Bugfixes, implemented infinite loop for loop() method, almost finished docs
* Finish writing docs
* Add automatic documentation builder script
* Finished writing docs
2018-03-20 12:48:05 +01:00
}
2019-09-02 17:08:36 +02:00
if ( \in_array ( $ptype , [ 'InputEncryptedFile' ]) && ! isset ( $this -> settings [ 'td' ])) {
2020-04-05 22:22:47 +02:00
$human_ptype = 'File path or ' . $ptype ;
Documentation rework (#349)
* Documentation rework
* Apply fixes from StyleCI
* Documentation fixes
* Login as bot through web/cli API, allow using invite links in joinChannel, full invite links in importChatInvite and checkChatInvite, non-invite links in importChatInvite
* Apply fixes from StyleCI
* Logging fixes
* Build docs
* Add methods to modify start template, bugfix to logging and keyboard conversion
* Add TL documentator
* Document MTProto methods
* Documenting methods...
* 7% documented
* Bugfixes
* Update docs
* Update docs
* Simplify file management
* Implement automatic object conversion for media, and more awesome stuff
* Implement automatic object conversion for media, and more awesome stuff
* Implement event update handler and file upload/download callback
* Auto-detect mime type, duration, width and height of media
* Update docs
* Document new file functions
* Fix links
* Fix links
* Update bot.php to use event loop
* Implement webhook update handler and forking in main loop
* Build docs
* Better docs
* Fixes to secret chats
* Almost finished updating docs
* Bugfixes, implemented infinite loop for loop() method, almost finished docs
* Finish writing docs
* Add automatic documentation builder script
* Finished writing docs
2018-03-20 12:48:05 +01:00
}
2019-10-31 15:06:25 +01:00
$type_or_bare_type = \ctype_upper ( Tools :: end ( \explode ( '.' , $param [ $type_or_subtype ]))[ 0 ]) || \in_array ( $param [ $type_or_subtype ], [ '!X' , 'X' , 'bytes' , 'true' , 'false' , 'double' , 'string' , 'Bool' , 'int' , 'long' , 'int128' , 'int256' , 'int512' , 'int53' ]) ? 'types' : 'constructors' ;
2020-06-16 17:52:55 +02:00
if ( ! isset ( $this -> td_descriptions [ 'methods' ][ $method ][ 'params' ][ $param [ 'name' ]])) {
if ( isset ( $this -> td_descriptions [ 'methods' ][ $method ][ 'description' ])) {
$this -> td_descriptions [ 'methods' ][ $method ][ 'params' ][ $param [ 'name' ]] = \danog\MadelineProto\Lang :: $lang [ 'en' ][ 'method_' . $method . '_param_' . $param [ 'name' ] . '_type_' . $param [ 'type' ]] ? ? '' ;
Documentation rework (#349)
* Documentation rework
* Apply fixes from StyleCI
* Documentation fixes
* Login as bot through web/cli API, allow using invite links in joinChannel, full invite links in importChatInvite and checkChatInvite, non-invite links in importChatInvite
* Apply fixes from StyleCI
* Logging fixes
* Build docs
* Add methods to modify start template, bugfix to logging and keyboard conversion
* Add TL documentator
* Document MTProto methods
* Documenting methods...
* 7% documented
* Bugfixes
* Update docs
* Update docs
* Simplify file management
* Implement automatic object conversion for media, and more awesome stuff
* Implement automatic object conversion for media, and more awesome stuff
* Implement event update handler and file upload/download callback
* Auto-detect mime type, duration, width and height of media
* Update docs
* Document new file functions
* Fix links
* Fix links
* Update bot.php to use event loop
* Implement webhook update handler and forking in main loop
* Build docs
* Better docs
* Fixes to secret chats
* Almost finished updating docs
* Bugfixes, implemented infinite loop for loop() method, almost finished docs
* Finish writing docs
* Add automatic documentation builder script
* Finished writing docs
2018-03-20 12:48:05 +01:00
}
}
2020-06-16 17:52:55 +02:00
if ( isset ( $this -> td_descriptions [ 'methods' ][ $method ])) {
$table .= '|' . StrTools :: markdownEscape ( $param [ 'name' ]) . '|' . ( isset ( $param [ 'subtype' ]) ? 'Array of ' : '' ) . '[' . StrTools :: markdownEscape ( $human_ptype ) . '](../' . $type_or_bare_type . '/' . $ptype . '.md) | ' . $this -> td_descriptions [ 'methods' ][ $method ][ 'params' ][ $param [ 'name' ]] . ' | ' . ( isset ( $param [ 'pow' ]) || ( $id = $this -> TL -> getConstructors ( $this -> td ) -> findByPredicate ( \lcfirst ( $param [ 'type' ]) . 'Empty' )) && $id [ 'type' ] === $param [ 'type' ] || ( $id = $this -> TL -> getConstructors ( $this -> td ) -> findByPredicate ( 'input' . $param [ 'type' ] . 'Empty' )) && $id [ 'type' ] === $param [ 'type' ] ? 'Optional' : 'Yes' ) . '|' ;
2018-08-29 11:25:49 +02:00
} else {
2020-06-16 17:52:55 +02:00
$table .= '|' . StrTools :: markdownEscape ( $param [ 'name' ]) . '|' . ( isset ( $param [ 'subtype' ]) ? 'Array of ' : '' ) . '[' . StrTools :: markdownEscape ( $human_ptype ) . '](../' . $type_or_bare_type . '/' . $ptype . '.md) | ' . ( isset ( $param [ 'pow' ]) || ( $id = $this -> TL -> getConstructors ( $this -> td ) -> findByPredicate ( \lcfirst ( $param [ 'type' ]) . 'Empty' )) && $id [ 'type' ] === $param [ 'type' ] || ( $id = $this -> TL -> getConstructors ( $this -> td ) -> findByPredicate ( 'input' . $param [ 'type' ] . 'Empty' )) && $id [ 'type' ] === $param [ 'type' ] ? 'Optional' : 'Yes' ) . '|' ;
2017-08-18 18:10:30 +02:00
}
$table .= PHP_EOL ;
2020-04-05 22:22:47 +02:00
$pptype = \in_array ( $ptype , [ 'string' , 'bytes' ]) ? " ' " . $ptype . " ' " : $ptype ;
$ppptype = \in_array ( $ptype , [ 'string' ]) ? '"' . $ptype . '"' : $ptype ;
$ppptype = \in_array ( $ptype , [ 'bytes' ]) ? '{"_": "bytes", "bytes":"base64 encoded ' . $ptype . '"}' : $ppptype ;
$params .= " ' " . $param [ 'name' ] . " ' => " ;
$params .= ( isset ( $param [ 'subtype' ]) ? '[' . $pptype . ', ' . $pptype . ']' : $pptype ) . ', ' ;
$json_params .= '"' . $param [ 'name' ] . '": ' . ( isset ( $param [ 'subtype' ]) ? '[' . $ppptype . ']' : $ppptype ) . ', ' ;
$pwr_params .= $param [ 'name' ] . ' - Json encoded ' . ( isset ( $param [ 'subtype' ]) ? ' array of ' . $ptype : $ptype ) . " \n \n " ;
$lua_params .= $param [ 'name' ] . '=' ;
$lua_params .= ( isset ( $param [ 'subtype' ]) ? '{' . $pptype . '}' : $pptype ) . ', ' ;
2017-08-18 18:10:30 +02:00
if ( $param [ 'name' ] === 'reply_markup' ) {
$hasreplymarkup = true ;
}
if ( $param [ 'name' ] === 'message' ) {
$hasmessage = true ;
}
if ( $param [ 'name' ] === 'entities' ) {
$hasentities = true ;
2018-08-29 11:25:49 +02:00
$table .= ' | parse\\_mode | [ string ]( ../ types / string . md ) | Whether to parse HTML or Markdown markup in the message | Optional |
2017-08-18 18:10:30 +02:00
' ;
$params .= " 'parse_mode' => 'string', " ;
2019-10-29 22:41:31 +01:00
$lua_params .= " parseMode='string', " ;
$json_params .= '"parseMode": "string"' ;
$pwr_params = " parseMode - string \n " ;
2017-08-18 18:10:30 +02:00
}
}
2020-06-16 17:52:55 +02:00
$description = isset ( $this -> td_descriptions [ 'methods' ][ $method ]) ? $this -> td_descriptions [ 'methods' ][ $method ][ 'description' ] : $method . ' parameters, return type and example' ;
2019-12-27 18:50:56 +01:00
$symFile = \str_replace ( '.' , '_' , $method );
2020-01-31 19:29:43 +01:00
$redir = $symFile !== $method ? " \n redirect_from: /API_docs/methods/ { $symFile } .html " : '' ;
2020-10-01 20:48:22 +02:00
$description = \rtrim ( \explode ( " \n " , $description )[ 0 ], ':' );
2020-06-16 17:52:55 +02:00
$header = $this -> template ( 'Method' , $method , $description , $redir , StrTools :: markdownEscape ( $method ));
2017-08-18 18:10:30 +02:00
if ( $this -> td ) {
2020-06-16 17:52:55 +02:00
$header .= " YOU CANNOT USE THIS METHOD IN MADELINEPROTO \n \n \n \n \n " ;
2017-08-18 18:10:30 +02:00
}
2020-06-16 17:52:55 +02:00
$header .= isset ( $this -> td_descriptions [ 'methods' ][ $method ]) ? $this -> td_descriptions [ 'methods' ][ $method ][ 'description' ] . PHP_EOL . PHP_EOL : '' ;
2017-08-18 18:10:30 +02:00
$table .= '
' ;
2020-06-16 17:52:55 +02:00
$return = '### Return type: [' . StrTools :: markdownEscape ( $type ) . '](../types/' . $php_type . ' . md )
2017-08-18 18:10:30 +02:00
' ;
2020-06-16 17:52:55 +02:00
$bot = ! \in_array ( $method , $bots );
2017-08-25 14:43:29 +02:00
$example = '' ;
if ( ! isset ( $this -> settings [ 'td' ])) {
2020-04-05 22:22:47 +02:00
$example .= '### Can bots use this method: **' . ( $bot ? 'YES' : 'NO' ) . " ** \n \n \n " ;
2020-06-16 17:52:55 +02:00
$example .= \str_replace ( '[]' , '' , $this -> template ( 'method-example' , $type , $phpMethod , $params , $method , $lua_params ));
2017-08-25 14:43:50 +02:00
if ( $hasreplymarkup ) {
2020-06-16 17:52:55 +02:00
$example .= $this -> template ( 'reply_markup' );
2017-08-25 14:43:50 +02:00
}
if ( $hasmessage ) {
2020-06-16 17:52:55 +02:00
$example .= $this -> template ( 'chunks' , StrTools :: markdownEscape ( $type ), $php_type );
2017-08-25 14:43:50 +02:00
}
if ( $hasentities ) {
2020-06-16 17:52:55 +02:00
$example .= $this -> template ( 'parse_mode' );
2017-08-25 14:43:50 +02:00
}
2020-06-16 17:52:55 +02:00
if ( isset ( $new [ 'result' ][ $method ])) {
2019-06-29 14:54:12 +02:00
$example .= ' ### Errors
2018-03-27 14:41:50 +02:00
2019-06-29 14:54:12 +02:00
| Code | Type | Description |
|------|----------|---------------|
2018-03-27 14:41:50 +02:00
' ;
2020-06-16 17:52:55 +02:00
foreach ( $new [ 'result' ][ $method ] as $error ) {
2019-06-29 14:54:12 +02:00
[ $error , $code ] = $error ;
2020-04-05 22:22:47 +02:00
$example .= " | { $code } | { $error } | " . $errors [ 'human_result' ][ $error ][ 0 ] . '|' . " \n " ;
2018-03-27 14:41:50 +02:00
}
$example .= " \n \n " ;
}
2017-08-25 14:43:50 +02:00
}
2020-04-05 22:22:47 +02:00
\file_put_contents ( 'methods/' . $method . '.md' , $header . $table . $return . $example );
2017-08-18 18:10:30 +02:00
}
2018-04-08 19:53:30 +02:00
$this -> logger -> logger ( 'Generating methods index...' , \danog\MadelineProto\Logger :: NOTICE );
2019-09-02 17:08:36 +02:00
\ksort ( $this -> docs_methods );
\ksort ( $this -> human_docs_methods );
2017-08-18 18:10:30 +02:00
$last_namespace = '' ;
foreach ( $this -> docs_methods as $method => & $value ) {
2019-09-02 17:08:36 +02:00
$new_namespace = \preg_replace ( '/_.*/' , '' , $method );
2017-08-18 18:10:30 +02:00
$br = $new_namespace != $last_namespace ? ' ***
2018-03-23 17:59:56 +01:00
< br >< br >
' : ' ' ;
2020-04-05 22:22:47 +02:00
$value = $br . $value ;
2018-03-23 17:44:33 +01:00
$last_namespace = $new_namespace ;
}
2020-06-16 17:52:55 +02:00
\file_put_contents ( 'methods/api_' . $this -> index , $this -> template ( 'methods-api-index' , $this -> index , \implode ( '' , $this -> docs_methods )));
\file_put_contents ( 'methods/' . $this -> index , $this -> template ( 'methods-index' , $this -> index , \implode ( '' , $this -> human_docs_methods )));
2017-08-18 18:10:30 +02:00
}
2018-02-24 17:54:39 +01:00
}