Шаблонът на най-простия бот за телеграма за ученици от 7-9 клас на Powershell

По време на разговори с приятел изведнъж разбрах за себе си, че децата от 8-10 клас изобщо не се учат на програмиране в тяхното училище. Word, Excel и всичко останало. Няма лого, нито дори Pascal, нито дори VBA за Excel.

Бях много изненадан, отворих интернет и се изкачих да чета -
Една от задачите на профилираното училище е да допринесе за възпитанието на ново поколение, което по степен на развитие и начин на живот отговаря на условията на информационното общество.
Този курс ще позволи на практика да консолидира знанията на студентите за основните конструкции на езика за програмиране Pascal. (от програмата на някоя гимназия за 2017 г.)

В резултат на това реших да отделя няколко часа и да скицирам пример „как да създам прост бот за ученици“.

Под разрез, за ​​това как да напиша още един прост бот в Powershell и да го накарам да работи без уеб кукички, бели IP адреси, специални сървъри, виртуални машини за внедряване в облака и други неща - на обикновен домашен компютър с обикновен Windows.

TLDR: Още една скучна статия с граматически и фактически грешки, нищо за четене, без хумор, без снимки.

В статията няма нищо ново, почти всичко, написано по-рано, вече беше на Habré, например в статии Инструкции: Как да създадете ботове в Telegram и Telegram бот за системен администратор.
Освен това статията е умишлено излишна, за да не се позовава всеки път на учебна литература. В текста няма препратки към банда 4, дълбоки гмуркания на PowerShell или, да речем, 5-те стълба на добре архитектурираната рамка на AWS.

Вместо предговор можете да пропуснете

Чувствайте се свободни да пропуснетеПрез 2006 г. Microsoft пусна PowerShell 1.0 за тогавашните Windows XP, Vista и 2003 сървъри. В някои отношения той замени неща като cmdbat скриптове, vb скриптове, Windows Script Host и JScript.

Дори сега PowerShell може да се разглежда само като следващата стъпка след опциите за лого, вместо Delphi (или нещо по-старо), което вероятно все още се използва някъде, въпреки наличието на цикли, класове, функции, MS GUI извиквания, интеграция с Git и така нататък.

Powershell се използва сравнително рядко, можете да го срещнете само под формата на PowerShell Core, VMware vSphere PowerCLI, Azure PowerShell, MS Exchange, конфигурация на желаното състояние, PowerShell уеб достъп и около дузина рядко използвани програми и функции. Може би той ще получи втори вятър с освобождаването WSL2, но не е точно така.

Powershell има и три големи плюса:

1. Той е сравнително прост, има много литература и примери за него и дори на руски, например, статия за Foreach е от книгата PowerShell в дълбочина - относно разликата () и {}
2. Предлага се с редактор ISE, в комплект с Windows. Има дори някакъв вид дебъгер.
3. От него лесно се извикват компоненти за изграждане на графичен интерфейс.

0. Подготовка.

Ще ни трябва:

• Компютър с Windows (имам Windows 10)
• Поне някакъв вид достъп до Интернет (чрез NAT например)
• За тези, които имат ограничен достъп до телеграмата - инсталиран и конфигуриран freegate в браузъра, в някои трудни случаи, заедно със Symple DNS Crypt
• Наличието на работещ телеграм клиент на телефона
• Разбиране на самите основи - какво е променлива, масив, цикъл.

Отворени и прочетени статии - Инструкции: Как да създадете ботове в Telegram и Telegram бот за системен администратор

1. Нека създадем друг тестов бот.

Тъй като всички вече знаят това и вече се е случвало, можете също да пропуснетеКакто е посочено в статията по-горе – На първо място, бот за Telegram – това все още е приложение, работещо от ваша страна, което прави заявки към API на Telegram Bot. Освен това API е разбираем - ботът получава достъп до конкретен URL адрес с параметри, а Telegram отговаря с JSON обект.

Свързани проблеми: ако по някакъв неизвестен начин вземете някакъв код от JSON обекта и по някакъв начин го изпратите за изпълнение (не нарочно), кодът ще бъде изпълнен вместо вас.

Процесът на създаване е описан в двете статии по-горе, но повтарям: в телеграмата отворете контакти, потърсете @botfather, кажете му / newbot, създайте бот Botfortest12344321, нека го наречем Mynext1234bot и получете съобщение с уникален ключ като 1234544311:AbcDefNNNNNNNNNNNN

Пазете ключа и не го давайте!

След това можете да конфигурирате бота, например, да забраните добавянето му към групи, но това не е необходимо в първите стъпки.

Нека попитаме BotFather "/mybot" и да коригираме настройките, ако нещо не ни харесва.

Отворете отново контактите, намерете там @Botfortest12344321 (започването на търсенето с @ е задължително), щракнете върху "старт" и пишете на бота "/Слава на роботите". Знакът / е задължителен, кавички не са необходими.
Ботът, разбира се, няма да отговори нищо.

Нека проверим дали ботът е създаден - отворете го.

api.telegram.org/bot1234544311:AbcDefNNNNNNNNNNNN/getMe
където 1234544311:AbcDefNNNNNNNNNNNN е предишният получен ключ,
и вземете линия като
{"ok":true,"result":{""}}

Имаме първата тайна фраза (токен). Сега трябва да разберем втория таен номер - ID на чата с бота. Всеки чат, група и т.н. е индивидуален и има свой номер (понякога с минус за отворени групи). За да разберем този номер, трябва да поискаме в браузъра (всъщност това изобщо не е необходимо в браузъра, но за по-добро разбиране можете да започнете с него) адреса (където 1234544311:NNNNNNNN е вашият токен

https://api.telegram.org/bot1234544311:NNNNNNNNN/getUpdates

и получете отговор като

{"ok":true,"result":[{"update_id":…,… чат":{"документ за самоличност":123456789

Трябва ни точно chat_id.

Нека проверим дали можем да пишем в чата ръчно: обадете се на адреса от браузъра

https://api.telegram.org/botваштокен/sendMessage?chat_id=123456789&text="Life is directed motion"

Ако сте получили съобщение от бота в чата - добре, преминавате към следващия етап.

Така (през браузъра) винаги можете да проверите къде са проблемите - имате при генериране на линк, или нещо някъде е скрито и не работи.

Какво трябва да знаете, преди да продължите да четете

Telegram има няколко вида групови чатове (отворени, затворени). За тези чатове някои от функциите (например id) са различни, което понякога причинява някои проблеми.

Ще приемем, че е краят на 2019 г. и дори героят на нашето време, добре познатият човек-оркестър (администратор, адвокат, служител по информационна сигурност, програмист и практически MVP) Евгений В. разграничава променливата $i от масив, е усвоил цикли, гледате през следващите няколко години ще усвоите Chocolatey и там до Паралелна обработка с PowerShell и ForEach-Object Parallel ще дойде.

1. Мислим какво ще направи нашият бот

Нямах идеи, трябваше да помисля. Вече написах бот-тетрадка. Не исках да правя бот, „който изпраща нещо някъде“. За да свържете Azure, имате нужда от кредитна карта, но откъде студентът я взема? Трябва да се отбележи, че всичко не е толкова лошо: основните облаци дават някакъв тестов период безплатно (но все пак се нуждаете от номер на кредитна карта - и той ще бъде приспаднат от нея, изглежда долар. Не помня ако се е върнал по-късно.)

Без AI ML не е толкова интересно да се направи глупав бот за поезия.

Реших да направя бот, който да ми напомня (или не) английски думи в речник.
Речникът, за да не се забърквате с базата данни, ще бъде в текстов файл и ще се попълва ръчно.
В този случай задачата е да се покажат основите на работа, а не да се направи поне частично завършен продукт.

2. Пробване какво и как за първи път

Създайте папка C:poshtranslate
Първо, нека видим какъв вид powershell имаме, стартирайте ISE чрез start-run
powerhell ise
или намерете Powershell ISE в инсталираните програми.
След стартиране ще се отвори обичайният познат „някакъв редактор“, ако няма текстово поле, винаги можете да щракнете върху „Файл - създаване на нов“.

Да видим версията на powershell - напишете в текстовото поле:

get-host 

и натиснете F5.

Powershell ще предложи да запази - "Скриптът, който ще изпълните, ще бъде записан.", Ние се съгласяваме и запазваме файла от powershell в C: poshtranslate с името myfirstbotBT100.

След стартиране в долното текстово поле получаваме табела с данни:

Name             : Windows PowerShell ISE Host
Version          : 5.1.(и так далее)

Имам 5.1 с нещо, стига. Ако имате стар Windows 7/8, тогава всичко е наред - въпреки че PowerShell трябва да се актуализира до версия 5 - например, Directions.

Въведете Get-Date в командния ред по-долу, натиснете Enter, вижте часа, отидете в основната папка с командата
cd
и изчистете екрана с командата cls (не, не е нужно да използвате rm)

Сега нека проверим какво работи и как - нека напишем дори не код, а два реда и се опитайте да разберете какво правят. Нека коментираме реда със символа get-host # и да добавим малко.

# Пример шаблона бота 
# get-host
<# это пример многострочного комментария #>
$TimeNow = Get-Date
$TimeNow

(Интересно. Има две дузини опции в падащия списък за проектиране на код на Habré - но powershell не е там. Dos е. Perl е.)

И стартирайте кода, като натиснете F5 или ">" от GUI.

Получаваме резултата:

Saturday, December 8, 2019 21:00:50 PM (или что-то типа)

Сега нека разгледаме тези два реда и някои интересни точки, за да не се връщаме към това в бъдеще.

За разлика от Pascal (и не само), powershell сам се опитва да определи какъв тип да присвои на променлива, повече за това е написано в статията Образователна програма по писане на езици за програмиране
Следователно, като настроим променливата $TimeNow и й присвоим стойността на текущата дата и час (Get-Date), не е нужно да се тревожим твърде много за това какъв тип данни ще има там.

Вярно, това невежество може да навреди след това, но това е по-късно. По-долу има пример в текста.
Да видим какво имаме. Изпълнение (от командния ред)

$TimeNow | Get-member

и да получите страница с неразбираем текст

Пример за неразбираем текст номер 1

PS C:> $TimeNow | Get-member
   TypeName: System.DateTime
Name                 MemberType     Definition                                                                                                                                       
----                 ----------     ----------                                                                                                                                       
Add                  <b>Method         </b>datetime Add(timespan value)  
..
DisplayHint          NoteProperty   DisplayHintType DisplayHint=DateTime                                                                                                             
Date                 <b>Property       </b>datetime Date {get;}                                                                                                                             
Year                 Property       int Year {get;}   
..                                                                                                                               
DateTime             ScriptProperty System.Object DateTime {get=if ((& { Set-StrictMode -Version 1; $this.DisplayHint }) -ieq  "Date")...                                         

Както можете да видите, променлива от тип TypeName: System.DateTime е създадена с куп методи (в смисъл какво можем да правим с този променлив обект) и свойства.

Да се ​​обадим $TimeNow.DayOfYear - вземете номера на деня в годината.
Да се ​​обадим $TimeNow.DayOfYear | Get-Member - получи TypeName: System.Int32 и група от методи.
Да се ​​обадим $TimeNow.ToUniversalTime() - и вземете часа в UTC

Debugger

Понякога се случва да трябва да изпълните програма до определен ред и да видите състоянието на програмата в този момент. За да направи това, ISE има функция за отстраняване на грешки - превключване на точката на прекъсване
Поставете точка на прекъсване някъде по средата, пуснете тези два реда и вижте как изглежда прекъсването.

3. Разбиране на взаимодействието с бота на Telegram

Разбира се, още повече литература е написана за взаимодействието с бота, с всички getpush и т.н., но въпросът за теорията може да се счита за незадължителен.

В нашия случай се нуждаем от:

• Научете се да изпращате нещо в кореспонденция
• Научете се да получавате нещо от кореспонденцията

3.1 Да се ​​научим да изпращаме нещо в кореспонденция и да получаваме от него

Малко код - част 3

Write-output "This is part 3"
$MyToken = "1234544311:AbcDefNNNNNNNNNNNNN"
$MyChatID = "123456789"
$MyProxy = "http://1.2.3.4:5678" 

$TimeNow = Get-Date
$TimeNow.ToUniversalTime()
$ScriptDir = Split-Path $script:MyInvocation.MyCommand.Path
$BotVersion = "BT102"

$MyText01 = "Life is directed motion - " + $TimeNow

$URL4SEND = "https://api.telegram.org/bot$MyToken/sendMessage?chat_id=$MyChatID&text=$MyText01"

Invoke-WebRequest -Uri $URL4SEND

и в RF на това място получаваме грешката Unable to connect to the remote server.

Или не го разбираме - зависи от телеком оператора и дали проксито е конфигурирано и работи
Е - остава да добавите прокси. Моля, обърнете внимание - използването на некриптиран и обикновено оставен прокси е изключително опасно за вашето здраве.

Задачата да се намери работещ прокси не е много трудна - повечето от публикуваните http проксита работят. При мен май работи пети поред.

Синтаксис, използващ прокси:

Invoke-WebRequest -Uri $URL4SEND -Proxy $MyProxy

Ако сте получили съобщение в чата си с бота, значи всичко е наред, можете да продължите. Ако не, продължете с отстраняването на грешки.

Можете да видите в какво се превръща вашият $URL4SEND низ и да опитате да го поискате в браузъра, като това:

$URL4SEND2 = '"'+$URL4SEND+'"'
start chrome $URL4SEND2 

3.2. Научихме се да пишем „нещо“ в чата, сега ще се опитаме да четем

Нека добавим още 4 реда и да видим какво има вътре чрез | get-член

$URLGET = "https://api.telegram.org/bot$MyToken/getUpdates"
$MyMessageGet = Invoke-WebRequest -Uri $URLGET -Method Get -Proxy $MyProxy
Write-Host "Get-Member"
$MyMessageGet | Get-Member

Най-интересното ни дава

Content           Property   string Content {get;}  
ParsedHtml        Property   mshtml.IHTMLDocument2 ParsedHtml {get;}                                    
RawContent        Property   string RawContent {get;set;}

Да видим какво има в тях:

Write-Host "ParsedHtml"
$MyMessageGet.ParsedHtml # тут интересное
Write-Host "RawContent"
$MyMessageGet.RawContent # и тут интересное, но еще к тому же и читаемое. 
Write-Host "Content"
$MyMessageGet.Content

Ако всичко работи за вас, ще получите дълъг ред като:

{"ok":true,"result":[{"update_id":12345678,
"message":{"message_id":3,"from":{"id"

За щастие, в публикуваната по-рано статия Telegram bot за системния администратор, този ред (да, според $MyMessageGet.RawContent | get-member е System.String) вече е демонтиран.

4. Обработете полученото (вече знаем как да изпратим поне нещо)

Както вече беше писано тук, най-необходимото се крие в съдържанието. Нека го разгледаме по-внимателно.

Първо, нека напишем още няколко фрази на бота от уеб интерфейса или от телефона

/message1
/message2
/message3

и погледнете през браузъра адреса, който е генериран в променливата $URLGET.

Ще видим нещо като:

{"ok":true,"result":[{"update_id":NNNNNNN,
"message":{"message_id":10, .. "text":"/message1"
"message":{"message_id":11, .. "text":"/message2 
"message":{"message_id":12, .. "text":"/message3 

Какво е? Някакъв сложен обект от масиви от обекти, съдържащи идентификатор на съобщение, идентификатор на чат, идентификатор на изпращане и много информация.

Не е нужно обаче да анализираме „какъв обект е това“ - част от работата вече е свършена за нас. Да видим какво има вътре:

Четене на получени съобщения или част 4

Write-Host "This is part 4" <# конечно эта строка нам не нужна в итоговом тексте, но по ней удобно искать. #> 

$Content4Pars01 = ConvertFrom-Json $MyMessageGet.Content
$Content4Pars01 | Get-Member
$Content4Pars01.result
$Content4Pars01.result[0]
$Content4Pars01.result[0] | Get-Member
$Content4Pars01.result[0].update_id
$Content4Pars01.result[0].message
$Content4Pars01.result[0].message.text
$Content4Pars01.result[1].message.text
$Content4Pars01.result[2].message.text

5. Какво да правим с него сега

Запазете получения файл под името myfirstbotBT105 или каквото искате, променете заглавието и коментирайте целия вече написан код

<#start comment 105 end comment 105#>

Сега трябва да решим къде да вземем речника (е, къде - на диск във файл) и как ще изглежда.

Разбира се, можете да попълните огромен речник направо в текста на скрипта, но това абсолютно не е така.
Затова нека да видим с какво powershell може да работи нормално.
Всъщност той не се интересува с какъв файл да работи, нас не ни интересува.
Имаме избор: txt (възможно е, но защо), csv, xml.
И можете да видите всички. Да видим всички.
Създайте клас MyVocabClassExample1 и променлива $MyVocabExample1
Отбелязвам, че класът е написан без $

някакъв код #5

write-host "This is part 5"
class MyVocabClassExample1 {
    [string]$Original  # слово
    [string]$Transcript
    [string]$Translate
    [string]$Example
    [int]$VocWordID # очень интересный момент. Использование int с его ограничениями может порой приводить к диким последствиям, для примера - недавний случай с SSD HPE. Изначально я не стал добавлять этот элемент, потом все же дописал и закомментировал.
    }

$MyVocabExample1 = [MyVocabClassExample1]::new()
$MyVocabExample1.Original = "Apple"
$MyVocabExample1.Transcript = "[ ˈapəl ]"
$MyVocabExample1.Translate = "Яблоко"
$MyVocabExample1.Example = "An apple is a sweet, edible fruit produced by an apple tree (Malus domestica)"
# $MyVocabExample1.$VocWordID = 1

$MyVocabExample2 = [MyVocabClassExample1]::new()
$MyVocabExample2.Original = "Pear"
$MyVocabExample2.Transcript = "[ pe(ə)r ]"
$MyVocabExample2.Translate = "Груша"
$MyVocabExample2.Example = "The pear (/ˈpɛər/) tree and shrub are a species of genus Pyrus"
# $MyVocabExample1.$VocWordID = 2

Нека се опитаме да го запишем във файловете от примерен.

Някакъв код #5.1

Write-Host $ScriptDir # надеюсь $ScriptDir вы не закомментировали 
$MyFilenameExample01 = $ScriptDir + "Example01.txt"
$MyFilenameExample02 = $ScriptDir + "Example02.txt"
Write-Host $MyFilenameExample01
Out-File  -FilePath $MyFilenameExample01 -InputObject $MyVocabExample1

Out-File  -FilePath $MyFilenameExample01 -InputObject -Append $MyVocabExample2
notepad $MyFilenameExample01

- и получавате грешка на реда Out-File -FilePath $MyFilenameExample01 -InputObject -Append $MyVocabExample2.

Не иска да добавя, ах-ах какъв срам.

$MyVocabExample3AsArray = @($MyVocabExample1,$MyVocabExample2)
Out-File  -FilePath $MyFilenameExample02 -InputObject $MyVocabExample3AsArray
notepad $MyFilenameExample02

Да видим какво е станало. Красив текстов изглед - но как да експортирате обратно от него? Въведете някакъв вид текстови разделители, като запетаи?

И в резултат на това вземете "файл с разделители - запетаи, стойности, разделени със запетая (CSV) A СПРИ ИЗЧАКАЙ.
#

$MyFilenameExample03 = $ScriptDir + "Example03.csv"
$MyFilenameExample04 = $ScriptDir + "Example04.csv"
Export-Csv  -Path $MyFilenameExample03 -InputObject $MyVocabExample1 
Export-Csv  -Path $MyFilenameExample03 -InputObject $MyVocabExample2 -Append 
Export-Csv  -Path $MyFilenameExample04 -InputObject $MyVocabExample3AsArray 

Както можете лесно да видите, MS не се отличава особено с логика, за подобна процедура в единия случай се използва -FilePath, а в другия -Path.

Освен това руският език изчезна в третия файл, в четвъртия файл се оказа ... добре, нещо се случи. #TYPE System.Object[] 00
# "Count", "Length", "LongLength", "Rank", "SyncRoot", "IsReadOnly", "IsFixedSize", "IsSynchronized"
#
Нека го пренапишем малко:

Export-Csv  -Path $MyFilenameExample03 -InputObject $MyVocabExample1 -Encoding Unicode
Export-Csv  -Path $MyFilenameExample03 -InputObject $MyVocabExample2 -Append -Encoding Unicode
notepad $MyFilenameExample03
notepad $MyFilenameExample04

Изглежда помогна, но форматът все още не ми харесва.

Особено не ми харесва, че не мога да поставя редове от обект във файл директно.
Между другото, след като започнахме да пишем във файлове, можем ли да започнем да регистрираме стартирането? Имаме време като променлива, можем да зададем името на файла.

Вярно, че все още няма какво да се пише, но можете да помислите как най-добре да направите ротацията на трупите.
Нека опитаме xml засега.

малко xml

$MyFilenameExample05 = $ScriptDir + "Example05.xml"
$MyFilenameExample06 = $ScriptDir + "Example06.xml"
Export-Clixml  -Path $MyFilenameExample05 -InputObject $MyVocabExample1 
Export-Clixml  -Path $MyFilenameExample05 -InputObject $MyVocabExample2 -Append -Encoding Unicode
Export-Clixml  -Path $MyFilenameExample06 -InputObject $MyVocabExample3AsArray
notepad $MyFilenameExample05
notepad $MyFilenameExample06

Експортирането в xml има солидни предимства - четливост, експортиране на целия обект и липса на необходимост от uppend.

Нека опитаме прочетете xml файл.

Малко четене от xml

$MyFilenameExample06 = $ScriptDir + "Example06.xml"
$MyVocabExample4AsArray = Import-Clixml -Path $MyFilenameExample06
# $MyVocabExample4AsArray 
# $MyVocabExample4AsArray[0]
# и немного о совершенно неочевидных нюансах. Powershell время от времени ведет себя не так, как вроде бы как бы стоило бы ожидать бы.
# например у меня эти два вывода отличаются
# Write-Output $MyVocabExample4AsArray 
# write-host $MyVocabExample4AsArray 

Да се ​​върнем на задачата. Написахме тестов файл, прочетохме го, форматът за съхранение е разбираем, ако е необходимо, можете да напишете отделен малък файлов редактор за добавяне и изтриване на редове.

Напомням, че задачата беше да се направи малък тренировъчен бот.

Формат на работа: Изпращам командата „пример“ на бота, ботът ми изпраща произволно избрана дума и транскрипция и след 10 секунди изпраща превод и коментар. Ние знаем как да четем команди и, разбира се, да се научим как автоматично да избираме и проверяваме прокси сървъри и да нулираме броячите на съобщения до забрава.

Нека да разкоментираме всичко, което преди това е коментирано като ненужно, да коментираме примерите с txt и csv, които са станали ненужни, и да запазим файла като версия B106

А, да. Нека отново да изпратим нещо на бота.

6. Изпращане от функции и др

Преди да обработите приемането, трябва да направите функцията за изпращане на "поне нещо", с изключение на тестовото съобщение.

Разбира се, в примера ще имаме само едно изпращане и само една обработка, но какво ще стане, ако трябва да направим едно и също нещо няколко пъти?

По-лесно е да напишете функция. И така, имаме променлива от обектния тип $MyVocabExample4AsArray, прочетена от файла, като масив от два цели елемента.
Хайде да четем.

В същото време ще се занимаваме с часовника, ще ни трябва по-късно (всъщност в този пример няма да ни трябва 🙂

Някакъв код #6.1

Write-Output "This is Part 6"
$Timezone = (Get-TimeZone)
IF($Timezone.SupportsDaylightSavingTime -eq $True){
    $TimeAdjust =  ($Timezone.BaseUtcOffset.TotalSeconds + 3600) } # приведенное время
    ELSE{$TimeAdjust = ($Timezone.BaseUtcOffset.TotalSeconds) 
    }
    
function MyFirstFunction($SomeExampleForFunction1){
$TimeNow = Get-Date
$TimeNow.ToUniversalTime()
# $MyText02 = $TimeNow + " " + $SomeExampleForFunction1 # и вот тут мы получим ошибку
$MyText02 = $SomeExampleForFunction1 + " " + $TimeNow # а тут не получим, кто догадается почему - тот молодец.

$URL4SendFromFunction = "https://api.telegram.org/bot$MyToken/sendMessage?chat_id=$MyChatID&text=$MyText02"
Invoke-WebRequest -Uri $URL4SendFromFunction -Proxy $MyProxy
}

Както можете лесно да видите, $MyToken и $MyChatID се извикват във функцията, която беше твърдо кодирана по-рано.

Не е необходимо да правите това и ако $MyToken е един за всеки бот, тогава $MyChatID ще се промени в зависимост от чата.

Но тъй като това е пример, засега ще го игнорираме.

Тъй като $MyVocabExample4AsArray не е масив, въпреки че е много подобен, тогава не можеш просто да вземеш попитайте за дължината му.

За пореден път ще трябва да правим това, което не може - да скачаме с парашут не по кодекса - да вземем и да броим

Някакъв код #6.2

$MaxRandomExample = 0 
foreach ($Obj in $MyVocabExample4AsArray) {
$MaxRandomExample ++
}
Write-Output $MaxRandomExample
$RandomExample = Get-Random -Minimum 0 -Maximum ($MaxRandomExample)
$TextForExample1 = $MyVocabExample4AsArray[$RandomExample].Original
# MyFirstFunction($TextForExample1)
# или в одну строку
# MyFirstFunction($MyVocabExample4AsArray[Get-Random -Minimum 0 -Maximum ($MaxRandomExample -1)].Example)
# Угадайте сами, какой пример легче читается посторонними людьми.

случаен интересна функция. Да кажем, че искаме да получим 0 или 1 (имаме само два елемента в масива). При задаване на граници 0..1 - ще получим ли "1"?
не - няма да го получим, специално сме дали пример Пример 2: Вземете произволно цяло число между 0 и 99 Get-Random -Maximum 100
Следователно за 0..1 трябва да зададем размера на 0..2, докато максималният брой на елемента е = 1.

7. Обработка на входящи съобщения и максимална дължина на опашката

Къде спряхме по-рано? имаме получена променлива $MyMessageGet
и полученото от него $Content4Pars01, от което се интересуваме от елементите на масива Content4Pars01.result

$Content4Pars01.result[0].update_id
$Content4Pars01.result[0].message
$Content4Pars01.result[0].message.text

Нека изпратим на бота /message10, /message11, /message12, /word и отново /word и /hello.
Да видим какво имаме:

$Content4Pars01.result[0].message.text
$Content4Pars01.result[2].message.text

Нека итерираме всичко получено и да изпратим отговор, ако съобщението е /word
случаят на конструкт, който някои описват като if-elseif, се извиква в powershell чрез превключвател. В същото време в кода по-долу се използва ключът -wildcard, който е напълно ненужен и дори вреден.

Някакъв код #7.1

Write-Output "This is part 7"
Foreach ($Result in $Content4Pars01.result) # Да, можно сделать быстрее 
 { 
    switch -wildcard ($Result.message.text) 
            {
            "/word" {MyFirstFunction($TextForExample1)}
            }
}

Нека стартираме скрипта няколко пъти. Ще получим една и съща дума два пъти за всеки опит за изпълнение, особено ако сме направили грешка при внедряването на случаен принцип.

Но спри. Не изпратихме /word отново, защо съобщението се обработва отново?

Опашката за изпращане на съобщения до бота е с крайна дължина (мисля 100 или 200 съобщения) и трябва да се изчисти ръчно.

Разбира се, това е описано в документацията, но е необходимо да се прочете!

В този случай се нуждаем от параметъра ?chat_id, а &timeout, &limit, &parse_mode=HTML и &disable_web_page_preview=true все още не са необходими.

Документация telegram api е тук
Пише на английски и бяло:
Идентификатор на първата актуализация, която трябва да бъде върната. Трябва да е по-голям с единица от най-високия сред идентификаторите на предишни получени актуализации. По подразбиране актуализациите започват с най-ранната
непотвърдена актуализация се връщат. Актуализацията се счита за потвърдена веднага щом getUpdates се извика с офсет по-висок отколкото неговия update_id. Отрицателното отместване може да бъде зададено за извличане на актуализации, започващи от -offset update от края на опашката за актуализации. Всички предишни актуализации ще бъдат забравени.

Нека разгледаме:

$Content4Pars01.result[0].update_id
$Content4Pars01.result[1].update_id 
$Content4Pars01.result | select -last 1
($Content4Pars01.result | select -last 1).update_id

Да, и нека нулираме - ще пренапишем функцията малко. Имаме две възможности - да предадем цялото съобщение на функцията и да го обработим изцяло във функцията или да дадем само идентификатора на съобщението и да го отхвърлим. Например, вторият изглежда по-прост.

Преди това нашият низ за заявка „всички съобщения“ изглеждаше така

$URLGET = "https://api.telegram.org/bot$MyToken/getUpdates"

и ще изглежда така

$LastMessageId = ($Content4Pars01.result | select -last 1).update_id
$URLGET1 = "https://api.telegram.org/bot$mytoken/getUpdates?offset=$LastMessageId&limit=100" 
$MyMessageGet = Invoke-WebRequest -Uri $URLGET1 -Method Get -Proxy $MyProxy 

Никой не ви забранява първо да получите всички съобщения, да ги обработите и едва след успешна обработка заявка непотвърдена -> потвърдена.

Защо има смисъл да се обаждате за потвърждение след приключване на цялата обработка? Може да се провали по средата на изпълнението и ако за примера на безплатен чатбот пропускането на едно съобщение все още не е нищо особено, тогава ако обработвате нечия заплата или транзакция с карта, тогава резултатът може да е по-лош.

Още няколко реда код

$LastMessageId = ($Content4Pars01.result | select -last 1).update_id  #ошибку в этом месте предполагается исправить самостоятельно. 
$URLGET1 = "https://api.telegram.org/bot$mytoken/getUpdates?offset=$LastMessageId&limit=100" 
Invoke-WebRequest -Uri $URLGET1 -Method Get -Proxy $MyProxy

8. Вместо заключение

Основните функции - четене на съобщения, изчистване на опашката, четене от файл и писане във файл са изпълнени и показани.

Остават само четири неща за вършене:

• изпращане на правилния отговор на заявката в чата
• изпращане на отговор на ВСЕКИ чат, в който е добавен бот
• изпълняване на код в цикъл
• стартиране на бота от програмата за планиране на Windows.

Всички тези задачи са прости и лесни за изпълнение чрез четене на документацията за параметри като
Set-ExecutionPolicy Unrestricted и -ExecutionPolicy Bypass
цикъл на формата

$TimeToSleep = 3 # опрос каждые 3 секунды
$TimeToWork = 10 # минут
$HowManyTimes = $TimeToWork*60/$TimeToSleep # счетчик для цикла
$MainCounter = 0
for ($MainCounter=0; $MainCounter -le $HowManyTimes) {
sleep $TimeToSleep
$MainCounter ++

Благодаря на всички за четенето.

Източник: www.habr.com