Lihtsaim Telegrami boti malli šabloon 7-9 klassi õpilastele Powershellis.

Vestluste käigus sõbraga sain äkki teada, et nende koolis ei õpetata 8.-10. klassi lapsi programmeerimisse. Ainult Word, Excel ja kõik. Ei logo, isegi mitte Pascalit ega VBA-d Excelis.

Olin väga üllatunud, avasin interneti ja hakkasin lugema —
Üks erikooli eesmärke on harida uut põlvkonda, kes vastab oma arengu tasemelt ja eluviisilt infoühiskonna nõudmistele.
See kursus aitab õpilastel kinnistada oma teadmisi Pascal programmeerimiskeele peamistest struktuuridest. (mõne gümnaasiumi 2017. aasta programmist)

Lõpuks otsustasin kulutada paar tundi ja koostada näite «kuidas luua lihtsat boti — koolinoortele».

Allpool on juttu sellest, kuidas kirjutada järjekordne lihtne bot Powershellis ja sundida seda tööle ilma webhookita, valgete IP-de ja eraldatud serveriteta, pilveteenustes juurutatavate virtuaalide ja muu sellisega — lihtsalt tavalises kodu PC-s tavalise Windowsiga.

TLDR: Veel üks igav artikkel grammatiliste ja faktipõhiste vigadega, ei ole, mida lugeda, nalja ei ole, pilte ei ole.

Artiklis ei ole midagi uut, peaaegu kõik varem kirjutatud on juba olnud Habril, näiteks artiklites. Juhend: Kuidas luua roboteid Telegramis ja Telegrami bot süsteemiadministraatorile.
Lisaks on artikkel spetsiaalselt liialdatud, et mitte viidata iga kord õpikutele. Tekst ei sisalda mingeid viiteid nagu bänd 4, PowerShell Deep Dives või näiteks The 5 Pillars of the AWS Well-Architected Framework.

Sissejuhatusest võib julgelt mööda minna.

Julgesti mööda magama.2006. aastal käivitas Microsoft PowerShell 1.0, mis oli mõeldud tolleaegsele Windows XP, Vista ja 2003 serverile. Osaliselt asendas see selliseid asju nagu cmdbat skriptid, vb skriptid, Windows Script Host ja JScript.

Isegi täna võib PowerShelli vaadelda ainult kui järgmist sammu pärast Logo variante, kuigi kuskil võib-olla kasutatakse endiselt Delphi't (või midagi vanemat), vaatamata selle tsüklite, klasside, funktsioonide, MS GUI väljakutsete olemasolule. integreerimine Gitiga ja nii edasi.

PowerShelli kasutatakse suhteliselt harva; sellega võib kokku puutuda enamasti PowerShell Core, VMware vSphere PowerCLI, Azure PowerShell, MS Exchange, Desired State Configuration kujul. PowerShell Web Access ja veel kümne teise harva kasutatava programmi ja funktsiooni kujul. Võib-olla saab tal teine elu, kui välja tuleb WSL2, aga see ei ole kindel.

PowerShelli on kolm suurt eelist:

1. See on suhteliselt lihtne, selle kohta on palju kirjandust ja näiteid, ka vene keeles, näiteks artikkel Foreach — raamatust PowerShell süvitsi — erinevus () ja {}
2. See tuleb koos redaktoriga ISE, Windowsi komplektiga. Seal on isegi mõni silur.
3. Selle kaudu on lihtne kutsuda graafilise liidesega komponente.

0. Valmistamine.

Meile on vaja:

• Windowsi arvutit (mul on Windows 10)
• Mingit internetiühendust (näiteks NAT-i kaudu)
• Neile, kellel on piiratud juurdepääs Telegramile — installitud ja seadistatud Freegate brauseris, mõnel keerulisemal juhul koos Symple DNS Cryptiga
• Töötava Telegrami kliendi olemasolu telefonis
• Põhitõdede mõistmine — mis on muutuja, massiiv, tsükkel.

Avatud ja loetud artiklid — Juhend: Kuidas luua roboteid Telegramis ja Telegrami bot süsteemiadministraatorile

1. Loome järgmise katse boti.

Kuna seda teavad kõik ja seda on juba tehtud, võib selle ka vahele jättaNagu ülaltoodud artiklis öeldud — Esiteks, Telegrami bot — on endiselt rakendus, mis töötab teie poolel ja esitab päringuid Telegram Bot API-le. Ja API on selge — bot pöördub kindla URL-i poole parameetritega, Telegram vastab JSON objektiga.

Sellega seotud probleemid: kui te mingil müstiliselt moel võtate teatud koodi JSON objektist ja saadate selle täitmiseks (ilma eesmärgita) — kood täidetakse teie juures.

Protsess loomine on kirjeldatud kahes ülaltoodud artiklis, kuid kordame: Telegramis avame kontaktid, otsime @botfather'it, ütleme talle /newbot, loome boti Botfortest12344321, nimetame selle Mynext1234bot'iks ja saame sõnumi unikaalse võtmega kujul 1234544311:AbcDefNNNNNNNNNNNNN.

Hoidke võti alles ja ärge jagage seda!

Edasi saab bot'i seadistada, näiteks keelata selle lisamise gruppidesse, kuid esimestel sammudel ei ole see vajalik.

Küsimine BotFather'ilt «/mybot» ja saame seadeid korrigeerida, kui midagi ei meeldi.

Avame taas kontaktid, leiame sealt @Botfortest12344321 (otsing peab olema alustatud @-st), vajutame «alusta» ja kirjutame botile «/Sлава роботам». Sümbool / on kohustuslik, jutumärgid ei ole vajalikud.
Bot ei vasta midagi, loomulikult.

Kontrollime, et bot on loodud — avame.

api.telegram.org/bot1234544311:AbcDefNNNNNNNNNNNNN/getMe
kus 1234544311:AbcDefNNNNNNNNNNNNN — eelnevalt saadud võti,
ja saame rea kujul
{«ok»:true,«result»:{«»}}

Esimene salajane fraas (token) on meil olemas. Nüüd peame leidma teise salajase numbri — vestluse ID boti jaoks. Iga vestlus, grupp jne on individuaalsed ja neil on oma number (mõnikord miinusmärk — avatud gruppide jaoks). Selle numbri leidmiseks peame veebibrauseris (kuigi tõeliselt ei pea tingimata brauseris olema, kuid arusaamise huvides on hea alustada sealt) küsima aadressi (kus 1234544311:NNNNNNNNN on teie token).

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

ja saama vastuse kujul

{«ok»:true,«result»:[{«update_id»:…,… chat«:{«id»:123456789

Me vajame just chat_id-d.

Kontrollime, kas saame vestlusesse käsitsi kirjutada: kutsume veebibrauseris üles aadressi

https://api.telegram.org/botteietoken/sendMessage?chat_id=123456789&text="Life is directed motion"

Kui botilt tuleb teie vestlusse sõnum — okei, liigute järgmise sammu juurde.

Seega saate (brauseri kaudu) alati kontrollida, kus on probleem — kas teie lingi genereerimisel või midagi on kuskil varjatud ja ei tööta.

Mida tuleks teada enne lugemise jätkamist

Telegramis on mitu tüüpi grupivestlusi (avatud, suletud). Nende vestluste puhul erinevad teatud funktsioonid (näiteks ID), mis tekitab vahel teatud probleeme.

Kujutame ette, et 2019. aasta lõpus on meie ajastu kangelane, kõigile tuntud Üksik-Muusik (administraator, jurist, infotehnoloogia spetsialist, programmeerija ja sisuliselt MVP) Jevgeni V. suudab eristada muutujat $i massiivist, omandanud tsüklid, ja ehk paari aasta pärast õpib ta ka Chocolatey ja siis jõuab Paralleelne töötlemine PowerShellis ja ForEach-Object Parallel kuni.

1. Mõtleme, mida meie bot teeb

Mul ei olnud mingeid ideid, tuli mõelda. Olen juba kirjutanud botiga, mis toimib märkmete tegemiseks. Ei soovinud teha bot’i, „mis saadab midagi kuhugi“. Azure'i ühendamiseks on vajalik krediitkaart, aga kust see koolipoisil on? Pean mainima, et asi pole nii hull: peamised pilveteenused pakuvad mingit katseaega tasuta (aga krediitkaardi number on ikkagi vajalik — ja sealt võetakse, näib, dollar. Ei mäleta, kas see hiljem tagasi tuli.)

Ilma AI ML-ita pole botist, kes on ülekaaluline luuletaja, nii huvitav.

Otsustasin teha boti, mis meenutaks mulle (või mitte mulle) ingliskeelseid sõnu sõnastikust.
Sõnastik, et vältida andmebaasiga mässamist, asub tekstifailis ja täiendatakse käsitsi.
Antud juhul on ülesanne näidata põhialuseid, mitte luua isegi osaliselt valmid toode.

2. Proovime esmakordselt, kuidas ja mida teha

Loo kaust C:poshtranslate
Alustuseks vaatame, mis meil on PowerShellis, käivitame ISE läbi käivita menüü.
powershell ise
või leiame PowerShell ISE installitud programmide seast.
Pärast käivitamist avaneb tavaline tuttav «mingi redaktor», kui tekstivälja ei ole, siis võib alati vajutada «File — create new».

Vaadake PowerShelli versiooni — kirjuta tekstiväljale:

get-host 

ja vajuta F5.

PowerShell pakub salvestamist — «The script you are about to run will be saved.», nõustume ja salvestame C:poshtranslate faili nimega myfirstbotBT100.

Pärast käivitamist saame alumises tekstiväljas andmete tabeli:

Nimi              : Windows PowerShell ISE Host
Versioon           : 5.1.(ja nii edasi)

Mul on 5.1 koos millegagi, seda on piisavalt. Kui sul on vana Windows 7/8, pole hullu — kuigi PowerShell tuleb uuendada versioonile 5 — näiteks, juhendis.

Küsi käsurealt allpool Get-Date, vajuta Enter, vaata kellaaega, mine juurkausta käsuga
cd
ja puhasta ekraan käsuga cls (ei, rm ei ole vajalik)

Nüüd vaatame, kuidas see töötab — kirjutame isegi mitte koodi, vaid paar rida ja proovime aru saada, mida need teevad. Kommenteerime välja # get-host sümboliga rea ja lisame natuke juurde.

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

(Huvitaval kombel. Hüperlinkide koodide vormindamise loendis on paar tosina varianti — aga powershelli seal ei ole. Dos on olemas. Perl on olemas.)

Ja käivitame koodi, vajutades F5 või „>” GUI-st.

Saame väljundi:

Laupäev, 8. detsember 2019 21:00:50 (või midagi sarnast)

Nüüd uurime, mis need kaks rida teevad ja mõningaid huvitavaid asju, et hiljem tagasi ei peaks tulema.

Erinevalt Pascalist (ja mitte ainult) proovib PowerShell ise kindlaks teha, millist tüüpi andmetüübile muutuja määrata, sellest on rohkem kirjutatud artiklis Andmetüüpide ülevaade programmeerimiskeeltes
Seetõttu, kui loome muutuja $TimeNow ja määrame sellele väärtuseks praeguse kuupäeva ja kellaaja (Get-Date), ei pea me eriti muretsema, milline andmetüüp seal olema hakkab.

Tõsi, sellest teadmatusest võib hiljem valus olla, aga see on siis. Allpool tekstis tuleb näide.
Vaadake, mis meil on. Täidame (käskluste ridadega)

$TimeNow | Get-member

ja saame mittetõlgitava teksti lehe

Mittearusaadava teksti näide nr 1

PS C:> $TimeNow | Get-member
   Tüüp: System.DateTime
Nimi                  Liik           Määratlus                                                                                                                                       
----                  ------         ----------                                                                                                                                       
Lisa                  <b>Meetod         </b>datetime Lisa(timespan väärtus)  
..
Kuvamisviis         NoteProperty   KuvamisviisTüüp Kuvamisviis=DateTime                                                                                                             
Kuupäev                 <b>Omadus       </b>datetime Kuupäev {get;}                                                                                                                             
Aasta                Omistamine    int Aasta {get;}   
..                                                                                                                               
KuupäevAeg          SkriptOmistamine System.Object KuupäevAeg {get=if ((&amp; { Set-StrictMode -Version 1; $this.Kuvamisviis }) -ieq  "Kuupäev")...                                         

Nagu näha, on loodud muutuja tüübi TypeName: System.DateTime, millel on palju meetodeid (mõttes, et me saame selle objektimuutuja kohta teha) ja omadusi.

Kutsume välja $TimeNow.DayOfYear — saame aasta päeva numbri.
Kutsume välja $TimeNow.DayOfYear | Get-Member — saame TypeName: System.Int32 ja grupp meetodeid.
Kutsume välja $TimeNow.ToUniversalTime() — ja saame UTC aja

Silumine

Mõnikord on vajalik täita programm kuni mingisse ritta ja vaadata programmi seisundit sel hetkel. Selleks on ISE-s funktsioon Debug — toggle break point.
Asetage peatuspunkt kuskil keskel, käivitage need kaks rida ja vaadake, milline on peatus.

3. Tegeleme Telegrami botiga suhtlemisega

Loomulikult on botiga suhtlemise kohta, kõikide getpushide jms kohta kirjutatud veel rohkem kirjandust, kuid teooria küsimusi saab arutada valikuliselt.

Meie puhul on vajalik:

• Õppida mõnda saatma vestlusesse
• Õppida midagi vestlusest saama

3.1 Õpime midagi vestlusesse saatma ja sealt vastu saama

Veidi koodi — osa 3

Kirjutage väljund "See on osa 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 = "Elu on suunatud liikumine - " + $TimeNow

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

Invoke-WebRequest -Uri $URL4SEND

ja Venemaal saame sel kohal vea Unable to connect to the remote server.

Või ei saa — see oleneb sideoperaatorist ja sellest, kas proxy on seadistatud ja töötab.
Noh — jääb üle lisada proxy. Pange tähele — krüpteerimata ja üldiselt kahtlase proxy kasutamine on teie tervisele äärmiselt ohtlik.

Töötava proxy leidmise ülesanne pole väga keeruline — enamik avaldatud http proxy'dest töötab. Minu puhul töötas viies järele proovitud.

Proxy kasutamise süntaks:

Invoke-WebRequest -Uri $URL4SEND -Proxy $MyProxy

Kui olete saanud sõnumi oma chat'i botiga — siis on kõik suurepärane, saab edasi minna. Kui ei — jätkake tõrkeotsingut.

Võite vaadata, kuidas teie string $URL4SEND muutub ja proovida seda brauseris, näiteks nii:

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

3.2. Oleme õppinud kirjutama "midagi" chatti, nüüd proovime lugeda.

Lisame veel 4 rida ja vaatame, mis seal sees on через | get-member

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

Kõige huvitavamat pakub meile

Sisu           Omand   string Content {get;}
ParandatudHtml   Omand   mshtml.IHTMLDocument2 ParsedHtml {get;}
TooresSisu      Omand   string RawContent {get;set;}

Vaatame, mis neis on:

Write-Host "ParandatudHtml"
$MyMessageGet.ParsedHtml # siin on huvitav
Write-Host "TooresSisu"
$MyMessageGet.RawContent # ja siin on samuti huvitav, peale selle veel ka loetav.
Write-Host "Sisu"
$MyMessageGet.Content

Kui kõik töötab, peaksite saama pika rea kujul:

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

Kahjuks, varem ilmunud artiklis Telegram-bot süsteemi administraatorile oli see rida (jah, vastavalt $MyMessageGet.RawContent | get-member — see on System.String), juba analüüside all.

4. Töötle saadud (me juba oskame midagi saata)

Nagu juba öeldud siin, kõige vajalik on sisus. Vaatame seda tähelepanelikumalt.

Esiteks kirjutame botile veel paar lauset veebiliidesest või telefonist

/message1
/message2
/message3

ja vaatame brauseris aadressi, mis on saadud muutuja $URLGET.

Küsimine näeb välja midagi sellist:

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

Mis see on? Kuidagi keeruline objekt, mis koosneb objektide massiivist, sisaldades sõnumi globaalset identifikaatorit, vestluse identifikaatorit, saatmise identifikaatorit ja palju muud teavet.

Kuid me ei pea uurima, «mis see objekt on» — osa tööst on juba meie eest ära tehtud. Vaatame, mis seal sees on:

Lugedes saadud sõnumeid või osa 4

Write-Host "See on osa 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. Mida me nüüd sellega teeme

Salvestame saadud faili nimega myfirstbotBT105 või milleks iganes teile rohkem meeldib, muudame pealkirja ja kommentaariks kogu senise kirjutatud koodi:

<#start comment 105 end comment 105#>

Nüüd peame otsustama, kust sõnastikku saada (noh, kuidas — kettal failis) ja kuidas see välja näeb.

Muidugi, võid täita tohutu sõnastiku otse skriptitekstis, kuid see ei ole just õige lähenemine.
Seetõttu vaatame, milliste failidega powershell tavaliselt hakkama saab.
Tegelikult ei ole talle oluline, millise failiga töötada, kuid meie jaoks on see tähtis.
Valikuks on meil: txt (võib küll, aga milleks), csv, xml.
Võime vaadata kõiki. Vaatame kõiki.
Loome klassi MyVocabClassExample1 ja muutuja $MyVocabExample1.
Tänan, et märkisite, klassi kirjutatakse ilma $-ta.

veidi koodi #5.

write-host "This is part 5"
class MyVocabClassExample1 {
    [string]$Original  # sõna
    [string]$Transcript
    [string]$Translate
    [string]$Example
    [int]$VocWordID # väga huvitav punkt. int kasutamine oma piirangutega võib vahel viia kummaliste tagajärgedeni, näiteks - hiljuti juhtunud juhtum SSD HPE-ga. Alguses ei lisanud ma seda elementi, kuid hiljem siiski lisasin ja kommenteerisin välja.
    }

$MyVocabExample1 = [MyVocabClassExample1]::new()
$MyVocabExample1.Original = "Apple"
$MyVocabExample1.Transcript = "[ ˈapəl ]"
$MyVocabExample1.Translate = "Õun"
$MyVocabExample1.Example = "Õun on magus, söödav puuvili, mida toodab õunapuu (Malus domestica)"
# $MyVocabExample1.$VocWordID = 1

$MyVocabExample2 = [MyVocabClassExample1]::new()
$MyVocabExample2.Original = "Pear"
$MyVocabExample2.Transcript = "[ pe(ə)r ]"
$MyVocabExample2.Translate = "Pruun"
$MyVocabExample2.Example = "Pruun (/ˈpɛər/) puu ja põõsas kuuluvad Pyrus sugu"
# $MyVocabExample1.$VocWordID = 2

Proovime selle salvestada failidesse. musteri.

Veidi koodi #5.1

Write-Host $ScriptDir # loodetavasti te ei ole $ScriptDir kommenteerinud 
$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

— ja saame vea real Out-File -FilePath $MyFilenameExample01 -InputObject -Append $MyVocabExample2.

Ei taha lisada, oh ei, kui kahju.

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

Vaadakem, mis välja tuli. Väga hea tekstivorm — aga kuidas seda tagasi eksportida? Tekkima mingid tekstieraldajad, näiteks komad?

Ja lõpuks saada „fail eraldajatega — komadega, comma-separated values (CSV) A PEATA OODAKE.
#

$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 

Kuidas on lihtne näha, et MS ei erinenud mõtlemises palju, sarnase protseduuri jaoks kasutatakse ühes kohas -FilePath, teises -Path.

Lisaks sellele kadus kolmandas failis vene keel, neljandas failis tuli välja... noh, midagi tuli välja. #TYPE System.Object[] 00
# „Count“,»Length»,«LongLength»,«Rank»,«SyncRoot»,«IsReadOnly»,«IsFixedSize»,«IsSynchronized»
#
Veidi ümber kirjutame:

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

Tundub, et see aitas — kuid formaat ei meeldi mulle ikka veel.

Eriti ei meeldi mulle, et ma ei saa objekti ridu otse faili panna.
Muide, kui me juba faile kirjutama hakkasime — kas peaksime ka käivitamise logi pidama? Aeg on meil muutuja, faili nime oskame määrata.

Kirjutada, tõsi, praegu ei ole midagi, kuid võime mõelda, kuidas logide rotatsiooni paremini teha.
Proovime xml-i.

Veidi xml-i

$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-i ekspordil on ainult plussid — loetavus, kogu objekti ekspordivõime ja uppend'i täitma ei pea.

Proovime lugeda xml faili.

Veidi lugemist xml-ist

$MyFilenameExample06 = $ScriptDir + "Example06.xml"
$MyVocabExample4AsArray = Import-Clixml -Path $MyFilenameExample06
# $MyVocabExample4AsArray 
# $MyVocabExample4AsArray[0]
# ja veidi täiesti ootamatute nüansside kohta. Powershell käitub aeg-ajalt nii, nagu võiks eeldada.
# näiteks minul need kaks väljundit erinevad
# Write-Output $MyVocabExample4AsArray 
# write-host $MyVocabExample4AsArray 

Naaseme ülesande juurde. Proovifaili oleme loonud, lugenud, salvestusformaat on selge, vajadusel saab kirjutada eraldi väikese failiredaktori ridade lisamiseks ja eemaldamiseks.

Tuletan meelde, et ülesanne oli luua väike koolitusbot.

Töö formaat: saadan botile käsu „näide“, bot saadab mulle juhuslikult valitud sõna ja transkriptsiooni, ning 10 sekundi pärast saadab tõlke ja kommentaari. Käsklusi oskame lugeda, veel tuleks muidugi õppida automaatselt valima ja kontrolima proksisid ning kustutama sõnumite loendamise.

Kunstime kõik varem kommenteeritud asjad uuesti välja, kommenteerime välja enam mittehädavajalikud näited txt ja csv failidest, ja salvestame faili kui versiooni B106.

Ah, jah. Saame midagi botile veel kord saata.

6. Saatmine funktsioonidest ja muust

Enne andmete töötlemist peab olema määratud funktsioon, mis saadab «mida iganes», peale test-sõnumi.

Muidugi, meie näites on ainult üks saatmine ja ainult üks töötlemine, kuid mis juhtub, kui tuleb sama asja teha mitu korda?

Lihtsam on kirjutada funktsioon. Meil on objektitüüp $MyVocabExample4AsArray, mis loetakse failist kaheelemendilisena massiivina.
Hakkame lugema.

Samas käsitleme kellaaegu, sellega on meil hiljem tööd (kuigi selles näites ei ole see vajalik 🙂

Veidi koodi #6.1

Write-Output "See on osa 6"
$Timezone = (Get-TimeZone)
IF($Timezone.SupportsDaylightSavingTime -eq $True){
    $TimeAdjust =  ($Timezone.BaseUtcOffset.TotalSeconds + 3600) } # kohandatud aeg
    ELSE{$TimeAdjust = ($Timezone.BaseUtcOffset.TotalSeconds) 
    }
    
function MyFirstFunction($SomeExampleForFunction1){
$TimeNow = Get-Date
$TimeNow.ToUniversalTime()
# $MyText02 = $TimeNow + " " + $SomeExampleForFunction1 # siin me saame vea
$MyText02 = $SomeExampleForFunction1 + " " + $TimeNow # siin me ei saa, kes arvab miks - on tubli.

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

Kergesti võib näha, et funktsioonis kasutatakse $MyToken ja $MyChatID, mis on eelnevalt kindlalt määratud.

Nii teha ei tohi, ja kui $MyToken on iga boti jaoks ühesugune, siis $MyChatID muutub vastavalt vestlusele.

Kuid kuna see on näide, ignoreerime seda seni.

Kuna $MyVocabExample4AsArray ei ole massiiv, kuigi see näeb välja nagu massiiv, siis ei saa lihtsalt võtta ja küsida selle pikkust.

Peame uuesti tegema midagi, mida ei tohiks — hüppama mitte koodeksi järgi — võtma ja arvutama

Natuke koodi #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)
# või ühes reas
# MyFirstFunction($MyVocabExample4AsArray[Get-Random -Minimum 0 -Maximum ($MaxRandomExample -1)].Example)
# Arvake ise, milline näide on väljastpoolt kergemini loetav.

Juhuslik huvitav funktsioon. Oletame, et soovime saada 0 või 1 (meil on massiivis kokku kaks elementi). Kui määrame piirid 0..1 — kas saame „1”?
ei — ei saa, meil on spetsiaalselt toodud näide Example 2: Get a random integer between 0 and 99 Get-Random -Maximum 100
Seetõttu peame 0..1 jaoks määrama suuruse 0..2, sel juhul on maksimaalne element = 1.

7. Saadetud sõnumite töötlemine ja järjekorra maksimaalne pikkus

Kuidas me eelnevalt lõpetasime? Meil on saadud muutuja $MyMessageGet
ja sellest saadud $Content4Pars01, millest meid huvitavad massiivi elemendid Content4Pars01.result

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

Saadame botile /message10, /message11, /message12, /word ja veel kord /word ja /tervitus.
Vaadakem, mida oleme saanud:

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

Käime läbi kõik saadud ja saadame vastuse, kui sõnum oli /word
struktuur case of, mida mõned kirjeldavad kui if-elseif, powershellis kutsutakse läbi switch. Samal ajal on allolevas koodis kasutatud võtit -wildcard, mis pole üldse vajalik ja isegi kahjulik.

Natuke koodi #7.1

Write-Output "This is part 7"
Foreach ($Result in $Content4Pars01.result) # Jah, saab teha kiiremini
 { 
    switch -wildcard ($Result.message.text) 
            {
            "/word" {MyFirstFunction($TextForExample1)}
            }
}

Käivitage skript paar korda. Saame kaks korda sama sõna iga kord, eriti kui oleme juhuslikku rakendamises eksinud.

Aga stopp. Me ei saatnud /word veel kord, miks siis sõnum töödeldakse uuesti?

Botile saadetavate sõnumite järjekorrale on piiratud pikkus (tundub, et 100 või 200 sõnumit), ja see tuleb käsitsi puhastada.

Dokumendist on see loomulikult kirjas, aga seda peab lugema!

Antud juhul on meil vajalik parameeter ?chat_id, samas &timeout, &limit, &parse_mode=HTML ja &disable_web_page_preview=true ei ole hetkel vajalikud.

Dokumentatsioon telegram api kohta asub siin
Inglise keeles on seal kirjas:
Esimese uuenduse identifikaator, mida tagastatakse. Peab olema suurem kui üks kõrgemas identifikaatorite seas, mida eelnevalt saadud uuendustest leiti. Vaikesätete kohaselt tagastatakse uuendused, alustades esimesest.
kinnitamata uuendust tagastatakse. Uuendus loetakse kinnitatuks, kui getUpdates on kutsutud üles kõrgema. offset kui tema update_id. . Negatiivne offset võib olla määratud, et tagastada uuendusi, alustades -offset uuendusest uuenduste järjekorra lõpust. Kõik eelnevad uuendused unustatakse.Vaadakem:

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

Ja kirjutame ümber — veidi muudame funktsiooni. Meil on kaks varianti — edastada funktsioonile kogu sõnum ja töödelda see kogu ulatuses funktsioonis, või anda ainult sõnumi ID ja seejärel see ka tühistada. Näiteks näeb teine variant lihtsam välja.

Varem nägi meie päring «kõikide sõnumite» kohta välja nagu

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

aga näeb välja nagu

$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" 
$MyMessageGet = Invoke-WebRequest -Uri $URLGET1 -Method Get -Proxy $MyProxy 

Keegi ei keela alguses kõiki sõnumeid saada, neid töödelda ja ainult pärast eduka töötlemise lõpetamist küsida unconfirmed -> confirmed.

Miks on mõttekas kutsuda üles kinnitama pärast kõigi töötlemiste lõpetamist? Võimalik on tõrge keskel, ja kui näiteks tasuta vestlusroboti jaoks on ühe sõnumi vahelejätmine veel millekski erilist, siis kui töötlete kellegi palka või kaarditehingut, siis võib lõpp olla hullem.

Veel paar rida koodi

$LastMessageId = ($Content4Pars01.result | select -last 1).update_id  # ebatäpsus siin eeldatakse, et parandate iseseisvalt. 
$URLGET1 = "https://api.telegram.org/bot$mytoken/getUpdates?offset=$LastMessageId&limit=100" 
Invoke-WebRequest -Uri $URLGET1 -Method Get -Proxy $MyProxy

8. Kokkuvõtte asemel

Põhiomadused — sõnumite lugemine, järjekorra lähtestamine, failist lugemine ja faili kirjutamine on teostatud ja näidatud.

On jäänud teha vaid neli asja:

• õige vastuse saatmine vestluse päringule
• vastuse saatmine IGA vestlusse, kuhu bot lisati
• koodi täitmine tsüklis
• boti käivitamine Windowsi ajakavale.

Kõik need ülesanded on lihtsad ja kergesti teostatavad dokumentatsiooni lugemise abil, näiteks parameetrite kohta, nagu
Set-ExecutionPolicy Unrestricted ja -ExecutionPolicy Bypass
taolise tsükli puhul

$TimeToSleep = 3 # küsitlus iga 3 sekundi tagant
$TimeToWork = 10 # minutit
$HowManyTimes = $TimeToWork*60/$TimeToSleep # loendur tsükli jaoks
$MainCounter = 0
for ($MainCounter=0; $MainCounter -le $HowManyTimes) {
sleep $TimeToSleep
$MainCounter ++

Aitäh kõigile, kes lõpuni lugesid.

Allikas: habr.com