davtur19
/
tgscraper
mirror of https://github.com/Sysbot-org/tgscraper.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity
A PHP library used to extract JSON data (and auto-generate PHP classes) from Telegram bot API documentation page.
57 Commits 2 Branches 25 Tags 1.2 MiB
PHP 99.6%
Dockerfile 0.4%
Go to file
Sys 9d0cdff59b
Bot API 6.9 and 7.0 		2024-01-05 22:44:32 +01:00
.github/workflows Bot API 5.5.0 update 2021-12-11 01:47:04 +01:00
bin Huge refactoring, custom schema changes, dump-schemas command 2022-04-15 23:33:46 +02:00
docs Huge refactoring, custom schema changes, dump-schemas command 2022-04-15 23:33:46 +02:00
src Bot API 6.9 and 7.0 2024-01-05 22:44:32 +01:00
templates OpenAPI, changelog, cache package support 2021-08-23 13:12:50 +02:00
.dockerignore Automatic Docker build, abstract classes implementation in stubs 2021-07-30 00:25:07 +02:00
.gitignore Bot API 6.3 2022-11-05 17:01:35 +01:00
CHANGELOG.md Bot API 6.9 and 7.0 2024-01-05 22:44:32 +01:00
Dockerfile OpenAPI, changelog, cache package support 2021-08-23 13:12:50 +02:00
LICENSE Updated project license 2021-06-17 18:05:04 +02:00
README.md Huge refactoring, custom schema changes, dump-schemas command 2022-04-15 23:33:46 +02:00
composer.json Added dev dependencies and bot API 6.0 support 2022-04-16 16:40:00 +02:00
composer.lock Bot API 6.9 and 7.0 2024-01-05 22:44:32 +01:00
psalm.xml Huge refactoring, custom schema changes, dump-schemas command 2022-04-15 23:33:46 +02:00

README.md

TGScraper

License Required PHP Version Latest Stable Version Dependencies Code Quality

A PHP library used to extract JSON data (and auto-generate PHP classes) from Telegram bot API documentation page.

Changelog

Interested in recent changes? Have a look here!

Installation

Install the library with composer:

  $ composer require sysbot/tgscraper --prefer-stable

(Optional) Install the cache package:

  $ composer require sysbot/tgscraper-cache

Using from command line

Once installed, you can use the CLI to interact with the library.

For basic help and command list:

  $ vendor/bin/tgscraper help

JSON

Extract the latest schema in a human-readable JSON:

  $ vendor/bin/tgscraper app:export-schema --readable botapi.json

Or, if you want a Postman-compatible JSON (thanks to davtur19):

  $ vendor/bin/tgscraper app:export-schema --postman botapi_postman.json

YAML

Extract the latest schema in YAML format:

  $ vendor/bin/tgscraper app:export-schema --yaml botapi.yaml

OpenAPI

Extract the latest OpenAPI schema in JSON format:

  $ vendor/bin/tgscraper app:export-schema --openapi botapi_openapi.json

Or, if you prefer YAML:

  $ vendor/bin/tgscraper app:export-schema --openapi --yaml botapi_openapi.yaml

Stubs

Note: since Telegram may change the page format at any time, do NOT rely on the automagically generated stubs from this library, ALWAYS review the code!

TGScraper can also generate class stubs that you can use in your library. A sample implementation is available in the Sysbot Telegram module.

Create stubs in the out/ directory using Sysbot\Telegram as namespace prefix:

  $ vendor/bin/tgscraper app:create-stubs --namespace-prefix "Sysbot\Telegram" out

All versions

If you want to generate all schemas and stubs for every Bot API version, you can!

Here's an example on how to export everything to the out/ directory, with schemas in human-readable format and using Sysbot\Telegram as namespace prefix for the stubs:

  $ vendor/bin/tgscraper app:dump-schemas -r --namespace-prefix "Sysbot\Telegram" out

Custom format

If you're interested in the custom format generated by TGScraper, you can find its schema here.