lbxtoolkit 2.1.0__tar.gz → 2.1.1__tar.gz
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
|
@@ -0,0 +1,4339 @@
|
|
|
1
|
+
Metadata-Version: 2.1
|
|
2
|
+
Name: lbxtoolkit
|
|
3
|
+
Version: 2.1.1
|
|
4
|
+
Summary:
|
|
5
|
+
Author: Cristiano P. Ferrari
|
|
6
|
+
Author-email: cristiano.ferrari@lbx.com.br
|
|
7
|
+
Requires-Python: >=3.12,<4.0
|
|
8
|
+
Classifier: Programming Language :: Python :: 3
|
|
9
|
+
Classifier: Programming Language :: Python :: 3.12
|
|
10
|
+
Requires-Dist: msal (>=1.30.0,<2.0.0)
|
|
11
|
+
Requires-Dist: numpy (>=2.0.1,<3.0.0)
|
|
12
|
+
Requires-Dist: pandas (>=2.2.2,<3.0.0)
|
|
13
|
+
Requires-Dist: psutil (>=6.0.0,<7.0.0)
|
|
14
|
+
Requires-Dist: psycopg2 (>=2.9.9,<3.0.0)
|
|
15
|
+
Requires-Dist: pygetwindow (>=0.0.9,<0.0.10)
|
|
16
|
+
Requires-Dist: pywin32 (>=306,<307)
|
|
17
|
+
Requires-Dist: requests (>=2.32.3,<3.0.0)
|
|
18
|
+
Requires-Dist: selenium (>=4.23.1,<5.0.0)
|
|
19
|
+
Requires-Dist: validators (>=0.33.0,<0.34.0)
|
|
20
|
+
Requires-Dist: webdriver-manager (>=4.0.2,<5.0.0)
|
|
21
|
+
Description-Content-Type: text/markdown
|
|
22
|
+
|
|
23
|
+
::: {md-component="skip"}
|
|
24
|
+
[Skip to content](#lbxtoolkit){.md-skip}
|
|
25
|
+
:::
|
|
26
|
+
|
|
27
|
+
::: {md-component="announce"}
|
|
28
|
+
:::
|
|
29
|
+
|
|
30
|
+
::::::::::::: {.md-header .md-header--shadow md-component="header"}
|
|
31
|
+
[](. "lbxtoolkit"){.md-header__button
|
|
32
|
+
.md-logo aria-label="lbxtoolkit" md-component="logo"}
|
|
33
|
+
|
|
34
|
+
|
|
35
|
+
:::::: {.md-header__title md-component="header-title"}
|
|
36
|
+
::::: md-header__ellipsis
|
|
37
|
+
::: md-header__topic
|
|
38
|
+
[ lbxtoolkit ]{.md-ellipsis}
|
|
39
|
+
:::
|
|
40
|
+
|
|
41
|
+
::: {.md-header__topic md-component="header-topic"}
|
|
42
|
+
[ Home ]{.md-ellipsis}
|
|
43
|
+
:::
|
|
44
|
+
:::::
|
|
45
|
+
::::::
|
|
46
|
+
|
|
47
|
+
|
|
48
|
+
|
|
49
|
+
:::::::: {.md-search md-component="search" role="dialog"}
|
|
50
|
+
::::::: {.md-search__inner role="search"}
|
|
51
|
+
|
|
52
|
+
|
|
53
|
+
|
|
54
|
+
|
|
55
|
+
|
|
56
|
+
:::::: md-search__output
|
|
57
|
+
::::: {.md-search__scrollwrap tabindex="0" md-scrollfix=""}
|
|
58
|
+
:::: {.md-search-result md-component="search-result"}
|
|
59
|
+
::: md-search-result__meta
|
|
60
|
+
Initializing search
|
|
61
|
+
:::
|
|
62
|
+
::::
|
|
63
|
+
:::::
|
|
64
|
+
::::::
|
|
65
|
+
:::::::
|
|
66
|
+
::::::::
|
|
67
|
+
:::::::::::::
|
|
68
|
+
|
|
69
|
+
:::::::::::::::::::::::::::::::::::::::::::::::::::::::::: {.md-container md-component="container"}
|
|
70
|
+
:::::::::::::::::::::::::::::::::::::::::::::::::::::: {.md-main role="main" md-component="main"}
|
|
71
|
+
::::::::::::::::::::::::::::::::::::::::::::::::::::: {.md-main__inner .md-grid}
|
|
72
|
+
::::: {.md-sidebar .md-sidebar--primary md-component="sidebar" md-type="navigation"}
|
|
73
|
+
:::: md-sidebar__scrollwrap
|
|
74
|
+
::: md-sidebar__inner
|
|
75
|
+
[](. "lbxtoolkit"){.md-nav__button
|
|
76
|
+
.md-logo aria-label="lbxtoolkit" md-component="logo"} lbxtoolkit
|
|
77
|
+
|
|
78
|
+
[ Home ]{.md-ellipsis} []{.md-nav__icon .md-icon} [[ Home
|
|
79
|
+
]{.md-ellipsis}](.){.md-nav__link .md-nav__link--active}
|
|
80
|
+
|
|
81
|
+
[]{.md-nav__icon .md-icon} Table of contents
|
|
82
|
+
|
|
83
|
+
- [[ lbxtoolkit ]{.md-ellipsis}](#lbxtoolkit){.md-nav__link}
|
|
84
|
+
- [[ Biblioteca de ferramentas LBX S/A
|
|
85
|
+
]{.md-ellipsis}](#lbxtoolkit--biblioteca-de-ferramentas-lbx-sa){.md-nav__link}
|
|
86
|
+
- [[ Classe e funções
|
|
87
|
+
]{.md-ellipsis}](#lbxtoolkit--classe-e-funcoes){.md-nav__link}
|
|
88
|
+
- [[ Instalação e uso:
|
|
89
|
+
]{.md-ellipsis}](#lbxtoolkit--instalacao-e-uso){.md-nav__link}
|
|
90
|
+
- [[ Instalação
|
|
91
|
+
]{.md-ellipsis}](#lbxtoolkit--instalacao){.md-nav__link}
|
|
92
|
+
- [[ Uso ]{.md-ellipsis}](#lbxtoolkit--uso){.md-nav__link}
|
|
93
|
+
- [[ ConfigManager
|
|
94
|
+
]{.md-ellipsis}](#lbxtoolkit.ConfigManager){.md-nav__link}
|
|
95
|
+
- [[ Servicer ]{.md-ellipsis}](#lbxtoolkit.Servicer){.md-nav__link}
|
|
96
|
+
- [[ cleanup
|
|
97
|
+
]{.md-ellipsis}](#lbxtoolkit.Servicer.cleanup){.md-nav__link}
|
|
98
|
+
- [[ daemon_log
|
|
99
|
+
]{.md-ellipsis}](#lbxtoolkit.Servicer.daemon_log){.md-nav__link}
|
|
100
|
+
- [[ run ]{.md-ellipsis}](#lbxtoolkit.Servicer.run){.md-nav__link}
|
|
101
|
+
- [[ stop
|
|
102
|
+
]{.md-ellipsis}](#lbxtoolkit.Servicer.stop){.md-nav__link}
|
|
103
|
+
- [[ api_rest ]{.md-ellipsis}](#lbxtoolkit.api_rest){.md-nav__link}
|
|
104
|
+
- [[ Classe api_rest
|
|
105
|
+
]{.md-ellipsis}](#lbxtoolkit.api_rest--classe-api_rest){.md-nav__link}
|
|
106
|
+
- [[ auth_EntraID
|
|
107
|
+
]{.md-ellipsis}](#lbxtoolkit.auth_EntraID){.md-nav__link}
|
|
108
|
+
- [[ Classe auth_EntraID
|
|
109
|
+
]{.md-ellipsis}](#lbxtoolkit.auth_EntraID--classe-auth_entraid){.md-nav__link}
|
|
110
|
+
- [[ lbx_logger
|
|
111
|
+
]{.md-ellipsis}](#lbxtoolkit.lbx_logger){.md-nav__link}
|
|
112
|
+
- [[ Classe lbx_logger
|
|
113
|
+
]{.md-ellipsis}](#lbxtoolkit.lbx_logger--classe-lbx_logger){.md-nav__link}
|
|
114
|
+
- [[ misc ]{.md-ellipsis}](#lbxtoolkit.misc){.md-nav__link}
|
|
115
|
+
- [[ Classe misc
|
|
116
|
+
]{.md-ellipsis}](#lbxtoolkit.misc--classe-misc){.md-nav__link}
|
|
117
|
+
- [[ postgreSQL
|
|
118
|
+
]{.md-ellipsis}](#lbxtoolkit.postgreSQL){.md-nav__link}
|
|
119
|
+
- [[ Classe postgreSQL
|
|
120
|
+
]{.md-ellipsis}](#lbxtoolkit.postgreSQL--classe-postgresql){.md-nav__link}
|
|
121
|
+
:::
|
|
122
|
+
::::
|
|
123
|
+
:::::
|
|
124
|
+
|
|
125
|
+
::::: {.md-sidebar .md-sidebar--secondary md-component="sidebar" md-type="toc"}
|
|
126
|
+
:::: md-sidebar__scrollwrap
|
|
127
|
+
::: md-sidebar__inner
|
|
128
|
+
[]{.md-nav__icon .md-icon} Table of contents
|
|
129
|
+
|
|
130
|
+
- [[ lbxtoolkit ]{.md-ellipsis}](#lbxtoolkit){.md-nav__link}
|
|
131
|
+
- [[ Biblioteca de ferramentas LBX S/A
|
|
132
|
+
]{.md-ellipsis}](#lbxtoolkit--biblioteca-de-ferramentas-lbx-sa){.md-nav__link}
|
|
133
|
+
- [[ Classe e funções
|
|
134
|
+
]{.md-ellipsis}](#lbxtoolkit--classe-e-funcoes){.md-nav__link}
|
|
135
|
+
- [[ Instalação e uso:
|
|
136
|
+
]{.md-ellipsis}](#lbxtoolkit--instalacao-e-uso){.md-nav__link}
|
|
137
|
+
- [[ Instalação
|
|
138
|
+
]{.md-ellipsis}](#lbxtoolkit--instalacao){.md-nav__link}
|
|
139
|
+
- [[ Uso ]{.md-ellipsis}](#lbxtoolkit--uso){.md-nav__link}
|
|
140
|
+
- [[ ConfigManager
|
|
141
|
+
]{.md-ellipsis}](#lbxtoolkit.ConfigManager){.md-nav__link}
|
|
142
|
+
- [[ Servicer ]{.md-ellipsis}](#lbxtoolkit.Servicer){.md-nav__link}
|
|
143
|
+
- [[ cleanup
|
|
144
|
+
]{.md-ellipsis}](#lbxtoolkit.Servicer.cleanup){.md-nav__link}
|
|
145
|
+
- [[ daemon_log
|
|
146
|
+
]{.md-ellipsis}](#lbxtoolkit.Servicer.daemon_log){.md-nav__link}
|
|
147
|
+
- [[ run ]{.md-ellipsis}](#lbxtoolkit.Servicer.run){.md-nav__link}
|
|
148
|
+
- [[ stop
|
|
149
|
+
]{.md-ellipsis}](#lbxtoolkit.Servicer.stop){.md-nav__link}
|
|
150
|
+
- [[ api_rest ]{.md-ellipsis}](#lbxtoolkit.api_rest){.md-nav__link}
|
|
151
|
+
- [[ Classe api_rest
|
|
152
|
+
]{.md-ellipsis}](#lbxtoolkit.api_rest--classe-api_rest){.md-nav__link}
|
|
153
|
+
- [[ auth_EntraID
|
|
154
|
+
]{.md-ellipsis}](#lbxtoolkit.auth_EntraID){.md-nav__link}
|
|
155
|
+
- [[ Classe auth_EntraID
|
|
156
|
+
]{.md-ellipsis}](#lbxtoolkit.auth_EntraID--classe-auth_entraid){.md-nav__link}
|
|
157
|
+
- [[ lbx_logger
|
|
158
|
+
]{.md-ellipsis}](#lbxtoolkit.lbx_logger){.md-nav__link}
|
|
159
|
+
- [[ Classe lbx_logger
|
|
160
|
+
]{.md-ellipsis}](#lbxtoolkit.lbx_logger--classe-lbx_logger){.md-nav__link}
|
|
161
|
+
- [[ misc ]{.md-ellipsis}](#lbxtoolkit.misc){.md-nav__link}
|
|
162
|
+
- [[ Classe misc
|
|
163
|
+
]{.md-ellipsis}](#lbxtoolkit.misc--classe-misc){.md-nav__link}
|
|
164
|
+
- [[ postgreSQL
|
|
165
|
+
]{.md-ellipsis}](#lbxtoolkit.postgreSQL){.md-nav__link}
|
|
166
|
+
- [[ Classe postgreSQL
|
|
167
|
+
]{.md-ellipsis}](#lbxtoolkit.postgreSQL--classe-postgresql){.md-nav__link}
|
|
168
|
+
:::
|
|
169
|
+
::::
|
|
170
|
+
:::::
|
|
171
|
+
|
|
172
|
+
:::::::::::::::::::::::::::::::::::::::::::::: {.md-content md-component="content"}
|
|
173
|
+
# Home
|
|
174
|
+
|
|
175
|
+
::::::::::::::::::::::::::::::::::::::::::::: {.doc .doc-object .doc-module}
|
|
176
|
+
[]{#lbxtoolkit}
|
|
177
|
+
|
|
178
|
+
:::::::::::::::::::::::::::::::::::::::::::: {.doc .doc-contents .first}
|
|
179
|
+
## **Biblioteca de ferramentas LBX S/A** {#lbxtoolkit--biblioteca-de-ferramentas-lbx-sa}
|
|
180
|
+
|
|
181
|
+
Esta biblioteca possui um ferramentas utilitárias de uso recorrente para
|
|
182
|
+
aplicações de RPA em python.
|
|
183
|
+
|
|
184
|
+
### **Classe e funções** {#lbxtoolkit--classe-e-funcoes}
|
|
185
|
+
|
|
186
|
+
**auth_EntraID**\
|
|
187
|
+
Usa o Microsoft Entra ID (antiga Azure AD) para evitar execução não
|
|
188
|
+
autorizada disclaimer : Mensagem sobre a necessidade de autenticação
|
|
189
|
+
valida_grupo : Autentica o usuário e aborta se checa não pertencer ao
|
|
190
|
+
grupo de segurança
|
|
191
|
+
|
|
192
|
+
**postgreSQL** Interage com o banco de dados PostgreSQL - *.db*: Inicia
|
|
193
|
+
sessão com o banco - *.csv_df*: Lê arquivo CSV e gera Dataframe (pandas)
|
|
194
|
+
a partir dele - *.db_insert_df*: Insere informações de Dataframe em
|
|
195
|
+
tabela do banco com estrutura equivalente - *.db_select*: Retorna um
|
|
196
|
+
cursor a partir de uma query - *.db_update*: Executa update em tabelas
|
|
197
|
+
|
|
198
|
+
**api_rest** Interage com APIs RESTfull, especialmente providas para a
|
|
199
|
+
plataforma Sienge - *.auth_base*: Autentica (HTTPBasicAuth) sessão na
|
|
200
|
+
API - *.auth_bearer*: Autentica sessão na API pelos métodos: OAuth, JWT,
|
|
201
|
+
Bearer\
|
|
202
|
+
- *.endpoint_json*: Realizad chama ao endpoint. Payload em formato
|
|
203
|
+
`json` opcional. - *.trata_erro_sienge*: Retorna a mensagem de erro do
|
|
204
|
+
Sienge caso código de retorno seja diferente de 200. - *.close*: Encerra
|
|
205
|
+
a sessão autenticada
|
|
206
|
+
|
|
207
|
+
**lbx_logger** Manipula e formata as mensagens de saída do script para
|
|
208
|
+
direcioná-las para tela (stdout) e/ou arquivo de log - *.add*: Adiciona
|
|
209
|
+
a mensagem a um *buffer* sem exibir, acumulando até a próxima chamada em
|
|
210
|
+
algum dos níveis abaixo. - *.print*: Contorna o manipulador de log e
|
|
211
|
+
imprime diretamente na tela (stdout), sem formatar a mensagem nem
|
|
212
|
+
registrar no arquivo - *.debug, .info, .aviso, .erro, .critico*:
|
|
213
|
+
Classifica as mensagens por nível de severidade/relevância e rediciona a
|
|
214
|
+
saída (arquivo, tela, tela+arquivo) conforme a configuração do nível -
|
|
215
|
+
*.stop_logging*: Interrompe a manipulação das saídas pelo logger e
|
|
216
|
+
restaura as saídas padrão (stdout/stderr) para a tela - *.filtra*:
|
|
217
|
+
Filtra os eventos do arquivo de log registrados em um intervalo de tempo
|
|
218
|
+
específico
|
|
219
|
+
|
|
220
|
+
**misc** Classe de miscelâneas/diversos - *.seleciona_arquivo*: Abre um
|
|
221
|
+
picker do sistema operacionar para selecionar um *arquivo* e retorna seu
|
|
222
|
+
path - *.seleciona_dir*: Abre um picker do sistema operacionar para
|
|
223
|
+
selecionar um *diretório* e retorna seu path - *.normaliza*: Limpa
|
|
224
|
+
caracteres especiais e espaços de strings e retorna tudo em minúsculo -
|
|
225
|
+
*.get_cmd_window*: Captura a referencia da janela atual (cmd.exe) para
|
|
226
|
+
retornar o foco à ela depois de chamar os pickers - *.maximize_console*:
|
|
227
|
+
Maxima a janela do console (cmd.exe)
|
|
228
|
+
|
|
229
|
+
### Instalação e uso: {#lbxtoolkit--instalacao-e-uso}
|
|
230
|
+
|
|
231
|
+
#### Instalação {#lbxtoolkit--instalacao}
|
|
232
|
+
|
|
233
|
+
pip install lbx_toolkit
|
|
234
|
+
|
|
235
|
+
#### Uso {#lbxtoolkit--uso}
|
|
236
|
+
|
|
237
|
+
from lbx_toolkit import auth_EntraID, PostgreSQL, api_rest, lbx_logger
|
|
238
|
+
|
|
239
|
+
::::::::::::::::::::::::::::::::::::::::::: {.doc .doc-children}
|
|
240
|
+
:::::: {.doc .doc-object .doc-class}
|
|
241
|
+
## `ConfigManager` {#lbxtoolkit.ConfigManager .doc .doc-heading}
|
|
242
|
+
|
|
243
|
+
::::: {.doc .doc-contents}
|
|
244
|
+
Como Funciona Singleton Pattern: ConfigManager é um singleton que
|
|
245
|
+
garante que todas as partes do código usem a mesma instância e,
|
|
246
|
+
portanto, compartilhem a mesma configuração. Inicialização com
|
|
247
|
+
Argumentos Dinâmicos: O método initialize usa \*\*kwargs para aceitar
|
|
248
|
+
qualquer número de pares chave-valor, armazenando-os no dicionário
|
|
249
|
+
\_config da instância. Método Genérico get: O método get aceita uma
|
|
250
|
+
chave como argumento e retorna o valor correspondente do dicionário
|
|
251
|
+
\_config. Método set: O método set permite adicionar ou atualizar
|
|
252
|
+
dinamicamente valores no dicionário \_config. Método reset: O método
|
|
253
|
+
reset limpa todas as configurações armazenadas, permitindo uma nova
|
|
254
|
+
inicialização do ConfigManager com novos valores
|
|
255
|
+
|
|
256
|
+
Source code in `lbxtoolkit\__init__.py`
|
|
257
|
+
|
|
258
|
+
::: highlight
|
|
259
|
+
+-----------------------------------+-----------------------------------+
|
|
260
|
+
| ::: linenodiv | <div> |
|
|
261
|
+
| 1336 | |
|
|
262
|
+
| 1337 | class ConfigManager: # Inicia |
|
|
263
|
+
| 1338 | liza e recupera variáveis em ambi |
|
|
264
|
+
| 1339 | ente de intercâmbio entre classes |
|
|
265
|
+
| 1340 | """ |
|
|
266
|
+
| 1341 | Como Funciona |
|
|
267
|
+
| 1342 | |
|
|
268
|
+
| 1343 | Singleton Pattern: ConfigMan |
|
|
269
|
+
| 1344 | ager é um singleton que garante q |
|
|
270
|
+
| 1345 | ue todas as partes do código usem |
|
|
271
|
+
| 1346 | a mesma instância e, portanto, c |
|
|
272
|
+
| 1347 | ompartilhem a mesma configuração. |
|
|
273
|
+
| 1348 | Inicializ |
|
|
274
|
+
| 1349 | ação com Argumentos Dinâmicos: O |
|
|
275
|
+
| 1350 | método initialize usa **kwargs pa |
|
|
276
|
+
| 1351 | ra aceitar qualquer número de par |
|
|
277
|
+
| 1352 | es chave-valor, armazenando-os no |
|
|
278
|
+
| 1353 | dicionário _config da instância. |
|
|
279
|
+
| 1354 | |
|
|
280
|
+
| 1355 | Método Genérico get: O |
|
|
281
|
+
| 1356 | método get aceita uma chave como |
|
|
282
|
+
| 1357 | argumento e retorna o valor corr |
|
|
283
|
+
| 1358 | espondente do dicionário _config. |
|
|
284
|
+
| 1359 | M |
|
|
285
|
+
| 1360 | étodo set: O método set permite a |
|
|
286
|
+
| 1361 | dicionar ou atualizar dinamicamen |
|
|
287
|
+
| 1362 | te valores no dicionário _config. |
|
|
288
|
+
| 1363 | Método rese |
|
|
289
|
+
| 1364 | t: O método reset limpa todas as |
|
|
290
|
+
| 1365 | configurações armazenadas, permit |
|
|
291
|
+
| 1366 | indo uma nova inicialização do Co |
|
|
292
|
+
| 1367 | nfigManager com novos valores |
|
|
293
|
+
| 1368 | """ |
|
|
294
|
+
| 1369 | _instance = None |
|
|
295
|
+
| 1370 | def __new__(cls): |
|
|
296
|
+
| 1371 | |
|
|
297
|
+
| 1372 | if cls._instance is None: |
|
|
298
|
+
| ::: | |
|
|
299
|
+
| | cls._instance = super |
|
|
300
|
+
| | (ConfigManager, cls).__new__(cls) |
|
|
301
|
+
| | |
|
|
302
|
+
| | cls._instance._config = {} |
|
|
303
|
+
| | return cls._instance |
|
|
304
|
+
| | # |
|
|
305
|
+
| | # |
|
|
306
|
+
| | @classmethod |
|
|
307
|
+
| | |
|
|
308
|
+
| | def initialize(cls, **kwargs): |
|
|
309
|
+
| | instance = cls() |
|
|
310
|
+
| | |
|
|
311
|
+
| | for key, value in kwargs.items(): |
|
|
312
|
+
| | |
|
|
313
|
+
| | instance._config[key] = value |
|
|
314
|
+
| | # |
|
|
315
|
+
| | # |
|
|
316
|
+
| | @classmethod |
|
|
317
|
+
| | def get(cls, key): |
|
|
318
|
+
| | retu |
|
|
319
|
+
| | rn cls._instance._config.get(key) |
|
|
320
|
+
| | # |
|
|
321
|
+
| | # |
|
|
322
|
+
| | @classmethod |
|
|
323
|
+
| | def set(cls, key, value): |
|
|
324
|
+
| | c |
|
|
325
|
+
| | ls._instance._config[key] = value |
|
|
326
|
+
| | # |
|
|
327
|
+
| | # |
|
|
328
|
+
| | @classmethod |
|
|
329
|
+
| | def reset(cls): |
|
|
330
|
+
| | |
|
|
331
|
+
| | cls._instance._config = {} |
|
|
332
|
+
| | |
|
|
333
|
+
| | </div> |
|
|
334
|
+
+-----------------------------------+-----------------------------------+
|
|
335
|
+
:::
|
|
336
|
+
|
|
337
|
+
::: {.doc .doc-children}
|
|
338
|
+
:::
|
|
339
|
+
:::::
|
|
340
|
+
::::::
|
|
341
|
+
|
|
342
|
+
:::::::::::::::::: {.doc .doc-object .doc-class}
|
|
343
|
+
## `Servicer` {#lbxtoolkit.Servicer .doc .doc-heading}
|
|
344
|
+
|
|
345
|
+
::::::::::::::::: {.doc .doc-contents}
|
|
346
|
+
Classe base que implementa as rotinas padrão para a criação
|
|
347
|
+
dameons/serviços do windows. Além de iniciar e interromper o
|
|
348
|
+
daemon/serviço, a classe implementar os métodos daemon_logs() e
|
|
349
|
+
cleanup(), dependencias de run() e stop() que criam um arquivo de log do
|
|
350
|
+
serviço/daemon (não do script em si) e um arquivo PID para o monitor de
|
|
351
|
+
serviços. Os métodos padrão são init(), run() e stop() e não devem ser
|
|
352
|
+
redefinidos/sobrecarregados. Para ser funcional, é necessária a criação
|
|
353
|
+
de uma classe local que herde essa classe e redefina (por sobrecarga) ao
|
|
354
|
+
menos os métodos on_run, on_start e args_parser(). on_init é opcional.
|
|
355
|
+
Outros métodos complementares são oferidos para init, run e stop,
|
|
356
|
+
permitindo injetar código no ínicio (pre) e fim (pós) os respectivos
|
|
357
|
+
métodos (on_init_pre(), on_init_pos(), on_run_pre(), on_run_pos(),
|
|
358
|
+
on_stop_pre(), on_stop_pos())
|
|
359
|
+
|
|
360
|
+
Source code in `lbxtoolkit\__init__.py`
|
|
361
|
+
|
|
362
|
+
::: highlight
|
|
363
|
+
+-----------------------------------+-----------------------------------+
|
|
364
|
+
| ::: linenodiv | <div> |
|
|
365
|
+
| 1377 | |
|
|
366
|
+
| 1378 | class Servicer(): # Cria |
|
|
367
|
+
| 1379 | um daemon para rodar como serviço |
|
|
368
|
+
| 1380 | """ |
|
|
369
|
+
| 1381 | |
|
|
370
|
+
| 1382 | Classe base que implem |
|
|
371
|
+
| 1383 | enta as rotinas padrão para a cri |
|
|
372
|
+
| 1384 | ação dameons/serviços do windows. |
|
|
373
|
+
| 1385 | Além de iniciar e i |
|
|
374
|
+
| 1386 | nterromper o daemon/serviço, a cl |
|
|
375
|
+
| 1387 | asse implementar os métodos daemo |
|
|
376
|
+
| 1388 | n_logs() e cleanup(), dependencia |
|
|
377
|
+
| 1389 | s de run() e stop() que criam um |
|
|
378
|
+
| 1390 | arquivo de log do serviço/daemon |
|
|
379
|
+
| 1391 | (não do script em si) e um arquiv |
|
|
380
|
+
| 1392 | o PID para o monitor de serviços. |
|
|
381
|
+
| 1393 | |
|
|
382
|
+
| 1394 | Os métodos padrão são i |
|
|
383
|
+
| 1395 | nit(), run() e stop() e não devem |
|
|
384
|
+
| 1396 | ser redefinidos/sobrecarregados. |
|
|
385
|
+
| 1397 | Para ser funcional, é |
|
|
386
|
+
| 1398 | necessária a criação de uma clas |
|
|
387
|
+
| 1399 | se local que herde essa classe e |
|
|
388
|
+
| 1400 | redefina (por sobrecarga) ao meno |
|
|
389
|
+
| 1401 | s os métodos on_run, on_start e a |
|
|
390
|
+
| 1402 | rgs_parser(). on_init é opcional. |
|
|
391
|
+
| 1403 | |
|
|
392
|
+
| 1404 | Outros métodos complementares são |
|
|
393
|
+
| 1405 | oferidos para init, run e stop, |
|
|
394
|
+
| 1406 | permitindo injetar código no ínic |
|
|
395
|
+
| 1407 | io (pre) e fim (pós) os respectiv |
|
|
396
|
+
| 1408 | os métodos (on_init_pre(), on_ini |
|
|
397
|
+
| 1409 | t_pos(), on_run_pre(), on_run_pos |
|
|
398
|
+
| 1410 | (), on_stop_pre(), on_stop_pos()) |
|
|
399
|
+
| 1411 | """ |
|
|
400
|
+
| 1412 | def __init__(se |
|
|
401
|
+
| 1413 | lf, Log=None, piddir=None):#TODO: |
|
|
402
|
+
| 1414 | ao criar uma classe padrão usar |
|
|
403
|
+
| 1415 | args/kwargs para lidar como param |
|
|
404
|
+
| 1416 | etros variáveis no instanciamento |
|
|
405
|
+
| 1417 | |
|
|
406
|
+
| 1418 | # PRE-REQUISITOS/DEPENDÊNCIAS: |
|
|
407
|
+
| 1419 | se |
|
|
408
|
+
| 1420 | lf.log = ConfigManager.get('log') |
|
|
409
|
+
| 1421 | self.kwargs = |
|
|
410
|
+
| 1422 | ConfigManager.get('argparse_cfg') |
|
|
411
|
+
| 1423 | |
|
|
412
|
+
| 1424 | self.kwopts = ConfigManager.ge |
|
|
413
|
+
| 1425 | t('argparse_opt') |
|
|
414
|
+
| 1426 | self.ambiente = Confi |
|
|
415
|
+
| 1427 | gManager.get('ambiente') |
|
|
416
|
+
| 1428 | |
|
|
417
|
+
| 1429 | if self.log is None or not |
|
|
418
|
+
| 1430 | isinstance(self.log, lbx_logger): |
|
|
419
|
+
| 1431 | rai |
|
|
420
|
+
| 1432 | se ValueError(f'Argumento "log" é |
|
|
421
|
+
| 1433 | mandatório e deve ser uma instân |
|
|
422
|
+
| 1434 | cia de "lbxtoolkit.lbx_logger"') |
|
|
423
|
+
| 1435 | |
|
|
424
|
+
| 1436 | if self.kwargs is None: |
|
|
425
|
+
| 1437 | ra |
|
|
426
|
+
| 1438 | ise ValueError(f'Argumento "argpa |
|
|
427
|
+
| 1439 | rse_cfg" é mandatório e deve ser |
|
|
428
|
+
| 1440 | um dicionário com ao mínimo as ch |
|
|
429
|
+
| 1441 | aves: [description, usage, usage, |
|
|
430
|
+
| 1442 | add_help, formatter_class] para |
|
|
431
|
+
| 1443 | configuração do módulo argpase') |
|
|
432
|
+
| 1444 | |
|
|
433
|
+
| 1445 | if self.kwopts is None: |
|
|
434
|
+
| 1446 | raise V |
|
|
435
|
+
| 1447 | alueError(f'Argumento "argparse_o |
|
|
436
|
+
| 1448 | pt" é mandatório e deve ser uma l |
|
|
437
|
+
| 1449 | ista de dicionários ao mínimo as |
|
|
438
|
+
| 1450 | chaves: [short, long, action, hel |
|
|
439
|
+
| 1451 | p] para tratamento dos argumentos |
|
|
440
|
+
| 1452 | recebidos da linha de comando') |
|
|
441
|
+
| 1453 | if self.ambient |
|
|
442
|
+
| 1454 | e is None or self.ambiente not in |
|
|
443
|
+
| 1455 | ['Linux', 'Windows', 'Serviço']: |
|
|
444
|
+
| 1456 | r |
|
|
445
|
+
| 1457 | aise ValueError(f'Argumento "ambi |
|
|
446
|
+
| 1458 | ente" é mandatório e deve ser uma |
|
|
447
|
+
| 1459 | string com um dos seguintes valo |
|
|
448
|
+
| 1460 | res: [Linux, Windows, Serviço]') |
|
|
449
|
+
| 1461 | |
|
|
450
|
+
| 1462 | self.on_init_pre( |
|
|
451
|
+
| 1463 | ) ## método opcional a ser defini |
|
|
452
|
+
| 1464 | to por sobrecarga na função local |
|
|
453
|
+
| 1465 | |
|
|
454
|
+
| 1466 | # Argu |
|
|
455
|
+
| 1467 | mentos padrão obrigatórios |
|
|
456
|
+
| 1468 | self. |
|
|
457
|
+
| 1469 | LogFile = Path('.',os.path.splite |
|
|
458
|
+
| 1470 | xt(os.path.basename(__file__))[0] |
|
|
459
|
+
| 1471 | + '.daemon') if not Log else Log |
|
|
460
|
+
| 1472 | |
|
|
461
|
+
| 1473 | self.OS = platform.system() |
|
|
462
|
+
| 1474 | |
|
|
463
|
+
| 1475 | self.PID = os.getppid() |
|
|
464
|
+
| 1476 | self.IP = socket.ge |
|
|
465
|
+
| 1477 | thostbyname(socket.gethostname()) |
|
|
466
|
+
| 1478 | |
|
|
467
|
+
| 1479 | self.Host = socket.gethostname() |
|
|
468
|
+
| 1480 | |
|
|
469
|
+
| 1481 | self.Usuario = os.getlogin() i |
|
|
470
|
+
| 1482 | f self.OS == 'Windows' else os.pa |
|
|
471
|
+
| 1483 | th.expanduser('~').split(r'/')[1] |
|
|
472
|
+
| 1484 | se |
|
|
473
|
+
| 1485 | lf.Me = os.path.abspath(__file__) |
|
|
474
|
+
| 1486 | self.PIDDir = Pa |
|
|
475
|
+
| 1487 | th('.') if not piddir else piddir |
|
|
476
|
+
| 1488 | self.PIDFile = |
|
|
477
|
+
| 1489 | Path(self.PIDDir,str(self.PID)) |
|
|
478
|
+
| 1490 | self.exit = False |
|
|
479
|
+
| 1491 | |
|
|
480
|
+
| 1492 | self.mode = '[DAEMON (console)]' |
|
|
481
|
+
| 1493 | |
|
|
482
|
+
| 1494 | self.on_init( |
|
|
483
|
+
| 1495 | ) ## método opcional a ser defini |
|
|
484
|
+
| 1496 | to por sobrecarga na função local |
|
|
485
|
+
| 1497 | |
|
|
486
|
+
| 1498 | |
|
|
487
|
+
| 1499 | self.on_init_pos() ## método opci |
|
|
488
|
+
| 1500 | onal a ser definito por sobrecarg |
|
|
489
|
+
| 1501 | a na função local |
|
|
490
|
+
| 1502 | # |
|
|
491
|
+
| 1503 | # |
|
|
492
|
+
| 1504 | def main(self): |
|
|
493
|
+
| 1505 | #kwargs = |
|
|
494
|
+
| 1506 | ConfigManager.get('argparse_cfg') |
|
|
495
|
+
| 1507 | |
|
|
496
|
+
| 1508 | #kwopts = ConfigManager.ge |
|
|
497
|
+
| 1509 | t('argparse_opt') |
|
|
498
|
+
| 1510 | |
|
|
499
|
+
| 1511 | #ambiente = ConfigManage |
|
|
500
|
+
| 1512 | r.get('ambiente') |
|
|
501
|
+
| 1513 | i |
|
|
502
|
+
| 1514 | f len(sys.argv) == 1 and self.amb |
|
|
503
|
+
| 1515 | iente == 'Serviço': ## VEM DAQUI |
|
|
504
|
+
| 1516 | https://gist.github.com/drmalex07 |
|
|
505
|
+
| 1517 | /10554232?permalink_comment_id=25 |
|
|
506
|
+
| 1518 | 55358#gistcomment-2555358 |
|
|
507
|
+
| 1519 | |
|
|
508
|
+
| 1520 | servicemanager.Initialize() |
|
|
509
|
+
| 1521 | servicemanager.Pr |
|
|
510
|
+
| 1522 | epareToHostSingle(ServicoWindows) |
|
|
511
|
+
| 1523 | serviceman |
|
|
512
|
+
| 1524 | ager.StartServiceCtrlDispatcher() |
|
|
513
|
+
| 1525 | elif len(sys.argv) |
|
|
514
|
+
| 1526 | > 1 and sys.argv[1] == 'install': |
|
|
515
|
+
| 1527 | |
|
|
516
|
+
| 1528 | ServicoWindows.SvcInstall() |
|
|
517
|
+
| 1529 | elif len(sys.argv) |
|
|
518
|
+
| 1530 | > 1 and sys.argv[1] == 'remove': |
|
|
519
|
+
| ::: | Servi |
|
|
520
|
+
| | coWindows.SvcRemove() |
|
|
521
|
+
| | else: |
|
|
522
|
+
| | if len(sys.a |
|
|
523
|
+
| | rgv) > 1 and sys.argv[1] in ['sta |
|
|
524
|
+
| | rt', 'stop', 'restart', 'debug']: |
|
|
525
|
+
| | |
|
|
526
|
+
| | win32serviceutil. |
|
|
527
|
+
| | HandleCommandLine(ServicoWindows) |
|
|
528
|
+
| | else: |
|
|
529
|
+
| | |
|
|
530
|
+
| | self.parser = argpa |
|
|
531
|
+
| | rse.ArgumentParser(**self.kwargs) |
|
|
532
|
+
| | |
|
|
533
|
+
| | for opt in self.kwopts: |
|
|
534
|
+
| | |
|
|
535
|
+
| | self.parser.add_argument( |
|
|
536
|
+
| | opt['short'], opt['long'], action |
|
|
537
|
+
| | =opt['action'], help=opt['help']) |
|
|
538
|
+
| | self.args = |
|
|
539
|
+
| | self.parser.parse_args() |
|
|
540
|
+
| | |
|
|
541
|
+
| | |
|
|
542
|
+
| | self.args_paser() ## tratamento d |
|
|
543
|
+
| | os arguemntos deve ser redefindo |
|
|
544
|
+
| | por sobrecarga no na função local |
|
|
545
|
+
| | # |
|
|
546
|
+
| | # |
|
|
547
|
+
| | def run(self): |
|
|
548
|
+
| | """I |
|
|
549
|
+
| | nicia a execução do do serviço""" |
|
|
550
|
+
| | |
|
|
551
|
+
| | self.on_run_pre() ## |
|
|
552
|
+
| | método opcional a ser definito p |
|
|
553
|
+
| | or sobrecarga na função local |
|
|
554
|
+
| | |
|
|
555
|
+
| | |
|
|
556
|
+
| | self.daemon_log('START') |
|
|
557
|
+
| | ## Gera o PIDFile |
|
|
558
|
+
| | self.log.ad |
|
|
559
|
+
| | d(f'Iniciando daemon [PID: {self. |
|
|
560
|
+
| | PID}] para monitorar os processos |
|
|
561
|
+
| | que rodam como serviço/daemon mo |
|
|
562
|
+
| | nitorados em: {self.PIDDir}... ') |
|
|
563
|
+
| | try: |
|
|
564
|
+
| | |
|
|
565
|
+
| | with open(self.PIDF |
|
|
566
|
+
| | ile, 'w', encoding='utf-8') as f: |
|
|
567
|
+
| | f.write(self. |
|
|
568
|
+
| | Me + ';' + str(self.LogFile)) |
|
|
569
|
+
| | |
|
|
570
|
+
| | except Exception as Err: |
|
|
571
|
+
| | |
|
|
572
|
+
| | self.stop('CRASH') |
|
|
573
|
+
| | |
|
|
574
|
+
| | self.log.erro(f'Erro [{Err}] ao s |
|
|
575
|
+
| | alvar PIDFile: {self.PIDFile}') |
|
|
576
|
+
| | self.log.info(f'Ok!' |
|
|
577
|
+
| | ) ## trocar para debug em prd ?? |
|
|
578
|
+
| | |
|
|
579
|
+
| | |
|
|
580
|
+
| | self.on_run() # função princ |
|
|
581
|
+
| | ipal para interreper o daemon/ser |
|
|
582
|
+
| | viço, definir localmente por sobr |
|
|
583
|
+
| | ecarga (criar classe que herde es |
|
|
584
|
+
| | sa classe e defina essa função) |
|
|
585
|
+
| | |
|
|
586
|
+
| | self.on_run_pos() ## |
|
|
587
|
+
| | método opcional a ser definito p |
|
|
588
|
+
| | or sobrecarga na função local |
|
|
589
|
+
| | # |
|
|
590
|
+
| | # |
|
|
591
|
+
| | |
|
|
592
|
+
| | def stop(self, evento='STOP'): |
|
|
593
|
+
| | |
|
|
594
|
+
| | """Interrompe o daemon/serviço""" |
|
|
595
|
+
| | |
|
|
596
|
+
| | |
|
|
597
|
+
| | self.on_stop_pre() ## mét |
|
|
598
|
+
| | odo opcional a ser definito por s |
|
|
599
|
+
| | obrecarga na função local |
|
|
600
|
+
| | |
|
|
601
|
+
| | |
|
|
602
|
+
| | self.daemon_log(evento) |
|
|
603
|
+
| | |
|
|
604
|
+
| | self.on_stop() # função pri |
|
|
605
|
+
| | ncipal para interreper o daemon/s |
|
|
606
|
+
| | erviço, definir localmente por so |
|
|
607
|
+
| | brecarga (criar classe que herde |
|
|
608
|
+
| | essa classe e defina essa função) |
|
|
609
|
+
| | self.cleanup() |
|
|
610
|
+
| | self.exit=True |
|
|
611
|
+
| | |
|
|
612
|
+
| | |
|
|
613
|
+
| | self.on_stop_pos() ## mét |
|
|
614
|
+
| | odo opcional a ser definito por s |
|
|
615
|
+
| | obrecarga na função local |
|
|
616
|
+
| | # |
|
|
617
|
+
| | # |
|
|
618
|
+
| | def cleanup(self): # |
|
|
619
|
+
| | # Elimina o arquivo PID do proces |
|
|
620
|
+
| | so se estiver rodando como daemon |
|
|
621
|
+
| | """Método auxil |
|
|
622
|
+
| | iar utilizado no stop() para limp |
|
|
623
|
+
| | ar o o PID file na interrupção""" |
|
|
624
|
+
| | |
|
|
625
|
+
| | |
|
|
626
|
+
| | self.on_cleanup_pre() ## mét |
|
|
627
|
+
| | odo opcional a ser definito por s |
|
|
628
|
+
| | obrecarga na função local |
|
|
629
|
+
| | |
|
|
630
|
+
| | |
|
|
631
|
+
| | if self.PIDFile: ## ver |
|
|
632
|
+
| | ifica se está rodando como daemon |
|
|
633
|
+
| | |
|
|
634
|
+
| | if Path(self.PIDFile).exists(): |
|
|
635
|
+
| | |
|
|
636
|
+
| | Path(self.PIDFile).u |
|
|
637
|
+
| | nlink() ##exclui o pidfile do da |
|
|
638
|
+
| | emon se o arquivo existir |
|
|
639
|
+
| | |
|
|
640
|
+
| | self.PIDFile = None |
|
|
641
|
+
| | |
|
|
642
|
+
| | |
|
|
643
|
+
| | self.on_cleanup_pos() ## mé |
|
|
644
|
+
| | todo opcional a ser definito por |
|
|
645
|
+
| | sobrecarga na função local |
|
|
646
|
+
| | # |
|
|
647
|
+
| | # |
|
|
648
|
+
| | def daemon_log |
|
|
649
|
+
| | (self, evento=None): ## Gerar log |
|
|
650
|
+
| | de início/interrupção do serviço |
|
|
651
|
+
| | """Mét |
|
|
652
|
+
| | odo auxiliar utilizado alimentar |
|
|
653
|
+
| | log do histórico de inicialização |
|
|
654
|
+
| | /interrupção do serviço/daemon""" |
|
|
655
|
+
| | |
|
|
656
|
+
| | evento = |
|
|
657
|
+
| | 'CHECK' if not evento else evento |
|
|
658
|
+
| | |
|
|
659
|
+
| | evento = evento.upper() |
|
|
660
|
+
| | |
|
|
661
|
+
| | TimeStamp = datetime.datetime.no |
|
|
662
|
+
| | w().strftime('%Y-%m-%d %H:%M:%S') |
|
|
663
|
+
| | Message = f'{TimeSt |
|
|
664
|
+
| | amp} - {evento} - {self.OS} - {se |
|
|
665
|
+
| | lf.Host}/{self.IP} - PID: {self.P |
|
|
666
|
+
| | ID} - {self.Usuario} - {self.Me}' |
|
|
667
|
+
| | try: |
|
|
668
|
+
| | with |
|
|
669
|
+
| | open(self.LogFile, 'a') as file: |
|
|
670
|
+
| | |
|
|
671
|
+
| | file.write(Message + '\n') |
|
|
672
|
+
| | |
|
|
673
|
+
| | except Exception as Err: |
|
|
674
|
+
| | |
|
|
675
|
+
| | self.log.erro(f'Erro [{Er |
|
|
676
|
+
| | r}] ao gravar status do daemon em |
|
|
677
|
+
| | {self.LogFile}') |
|
|
678
|
+
| | # |
|
|
679
|
+
| | # |
|
|
680
|
+
| | def on_init_pre(self): |
|
|
681
|
+
| | pass |
|
|
682
|
+
| | def on_init_pos(self): |
|
|
683
|
+
| | pass |
|
|
684
|
+
| | def on_init(self): |
|
|
685
|
+
| | pass |
|
|
686
|
+
| | def on_cleanup_pre(self): |
|
|
687
|
+
| | pass |
|
|
688
|
+
| | def on_cleanup_pos(self): |
|
|
689
|
+
| | pass |
|
|
690
|
+
| | def on_cleanup(self): |
|
|
691
|
+
| | pass |
|
|
692
|
+
| | def on_run_pre(self): |
|
|
693
|
+
| | pass |
|
|
694
|
+
| | def on_run_pos(self): |
|
|
695
|
+
| | pass |
|
|
696
|
+
| | def on_run(self): |
|
|
697
|
+
| | pass |
|
|
698
|
+
| | def on_stop_pre(self): |
|
|
699
|
+
| | pass |
|
|
700
|
+
| | def on_stop_pos(self): |
|
|
701
|
+
| | pass |
|
|
702
|
+
| | def on_stop(self): |
|
|
703
|
+
| | pass |
|
|
704
|
+
| | def args_paser(self): |
|
|
705
|
+
| | pass |
|
|
706
|
+
| | |
|
|
707
|
+
| | </div> |
|
|
708
|
+
+-----------------------------------+-----------------------------------+
|
|
709
|
+
:::
|
|
710
|
+
|
|
711
|
+
::::::::::::::: {.doc .doc-children}
|
|
712
|
+
::::: {.doc .doc-object .doc-function}
|
|
713
|
+
### [`cleanup`{.highlight .language-python}]{.n}[`()`{.highlight .language-python}]{.p} {#lbxtoolkit.Servicer.cleanup .doc .doc-heading}
|
|
714
|
+
|
|
715
|
+
:::: {.doc .doc-contents}
|
|
716
|
+
Método auxiliar utilizado no stop() para limpar o o PID file na
|
|
717
|
+
interrupção
|
|
718
|
+
|
|
719
|
+
Source code in `lbxtoolkit\__init__.py`
|
|
720
|
+
|
|
721
|
+
::: highlight
|
|
722
|
+
+-----------------------------------+-----------------------------------+
|
|
723
|
+
| ::: linenodiv | <div> |
|
|
724
|
+
| 1478 | |
|
|
725
|
+
| 1479 | def cleanup(self): # |
|
|
726
|
+
| 1480 | # Elimina o arquivo PID do proces |
|
|
727
|
+
| 1481 | so se estiver rodando como daemon |
|
|
728
|
+
| 1482 | """Método auxil |
|
|
729
|
+
| 1483 | iar utilizado no stop() para limp |
|
|
730
|
+
| 1484 | ar o o PID file na interrupção""" |
|
|
731
|
+
| 1485 | |
|
|
732
|
+
| 1486 | |
|
|
733
|
+
| 1487 | self.on_cleanup_pre() ## mét |
|
|
734
|
+
| 1488 | odo opcional a ser definito por s |
|
|
735
|
+
| ::: | obrecarga na função local |
|
|
736
|
+
| | |
|
|
737
|
+
| | if self.PIDFile: ## ver |
|
|
738
|
+
| | ifica se está rodando como daemon |
|
|
739
|
+
| | |
|
|
740
|
+
| | if Path(self.PIDFile).exists(): |
|
|
741
|
+
| | |
|
|
742
|
+
| | Path(self.PIDFile).u |
|
|
743
|
+
| | nlink() ##exclui o pidfile do da |
|
|
744
|
+
| | emon se o arquivo existir |
|
|
745
|
+
| | |
|
|
746
|
+
| | self.PIDFile = None |
|
|
747
|
+
| | |
|
|
748
|
+
| | |
|
|
749
|
+
| | self.on_cleanup_pos() ## mé |
|
|
750
|
+
| | todo opcional a ser definito por |
|
|
751
|
+
| | sobrecarga na função local |
|
|
752
|
+
| | |
|
|
753
|
+
| | </div> |
|
|
754
|
+
+-----------------------------------+-----------------------------------+
|
|
755
|
+
:::
|
|
756
|
+
::::
|
|
757
|
+
:::::
|
|
758
|
+
|
|
759
|
+
::::: {.doc .doc-object .doc-function}
|
|
760
|
+
### [`daemon_log`{.highlight .language-python}]{.n}[`(`{.highlight .language-python}]{.p}[`evento`{.highlight .language-python}]{.n}[`=`{.highlight .language-python}]{.o}[`None`{.highlight .language-python}]{.kc}[`)`{.highlight .language-python}]{.p} {#lbxtoolkit.Servicer.daemon_log .doc .doc-heading}
|
|
761
|
+
|
|
762
|
+
:::: {.doc .doc-contents}
|
|
763
|
+
Método auxiliar utilizado alimentar log do histórico de
|
|
764
|
+
inicialização/interrupção do serviço/daemon
|
|
765
|
+
|
|
766
|
+
Source code in `lbxtoolkit\__init__.py`
|
|
767
|
+
|
|
768
|
+
::: highlight
|
|
769
|
+
+-----------------------------------+-----------------------------------+
|
|
770
|
+
| ::: linenodiv | <div> |
|
|
771
|
+
| 1491 | |
|
|
772
|
+
| 1492 | def daemon_log |
|
|
773
|
+
| 1493 | (self, evento=None): ## Gerar log |
|
|
774
|
+
| 1494 | de início/interrupção do serviço |
|
|
775
|
+
| 1495 | """Mét |
|
|
776
|
+
| 1496 | odo auxiliar utilizado alimentar |
|
|
777
|
+
| 1497 | log do histórico de inicialização |
|
|
778
|
+
| 1498 | /interrupção do serviço/daemon""" |
|
|
779
|
+
| 1499 | |
|
|
780
|
+
| 1500 | evento = |
|
|
781
|
+
| 1501 | 'CHECK' if not evento else evento |
|
|
782
|
+
| 1502 | evento = evento.upper() |
|
|
783
|
+
| ::: | |
|
|
784
|
+
| | TimeStamp = datetime.datetime.no |
|
|
785
|
+
| | w().strftime('%Y-%m-%d %H:%M:%S') |
|
|
786
|
+
| | Message = f'{TimeSt |
|
|
787
|
+
| | amp} - {evento} - {self.OS} - {se |
|
|
788
|
+
| | lf.Host}/{self.IP} - PID: {self.P |
|
|
789
|
+
| | ID} - {self.Usuario} - {self.Me}' |
|
|
790
|
+
| | try: |
|
|
791
|
+
| | with |
|
|
792
|
+
| | open(self.LogFile, 'a') as file: |
|
|
793
|
+
| | |
|
|
794
|
+
| | file.write(Message + '\n') |
|
|
795
|
+
| | except Exception as Err: |
|
|
796
|
+
| | |
|
|
797
|
+
| | self.log.erro(f'Erro [{Er |
|
|
798
|
+
| | r}] ao gravar status do daemon em |
|
|
799
|
+
| | {self.LogFile}') |
|
|
800
|
+
| | |
|
|
801
|
+
| | </div> |
|
|
802
|
+
+-----------------------------------+-----------------------------------+
|
|
803
|
+
:::
|
|
804
|
+
::::
|
|
805
|
+
:::::
|
|
806
|
+
|
|
807
|
+
::::: {.doc .doc-object .doc-function}
|
|
808
|
+
### [`run`{.highlight .language-python}]{.n}[`()`{.highlight .language-python}]{.p} {#lbxtoolkit.Servicer.run .doc .doc-heading}
|
|
809
|
+
|
|
810
|
+
:::: {.doc .doc-contents}
|
|
811
|
+
Inicia a execução do do serviço
|
|
812
|
+
|
|
813
|
+
Source code in `lbxtoolkit\__init__.py`
|
|
814
|
+
|
|
815
|
+
::: highlight
|
|
816
|
+
+-----------------------------------+-----------------------------------+
|
|
817
|
+
| ::: linenodiv | <div> |
|
|
818
|
+
| 1444 | |
|
|
819
|
+
| 1445 | def run(self): |
|
|
820
|
+
| 1446 | """I |
|
|
821
|
+
| 1447 | nicia a execução do do serviço""" |
|
|
822
|
+
| 1448 | |
|
|
823
|
+
| 1449 | self.on_run_pre() ## |
|
|
824
|
+
| 1450 | método opcional a ser definito p |
|
|
825
|
+
| 1451 | or sobrecarga na função local |
|
|
826
|
+
| 1452 | |
|
|
827
|
+
| 1453 | self.daemon_log('START') |
|
|
828
|
+
| 1454 | ## Gera o PIDFile |
|
|
829
|
+
| 1455 | self.log.ad |
|
|
830
|
+
| 1456 | d(f'Iniciando daemon [PID: {self. |
|
|
831
|
+
| 1457 | PID}] para monitorar os processos |
|
|
832
|
+
| 1458 | que rodam como serviço/daemon mo |
|
|
833
|
+
| 1459 | nitorados em: {self.PIDDir}... ') |
|
|
834
|
+
| 1460 | try: |
|
|
835
|
+
| 1461 | with open(self.PIDF |
|
|
836
|
+
| 1462 | ile, 'w', encoding='utf-8') as f: |
|
|
837
|
+
| ::: | f.write(self. |
|
|
838
|
+
| | Me + ';' + str(self.LogFile)) |
|
|
839
|
+
| | except Exception as Err: |
|
|
840
|
+
| | self.stop('CRASH') |
|
|
841
|
+
| | |
|
|
842
|
+
| | self.log.erro(f'Erro [{Err}] ao s |
|
|
843
|
+
| | alvar PIDFile: {self.PIDFile}') |
|
|
844
|
+
| | self.log.info(f'Ok!' |
|
|
845
|
+
| | ) ## trocar para debug em prd ?? |
|
|
846
|
+
| | |
|
|
847
|
+
| | |
|
|
848
|
+
| | self.on_run() # função princ |
|
|
849
|
+
| | ipal para interreper o daemon/ser |
|
|
850
|
+
| | viço, definir localmente por sobr |
|
|
851
|
+
| | ecarga (criar classe que herde es |
|
|
852
|
+
| | sa classe e defina essa função) |
|
|
853
|
+
| | |
|
|
854
|
+
| | self.on_run_pos() ## |
|
|
855
|
+
| | método opcional a ser definito p |
|
|
856
|
+
| | or sobrecarga na função local |
|
|
857
|
+
| | |
|
|
858
|
+
| | </div> |
|
|
859
|
+
+-----------------------------------+-----------------------------------+
|
|
860
|
+
:::
|
|
861
|
+
::::
|
|
862
|
+
:::::
|
|
863
|
+
|
|
864
|
+
::::: {.doc .doc-object .doc-function}
|
|
865
|
+
### [`stop`{.highlight .language-python}]{.n}[`(`{.highlight .language-python}]{.p}[`evento`{.highlight .language-python}]{.n}[`=`{.highlight .language-python}]{.o}[`'STOP'`{.highlight .language-python}]{.s1}[`)`{.highlight .language-python}]{.p} {#lbxtoolkit.Servicer.stop .doc .doc-heading}
|
|
866
|
+
|
|
867
|
+
:::: {.doc .doc-contents}
|
|
868
|
+
Interrompe o daemon/serviço
|
|
869
|
+
|
|
870
|
+
Source code in `lbxtoolkit\__init__.py`
|
|
871
|
+
|
|
872
|
+
::: highlight
|
|
873
|
+
+-----------------------------------+-----------------------------------+
|
|
874
|
+
| ::: linenodiv | <div> |
|
|
875
|
+
| 1465 | |
|
|
876
|
+
| 1466 | |
|
|
877
|
+
| 1467 | def stop(self, evento='STOP'): |
|
|
878
|
+
| 1468 | |
|
|
879
|
+
| 1469 | """Interrompe o daemon/serviço""" |
|
|
880
|
+
| 1470 | |
|
|
881
|
+
| 1471 | self.on_stop_pre() ## mét |
|
|
882
|
+
| 1472 | odo opcional a ser definito por s |
|
|
883
|
+
| 1473 | obrecarga na função local |
|
|
884
|
+
| 1474 | |
|
|
885
|
+
| 1475 | self.daemon_log(evento) |
|
|
886
|
+
| ::: | |
|
|
887
|
+
| | self.on_stop() # função pri |
|
|
888
|
+
| | ncipal para interreper o daemon/s |
|
|
889
|
+
| | erviço, definir localmente por so |
|
|
890
|
+
| | brecarga (criar classe que herde |
|
|
891
|
+
| | essa classe e defina essa função) |
|
|
892
|
+
| | self.cleanup() |
|
|
893
|
+
| | self.exit=True |
|
|
894
|
+
| | |
|
|
895
|
+
| | self.on_stop_pos() ## mét |
|
|
896
|
+
| | odo opcional a ser definito por s |
|
|
897
|
+
| | obrecarga na função local |
|
|
898
|
+
| | |
|
|
899
|
+
| | </div> |
|
|
900
|
+
+-----------------------------------+-----------------------------------+
|
|
901
|
+
:::
|
|
902
|
+
::::
|
|
903
|
+
:::::
|
|
904
|
+
:::::::::::::::
|
|
905
|
+
:::::::::::::::::
|
|
906
|
+
::::::::::::::::::
|
|
907
|
+
|
|
908
|
+
:::::: {.doc .doc-object .doc-class}
|
|
909
|
+
## `api_rest` {#lbxtoolkit.api_rest .doc .doc-heading}
|
|
910
|
+
|
|
911
|
+
::::: {.doc .doc-contents}
|
|
912
|
+
###### Classe **api_rest** {#lbxtoolkit.api_rest--classe-api_rest}
|
|
913
|
+
|
|
914
|
+
Destina-se a interatir com APIs RESTfull, em especial as publicadas pela
|
|
915
|
+
SoftPlan para a [Plataforma Sienge](https://api.sienge.com.br/docs/).
|
|
916
|
+
|
|
917
|
+
A classe deve ser instanciada conforme sintaxe abaixo:
|
|
918
|
+
|
|
919
|
+
`api_rest(url, credenciais, cadencia, timeout=6, logger=None, headers={"Content-Type": "application/json"}, verify=True)`
|
|
920
|
+
|
|
921
|
+
São nessários 2 parâmetros posicionais obrigatórios, e 5 parametros
|
|
922
|
+
nominais facultativos (valor padrão, se omisso, indicado na sintaxe
|
|
923
|
+
acima): - `url`: o endereço da URL de autenticação da API -
|
|
924
|
+
`crednciais`: Dicionário com credenciais de autenticação. - `cadencia`
|
|
925
|
+
Número máximo de chamadas *por segudo* à API - `timeout` Tempo máximo
|
|
926
|
+
(segundos) para aguardar retorno à chamada. Padrão 6s, se omisso. -
|
|
927
|
+
`logger` O objeto *log handler* para lidar com as informações de saída.
|
|
928
|
+
Se não informado, todas as saídas serão direcionadas para a stdout. -
|
|
929
|
+
`headers` Cabeçalhos *http* para a requisição à API. - `verify` Verifica
|
|
930
|
+
a validade do certificado SSL do servidor de destino da requisição.
|
|
931
|
+
|
|
932
|
+
Quanto às credenciais de autenticação, assim como a classe de interação
|
|
933
|
+
com o PostgreSQL, elas precisam ser fornecidas na forma de um
|
|
934
|
+
*dicionário*. Para o método `api_rest.aut_basic()`, o formato deve ser:
|
|
935
|
+
|
|
936
|
+
credenciais = {
|
|
937
|
+
'user': 'USUARIO_API',
|
|
938
|
+
'password': 'TOKEN_USUARIO'
|
|
939
|
+
}
|
|
940
|
+
|
|
941
|
+
Caso a autenticação seja pelo método `api_rest.aut_bearer()`, o
|
|
942
|
+
dicionário deve corresponder ao formato previsto pelo endpoint e seu
|
|
943
|
+
conteúdo será enviado como um JSON ao endereço indicado no parametro
|
|
944
|
+
`url`
|
|
945
|
+
|
|
946
|
+
A classe possui 3 métodos: - `api_rest.auth_basic()`: instanciamento da
|
|
947
|
+
sessão autenticando pelo método HTTPBasicAuth -
|
|
948
|
+
`api_rest.auth_bearer()`: instanciamento da sessão autenticando pelos
|
|
949
|
+
métodos OAuth, JWT, Bearer\
|
|
950
|
+
- `api_rest.endpoint_json([endereço], [método], payload=None)`: para a
|
|
951
|
+
chamada ao endpoint - `close()` para encerra a instância/sessão
|
|
952
|
+
|
|
953
|
+
O consumo é feito pelo método `api_rest.endpoint_json` que suporta
|
|
954
|
+
apenas APIs cujo payload (opcional) seja aceito no formato JSON.
|
|
955
|
+
|
|
956
|
+
Esse método espera 2 parametros posicionais obrigatórios: o endereço do
|
|
957
|
+
endpoint e o verbo (get, post, patch ou put), tendo parametro opcional o
|
|
958
|
+
objeto de \'payload\' (json). Note que o endereço do endpoint deve ser
|
|
959
|
+
informado completo. A URL informada no instanciamento da classe
|
|
960
|
+
corresponde apenas ao endereço de autenticação.
|
|
961
|
+
|
|
962
|
+
O tempo, em segundos, transcorrido entre a chamada a atual e a chamada
|
|
963
|
+
anterior ao endpoint pode ser consultado pelo argumento `.Intervalo` no
|
|
964
|
+
objeto recebido do retorno à chamada ao método `.endpoint_json`.
|
|
965
|
+
|
|
966
|
+
Da mesma forma, o tempo de espera imposto para respeitar a cadência do
|
|
967
|
+
webservcie também pode ser consultado pelo argumento `.Espera`.
|
|
968
|
+
|
|
969
|
+
Exemplo de uso:
|
|
970
|
+
|
|
971
|
+
from lbx_toolkit import api_rest
|
|
972
|
+
|
|
973
|
+
UrlBase=r'https://api.sienge.com.br/lbx/public/api/v1'
|
|
974
|
+
Credenciais = {
|
|
975
|
+
'user': 'USUARIO_API',
|
|
976
|
+
'password': 'TOKEN_USUARIO'
|
|
977
|
+
}
|
|
978
|
+
ApiSienge = api_rest(UrlBase,Credenciais,2.5) # limite de 2 requisições/segundo para cadência de chamada ao endpoint
|
|
979
|
+
Auth = ApiSienge.auth_basic()
|
|
980
|
+
|
|
981
|
+
Nutitulo=input('Numero do título:')
|
|
982
|
+
Nuparcela=input('Numero da parcela:')
|
|
983
|
+
Vencimento=input('Vencimento [AAAA-MM-DD]:')
|
|
984
|
+
Payload = {
|
|
985
|
+
"dueDate": f"{Vencimento}"
|
|
986
|
+
}
|
|
987
|
+
EndPoint = f'{UrlBase}/bills/{Nutitulo}/installments/{Nuparcela}'
|
|
988
|
+
|
|
989
|
+
#chama o endpoint e recebe o retorno no objeto AlteraVcto
|
|
990
|
+
AlteraVcto = ApiSienge.endpoint_json(EndPoint, 'patch', Payload)
|
|
991
|
+
|
|
992
|
+
No exemplo acima não é esperado que o endpoint retorne nenhum dado
|
|
993
|
+
(`patch`).
|
|
994
|
+
|
|
995
|
+
Quando se usa o verbo `get` e se espera o retorno de algum dado, use o
|
|
996
|
+
método `.json` do pacote `request` para acessar o objeto recebido.
|
|
997
|
+
|
|
998
|
+
Para uso em APIs com autenticação JWT (JSON Web Token), OAuth, Bearer
|
|
999
|
+
Token Authentication, a construção é a mesma indicada acima, bastando-se
|
|
1000
|
+
usar `.auth_bearer()` ao invés de *.auth_basic()*, e ajustar o
|
|
1001
|
+
dicionário `credenciais` informado no instanciamento da classe, que deve
|
|
1002
|
+
ser estruturado conforme o padrão fornecido peo mantendor da API e será
|
|
1003
|
+
enviado como payload ao endpoint (`json=credenciais`).
|
|
1004
|
+
|
|
1005
|
+
Source code in `lbxtoolkit\__init__.py`
|
|
1006
|
+
|
|
1007
|
+
::: highlight
|
|
1008
|
+
+-----------------------------------+-----------------------------------+
|
|
1009
|
+
| ::: linenodiv | <div> |
|
|
1010
|
+
| 709 | |
|
|
1011
|
+
| 710 | class api_ |
|
|
1012
|
+
| 711 | rest: # Classe para interação com |
|
|
1013
|
+
| 712 | APIs Rest (especialmente Sienge) |
|
|
1014
|
+
| 713 | """ |
|
|
1015
|
+
| 714 | #### Classe **api_rest** |
|
|
1016
|
+
| 715 | |
|
|
1017
|
+
| 716 | Destina-se |
|
|
1018
|
+
| 717 | a interatir com APIs RESTfull, e |
|
|
1019
|
+
| 718 | m especial as publicadas pela Sof |
|
|
1020
|
+
| 719 | tPlan para a [Plataforma Sienge]( |
|
|
1021
|
+
| 720 | https://api.sienge.com.br/docs/). |
|
|
1022
|
+
| 721 | |
|
|
1023
|
+
| 722 | A classe deve ser ins |
|
|
1024
|
+
| 723 | tanciada conforme sintaxe abaixo: |
|
|
1025
|
+
| 724 | |
|
|
1026
|
+
| 725 | `api_rest(url, credenc |
|
|
1027
|
+
| 726 | iais, cadencia, timeout=6, logger |
|
|
1028
|
+
| 727 | =None, headers={"Content-Type": " |
|
|
1029
|
+
| 728 | application/json"}, verify=True)` |
|
|
1030
|
+
| 729 | |
|
|
1031
|
+
| 730 | São nessári |
|
|
1032
|
+
| 731 | os 2 parâmetros posicionais obrig |
|
|
1033
|
+
| 732 | atórios, e 5 parametros nominais |
|
|
1034
|
+
| 733 | facultativos (valor padrão, se om |
|
|
1035
|
+
| 734 | isso, indicado na sintaxe acima): |
|
|
1036
|
+
| 735 | - `url`: o ender |
|
|
1037
|
+
| 736 | eço da URL de autenticação da API |
|
|
1038
|
+
| 737 | |
|
|
1039
|
+
| 738 | - `crednciais`: Dicionário |
|
|
1040
|
+
| 739 | com credenciais de autenticação. |
|
|
1041
|
+
| 740 | - `cadencia` Número máxim |
|
|
1042
|
+
| 741 | o de chamadas *por segudo* à API |
|
|
1043
|
+
| 742 | - `timeout` Tempo máximo |
|
|
1044
|
+
| 743 | (segundos) para aguardar retorno |
|
|
1045
|
+
| 744 | à chamada. Padrão 6s, se omisso. |
|
|
1046
|
+
| 745 | - `logger |
|
|
1047
|
+
| 746 | ` O objeto _log handler_ para lid |
|
|
1048
|
+
| 747 | ar com as informações de saída. S |
|
|
1049
|
+
| 748 | e não informado, todas as saídas |
|
|
1050
|
+
| 749 | serão direcionadas para a stdout. |
|
|
1051
|
+
| 750 | - `headers` Cabeçalho |
|
|
1052
|
+
| 751 | s _http_ para a requisição à API. |
|
|
1053
|
+
| 752 | - `verify` Verifica a |
|
|
1054
|
+
| 753 | validade do certificado SSL do s |
|
|
1055
|
+
| 754 | ervidor de destino da requisição. |
|
|
1056
|
+
| 755 | |
|
|
1057
|
+
| 756 | Quanto às creden |
|
|
1058
|
+
| 757 | ciais de autenticação, assim como |
|
|
1059
|
+
| 758 | a classe de interação com o Post |
|
|
1060
|
+
| 759 | greSQL, elas precisam ser forneci |
|
|
1061
|
+
| 760 | das na forma de um *dicionário*. |
|
|
1062
|
+
| 761 | Para o método `api_rest.a |
|
|
1063
|
+
| 762 | ut_basic()`, o formato deve ser: |
|
|
1064
|
+
| 763 | ``` |
|
|
1065
|
+
| 764 | credenciais = { |
|
|
1066
|
+
| 765 | |
|
|
1067
|
+
| 766 | 'user': 'USUARIO_API', |
|
|
1068
|
+
| 767 | |
|
|
1069
|
+
| 768 | 'password': 'TOKEN_USUARIO' |
|
|
1070
|
+
| 769 | } |
|
|
1071
|
+
| 770 | ``` |
|
|
1072
|
+
| 771 | Caso a au |
|
|
1073
|
+
| 772 | tenticação seja pelo método `api_ |
|
|
1074
|
+
| 773 | rest.aut_bearer()`, o dicionário |
|
|
1075
|
+
| 774 | deve corresponder ao formato prev |
|
|
1076
|
+
| 775 | isto pelo endpoint e seu conteúdo |
|
|
1077
|
+
| 776 | será enviado como um JSON ao end |
|
|
1078
|
+
| 777 | ereço indicado no parametro `url` |
|
|
1079
|
+
| 778 | |
|
|
1080
|
+
| 779 | |
|
|
1081
|
+
| 780 | |
|
|
1082
|
+
| 781 | A classe possui 3 métodos: |
|
|
1083
|
+
| 782 | - `api_rest.auth_basic() |
|
|
1084
|
+
| 783 | `: instanciamento da sessão auten |
|
|
1085
|
+
| 784 | ticando pelo método HTTPBasicAuth |
|
|
1086
|
+
| 785 | - ` |
|
|
1087
|
+
| 786 | api_rest.auth_bearer()`: instanci |
|
|
1088
|
+
| 787 | amento da sessão autenticando pel |
|
|
1089
|
+
| 788 | os métodos OAuth, JWT, Bearer |
|
|
1090
|
+
| 789 | - `api_rest.endpoint_jso |
|
|
1091
|
+
| 790 | n([endereço], [método], payload=N |
|
|
1092
|
+
| 791 | one)`: para a chamada ao endpoint |
|
|
1093
|
+
| 792 | - `close() |
|
|
1094
|
+
| 793 | ` para encerra a instância/sessão |
|
|
1095
|
+
| 794 | |
|
|
1096
|
+
| 795 | |
|
|
1097
|
+
| 796 | O consumo é feito pelo método `ap |
|
|
1098
|
+
| 797 | i_rest.endpoint_json` que suporta |
|
|
1099
|
+
| 798 | apenas APIs cujo payload (opcion |
|
|
1100
|
+
| 799 | al) seja aceito no formato JSON. |
|
|
1101
|
+
| 800 | |
|
|
1102
|
+
| 801 | Esse mét |
|
|
1103
|
+
| 802 | odo espera 2 parametros posiciona |
|
|
1104
|
+
| 803 | is obrigatórios: o endereço do en |
|
|
1105
|
+
| 804 | dpoint e o verbo (get, post, patc |
|
|
1106
|
+
| 805 | h ou put), tendo parametro opcion |
|
|
1107
|
+
| 806 | al o objeto de 'payload' (json). |
|
|
1108
|
+
| 807 | Note que o endereço d |
|
|
1109
|
+
| 808 | o endpoint deve ser informado com |
|
|
1110
|
+
| 809 | pleto. A URL informada no instanc |
|
|
1111
|
+
| 810 | iamento da classe corresponde ape |
|
|
1112
|
+
| 811 | nas ao endereço de autenticação. |
|
|
1113
|
+
| 812 | |
|
|
1114
|
+
| 813 | O tempo, e |
|
|
1115
|
+
| 814 | m segundos, transcorrido entre a |
|
|
1116
|
+
| 815 | chamada a atual e a chamada anter |
|
|
1117
|
+
| 816 | ior ao endpoint pode ser consulta |
|
|
1118
|
+
| 817 | do pelo argumento `.Intervalo` no |
|
|
1119
|
+
| 818 | objeto recebido do retorno à cha |
|
|
1120
|
+
| 819 | mada ao método `.endpoint_json`. |
|
|
1121
|
+
| 820 | |
|
|
1122
|
+
| 821 | Da |
|
|
1123
|
+
| 822 | mesma forma, o tempo de espera i |
|
|
1124
|
+
| 823 | mposto para respeitar a cadência |
|
|
1125
|
+
| 824 | do webservcie também pode ser con |
|
|
1126
|
+
| 825 | sultado pelo argumento `.Espera`. |
|
|
1127
|
+
| 826 | |
|
|
1128
|
+
| 827 | Exemplo de uso: |
|
|
1129
|
+
| 828 | |
|
|
1130
|
+
| 829 | ``` |
|
|
1131
|
+
| 830 | |
|
|
1132
|
+
| 831 | from lbx_toolkit import api_rest |
|
|
1133
|
+
| 832 | |
|
|
1134
|
+
| 833 | UrlBase=r'https://api |
|
|
1135
|
+
| 834 | .sienge.com.br/lbx/public/api/v1' |
|
|
1136
|
+
| 835 | Credenciais = { |
|
|
1137
|
+
| 836 | |
|
|
1138
|
+
| 837 | 'user': 'USUARIO_API', |
|
|
1139
|
+
| 838 | |
|
|
1140
|
+
| 839 | 'password': 'TOKEN_USUARIO' |
|
|
1141
|
+
| 840 | } |
|
|
1142
|
+
| 841 | ApiSienge = api_r |
|
|
1143
|
+
| 842 | est(UrlBase,Credenciais,2.5) # li |
|
|
1144
|
+
| 843 | mite de 2 requisições/segundo par |
|
|
1145
|
+
| 844 | a cadência de chamada ao endpoint |
|
|
1146
|
+
| 845 | |
|
|
1147
|
+
| 846 | Auth = ApiSienge.auth_basic() |
|
|
1148
|
+
| 847 | |
|
|
1149
|
+
| 848 | Nu |
|
|
1150
|
+
| 849 | titulo=input('Numero do título:') |
|
|
1151
|
+
| 850 | Nupa |
|
|
1152
|
+
| 851 | rcela=input('Numero da parcela:') |
|
|
1153
|
+
| 852 | Vencimento= |
|
|
1154
|
+
| 853 | input('Vencimento [AAAA-MM-DD]:') |
|
|
1155
|
+
| 854 | Payload = { |
|
|
1156
|
+
| 855 | |
|
|
1157
|
+
| 856 | "dueDate": f"{Vencimento}" |
|
|
1158
|
+
| 857 | } |
|
|
1159
|
+
| 858 | |
|
|
1160
|
+
| 859 | EndPoint = f'{UrlBase}/bills/{Nu |
|
|
1161
|
+
| 860 | titulo}/installments/{Nuparcela}' |
|
|
1162
|
+
| 861 | |
|
|
1163
|
+
| 862 | #chama o endpoint e rece |
|
|
1164
|
+
| 863 | be o retorno no objeto AlteraVcto |
|
|
1165
|
+
| 864 | |
|
|
1166
|
+
| 865 | AlteraVcto = ApiSienge.endpoint |
|
|
1167
|
+
| 866 | _json(EndPoint, 'patch', Payload) |
|
|
1168
|
+
| 867 | ``` |
|
|
1169
|
+
| 868 | |
|
|
1170
|
+
| 869 | No exemplo |
|
|
1171
|
+
| 870 | acima não é esperado que o endpoi |
|
|
1172
|
+
| 871 | nt retorne nenhum dado (`patch`). |
|
|
1173
|
+
| 872 | |
|
|
1174
|
+
| 873 | Quand |
|
|
1175
|
+
| 874 | o se usa o verbo `get` e se esper |
|
|
1176
|
+
| 875 | a o retorno de algum dado, use o |
|
|
1177
|
+
| 876 | método `.json` do pacote `request |
|
|
1178
|
+
| 877 | ` para acessar o objeto recebido. |
|
|
1179
|
+
| 878 | |
|
|
1180
|
+
| 879 | Para uso e |
|
|
1181
|
+
| 880 | m APIs com autenticação JWT (JSON |
|
|
1182
|
+
| 881 | Web Token), OAuth, Bearer Token |
|
|
1183
|
+
| 882 | Authentication, a construção é a |
|
|
1184
|
+
| 883 | mesma indicada acima, bastando-se |
|
|
1185
|
+
| 884 | usar `.auth_bearer()` ao invés d |
|
|
1186
|
+
| 885 | e _.auth_basic()_, e ajustar o di |
|
|
1187
|
+
| 886 | cionário `credenciais` informado |
|
|
1188
|
+
| 887 | no instanciamento da classe, que |
|
|
1189
|
+
| 888 | deve ser estruturado conforme o p |
|
|
1190
|
+
| 889 | adrão fornecido peo mantendor da |
|
|
1191
|
+
| 890 | API e será enviado como payload a |
|
|
1192
|
+
| 891 | o endpoint (`json=credenciais`). |
|
|
1193
|
+
| 892 | |
|
|
1194
|
+
| 893 | """ |
|
|
1195
|
+
| 894 | |
|
|
1196
|
+
| 895 | def __init__(self, url, credencia |
|
|
1197
|
+
| 896 | is, cadencia=3, timeout=6, logger |
|
|
1198
|
+
| 897 | =None, headers={"Content-Type": " |
|
|
1199
|
+
| 898 | application/json"}, verify=True): |
|
|
1200
|
+
| 899 | |
|
|
1201
|
+
| 900 | self.logger = logger if not l |
|
|
1202
|
+
| 901 | ogger is None else lbx_logger(Non |
|
|
1203
|
+
| 902 | e, logging.DEBUG, '%(levelname)s: |
|
|
1204
|
+
| 903 | %(message)s') # se não fornecer |
|
|
1205
|
+
| ::: | o logger, vai tudo para o console |
|
|
1206
|
+
| | |
|
|
1207
|
+
| | |
|
|
1208
|
+
| | if not validators.url(url): |
|
|
1209
|
+
| | self.logger. |
|
|
1210
|
+
| | critico('URL inválida: {url}. Pri |
|
|
1211
|
+
| | meiro parametro precisar uma URL |
|
|
1212
|
+
| | válida. Script abortado', exit=1) |
|
|
1213
|
+
| | if n |
|
|
1214
|
+
| | ot isinstance(credenciais, dict): |
|
|
1215
|
+
| | self. |
|
|
1216
|
+
| | logger.critico('O segundo paramet |
|
|
1217
|
+
| | ro posicional precisa ser um dici |
|
|
1218
|
+
| | onário. Script abortado', exit=1) |
|
|
1219
|
+
| | |
|
|
1220
|
+
| | self.RetEn |
|
|
1221
|
+
| | dPoint = None # Inicializa self. |
|
|
1222
|
+
| | RetEndPoint como None |
|
|
1223
|
+
| | |
|
|
1224
|
+
| | self.Headers = headers |
|
|
1225
|
+
| | |
|
|
1226
|
+
| | self.Verify = verify |
|
|
1227
|
+
| | self.Url = url |
|
|
1228
|
+
| | |
|
|
1229
|
+
| | self.Timeout = timeout |
|
|
1230
|
+
| | |
|
|
1231
|
+
| | self.Credenciais = credenciais |
|
|
1232
|
+
| | self.Cadencia = 1/cad |
|
|
1233
|
+
| | encia ## candencia corresponde a |
|
|
1234
|
+
| | chamadas por segundo, não minuto |
|
|
1235
|
+
| | |
|
|
1236
|
+
| | self.TempoUltReq = None |
|
|
1237
|
+
| | self.I |
|
|
1238
|
+
| | ntervalo = self.Cadencia + 1 |
|
|
1239
|
+
| | # |
|
|
1240
|
+
| | # |
|
|
1241
|
+
| | def controla_cadencia(s |
|
|
1242
|
+
| | elf): ## para controle apenas, nã |
|
|
1243
|
+
| | o deve ser chamada fora da classe |
|
|
1244
|
+
| | |
|
|
1245
|
+
| | # Verificar o tempo atual |
|
|
1246
|
+
| | Agora = time.time() |
|
|
1247
|
+
| | |
|
|
1248
|
+
| | # Cal |
|
|
1249
|
+
| | cular intervalo entre requisições |
|
|
1250
|
+
| | if self.TempoUltReq: |
|
|
1251
|
+
| | self.Int |
|
|
1252
|
+
| | ervalo = Agora - self.TempoUltReq |
|
|
1253
|
+
| | else: |
|
|
1254
|
+
| | |
|
|
1255
|
+
| | self.Intervalo = float('inf') |
|
|
1256
|
+
| | # Primeira requisição não espera |
|
|
1257
|
+
| | |
|
|
1258
|
+
| | |
|
|
1259
|
+
| | # Calcular o tempo de espera n |
|
|
1260
|
+
| | ecessário para respeitar o limite |
|
|
1261
|
+
| | i |
|
|
1262
|
+
| | f self.Intervalo < self.Cadencia: |
|
|
1263
|
+
| | self.Espera |
|
|
1264
|
+
| | = self.Cadencia - self.Intervalo |
|
|
1265
|
+
| | |
|
|
1266
|
+
| | time.sleep(self.Espera) |
|
|
1267
|
+
| | |
|
|
1268
|
+
| | return self.Espera |
|
|
1269
|
+
| | else: |
|
|
1270
|
+
| | self.Espera = 0 |
|
|
1271
|
+
| | r |
|
|
1272
|
+
| | eturn self.Espera, self.Intervalo |
|
|
1273
|
+
| | # |
|
|
1274
|
+
| | # |
|
|
1275
|
+
| | def auth_basic(self): |
|
|
1276
|
+
| | # Autentica e abre sessão na API |
|
|
1277
|
+
| | if |
|
|
1278
|
+
| | not self.Credenciais['user'] or |
|
|
1279
|
+
| | not self.Credenciais['password']: |
|
|
1280
|
+
| | |
|
|
1281
|
+
| | self.logger.critico('Dicioná |
|
|
1282
|
+
| | rio de credenciais não possui cha |
|
|
1283
|
+
| | ves "user" e/ou "password". Scrip |
|
|
1284
|
+
| | t abortado', exit=1) |
|
|
1285
|
+
| | try: |
|
|
1286
|
+
| | |
|
|
1287
|
+
| | self.Sessao = requests.Session() |
|
|
1288
|
+
| | |
|
|
1289
|
+
| | #Sessao.auth = (ApiUser, ApiPass) |
|
|
1290
|
+
| | |
|
|
1291
|
+
| | self.Sessao.auth = HTT |
|
|
1292
|
+
| | PBasicAuth(self.Credenciais['user |
|
|
1293
|
+
| | '], self.Credenciais['password']) |
|
|
1294
|
+
| | Au |
|
|
1295
|
+
| | th = self.Sessao.post(self.Url) |
|
|
1296
|
+
| | #pri |
|
|
1297
|
+
| | nt(f'Status: {Auth.status_code}') |
|
|
1298
|
+
| | |
|
|
1299
|
+
| | #print(f'Retorno: {Auth.text}') |
|
|
1300
|
+
| | |
|
|
1301
|
+
| | return self.Sessao |
|
|
1302
|
+
| | |
|
|
1303
|
+
| | except Exception as Err: |
|
|
1304
|
+
| | self.logger.c |
|
|
1305
|
+
| | ritico(f"Falha ao autenticar API: |
|
|
1306
|
+
| | {Err}. URL: {self.Url}", exit=1) |
|
|
1307
|
+
| | # |
|
|
1308
|
+
| | # |
|
|
1309
|
+
| | def auth_bearer(self): |
|
|
1310
|
+
| | # Autentica e abre sessão na API |
|
|
1311
|
+
| | |
|
|
1312
|
+
| | #self.UrlLogin = UrlLogin if U |
|
|
1313
|
+
| | rlLogin is not None else self.Url |
|
|
1314
|
+
| | try: |
|
|
1315
|
+
| | |
|
|
1316
|
+
| | self.Sessao = requests.Session() |
|
|
1317
|
+
| | Token = self |
|
|
1318
|
+
| | .Sessao.post(self.Url, headers=se |
|
|
1319
|
+
| | lf.Headers, json=self.Credenciais |
|
|
1320
|
+
| | , verify=self.Verify) |
|
|
1321
|
+
| | |
|
|
1322
|
+
| | self.Headers.update({"Authori |
|
|
1323
|
+
| | zation": f"Bearer {Token.text}"}) |
|
|
1324
|
+
| | if |
|
|
1325
|
+
| | 200 <= Token.status_code <= 299: |
|
|
1326
|
+
| | self.Sessa |
|
|
1327
|
+
| | o.status_code = Token.status_code |
|
|
1328
|
+
| | |
|
|
1329
|
+
| | self.Sessao.token = Token.text |
|
|
1330
|
+
| | |
|
|
1331
|
+
| | return self.Sessao |
|
|
1332
|
+
| | else: |
|
|
1333
|
+
| | |
|
|
1334
|
+
| | self.logger.critico(f"Erro a |
|
|
1335
|
+
| | o autenticar API: {Token.status_c |
|
|
1336
|
+
| | ode} - {Token.text}", exit=1) |
|
|
1337
|
+
| | |
|
|
1338
|
+
| | except Exception as Err: |
|
|
1339
|
+
| | self.logger.criti |
|
|
1340
|
+
| | co(f"Falha ao autenticar API: {Er |
|
|
1341
|
+
| | r}. URL: {self.Url}", exit=1) |
|
|
1342
|
+
| | # |
|
|
1343
|
+
| | # |
|
|
1344
|
+
| | def endpoint_js |
|
|
1345
|
+
| | on(self, endpoint, metodo, payloa |
|
|
1346
|
+
| | d=None): # Interage com End Point |
|
|
1347
|
+
| | |
|
|
1348
|
+
| | self.ult_tempo_req = time.time() |
|
|
1349
|
+
| | |
|
|
1350
|
+
| | self.Metodo = metodo.lower() |
|
|
1351
|
+
| | #se |
|
|
1352
|
+
| | lf.EndPoint = self.Url + endpoint |
|
|
1353
|
+
| | |
|
|
1354
|
+
| | self.EndPoint = endpoint |
|
|
1355
|
+
| | |
|
|
1356
|
+
| | self.Payload = payload |
|
|
1357
|
+
| | MetodosAceitos |
|
|
1358
|
+
| | = ['post', 'get', 'patch', 'put'] |
|
|
1359
|
+
| | |
|
|
1360
|
+
| | if not any(element in self.Metod |
|
|
1361
|
+
| | o for element in MetodosAceitos): |
|
|
1362
|
+
| | |
|
|
1363
|
+
| | self.logger.critico |
|
|
1364
|
+
| | (f'Método {self.Metodo} não previ |
|
|
1365
|
+
| | sto. Abortando chamada!', exit=1) |
|
|
1366
|
+
| | else: |
|
|
1367
|
+
| | ChamadaApi = |
|
|
1368
|
+
| | f'self.Sessao.{self.Metodo}(self |
|
|
1369
|
+
| | .EndPoint, timeout=self.Timeout, |
|
|
1370
|
+
| | headers=self.Headers, verify=self |
|
|
1371
|
+
| | .Verify)' if self.Payload is None |
|
|
1372
|
+
| | else f'self.Sessao.{self.Metodo} |
|
|
1373
|
+
| | (self.EndPoint, timeout=self.Time |
|
|
1374
|
+
| | out, headers=self.Headers, verify |
|
|
1375
|
+
| | =self.Verify, json=self.Payload)' |
|
|
1376
|
+
| | |
|
|
1377
|
+
| | self.controla_cadencia() |
|
|
1378
|
+
| | |
|
|
1379
|
+
| | self.TempoUltReq = time.time() |
|
|
1380
|
+
| | try: |
|
|
1381
|
+
| | se |
|
|
1382
|
+
| | lf.RetEndPoint = eval(ChamadaApi) |
|
|
1383
|
+
| | if sel |
|
|
1384
|
+
| | f.RetEndPoint.status_code >= 500: |
|
|
1385
|
+
| | |
|
|
1386
|
+
| | self.logger.critico(f'Erro {se |
|
|
1387
|
+
| | lf.RetEndPoint.status_code} na ch |
|
|
1388
|
+
| | amada do endpoint: {Err}\nEndpoin |
|
|
1389
|
+
| | t: {self.EndPoint}\nResposta: {se |
|
|
1390
|
+
| | lf.RetEndPoint.text}', exit=1) |
|
|
1391
|
+
| | |
|
|
1392
|
+
| | self.RetEndPoint. |
|
|
1393
|
+
| | Espera = self.Espera ## adiona o |
|
|
1394
|
+
| | tempo de espera ao retorno da API |
|
|
1395
|
+
| | |
|
|
1396
|
+
| | self.RetEndPoint.Intervalo = sel |
|
|
1397
|
+
| | f.Intervalo ## adiciona o interva |
|
|
1398
|
+
| | lo entre chamada ao retorno da AP |
|
|
1399
|
+
| | I |
|
|
1400
|
+
| | |
|
|
1401
|
+
| | return self.RetEndPoint |
|
|
1402
|
+
| | except reques |
|
|
1403
|
+
| | ts.exceptions.ReadTimeout as Err: |
|
|
1404
|
+
| | self.lo |
|
|
1405
|
+
| | gger.critico(f'Excedido tempo lim |
|
|
1406
|
+
| | ite {self.Timeout} para retorno d |
|
|
1407
|
+
| | o endpoint: {Err}\nEndpoint: {sel |
|
|
1408
|
+
| | f.EndPoint}', exit=1) |
|
|
1409
|
+
| | |
|
|
1410
|
+
| | except Exception as Err: |
|
|
1411
|
+
| | self.logger |
|
|
1412
|
+
| | .critico(f'Falha na chamada do en |
|
|
1413
|
+
| | dpoint: {Err}\nEndpoint: {self.En |
|
|
1414
|
+
| | dPoint}\nCodigo retorno: {self.Re |
|
|
1415
|
+
| | tEndPoint.status_code}\nResposta: |
|
|
1416
|
+
| | {self.RetEndPoint.text}', exit=1) |
|
|
1417
|
+
| | # |
|
|
1418
|
+
| | # |
|
|
1419
|
+
| | def tr |
|
|
1420
|
+
| | ata_erro_sienge(CodRet, Retorno): |
|
|
1421
|
+
| | if |
|
|
1422
|
+
| | not 200 <= CodRet <= 299: |
|
|
1423
|
+
| | try: |
|
|
1424
|
+
| | DicR |
|
|
1425
|
+
| | etorno = eval(Retorno.replace('nu |
|
|
1426
|
+
| | ll','None').replace(r'\n\t',' ')) |
|
|
1427
|
+
| | if 'c |
|
|
1428
|
+
| | lientMessage' in DicRetorno and D |
|
|
1429
|
+
| | icRetorno['clientMessage'] not in |
|
|
1430
|
+
| | ['None', None, '', ' ', 'null']: |
|
|
1431
|
+
| | MsgE |
|
|
1432
|
+
| | rro = DicRetorno['clientMessage'] |
|
|
1433
|
+
| | elif 'develop |
|
|
1434
|
+
| | erMessage' in DicRetorno and DicR |
|
|
1435
|
+
| | etorno['developerMessage'] not in |
|
|
1436
|
+
| | ['None', None, '', ' ', 'null']: |
|
|
1437
|
+
| | MsgErro |
|
|
1438
|
+
| | = DicRetorno['developerMessage'] |
|
|
1439
|
+
| | |
|
|
1440
|
+
| | elif 'message' in DicRetorno |
|
|
1441
|
+
| | and DicRetorno['message'] not in |
|
|
1442
|
+
| | ['None', None, '', ' ', 'null']: |
|
|
1443
|
+
| | |
|
|
1444
|
+
| | MsgErro = DicRetorno['message'] |
|
|
1445
|
+
| | else: |
|
|
1446
|
+
| | |
|
|
1447
|
+
| | MsgErro = Retorno |
|
|
1448
|
+
| | except: |
|
|
1449
|
+
| | MsgErro = Ret |
|
|
1450
|
+
| | orno.replace(r'\n\t',' ') |
|
|
1451
|
+
| | finally: |
|
|
1452
|
+
| | |
|
|
1453
|
+
| | return MsgErro |
|
|
1454
|
+
| | else: |
|
|
1455
|
+
| | |
|
|
1456
|
+
| | return Retorno |
|
|
1457
|
+
| | # |
|
|
1458
|
+
| | # |
|
|
1459
|
+
| | de |
|
|
1460
|
+
| | f close(self): # Encerra a cessão |
|
|
1461
|
+
| | self. |
|
|
1462
|
+
| | Sessao.close() |
|
|
1463
|
+
| | |
|
|
1464
|
+
| | </div> |
|
|
1465
|
+
+-----------------------------------+-----------------------------------+
|
|
1466
|
+
:::
|
|
1467
|
+
|
|
1468
|
+
::: {.doc .doc-children}
|
|
1469
|
+
:::
|
|
1470
|
+
:::::
|
|
1471
|
+
::::::
|
|
1472
|
+
|
|
1473
|
+
:::::: {.doc .doc-object .doc-class}
|
|
1474
|
+
## `auth_EntraID` {#lbxtoolkit.auth_EntraID .doc .doc-heading}
|
|
1475
|
+
|
|
1476
|
+
::::: {.doc .doc-contents}
|
|
1477
|
+
###### Classe **auth_EntraID** {#lbxtoolkit.auth_EntraID--classe-auth_entraid}
|
|
1478
|
+
|
|
1479
|
+
Este recurso tem o propósito de controlar as permissões de execução do
|
|
1480
|
+
script usando as credencias do ambiente AD em nuvem da Microsoft (Azure
|
|
1481
|
+
AD \>\> Microsoft Entra ID), abortando se a autentição falhar ou o
|
|
1482
|
+
usuário não pertencer ao grupo.
|
|
1483
|
+
|
|
1484
|
+
Essa classe possui apenas dois métodos:
|
|
1485
|
+
|
|
1486
|
+
- `auth_EntraID.disclaimer()`: apenas exibe uma tela de
|
|
1487
|
+
informações/instruções ao usuário.
|
|
1488
|
+
|
|
1489
|
+
- `auth_EntraID.valida_grupo([client_id], [client_secret], [tenant_id], timeout=60, log_file='auth_EntraID.log')`:
|
|
1490
|
+
efetua a autenticação do usuário e verifica se ele pertence ao grupo
|
|
1491
|
+
informado, abortando a execução caso não pertença ao grupo ou a
|
|
1492
|
+
autenticação não seja validada no tempo estabelecido. Os argumentos
|
|
1493
|
+
`timeout` e `log_file` são opcionais e, se omitidos, os valores aqui
|
|
1494
|
+
atribuídos serão adotados como padrão.
|
|
1495
|
+
|
|
1496
|
+
É necessário obter parametros da plataforma de identidade da Microsoft
|
|
1497
|
+
(AD Azure, agora Microsoft Entra ID), no [*Centro de administração do
|
|
1498
|
+
Microsoft Entra*](https://entra.microsoft.com). Sugerimos não armazenar
|
|
1499
|
+
estas ou outras informações sensíveis no script. Considere usar o pacote
|
|
1500
|
+
`dotenv` para isso.
|
|
1501
|
+
|
|
1502
|
+
Os argumentos obrigatórios (posicionais) são:
|
|
1503
|
+
|
|
1504
|
+
1\) `tenant_id` corresponde ao campo *ID do Locatário*, que pode ser
|
|
1505
|
+
obtido na página [visão geral de identidade do
|
|
1506
|
+
domínio](https://entra.microsoft.com/#blade/Microsoft_AAD_IAM/TenantOverview.ReactView)
|
|
1507
|
+
|
|
1508
|
+
2\) `client_id` corresponde ao *ID do aplicativo (cliente)*, obtido na
|
|
1509
|
+
secção [*Identidade \> Aplicativos \> Registros de
|
|
1510
|
+
Aplicativo*](https://entra.microsoft.com/#view/Microsoft_AAD_RegisteredApps/ApplicationsListBlade/quickStartType~/null/sourceType/Microsoft_AAD_IAM).
|
|
1511
|
+
Considere não reaproveitar aplicativos e criar um específico para essa
|
|
1512
|
+
finalidade.
|
|
1513
|
+
|
|
1514
|
+
3\) `secret_id` corresponde ao *Valor* do *ID secreto* (não ao próprio
|
|
1515
|
+
ID Secreto) do aplicativo. Este token não é passivel de consulta após
|
|
1516
|
+
gerado e para obtê-lo, é necessário criar um novo segredo para o
|
|
1517
|
+
aplicativo na subsecção *\"Certificados e Segredos\"*, após clicar no
|
|
1518
|
+
nome do aplicativo exibo na indicada no item (2). O token (*Valor do
|
|
1519
|
+
segredo*) deve ser copiado e anotado no ato da criação, pois *não é
|
|
1520
|
+
possível consultá-lo posteriormente*.
|
|
1521
|
+
|
|
1522
|
+
from lbx_toolkit import auth_EntraID
|
|
1523
|
+
|
|
1524
|
+
client_id = 'SEU_CLIENT_ID'
|
|
1525
|
+
client_secret = 'SEU_CLIENT_SECRET'
|
|
1526
|
+
tenant_id = 'SEU_TENANT_ID'
|
|
1527
|
+
|
|
1528
|
+
# inicializa instância
|
|
1529
|
+
auth = auth_EntraID(client_id, client_secret, tenant_id, timeout=60, log_file='auth_EntraID.log')
|
|
1530
|
+
|
|
1531
|
+
# exibe a mensagem padrão de aviso
|
|
1532
|
+
auth.disclaimer()
|
|
1533
|
+
|
|
1534
|
+
auth.valida_grupo('Nome do Grupo de Distribuição')
|
|
1535
|
+
# se usuário não pertencer a grupo informado, a execução do script é abortada.
|
|
1536
|
+
|
|
1537
|
+
Source code in `lbxtoolkit\__init__.py`
|
|
1538
|
+
|
|
1539
|
+
::: highlight
|
|
1540
|
+
+-----------------------------------+-----------------------------------+
|
|
1541
|
+
| ::: linenodiv | <div> |
|
|
1542
|
+
| 100 | |
|
|
1543
|
+
| 101 | |
|
|
1544
|
+
| 102 | class auth_EntraID: # Classe d |
|
|
1545
|
+
| 103 | e autenticação de usuários no Mic |
|
|
1546
|
+
| 104 | rosoft Entra ID (antiga Azure AD) |
|
|
1547
|
+
| 105 | """ |
|
|
1548
|
+
| 106 | |
|
|
1549
|
+
| 107 | #### Classe **auth_EntraID** |
|
|
1550
|
+
| 108 | |
|
|
1551
|
+
| 109 | Este rec |
|
|
1552
|
+
| 110 | urso tem o propósito de controlar |
|
|
1553
|
+
| 111 | as permissões de execução do scr |
|
|
1554
|
+
| 112 | ipt usando as credencias do ambie |
|
|
1555
|
+
| 113 | nte AD em nuvem da Microsoft (Azu |
|
|
1556
|
+
| 114 | re AD >> Microsoft Entra ID), abo |
|
|
1557
|
+
| 115 | rtando se a autentição falhar ou |
|
|
1558
|
+
| 116 | o usuário não pertencer ao grupo. |
|
|
1559
|
+
| 117 | |
|
|
1560
|
+
| 118 | Essa c |
|
|
1561
|
+
| 119 | lasse possui apenas dois métodos: |
|
|
1562
|
+
| 120 | |
|
|
1563
|
+
| 121 | - `auth_EntraID.disclaim |
|
|
1564
|
+
| 122 | er()`: apenas exibe uma tela de i |
|
|
1565
|
+
| 123 | nformações/instruções ao usuário. |
|
|
1566
|
+
| 124 | |
|
|
1567
|
+
| 125 | |
|
|
1568
|
+
| 126 | - `auth_EntraID.valida_grupo |
|
|
1569
|
+
| 127 | ([client_id], [client_secret], [t |
|
|
1570
|
+
| 128 | enant_id], timeout=60, log_file=' |
|
|
1571
|
+
| 129 | auth_EntraID.log')`: efetua a aut |
|
|
1572
|
+
| 130 | enticação do usuário e verifica s |
|
|
1573
|
+
| 131 | e ele pertence ao grupo informado |
|
|
1574
|
+
| 132 | , abortando a execução caso não |
|
|
1575
|
+
| 133 | pertença ao grupo ou a autenticaç |
|
|
1576
|
+
| 134 | ão não seja validada no tempo est |
|
|
1577
|
+
| 135 | abelecido. Os argumentos `timeout |
|
|
1578
|
+
| 136 | ` e `log_file` são opcionais e, s |
|
|
1579
|
+
| 137 | e omitidos, os valores aqui atrib |
|
|
1580
|
+
| 138 | uídos serão adotados como padrão. |
|
|
1581
|
+
| 139 | |
|
|
1582
|
+
| 140 | É necessário obter para |
|
|
1583
|
+
| 141 | metros da plataforma de identidad |
|
|
1584
|
+
| 142 | e da Microsoft (AD Azure, agora M |
|
|
1585
|
+
| 143 | icrosoft Entra ID), no [*Centro d |
|
|
1586
|
+
| 144 | e administração do Microsoft Entr |
|
|
1587
|
+
| 145 | a*](https://entra.microsoft.com). |
|
|
1588
|
+
| 146 | Sugerimos não arm |
|
|
1589
|
+
| 147 | azenar estas ou outras informaçõe |
|
|
1590
|
+
| 148 | s sensíveis no script. Considere |
|
|
1591
|
+
| 149 | usar o pacote `dotenv` para isso. |
|
|
1592
|
+
| 150 | |
|
|
1593
|
+
| 151 | Os argumento |
|
|
1594
|
+
| 152 | s obrigatórios (posicionais) são: |
|
|
1595
|
+
| 153 | |
|
|
1596
|
+
| 154 | 1) ` |
|
|
1597
|
+
| 155 | tenant_id` corresponde ao campo * |
|
|
1598
|
+
| 156 | ID do Locatário*, que pode ser ob |
|
|
1599
|
+
| 157 | tido na página [visão geral de id |
|
|
1600
|
+
| 158 | entidade do domínio](https://entr |
|
|
1601
|
+
| 159 | a.microsoft.com/#blade/Microsoft_ |
|
|
1602
|
+
| 160 | AAD_IAM/TenantOverview.ReactView) |
|
|
1603
|
+
| 161 | |
|
|
1604
|
+
| 162 | 2) `client_id` corres |
|
|
1605
|
+
| 163 | ponde ao *ID do aplicativo (clien |
|
|
1606
|
+
| 164 | te)*, obtido na secção [_Identida |
|
|
1607
|
+
| 165 | de > Aplicativos > Registros de A |
|
|
1608
|
+
| 166 | plicativo_](https://entra.microso |
|
|
1609
|
+
| 167 | ft.com/#view/Microsoft_AAD_Regist |
|
|
1610
|
+
| 168 | eredApps/ApplicationsListBlade/qu |
|
|
1611
|
+
| 169 | ickStartType~/null/sourceType/Mic |
|
|
1612
|
+
| 170 | rosoft_AAD_IAM). Considere não re |
|
|
1613
|
+
| 171 | aproveitar aplicativos e criar um |
|
|
1614
|
+
| 172 | específico para essa finalidade. |
|
|
1615
|
+
| 173 | |
|
|
1616
|
+
| 174 | 3) `secret_id` cor |
|
|
1617
|
+
| 175 | responde ao *Valor* do _ID secret |
|
|
1618
|
+
| 176 | o_ (não ao próprio ID Secreto) do |
|
|
1619
|
+
| 177 | aplicativo. Este token não é pas |
|
|
1620
|
+
| 178 | sivel de consulta após gerado e p |
|
|
1621
|
+
| 179 | ara obtê-lo, é necessário criar u |
|
|
1622
|
+
| 180 | m novo segredo para o aplicativo |
|
|
1623
|
+
| 181 | na subsecção _"Certificados e Seg |
|
|
1624
|
+
| 182 | redos"_, após clicar no nome do a |
|
|
1625
|
+
| 183 | plicativo exibo na indicada no it |
|
|
1626
|
+
| 184 | em (2). O token (_Valor do segred |
|
|
1627
|
+
| 185 | o_) deve ser copiado e anotado no |
|
|
1628
|
+
| 186 | ato da criação, pois *não é poss |
|
|
1629
|
+
| 187 | ível consultá-lo posteriormente*. |
|
|
1630
|
+
| 188 | |
|
|
1631
|
+
| 189 | |
|
|
1632
|
+
| 190 | ``` |
|
|
1633
|
+
| 191 | fro |
|
|
1634
|
+
| 192 | m lbx_toolkit import auth_EntraID |
|
|
1635
|
+
| 193 | |
|
|
1636
|
+
| 194 | |
|
|
1637
|
+
| 195 | client_id = 'SEU_CLIENT_ID' |
|
|
1638
|
+
| 196 | cl |
|
|
1639
|
+
| 197 | ient_secret = 'SEU_CLIENT_SECRET' |
|
|
1640
|
+
| 198 | |
|
|
1641
|
+
| 199 | tenant_id = 'SEU_TENANT_ID' |
|
|
1642
|
+
| 200 | |
|
|
1643
|
+
| 201 | # inicializa instância |
|
|
1644
|
+
| 202 | |
|
|
1645
|
+
| 203 | auth = auth_EntraID(client_id, cl |
|
|
1646
|
+
| 204 | ient_secret, tenant_id, timeout=6 |
|
|
1647
|
+
| 205 | 0, log_file='auth_EntraID.log') |
|
|
1648
|
+
| 206 | |
|
|
1649
|
+
| 207 | # |
|
|
1650
|
+
| 208 | exibe a mensagem padrão de aviso |
|
|
1651
|
+
| 209 | auth.disclaimer() |
|
|
1652
|
+
| 210 | |
|
|
1653
|
+
| 211 | auth.valida_grupo( |
|
|
1654
|
+
| 212 | 'Nome do Grupo de Distribuição') |
|
|
1655
|
+
| 213 | # se usuário |
|
|
1656
|
+
| 214 | não pertencer a grupo informado, |
|
|
1657
|
+
| 215 | a execução do script é abortada. |
|
|
1658
|
+
| 216 | ``` |
|
|
1659
|
+
| 217 | """ |
|
|
1660
|
+
| 218 | def _ |
|
|
1661
|
+
| 219 | _init__(self, client_id, client_s |
|
|
1662
|
+
| 220 | ecret, tenant_id, grupo, timeout= |
|
|
1663
|
+
| 221 | 60, log_file='auth_EntraID.log'): |
|
|
1664
|
+
| 222 | |
|
|
1665
|
+
| 223 | self.client_id = client_id |
|
|
1666
|
+
| 224 | s |
|
|
1667
|
+
| 225 | elf.client_secret = client_secret |
|
|
1668
|
+
| 226 | |
|
|
1669
|
+
| 227 | self.tenant_id = tenant_id |
|
|
1670
|
+
| 228 | |
|
|
1671
|
+
| 229 | self.timeout = timeout |
|
|
1672
|
+
| 230 | self.grupo = grupo |
|
|
1673
|
+
| 231 | self |
|
|
1674
|
+
| 232 | .authority = f"https://login.micr |
|
|
1675
|
+
| 233 | osoftonline.com/{self.tenant_id}" |
|
|
1676
|
+
| 234 | self.scope = ["https |
|
|
1677
|
+
| 235 | ://graph.microsoft.com/.default"] |
|
|
1678
|
+
| 236 | self.redir |
|
|
1679
|
+
| 237 | ect_uri = "http://localhost:8000" |
|
|
1680
|
+
| 238 | self.response = "" |
|
|
1681
|
+
| 239 | self.status_code = 0 |
|
|
1682
|
+
| 240 | self.server = None |
|
|
1683
|
+
| 241 | |
|
|
1684
|
+
| 242 | self.log_file = log_file |
|
|
1685
|
+
| 243 | |
|
|
1686
|
+
| 244 | # Configura o logger |
|
|
1687
|
+
| 245 | |
|
|
1688
|
+
| 246 | logging.basicConfig(filen |
|
|
1689
|
+
| 247 | ame=log_file, level=logging.INFO, |
|
|
1690
|
+
| 248 | |
|
|
1691
|
+
| 249 | format='%(asctime)s - %(name) |
|
|
1692
|
+
| 250 | s - %(levelname)s - %(message)s') |
|
|
1693
|
+
| 251 | self.log |
|
|
1694
|
+
| 252 | ger = logging.getLogger(__name__) |
|
|
1695
|
+
| 253 | # |
|
|
1696
|
+
| 254 | # |
|
|
1697
|
+
| 255 | |
|
|
1698
|
+
| 256 | def valida_grupo(self): # Valid |
|
|
1699
|
+
| 257 | a se o usuário autenticado perten |
|
|
1700
|
+
| 258 | ce a grupo de segurança informado |
|
|
1701
|
+
| 259 | # Redireciona std |
|
|
1702
|
+
| 260 | out e stderr para arquivos de log |
|
|
1703
|
+
| 261 | |
|
|
1704
|
+
| 262 | original_stdout = sys.stdout |
|
|
1705
|
+
| 263 | |
|
|
1706
|
+
| 264 | original_stderr = sys.stderr |
|
|
1707
|
+
| 265 | sys |
|
|
1708
|
+
| 266 | .stdout = open('stdout.log', 'a') |
|
|
1709
|
+
| 267 | sys |
|
|
1710
|
+
| 268 | .stderr = open('stderr.log', 'a') |
|
|
1711
|
+
| 269 | |
|
|
1712
|
+
| 270 | |
|
|
1713
|
+
| 271 | # Configurações do Selenium |
|
|
1714
|
+
| 272 | |
|
|
1715
|
+
| 273 | chrome_options = Options() |
|
|
1716
|
+
| 274 | chrome_op |
|
|
1717
|
+
| 275 | tions.add_argument("--incognito") |
|
|
1718
|
+
| 276 | |
|
|
1719
|
+
| 277 | |
|
|
1720
|
+
| 278 | # Inicializa a aplicação MSAL |
|
|
1721
|
+
| 279 | try: |
|
|
1722
|
+
| 280 | app = ms |
|
|
1723
|
+
| 281 | al.ConfidentialClientApplication( |
|
|
1724
|
+
| 282 | |
|
|
1725
|
+
| 283 | self.client_id, |
|
|
1726
|
+
| 284 | |
|
|
1727
|
+
| 285 | authority=self.authority, |
|
|
1728
|
+
| 286 | clie |
|
|
1729
|
+
| 287 | nt_credential=self.client_secret, |
|
|
1730
|
+
| 288 | ) |
|
|
1731
|
+
| 289 | |
|
|
1732
|
+
| 290 | except BaseException as err: |
|
|
1733
|
+
| 291 | print(f'Falha a |
|
|
1734
|
+
| 292 | o iniciar aplicação MSAL: {err}') |
|
|
1735
|
+
| 293 | |
|
|
1736
|
+
| 294 | # Restaura saída padrão |
|
|
1737
|
+
| 295 | |
|
|
1738
|
+
| 296 | sys.stdout.close() |
|
|
1739
|
+
| 297 | |
|
|
1740
|
+
| 298 | sys.stderr.close() |
|
|
1741
|
+
| 299 | |
|
|
1742
|
+
| 300 | sys.stdout = original_stdout |
|
|
1743
|
+
| 301 | |
|
|
1744
|
+
| 302 | sys.stderr = original_stderr |
|
|
1745
|
+
| 303 | print(f |
|
|
1746
|
+
| 304 | 'Script abortado por falha aplica |
|
|
1747
|
+
| 305 | ção MSAL. Verifque logs: {self.lo |
|
|
1748
|
+
| 306 | g_file}, stdout.log e sterr.log') |
|
|
1749
|
+
| 307 | os._exit(0) |
|
|
1750
|
+
| 308 | |
|
|
1751
|
+
| 309 | # Inicia |
|
|
1752
|
+
| 310 | o fluxo de código de autorização |
|
|
1753
|
+
| 311 | try: |
|
|
1754
|
+
| 312 | |
|
|
1755
|
+
| 313 | flow = app.initiate |
|
|
1756
|
+
| 314 | _auth_code_flow(scopes=self.scope |
|
|
1757
|
+
| 315 | , redirect_uri=self.redirect_uri) |
|
|
1758
|
+
| 316 | |
|
|
1759
|
+
| 317 | auth_url = flow["auth_uri"] |
|
|
1760
|
+
| 318 | |
|
|
1761
|
+
| 319 | self.response = f"Acessando a URL |
|
|
1762
|
+
| 320 | de autenticação Microsoft Entra |
|
|
1763
|
+
| 321 | ID (antiga Azure AD): {auth_url}" |
|
|
1764
|
+
| 322 | |
|
|
1765
|
+
| 323 | self.logger.info(self.response) |
|
|
1766
|
+
| 324 | |
|
|
1767
|
+
| 325 | except BaseException as err: |
|
|
1768
|
+
| 326 | print(f'Falha no |
|
|
1769
|
+
| 327 | fluxo de autorização Microsoft En |
|
|
1770
|
+
| 328 | tra ID (antiga Azure AD): {err}') |
|
|
1771
|
+
| 329 | |
|
|
1772
|
+
| 330 | # Restaura saída padrão |
|
|
1773
|
+
| 331 | |
|
|
1774
|
+
| 332 | sys.stdout.close() |
|
|
1775
|
+
| 333 | |
|
|
1776
|
+
| 334 | sys.stderr.close() |
|
|
1777
|
+
| 335 | |
|
|
1778
|
+
| 336 | sys.stdout = original_stdout |
|
|
1779
|
+
| 337 | |
|
|
1780
|
+
| 338 | sys.stderr = original_stderr |
|
|
1781
|
+
| 339 | |
|
|
1782
|
+
| 340 | print(f'Script abort |
|
|
1783
|
+
| 341 | ado por falha no fluxo de autoriz |
|
|
1784
|
+
| 342 | ação Microsoft Entra ID (antiga A |
|
|
1785
|
+
| 343 | zure AD). Verifque logs: {self.lo |
|
|
1786
|
+
| 344 | g_file}, stdout.log e sterr.log') |
|
|
1787
|
+
| 345 | |
|
|
1788
|
+
| 346 | os._exit(0) |
|
|
1789
|
+
| 347 | |
|
|
1790
|
+
| 348 | |
|
|
1791
|
+
| 349 | # Inicializa o ChromeDri |
|
|
1792
|
+
| 350 | ver com redirecionamento de saída |
|
|
1793
|
+
| 351 | try: |
|
|
1794
|
+
| 352 | service = Service |
|
|
1795
|
+
| 353 | (ChromeDriverManager().install()) |
|
|
1796
|
+
| 354 | service.start() |
|
|
1797
|
+
| 355 | |
|
|
1798
|
+
| 356 | driver = webdriver.Chrome(service |
|
|
1799
|
+
| 357 | =service, options=chrome_options) |
|
|
1800
|
+
| 358 | |
|
|
1801
|
+
| 359 | driver.get(auth_url) |
|
|
1802
|
+
| 360 | |
|
|
1803
|
+
| 361 | except BaseException as err: |
|
|
1804
|
+
| 362 | print(f'Falha na |
|
|
1805
|
+
| 363 | inicialização do Chrome: {err}') |
|
|
1806
|
+
| 364 | |
|
|
1807
|
+
| 365 | # Restaura saída padrão |
|
|
1808
|
+
| 366 | |
|
|
1809
|
+
| 367 | sys.stdout.close() |
|
|
1810
|
+
| 368 | |
|
|
1811
|
+
| 369 | sys.stderr.close() |
|
|
1812
|
+
| 370 | |
|
|
1813
|
+
| 371 | sys.stdout = original_stdout |
|
|
1814
|
+
| 372 | |
|
|
1815
|
+
| 373 | sys.stderr = original_stderr |
|
|
1816
|
+
| 374 | print(f'S |
|
|
1817
|
+
| 375 | cript abortado na inicialização d |
|
|
1818
|
+
| 376 | o Chrome. Verifque logs: {self.lo |
|
|
1819
|
+
| 377 | g_file}, stdout.log e sterr.log') |
|
|
1820
|
+
| 378 | |
|
|
1821
|
+
| 379 | os._exit(0) |
|
|
1822
|
+
| 380 | # |
|
|
1823
|
+
| 381 | # |
|
|
1824
|
+
| 382 | class Aut |
|
|
1825
|
+
| 383 | hHandler(BaseHTTPRequestHandler): |
|
|
1826
|
+
| 384 | def |
|
|
1827
|
+
| 385 | log_message(self, format, *args): |
|
|
1828
|
+
| 386 | self.server |
|
|
1829
|
+
| 387 | .logger.info("%s - - [%s] %s\n" % |
|
|
1830
|
+
| 388 | |
|
|
1831
|
+
| 389 | |
|
|
1832
|
+
| 390 | (self.client_address[0], |
|
|
1833
|
+
| 391 | |
|
|
1834
|
+
| 392 | |
|
|
1835
|
+
| 393 | self.log_date_time_string(), |
|
|
1836
|
+
| 394 | |
|
|
1837
|
+
| 395 | format % args)) |
|
|
1838
|
+
| 396 | # |
|
|
1839
|
+
| 397 | # |
|
|
1840
|
+
| 398 | def do_GET(self): |
|
|
1841
|
+
| 399 | parsed_pa |
|
|
1842
|
+
| 400 | th = urlparse.urlparse(self.path) |
|
|
1843
|
+
| 401 | |
|
|
1844
|
+
| 402 | query_params = url |
|
|
1845
|
+
| 403 | parse.parse_qs(parsed_path.query) |
|
|
1846
|
+
| 404 | |
|
|
1847
|
+
| 405 | self.send_response(200) |
|
|
1848
|
+
| 406 | self.send_he |
|
|
1849
|
+
| 407 | ader('Content-type', 'text/html') |
|
|
1850
|
+
| 408 | |
|
|
1851
|
+
| 409 | self.end_headers() |
|
|
1852
|
+
| 410 | |
|
|
1853
|
+
| 411 | # Captura o |
|
|
1854
|
+
| 412 | código de autorização e o estado |
|
|
1855
|
+
| 413 | |
|
|
1856
|
+
| 414 | if 'code' in query_pa |
|
|
1857
|
+
| 415 | rams and 'state' in query_params: |
|
|
1858
|
+
| 416 | |
|
|
1859
|
+
| 417 | self.server.au |
|
|
1860
|
+
| 418 | th_code = query_params['code'][0] |
|
|
1861
|
+
| 419 | |
|
|
1862
|
+
| 420 | self.server |
|
|
1863
|
+
| 421 | .state = query_params['state'][0] |
|
|
1864
|
+
| 422 | |
|
|
1865
|
+
| 423 | self.wfile.write(b""" |
|
|
1866
|
+
| 424 | |
|
|
1867
|
+
| 425 | <!DOCTYPE html> |
|
|
1868
|
+
| 426 | |
|
|
1869
|
+
| 427 | <html lang="pt_BR"> |
|
|
1870
|
+
| 428 | |
|
|
1871
|
+
| 429 | <head> |
|
|
1872
|
+
| 430 | |
|
|
1873
|
+
| 431 | <meta charset="UTF-8"> |
|
|
1874
|
+
| 432 | |
|
|
1875
|
+
| 433 | <met |
|
|
1876
|
+
| 434 | a name="viewport" content="width= |
|
|
1877
|
+
| 435 | device-width, initial-scale=1.0"> |
|
|
1878
|
+
| 436 | |
|
|
1879
|
+
| 437 | <style> |
|
|
1880
|
+
| 438 | |
|
|
1881
|
+
| 439 | body { |
|
|
1882
|
+
| 440 | |
|
|
1883
|
+
| 441 | |
|
|
1884
|
+
| 442 | font-family: 'Arial', sans-serif; |
|
|
1885
|
+
| 443 | |
|
|
1886
|
+
| 444 | |
|
|
1887
|
+
| 445 | background-color: #f8f9fa; |
|
|
1888
|
+
| 446 | |
|
|
1889
|
+
| 447 | margin: 0; |
|
|
1890
|
+
| 448 | |
|
|
1891
|
+
| 449 | |
|
|
1892
|
+
| 450 | font-size: 16px; |
|
|
1893
|
+
| 451 | |
|
|
1894
|
+
| 452 | |
|
|
1895
|
+
| 453 | padding: 30px; |
|
|
1896
|
+
| 454 | |
|
|
1897
|
+
| 455 | |
|
|
1898
|
+
| 456 | display: flex; * |
|
|
1899
|
+
| 457 | |
|
|
1900
|
+
| 458 | } |
|
|
1901
|
+
| 459 | |
|
|
1902
|
+
| 460 | |
|
|
1903
|
+
| 461 | |
|
|
1904
|
+
| 462 | .container { |
|
|
1905
|
+
| 463 | |
|
|
1906
|
+
| 464 | |
|
|
1907
|
+
| 465 | width: 100%; |
|
|
1908
|
+
| 466 | |
|
|
1909
|
+
| 467 | |
|
|
1910
|
+
| 468 | margin: auto; |
|
|
1911
|
+
| 469 | |
|
|
1912
|
+
| 470 | |
|
|
1913
|
+
| 471 | background-color: #ffffff; |
|
|
1914
|
+
| 472 | |
|
|
1915
|
+
| 473 | box-sha |
|
|
1916
|
+
| 474 | dow: 0 0 10px rgba(0, 0, 0, 0.1); |
|
|
1917
|
+
| 475 | |
|
|
1918
|
+
| 476 | |
|
|
1919
|
+
| 477 | padding: 16px; |
|
|
1920
|
+
| 478 | |
|
|
1921
|
+
| 479 | |
|
|
1922
|
+
| 480 | text-align: center; |
|
|
1923
|
+
| 481 | |
|
|
1924
|
+
| 482 | |
|
|
1925
|
+
| 483 | font-size: 16px; |
|
|
1926
|
+
| 484 | |
|
|
1927
|
+
| 485 | |
|
|
1928
|
+
| 486 | border-radius: 8px; |
|
|
1929
|
+
| 487 | |
|
|
1930
|
+
| 488 | } |
|
|
1931
|
+
| 489 | |
|
|
1932
|
+
| 490 | |
|
|
1933
|
+
| 491 | h1 { |
|
|
1934
|
+
| ::: | |
|
|
1935
|
+
| | |
|
|
1936
|
+
| | font-size: 18px; |
|
|
1937
|
+
| | |
|
|
1938
|
+
| | |
|
|
1939
|
+
| | text-align: center; |
|
|
1940
|
+
| | |
|
|
1941
|
+
| | |
|
|
1942
|
+
| | color: #007bff; |
|
|
1943
|
+
| | |
|
|
1944
|
+
| | } |
|
|
1945
|
+
| | |
|
|
1946
|
+
| | </style> |
|
|
1947
|
+
| | |
|
|
1948
|
+
| | </head> |
|
|
1949
|
+
| | |
|
|
1950
|
+
| | |
|
|
1951
|
+
| | <div class="container"> |
|
|
1952
|
+
| | |
|
|
1953
|
+
| | |
|
|
1954
|
+
| | <h1>Autenticaç&# |
|
|
1955
|
+
| | 227;o realizada com sucesso!</h1> |
|
|
1956
|
+
| | |
|
|
1957
|
+
| | A |
|
|
1958
|
+
| | guarde que esta página ser&# |
|
|
1959
|
+
| | 225; fechada automaticamente.<br> |
|
|
1960
|
+
| | |
|
|
1961
|
+
| | |
|
|
1962
|
+
| | Se isto não acontecer |
|
|
1963
|
+
| | , pode fechá-la manualmente. |
|
|
1964
|
+
| | |
|
|
1965
|
+
| | </div> |
|
|
1966
|
+
| | |
|
|
1967
|
+
| | </body></html> |
|
|
1968
|
+
| | |
|
|
1969
|
+
| | """) |
|
|
1970
|
+
| | else: |
|
|
1971
|
+
| | |
|
|
1972
|
+
| | self.wfile.write(b""" |
|
|
1973
|
+
| | |
|
|
1974
|
+
| | <!DOCTYPE html> |
|
|
1975
|
+
| | |
|
|
1976
|
+
| | <html lang="pt_BR"> |
|
|
1977
|
+
| | |
|
|
1978
|
+
| | <head> |
|
|
1979
|
+
| | |
|
|
1980
|
+
| | <meta charset="UTF-8"> |
|
|
1981
|
+
| | |
|
|
1982
|
+
| | <met |
|
|
1983
|
+
| | a name="viewport" content="width= |
|
|
1984
|
+
| | device-width, initial-scale=1.0"> |
|
|
1985
|
+
| | |
|
|
1986
|
+
| | <style> |
|
|
1987
|
+
| | |
|
|
1988
|
+
| | body { |
|
|
1989
|
+
| | |
|
|
1990
|
+
| | |
|
|
1991
|
+
| | font-family: 'Arial', sans-serif; |
|
|
1992
|
+
| | |
|
|
1993
|
+
| | |
|
|
1994
|
+
| | background-color: #f8f9fa; |
|
|
1995
|
+
| | |
|
|
1996
|
+
| | margin: 0; |
|
|
1997
|
+
| | |
|
|
1998
|
+
| | |
|
|
1999
|
+
| | font-size: 16px; |
|
|
2000
|
+
| | |
|
|
2001
|
+
| | |
|
|
2002
|
+
| | padding: 30px; |
|
|
2003
|
+
| | |
|
|
2004
|
+
| | |
|
|
2005
|
+
| | display: flex; * |
|
|
2006
|
+
| | |
|
|
2007
|
+
| | } |
|
|
2008
|
+
| | |
|
|
2009
|
+
| | |
|
|
2010
|
+
| | |
|
|
2011
|
+
| | .container { |
|
|
2012
|
+
| | |
|
|
2013
|
+
| | |
|
|
2014
|
+
| | width: 100%; |
|
|
2015
|
+
| | |
|
|
2016
|
+
| | |
|
|
2017
|
+
| | margin: auto; |
|
|
2018
|
+
| | |
|
|
2019
|
+
| | |
|
|
2020
|
+
| | background-color: #ffffff; |
|
|
2021
|
+
| | |
|
|
2022
|
+
| | box-sha |
|
|
2023
|
+
| | dow: 0 0 10px rgba(0, 0, 0, 0.1); |
|
|
2024
|
+
| | |
|
|
2025
|
+
| | |
|
|
2026
|
+
| | padding: 16px; |
|
|
2027
|
+
| | |
|
|
2028
|
+
| | |
|
|
2029
|
+
| | text-align: center; |
|
|
2030
|
+
| | |
|
|
2031
|
+
| | |
|
|
2032
|
+
| | font-size: 16px; |
|
|
2033
|
+
| | |
|
|
2034
|
+
| | |
|
|
2035
|
+
| | border-radius: 8px; |
|
|
2036
|
+
| | |
|
|
2037
|
+
| | } |
|
|
2038
|
+
| | |
|
|
2039
|
+
| | |
|
|
2040
|
+
| | h1 { |
|
|
2041
|
+
| | |
|
|
2042
|
+
| | |
|
|
2043
|
+
| | font-size: 18px; |
|
|
2044
|
+
| | |
|
|
2045
|
+
| | |
|
|
2046
|
+
| | text-align: center; |
|
|
2047
|
+
| | |
|
|
2048
|
+
| | |
|
|
2049
|
+
| | color: red; |
|
|
2050
|
+
| | |
|
|
2051
|
+
| | } |
|
|
2052
|
+
| | |
|
|
2053
|
+
| | </style> |
|
|
2054
|
+
| | |
|
|
2055
|
+
| | </head> |
|
|
2056
|
+
| | |
|
|
2057
|
+
| | |
|
|
2058
|
+
| | <div class="container"> |
|
|
2059
|
+
| | |
|
|
2060
|
+
| | <h1>Falh |
|
|
2061
|
+
| | a na autenticação!</h1> |
|
|
2062
|
+
| | |
|
|
2063
|
+
| | |
|
|
2064
|
+
| | Esta página ser&# |
|
|
2065
|
+
| | 225; fechada automaticamente.<br> |
|
|
2066
|
+
| | |
|
|
2067
|
+
| | |
|
|
2068
|
+
| | Se isto não acontecer |
|
|
2069
|
+
| | , pode fechá-la manualmente. |
|
|
2070
|
+
| | |
|
|
2071
|
+
| | </div> |
|
|
2072
|
+
| | |
|
|
2073
|
+
| | </body></html> |
|
|
2074
|
+
| | |
|
|
2075
|
+
| | """) |
|
|
2076
|
+
| | # |
|
|
2077
|
+
| | # |
|
|
2078
|
+
| | |
|
|
2079
|
+
| | # Inicializa o servidor HTTP |
|
|
2080
|
+
| | |
|
|
2081
|
+
| | self.server = HTTPServer( |
|
|
2082
|
+
| | ('localhost', 8000), AuthHandler) |
|
|
2083
|
+
| | |
|
|
2084
|
+
| | self.server.logger = self.logger |
|
|
2085
|
+
| | # Passa o logger para o servidor |
|
|
2086
|
+
| | |
|
|
2087
|
+
| | # Fun |
|
|
2088
|
+
| | ção para monitorar o tempo limite |
|
|
2089
|
+
| | |
|
|
2090
|
+
| | def monitor_timeout(): |
|
|
2091
|
+
| | |
|
|
2092
|
+
| | time.sleep(self.timeout) |
|
|
2093
|
+
| | if not h |
|
|
2094
|
+
| | asattr(self.server, 'auth_code'): |
|
|
2095
|
+
| | |
|
|
2096
|
+
| | self.response = "tempo limit |
|
|
2097
|
+
| | e para autenticação foi excedido" |
|
|
2098
|
+
| | |
|
|
2099
|
+
| | self.status_code = 490 |
|
|
2100
|
+
| | |
|
|
2101
|
+
| | self.logger.error(self.response) |
|
|
2102
|
+
| | |
|
|
2103
|
+
| | sys.stdout.close() |
|
|
2104
|
+
| | |
|
|
2105
|
+
| | sys.stderr.close() |
|
|
2106
|
+
| | |
|
|
2107
|
+
| | sys.stdout = original_stdout |
|
|
2108
|
+
| | |
|
|
2109
|
+
| | sys.stderr = original_stderr |
|
|
2110
|
+
| | print(f' |
|
|
2111
|
+
| | Código retorno: {self.status_code |
|
|
2112
|
+
| | } ', end='') ## self.status_code |
|
|
2113
|
+
| | = 200, usuário pertence ao grupo |
|
|
2114
|
+
| | informado. self.status_code = 299 |
|
|
2115
|
+
| | , grupo existe mas usuário NÃO pe |
|
|
2116
|
+
| | rtence à ele. Erros retornam 4xx. |
|
|
2117
|
+
| | |
|
|
2118
|
+
| | print(f'Resposta |
|
|
2119
|
+
| | : {self.response}', end='\n\n') |
|
|
2120
|
+
| | |
|
|
2121
|
+
| | print('Falha na a |
|
|
2122
|
+
| | utenticação! Execução abortada!') |
|
|
2123
|
+
| | driver.quit() |
|
|
2124
|
+
| | |
|
|
2125
|
+
| | self.server.server_close() |
|
|
2126
|
+
| | |
|
|
2127
|
+
| | os._exit(0) |
|
|
2128
|
+
| | # |
|
|
2129
|
+
| | # |
|
|
2130
|
+
| | # Inicia a thr |
|
|
2131
|
+
| | ead para monitorar o tempo limite |
|
|
2132
|
+
| | |
|
|
2133
|
+
| | timeout_thread = threadi |
|
|
2134
|
+
| | ng.Thread(target=monitor_timeout) |
|
|
2135
|
+
| | |
|
|
2136
|
+
| | timeout_thread.start() |
|
|
2137
|
+
| | |
|
|
2138
|
+
| | # |
|
|
2139
|
+
| | Espera pelo código de autorização |
|
|
2140
|
+
| | self.response = |
|
|
2141
|
+
| | "Esperando pela autenticação..." |
|
|
2142
|
+
| | |
|
|
2143
|
+
| | self.logger.info(self.response) |
|
|
2144
|
+
| | |
|
|
2145
|
+
| | self.server.handle_request() |
|
|
2146
|
+
| | |
|
|
2147
|
+
| | |
|
|
2148
|
+
| | # Restaura stdout e stderr |
|
|
2149
|
+
| | sys.stdout.close() |
|
|
2150
|
+
| | sys.stderr.close() |
|
|
2151
|
+
| | |
|
|
2152
|
+
| | sys.stdout = original_stdout |
|
|
2153
|
+
| | |
|
|
2154
|
+
| | sys.stderr = original_stderr |
|
|
2155
|
+
| | |
|
|
2156
|
+
| | # Ver |
|
|
2157
|
+
| | ifica se o código de autorização |
|
|
2158
|
+
| | foi obtido dentro do tempo limite |
|
|
2159
|
+
| | if not h |
|
|
2160
|
+
| | asattr(self.server, 'auth_code'): |
|
|
2161
|
+
| | return |
|
|
2162
|
+
| | |
|
|
2163
|
+
| | # Obté |
|
|
2164
|
+
| | m o código de autorização e o est |
|
|
2165
|
+
| | ado capturados pelo servidor HTTP |
|
|
2166
|
+
| | |
|
|
2167
|
+
| | auth_code = self.server.auth_code |
|
|
2168
|
+
| | |
|
|
2169
|
+
| | state = self.server.state |
|
|
2170
|
+
| | |
|
|
2171
|
+
| | # Ad |
|
|
2172
|
+
| | quire o token usando o código de |
|
|
2173
|
+
| | autorização, verificando o estado |
|
|
2174
|
+
| | try: |
|
|
2175
|
+
| | |
|
|
2176
|
+
| | result = app.acquire_ |
|
|
2177
|
+
| | token_by_auth_code_flow(flow, {"c |
|
|
2178
|
+
| | ode": auth_code, "state": state}) |
|
|
2179
|
+
| | |
|
|
2180
|
+
| | except ValueError as e: |
|
|
2181
|
+
| | |
|
|
2182
|
+
| | self.response = f"Erro |
|
|
2183
|
+
| | ao obter o token de acesso: {e}" |
|
|
2184
|
+
| | |
|
|
2185
|
+
| | self.status_code = 401 |
|
|
2186
|
+
| | |
|
|
2187
|
+
| | self.logger.error(self.response) |
|
|
2188
|
+
| | driver.quit() |
|
|
2189
|
+
| | return |
|
|
2190
|
+
| | |
|
|
2191
|
+
| | |
|
|
2192
|
+
| | if "access_token" in result: |
|
|
2193
|
+
| | acce |
|
|
2194
|
+
| | ss_token = result['access_token'] |
|
|
2195
|
+
| | headers = { |
|
|
2196
|
+
| | 'Authori |
|
|
2197
|
+
| | zation': 'Bearer ' + access_token |
|
|
2198
|
+
| | } |
|
|
2199
|
+
| | |
|
|
2200
|
+
| | # Obt |
|
|
2201
|
+
| | ém o email do usuário autenticado |
|
|
2202
|
+
| | |
|
|
2203
|
+
| | me_response = requests.get( |
|
|
2204
|
+
| | 'http |
|
|
2205
|
+
| | s://graph.microsoft.com/v1.0/me', |
|
|
2206
|
+
| | |
|
|
2207
|
+
| | headers=headers |
|
|
2208
|
+
| | ) |
|
|
2209
|
+
| | self.stat |
|
|
2210
|
+
| | us_code = me_response.status_code |
|
|
2211
|
+
| | i |
|
|
2212
|
+
| | f me_response.status_code == 200: |
|
|
2213
|
+
| | |
|
|
2214
|
+
| | me_data = me_response.json() |
|
|
2215
|
+
| | user_ema |
|
|
2216
|
+
| | il = me_data['userPrincipalName'] |
|
|
2217
|
+
| | |
|
|
2218
|
+
| | self.response = f"Email do u |
|
|
2219
|
+
| | suário autenticado: {user_email}" |
|
|
2220
|
+
| | |
|
|
2221
|
+
| | self.logger.info(self.response) |
|
|
2222
|
+
| | |
|
|
2223
|
+
| | # Verifi |
|
|
2224
|
+
| | ca se o usuário pertence ao grupo |
|
|
2225
|
+
| | |
|
|
2226
|
+
| | group_name = self.grupo |
|
|
2227
|
+
| | |
|
|
2228
|
+
| | |
|
|
2229
|
+
| | # Obtém o ID do usuário |
|
|
2230
|
+
| | |
|
|
2231
|
+
| | user_response = requests.get( |
|
|
2232
|
+
| | |
|
|
2233
|
+
| | f'https://graph.micros |
|
|
2234
|
+
| | oft.com/v1.0/users/{user_email}', |
|
|
2235
|
+
| | |
|
|
2236
|
+
| | headers=headers |
|
|
2237
|
+
| | ) |
|
|
2238
|
+
| | self.status |
|
|
2239
|
+
| | _code = user_response.status_code |
|
|
2240
|
+
| | if |
|
|
2241
|
+
| | user_response.status_code == 200: |
|
|
2242
|
+
| | |
|
|
2243
|
+
| | user_data = user_response.json() |
|
|
2244
|
+
| | |
|
|
2245
|
+
| | user_id = user_data['id'] |
|
|
2246
|
+
| | |
|
|
2247
|
+
| | |
|
|
2248
|
+
| | # Pesquisa o grupo pelo nome |
|
|
2249
|
+
| | |
|
|
2250
|
+
| | group_response = requests.get( |
|
|
2251
|
+
| | |
|
|
2252
|
+
| | f"https://graph |
|
|
2253
|
+
| | .microsoft.com/v1.0/groups?$filte |
|
|
2254
|
+
| | r=displayName eq '{group_name}'", |
|
|
2255
|
+
| | |
|
|
2256
|
+
| | headers=headers |
|
|
2257
|
+
| | ) |
|
|
2258
|
+
| | |
|
|
2259
|
+
| | self.status_ |
|
|
2260
|
+
| | code = group_response.status_code |
|
|
2261
|
+
| | if g |
|
|
2262
|
+
| | roup_response.status_code == 200: |
|
|
2263
|
+
| | g |
|
|
2264
|
+
| | roup_data = group_response.json() |
|
|
2265
|
+
| | |
|
|
2266
|
+
| | if 'value' in group_data |
|
|
2267
|
+
| | and len(group_data['value']) > 0: |
|
|
2268
|
+
| | |
|
|
2269
|
+
| | group_ |
|
|
2270
|
+
| | id = group_data['value'][0]['id'] |
|
|
2271
|
+
| | |
|
|
2272
|
+
| | |
|
|
2273
|
+
| | # Ve |
|
|
2274
|
+
| | rifica se o usuário está no grupo |
|
|
2275
|
+
| | |
|
|
2276
|
+
| | members_response = requests.get( |
|
|
2277
|
+
| | |
|
|
2278
|
+
| | f'https://graph.microsoft.com |
|
|
2279
|
+
| | /v1.0/groups/{group_id}/members', |
|
|
2280
|
+
| | |
|
|
2281
|
+
| | headers=headers |
|
|
2282
|
+
| | ) |
|
|
2283
|
+
| | |
|
|
2284
|
+
| | self.status_co |
|
|
2285
|
+
| | de = members_response.status_code |
|
|
2286
|
+
| | |
|
|
2287
|
+
| | if mem |
|
|
2288
|
+
| | bers_response.status_code == 200: |
|
|
2289
|
+
| | |
|
|
2290
|
+
| | membe |
|
|
2291
|
+
| | rs_data = members_response.json() |
|
|
2292
|
+
| | |
|
|
2293
|
+
| | if 'value' in members_data: |
|
|
2294
|
+
| | |
|
|
2295
|
+
| | user_in_group |
|
|
2296
|
+
| | = any(member['id'] == user_id for |
|
|
2297
|
+
| | member in members_data['value']) |
|
|
2298
|
+
| | |
|
|
2299
|
+
| | if user_in_group: |
|
|
2300
|
+
| | |
|
|
2301
|
+
| | self.respo |
|
|
2302
|
+
| | nse = f"O usuário {user_email} li |
|
|
2303
|
+
| | berado para uso desta aplicação." |
|
|
2304
|
+
| | |
|
|
2305
|
+
| | else: |
|
|
2306
|
+
| | |
|
|
2307
|
+
| | sel |
|
|
2308
|
+
| | f.response = f"O usuário {user_em |
|
|
2309
|
+
| | ail} NÃO liberado para uso desta |
|
|
2310
|
+
| | aplicação. Solicite acesso à TI." |
|
|
2311
|
+
| | |
|
|
2312
|
+
| | self.status_code = 299 |
|
|
2313
|
+
| | |
|
|
2314
|
+
| | else: |
|
|
2315
|
+
| | |
|
|
2316
|
+
| | self.r |
|
|
2317
|
+
| | esponse = "Resposta da API de mem |
|
|
2318
|
+
| | bros não contém a chave 'value'." |
|
|
2319
|
+
| | |
|
|
2320
|
+
| | self.status_code = 460 |
|
|
2321
|
+
| | |
|
|
2322
|
+
| | else: |
|
|
2323
|
+
| | |
|
|
2324
|
+
| | self.response = f"E |
|
|
2325
|
+
| | rro na resposta da API de membros |
|
|
2326
|
+
| | : {members_response.status_code}" |
|
|
2327
|
+
| | |
|
|
2328
|
+
| | self.response |
|
|
2329
|
+
| | += f"\n{members_response.json()}" |
|
|
2330
|
+
| | else: |
|
|
2331
|
+
| | |
|
|
2332
|
+
| | self.response = f"Grup |
|
|
2333
|
+
| | o '{group_name}' não encontrado." |
|
|
2334
|
+
| | |
|
|
2335
|
+
| | self.status_code = 470 |
|
|
2336
|
+
| | else: |
|
|
2337
|
+
| | |
|
|
2338
|
+
| | self.response = |
|
|
2339
|
+
| | f"Erro na resposta da API de grup |
|
|
2340
|
+
| | os: {group_response.status_code}" |
|
|
2341
|
+
| | |
|
|
2342
|
+
| | self.respons |
|
|
2343
|
+
| | e += f"\n{group_response.json()}" |
|
|
2344
|
+
| | else: |
|
|
2345
|
+
| | |
|
|
2346
|
+
| | self.response = |
|
|
2347
|
+
| | f"Erro na resposta da API de usuá |
|
|
2348
|
+
| | rio: {user_response.status_code}" |
|
|
2349
|
+
| | |
|
|
2350
|
+
| | self.respon |
|
|
2351
|
+
| | se += f"\n{user_response.json()}" |
|
|
2352
|
+
| | else: |
|
|
2353
|
+
| | |
|
|
2354
|
+
| | self.response = |
|
|
2355
|
+
| | f"Erro ao obter informações do us |
|
|
2356
|
+
| | uário: {me_response.status_code}" |
|
|
2357
|
+
| | self.resp |
|
|
2358
|
+
| | onse += f"\n{me_response.json()}" |
|
|
2359
|
+
| | else: |
|
|
2360
|
+
| | self.re |
|
|
2361
|
+
| | sponse = f"Erro ao obter o token |
|
|
2362
|
+
| | de acesso: {result.get('error')}" |
|
|
2363
|
+
| | |
|
|
2364
|
+
| | self.response += f"\n{ |
|
|
2365
|
+
| | result.get('error_description')}" |
|
|
2366
|
+
| | |
|
|
2367
|
+
| | self.status_code = 480 |
|
|
2368
|
+
| | |
|
|
2369
|
+
| | # Fecha o navegador |
|
|
2370
|
+
| | driver.quit() |
|
|
2371
|
+
| | service.stop() |
|
|
2372
|
+
| | |
|
|
2373
|
+
| | # Define o retorno |
|
|
2374
|
+
| | print(f'\n |
|
|
2375
|
+
| | Código retorno: {self.status_code |
|
|
2376
|
+
| | } ', end='') ## self.status_code |
|
|
2377
|
+
| | = 200, usuário pertence ao grupo |
|
|
2378
|
+
| | informado. self.status_code = 299 |
|
|
2379
|
+
| | , grupo existe mas usuário NÃO pe |
|
|
2380
|
+
| | rtence à ele. Erros retornam 4xx. |
|
|
2381
|
+
| | print(f'Resposta |
|
|
2382
|
+
| | : {self.response}', end='\n\n') |
|
|
2383
|
+
| | |
|
|
2384
|
+
| | if self.status_code == 200: |
|
|
2385
|
+
| | |
|
|
2386
|
+
| | print('Acesso autorizado!') |
|
|
2387
|
+
| | else: |
|
|
2388
|
+
| | print('Permissõe |
|
|
2389
|
+
| | s inválidas! Execução abortada!') |
|
|
2390
|
+
| | |
|
|
2391
|
+
| | os._exit(0) |
|
|
2392
|
+
| | # |
|
|
2393
|
+
| | # |
|
|
2394
|
+
| | def disclaimer(self |
|
|
2395
|
+
| | ): # Mostra o aviso do funcioname |
|
|
2396
|
+
| | nto e necessidade de autenticação |
|
|
2397
|
+
| | input(f""" |
|
|
2398
|
+
| | |
|
|
2399
|
+
| | Para ser utilizado d |
|
|
2400
|
+
| | e forma adequada e segura, este s |
|
|
2401
|
+
| | cript requer autenticação no Micr |
|
|
2402
|
+
| | osoft Entra ID (antiga Azure AD). |
|
|
2403
|
+
| | |
|
|
2404
|
+
| | Também requer que seu u |
|
|
2405
|
+
| | suário pertença a um grupo de seg |
|
|
2406
|
+
| | urança específico. Se você não te |
|
|
2407
|
+
| | m a segurança que tem permissão d |
|
|
2408
|
+
| | e uso, solicite previamente à TI. |
|
|
2409
|
+
| | |
|
|
2410
|
+
| | Para co |
|
|
2411
|
+
| | ntinuar, é necessário fornecer su |
|
|
2412
|
+
| | as credenciais, aquelas que costu |
|
|
2413
|
+
| | meiramente utiliza para acessar o |
|
|
2414
|
+
| | s serviços de e-mail corporativo. |
|
|
2415
|
+
| | |
|
|
2416
|
+
| | Uma janela de navegador será abe |
|
|
2417
|
+
| | rta e você será direcionado à tel |
|
|
2418
|
+
| | a de Logon do Microsoft Entra ID. |
|
|
2419
|
+
| | |
|
|
2420
|
+
| | Faça o Logon fornecendo usuário, |
|
|
2421
|
+
| | senha e validação de duplo fator |
|
|
2422
|
+
| | (no autenticador da Microsoft, i |
|
|
2423
|
+
| | nstalado em seu celular). |
|
|
2424
|
+
| | |
|
|
2425
|
+
| | Após a autenticação, a janela do |
|
|
2426
|
+
| | navegador será fechada e o script |
|
|
2427
|
+
| | iniciará o processo de execução. |
|
|
2428
|
+
| | |
|
|
2429
|
+
| | |
|
|
2430
|
+
| | Você tem {self.timeout} |
|
|
2431
|
+
| | segundos para realizar a autentic |
|
|
2432
|
+
| | ação ou a execução será abortada. |
|
|
2433
|
+
| | |
|
|
2434
|
+
| | |
|
|
2435
|
+
| | Tecle [ENTER] para continuar ... |
|
|
2436
|
+
| | |
|
|
2437
|
+
| | """) |
|
|
2438
|
+
| | |
|
|
2439
|
+
| | </div> |
|
|
2440
|
+
+-----------------------------------+-----------------------------------+
|
|
2441
|
+
:::
|
|
2442
|
+
|
|
2443
|
+
::: {.doc .doc-children}
|
|
2444
|
+
:::
|
|
2445
|
+
:::::
|
|
2446
|
+
::::::
|
|
2447
|
+
|
|
2448
|
+
:::::: {.doc .doc-object .doc-class}
|
|
2449
|
+
## `lbx_logger` {#lbxtoolkit.lbx_logger .doc .doc-heading}
|
|
2450
|
+
|
|
2451
|
+
::::: {.doc .doc-contents}
|
|
2452
|
+
###### Classe **lbx_logger** {#lbxtoolkit.lbx_logger--classe-lbx_logger}
|
|
2453
|
+
|
|
2454
|
+
Essa classe requer a importação do módulo `logging` no script em que for
|
|
2455
|
+
instanciada e tem o propósito de manipular/formatar as mensagens de
|
|
2456
|
+
saída do script, alterando o formato e redirecionando destino padrão
|
|
2457
|
+
(stdout e stderr) para uma combinação de tela e/ou arquivo.
|
|
2458
|
+
|
|
2459
|
+
O comportamento padrão é registrar todas as saídas *simultaneamente* em
|
|
2460
|
+
tela e no arquivo com endereço informado no parâmetro `log_file_path`.
|
|
2461
|
+
Se este parametro for omisso no instanciamento da classe, as mensagens
|
|
2462
|
+
serão exibidas apenas na tela.
|
|
2463
|
+
|
|
2464
|
+
A mensagens devem ser classificadas por grau de severidade/relevância,
|
|
2465
|
+
da menor para a maior, na seguinte ordem: *debug, info, warning (aviso),
|
|
2466
|
+
error (erro), critical (critico)*
|
|
2467
|
+
|
|
2468
|
+
A classificação do nível de serveridade da mensagem se dá pelo método
|
|
2469
|
+
escolhido para invocar a mensagem, correspondente aos níveis de
|
|
2470
|
+
severidade equivalentes.
|
|
2471
|
+
|
|
2472
|
+
A classe deve ser instanciada conforme sintaxe abaixo:
|
|
2473
|
+
|
|
2474
|
+
`lbx_logger(log_file_path=None, log_level=logging.DEBUG, formato_log='%(asctime)s - %(levelname)s - %(message)s', modulo=None, ignore_console=None, ignore_file=None):`
|
|
2475
|
+
|
|
2476
|
+
Todos os parametros são nominativos e facultativos. Em caso de omissão,
|
|
2477
|
+
os valores padrão são assumidos conforme o exemplo acima.
|
|
2478
|
+
|
|
2479
|
+
Os parametros para o instanciamento da classe são:
|
|
2480
|
+
|
|
2481
|
+
- `log_file_path` Define o caminho e o nome do arquivo de log. Se
|
|
2482
|
+
omisso, as mensagens serão todas direcionadas apenas para a tela.
|
|
2483
|
+
- `log_level` Define o nível mínimo de severidade das mensagens a
|
|
2484
|
+
serem manipuladas pelo logger. Se omisso, será assumido o nível mais
|
|
2485
|
+
baixo (*debug*). As mensagens com nível abaixo do especificado são
|
|
2486
|
+
descartadas. Os níveis devem ser informados de acordo com a sintaxe
|
|
2487
|
+
acima (prefixados com *logging.* e com o nome do nível em inglês e
|
|
2488
|
+
maiúsculas). Exemplo:
|
|
2489
|
+
- `logging.DEBUG` para manipular chamadas do método *.debug()* e
|
|
2490
|
+
acima.
|
|
2491
|
+
- `logging.INFO` para manipular chamadas do método *.info()* e acima.
|
|
2492
|
+
- `logging.WARNING` para manipular chamadas do método *.aviso()* e
|
|
2493
|
+
acima.
|
|
2494
|
+
- `logging.ERROR` para manipular chamadas do método *.erro()* e acima.
|
|
2495
|
+
- `logging.CRITICAL` para manipular chamadas do método *.critico()* e
|
|
2496
|
+
acima.
|
|
2497
|
+
- `formato_log` Define o formato em que a mensagem será apresentada.
|
|
2498
|
+
Se omisso, o padrá é *DATA_HORA - NIVEL - MENSAGEM*. Para maiores
|
|
2499
|
+
opções veja: [Atributos de
|
|
2500
|
+
log](https://docs.python.org/3/library/logging.html#logrecord-attributes)
|
|
2501
|
+
- `modulo` Nome do módulo para o qual os logs serão monitorados.
|
|
2502
|
+
Permite instanciar várias vezes a classe para criar manipuladores
|
|
2503
|
+
diferentes para módulos diferente. Informe o nome do módulo para
|
|
2504
|
+
criar um log específico para ele ou simplesmente omita o parametro
|
|
2505
|
+
para criar um log para o script em geral.
|
|
2506
|
+
- `ignore_console` Lista com os níveis de severidade a serem ignorados
|
|
2507
|
+
para *apresentação na tela*, registrando *apenas no arquivo* (quando
|
|
2508
|
+
informado no parametro `log_file_path`) e obedecendo ao nível mínimo
|
|
2509
|
+
estabelecido no parametro `log_level`. Note que omitir o parametro
|
|
2510
|
+
`log_file_path` e incluir um nível na lsita `ignore_console` implica
|
|
2511
|
+
em ignorar/suprimir esse nível de mensagem de qualquer apresentação.
|
|
2512
|
+
- `ignore_file` Mesma lógica do parametro `ignore_console`, mas com
|
|
2513
|
+
lógica invertida: suprime o registro do nível do arquivo e demonstra
|
|
2514
|
+
*apenas na tela*.
|
|
2515
|
+
|
|
2516
|
+
1\) As mensagem são manipuladas substituindo-se o comando `print()` pela
|
|
2517
|
+
chamada a um dos 5 métodos acima (*.add(), .debug(), .info(), .aviso(),
|
|
2518
|
+
.erro(), .critico()*). Exceto o método `.add()`, qualquer um dos demais
|
|
2519
|
+
métodos pode interromper a execução do script, através da passagem do
|
|
2520
|
+
parâmetro `exit`. Ao informar esse parametro na chamadada do método,
|
|
2521
|
+
atribua a ele o código de saída desejado (0 para normal, qualquer outro
|
|
2522
|
+
número para saída com erro). Exemplo:
|
|
2523
|
+
|
|
2524
|
+
log.erro('Essa mensagem apenas resulta em uma mensagem de nível ERROR')
|
|
2525
|
+
log.erro('Essa mensagem resulta em uma mensagem de nível ERRO e encerra o script com código de retorno -1', exit=-1)
|
|
2526
|
+
|
|
2527
|
+
Qualquer chamada ao comando `print()`, uma vez instanciado manipulador
|
|
2528
|
+
de log, será registada como uma chamada ao método *.info()* e registrada
|
|
2529
|
+
com este nível de severidade. Para retornar ao comportamente padrão do
|
|
2530
|
+
comando print, ou interromper o manipulador, faça chamada ao método
|
|
2531
|
+
`.stop_logging()`
|
|
2532
|
+
|
|
2533
|
+
2\) O método *.add()* não exibe/grava imediatamente a mensagem, mas
|
|
2534
|
+
apenas a diciona a *buffer*. Todas as chamas a *.add()* irão concatenar
|
|
2535
|
+
a mensagem recebida até a próxima chamada em algum dos níveis *.debug(),
|
|
2536
|
+
.info(), .aviso(), .erro(), .critico()*. Na primeira chama de um destes
|
|
2537
|
+
níveis após uma (ou mais) chamada(s) ao método *.add()* o *buffer* será
|
|
2538
|
+
concatenado à mensagem recebida por um destes métodos e o resultado será
|
|
2539
|
+
manipulado pelo log conforme os parametros definidos no intanciamento da
|
|
2540
|
+
classe e o método chamado. Essa função é útil para tratar mensagens com
|
|
2541
|
+
retorno condicional. Exemplo:
|
|
2542
|
+
|
|
2543
|
+
log.add('Mensagem 1# ') ## não será exibida/registrada
|
|
2544
|
+
log.add('Mensagem 2# ') ## não será exibida/registrada
|
|
2545
|
+
log.info('Mensagem 3) ## será exibida/registrada como nível "info" e com texto: "Mensagem 1# Mensagem 2# Mensagem 3"
|
|
2546
|
+
|
|
2547
|
+
3\) Os métodos que exibem as mensagens (`.debug()`,`.info()`,`.aviso()`,
|
|
2548
|
+
`.erro()`, `.critico()`) possuem 3 parametros: `message`, `corte=None`,
|
|
2549
|
+
`exit=None`.
|
|
2550
|
+
|
|
2551
|
+
- `message`: posicional e obrigatório. corresponde à mensagem a ser
|
|
2552
|
+
exibida
|
|
2553
|
+
- `corte`: o tamanho máximo da mensagem a ser exibida. opcional e se
|
|
2554
|
+
omitido, exibe a mensagem inteira. se fornecido, corta a mensagem no
|
|
2555
|
+
comprimento informado
|
|
2556
|
+
- `exit`: opcional. se informado (requer um código de retorno), aborta
|
|
2557
|
+
o script com o código informado. se omisso (padrão) a mensagem
|
|
2558
|
+
apenas é minutada pelo log, sem interferir no funcionamento do
|
|
2559
|
+
script
|
|
2560
|
+
|
|
2561
|
+
4\) O método `.filtra()` possui 3 parametros posicionais, todos
|
|
2562
|
+
opcionais: `log_file`, `dh_ini`, `dh_fim`.
|
|
2563
|
+
|
|
2564
|
+
Se os 3 forem omitidos, serão exibidas as entradas de log do arquivo
|
|
2565
|
+
corrente, definido no instanciamento da classe `lbx_logger`, registradas
|
|
2566
|
+
na última hora. Deste modo, o valor padrão para `dh_fim` é `now()` e
|
|
2567
|
+
para `dh_ini` é `now()` menos 1 hora.
|
|
2568
|
+
|
|
2569
|
+
Caso queira filtrar os registro de outro arquivo de log, que não seja o
|
|
2570
|
+
do script corrente, informe o endereço do arquivo no primeiro parametro.
|
|
2571
|
+
|
|
2572
|
+
E caso queira alterar alterar o período de filtragem, informe nos
|
|
2573
|
+
parametros 2 e 3 a data/hora de início e fim do período. Estes dois
|
|
2574
|
+
parametros aceitam tanto um objeto do tipo `datetime` como uma string
|
|
2575
|
+
(que será convertida para datetime), desde que ela esteja no formato
|
|
2576
|
+
`dd/mm/aaaa hh:mm:[ss]` (segundos são opcionais).
|
|
2577
|
+
|
|
2578
|
+
Considerando que os parametros são posicionais, caso queira omitir
|
|
2579
|
+
apenas um dos parametros, preencha a posição do parametro a ser omitido
|
|
2580
|
+
com `None`.
|
|
2581
|
+
|
|
2582
|
+
A saída dessa função retorna um objeto, que pode ser salvo em disco ou
|
|
2583
|
+
impresso na tela.
|
|
2584
|
+
|
|
2585
|
+
5\) Exemplos de uso:
|
|
2586
|
+
|
|
2587
|
+
from lbx_toolkit import lbx_logger
|
|
2588
|
+
import logging
|
|
2589
|
+
import os
|
|
2590
|
+
from pathlib import Path
|
|
2591
|
+
|
|
2592
|
+
DirBase = Path('./') # diretório corrente do script
|
|
2593
|
+
BaseName = os.path.splitext(os.path.basename(__file__))[0] # nome do script sem extensão
|
|
2594
|
+
LogFile = Path(DirBase, BaseName + '.log') # salva logs no diretório corrente, em um arquivo nomeado com nome do script + extensão ".log"
|
|
2595
|
+
|
|
2596
|
+
### instancia o manipulador para tratar todas as mensagens (nível DEBUG acima),
|
|
2597
|
+
# mas suprime a apresentação em tela das mensagens de nível "DEBUG" na tela,
|
|
2598
|
+
# apenas registrando-as somente no arquivo
|
|
2599
|
+
# e sumprime o registro no arquivo das mensagens de nível "ERROR",
|
|
2600
|
+
# mostrando-as apenas na tela
|
|
2601
|
+
log = lbx_logger(LogFile, logging.DEBUG, ignore_console=[logging.DEBUG], ignore_file=[logging.ERROR])
|
|
2602
|
+
|
|
2603
|
+
# Exemplo de mensagens de log
|
|
2604
|
+
log.debug('Esta é uma mensagem de debug')
|
|
2605
|
+
log.info('Esta é uma mensagem informativa')
|
|
2606
|
+
log.add('Esta mensagem não será exibida agora, mas acumulada no buffer# ')
|
|
2607
|
+
log.aviso('Esta é uma mensagem de aviso')
|
|
2608
|
+
log.erro('Esta é uma mensagem de erro')
|
|
2609
|
+
log.erro('Esta é uma mensagem erro muito comprida e será limitada a 40 caracteres, o restante será cortado e ingorado ao ser manipulado', 40)
|
|
2610
|
+
log.critico('Esta é uma mensagem crítica')
|
|
2611
|
+
|
|
2612
|
+
# Exemplo de função que gera uma exceção
|
|
2613
|
+
def funcao_com_erro():
|
|
2614
|
+
raise ValueError('Este é um erro de exemplo')
|
|
2615
|
+
|
|
2616
|
+
# Testando redirecionamento de print e captura de exceção
|
|
2617
|
+
print('Mensagem de teste via print')
|
|
2618
|
+
try:
|
|
2619
|
+
funcao_com_erro()
|
|
2620
|
+
except Exception as e:
|
|
2621
|
+
print(f'Capturado um erro: {e}')
|
|
2622
|
+
|
|
2623
|
+
log.erro('Essa é uma mensagem de erro e abortará a execução do script', exit=1)
|
|
2624
|
+
|
|
2625
|
+
log.info('Essa mensagem não será exibida pois o script foi abortado na mensagem anterior')
|
|
2626
|
+
|
|
2627
|
+
# obtem os registros de log da última hora (comportamento padrão)
|
|
2628
|
+
filtra_log = log.search()
|
|
2629
|
+
|
|
2630
|
+
# obtem os registros das últimas 6 horas
|
|
2631
|
+
ultimas_6h = datetime.datetime.now() - datetime.timedelta(hours=6) ## carimbo de tempo de 6 horas atrás !!! requer>> import datetime
|
|
2632
|
+
filtra_log = log.search(None, ultimas_6h) # None no 1º parametro impõe o log do arquivo corrente como padrão (definido em 'LogFile' e apontado no instanciamento da classe)
|
|
2633
|
+
|
|
2634
|
+
# obtem os registros do dia 14/01/2020 até 3h atrás
|
|
2635
|
+
ultimas_3h = datetime.datetime.now() - datetime.timedelta(hours=3) ## carimbo de tempo de 6 horas atrás !!! requer>> import datetime
|
|
2636
|
+
filtra_log = log.search(None, '14/01/2020 00:00', ultimas_3h) #
|
|
2637
|
+
|
|
2638
|
+
# obtem os registros do horário comercial do dia 23/12/2023 do arquivo salvo em C:\temp\outro_arquivo.log
|
|
2639
|
+
Outro_Log = Path(r'c:\temp\outro_arquivo.log')
|
|
2640
|
+
filtra_log = log.search(Outro_Log, '23/12/2023 08:00', '23/12/2023 18:00') #
|
|
2641
|
+
|
|
2642
|
+
# salva conteúdo filtrado em um arquivo:
|
|
2643
|
+
filtrado = 'filtered_log.txt'
|
|
2644
|
+
with open(filtado, 'w', encoding='ISO-8859-1') as output_file: # indique o enconding conforme salvo (UTF-8 ou ISO-8859-1)
|
|
2645
|
+
output_file.writelines(filta_log)
|
|
2646
|
+
|
|
2647
|
+
# mostra o conteúdo filtrado na tela
|
|
2648
|
+
print(''.join(filtra_log))
|
|
2649
|
+
|
|
2650
|
+
# mostra o conteúdo filtrado na tela, listando apenas as os registros do nível "DEBUG"
|
|
2651
|
+
for line in filtered_lines:
|
|
2652
|
+
if "DEBUG" in line:
|
|
2653
|
+
print(line, end='')
|
|
2654
|
+
|
|
2655
|
+
Source code in `lbxtoolkit\__init__.py`
|
|
2656
|
+
|
|
2657
|
+
::: highlight
|
|
2658
|
+
+-----------------------------------+-----------------------------------+
|
|
2659
|
+
| ::: linenodiv | <div> |
|
|
2660
|
+
| 906 | |
|
|
2661
|
+
| 907 | class lbx_logger: # Class |
|
|
2662
|
+
| 908 | e para gerenciar a saída para log |
|
|
2663
|
+
| 909 | r""" |
|
|
2664
|
+
| 910 | |
|
|
2665
|
+
| 911 | #### Classe **lbx_logger** |
|
|
2666
|
+
| 912 | |
|
|
2667
|
+
| 913 | Essa |
|
|
2668
|
+
| 914 | classe requer a importação do mód |
|
|
2669
|
+
| 915 | ulo `logging` no script em que fo |
|
|
2670
|
+
| 916 | r instanciada e tem o propósito d |
|
|
2671
|
+
| 917 | e manipular/formatar as mensagens |
|
|
2672
|
+
| 918 | de saída do script, alterando o |
|
|
2673
|
+
| 919 | formato e redirecionando destino |
|
|
2674
|
+
| 920 | padrão (stdout e stderr) para uma |
|
|
2675
|
+
| 921 | combinação de tela e/ou arquivo. |
|
|
2676
|
+
| 922 | |
|
|
2677
|
+
| 923 | O comportamen |
|
|
2678
|
+
| 924 | to padrão é registrar todas as sa |
|
|
2679
|
+
| 925 | ídas *simultaneamente* em tela e |
|
|
2680
|
+
| 926 | no arquivo com endereço informado |
|
|
2681
|
+
| 927 | no parâmetro `log_file_path`. Se |
|
|
2682
|
+
| 928 | este parametro for omisso no ins |
|
|
2683
|
+
| 929 | tanciamento da classe, as mensage |
|
|
2684
|
+
| 930 | ns serão exibidas apenas na tela. |
|
|
2685
|
+
| 931 | |
|
|
2686
|
+
| 932 | A mensagens |
|
|
2687
|
+
| 933 | devem ser classificadas por grau |
|
|
2688
|
+
| 934 | de severidade/relevância, da meno |
|
|
2689
|
+
| 935 | r para a maior, na seguinte ordem |
|
|
2690
|
+
| 936 | : *debug, info, warning (aviso), |
|
|
2691
|
+
| 937 | error (erro), critical (critico)* |
|
|
2692
|
+
| 938 | |
|
|
2693
|
+
| 939 | |
|
|
2694
|
+
| 940 | A classificação do nível d |
|
|
2695
|
+
| 941 | e serveridade da mensagem se dá p |
|
|
2696
|
+
| 942 | elo método escolhido para invocar |
|
|
2697
|
+
| 943 | a mensagem, correspondente aos n |
|
|
2698
|
+
| 944 | íveis de severidade equivalentes. |
|
|
2699
|
+
| 945 | |
|
|
2700
|
+
| 946 | A classe deve ser ins |
|
|
2701
|
+
| 947 | tanciada conforme sintaxe abaixo: |
|
|
2702
|
+
| 948 | |
|
|
2703
|
+
| 949 | `l |
|
|
2704
|
+
| 950 | bx_logger(log_file_path=None, log |
|
|
2705
|
+
| 951 | _level=logging.DEBUG, formato_log |
|
|
2706
|
+
| 952 | ='%(asctime)s - %(levelname)s - % |
|
|
2707
|
+
| 953 | (message)s', modulo=None, ignore_ |
|
|
2708
|
+
| 954 | console=None, ignore_file=None):` |
|
|
2709
|
+
| 955 | |
|
|
2710
|
+
| 956 | |
|
|
2711
|
+
| 957 | Todos os parametros são nomina |
|
|
2712
|
+
| 958 | tivos e facultativos. Em caso de |
|
|
2713
|
+
| 959 | omissão, os valores padrão são as |
|
|
2714
|
+
| 960 | sumidos conforme o exemplo acima. |
|
|
2715
|
+
| 961 | |
|
|
2716
|
+
| 962 | Os parametros par |
|
|
2717
|
+
| 963 | a o instanciamento da classe são: |
|
|
2718
|
+
| 964 | |
|
|
2719
|
+
| 965 | |
|
|
2720
|
+
| 966 | - `log_file_path` Define o camin |
|
|
2721
|
+
| 967 | ho e o nome do arquivo de log. Se |
|
|
2722
|
+
| 968 | omisso, as mensagens serão todas |
|
|
2723
|
+
| 969 | direcionadas apenas para a tela. |
|
|
2724
|
+
| 970 | |
|
|
2725
|
+
| 971 | - `log_level` Define o nível |
|
|
2726
|
+
| 972 | mínimo de severidade das mensagen |
|
|
2727
|
+
| 973 | s a serem manipuladas pelo logger |
|
|
2728
|
+
| 974 | . Se omisso, será assumido o níve |
|
|
2729
|
+
| 975 | l mais baixo (_debug_). As mensag |
|
|
2730
|
+
| 976 | ens com nível abaixo do especific |
|
|
2731
|
+
| 977 | ado são descartadas. Os níveis de |
|
|
2732
|
+
| 978 | vem ser informados de acordo com |
|
|
2733
|
+
| 979 | a sintaxe acima (prefixados com _ |
|
|
2734
|
+
| 980 | logging._ e com o nome do nível e |
|
|
2735
|
+
| 981 | m inglês e maiúsculas). Exemplo: |
|
|
2736
|
+
| 982 | - `lo |
|
|
2737
|
+
| 983 | gging.DEBUG` para manipular chama |
|
|
2738
|
+
| 984 | das do método *.debug()* e acima. |
|
|
2739
|
+
| 985 | - ` |
|
|
2740
|
+
| 986 | logging.INFO` para manipular cham |
|
|
2741
|
+
| 987 | adas do método *.info()* e acima. |
|
|
2742
|
+
| 988 | - `logg |
|
|
2743
|
+
| 989 | ing.WARNING` para manipular chama |
|
|
2744
|
+
| 990 | das do método *.aviso()* e acima. |
|
|
2745
|
+
| 991 | - `l |
|
|
2746
|
+
| 992 | ogging.ERROR` para manipular cham |
|
|
2747
|
+
| 993 | adas do método *.erro()* e acima. |
|
|
2748
|
+
| 994 | - `logging.CRITICA |
|
|
2749
|
+
| 995 | L` para manipular chamadas do mét |
|
|
2750
|
+
| 996 | odo *.critico()* e acima. |
|
|
2751
|
+
| 997 | - `f |
|
|
2752
|
+
| 998 | ormato_log` Define o formato em q |
|
|
2753
|
+
| 999 | ue a mensagem será apresentada. S |
|
|
2754
|
+
| 1000 | e omisso, o padrá é *DATA_HORA - |
|
|
2755
|
+
| 1001 | NIVEL - MENSAGEM*. Para maiores o |
|
|
2756
|
+
| 1002 | pções veja: [Atributos de log](ht |
|
|
2757
|
+
| 1003 | tps://docs.python.org/3/library/l |
|
|
2758
|
+
| 1004 | ogging.html#logrecord-attributes) |
|
|
2759
|
+
| 1005 | - `modu |
|
|
2760
|
+
| 1006 | lo` Nome do módulo para o qual os |
|
|
2761
|
+
| 1007 | logs serão monitorados. Permite |
|
|
2762
|
+
| 1008 | instanciar várias vezes a classe |
|
|
2763
|
+
| 1009 | para criar manipuladores diferent |
|
|
2764
|
+
| 1010 | es para módulos diferente. Inform |
|
|
2765
|
+
| 1011 | e o nome do módulo para criar um |
|
|
2766
|
+
| 1012 | log específico para ele ou simple |
|
|
2767
|
+
| 1013 | smente omita o parametro para cri |
|
|
2768
|
+
| 1014 | ar um log para o script em geral. |
|
|
2769
|
+
| 1015 | - `ignore_console |
|
|
2770
|
+
| 1016 | ` Lista com os níveis de severida |
|
|
2771
|
+
| 1017 | de a serem ignorados para *aprese |
|
|
2772
|
+
| 1018 | ntação na tela*, registrando *ape |
|
|
2773
|
+
| 1019 | nas no arquivo* (quando informado |
|
|
2774
|
+
| 1020 | no parametro `log_file_path`) e |
|
|
2775
|
+
| 1021 | obedecendo ao nível mínimo estabe |
|
|
2776
|
+
| 1022 | lecido no parametro `log_level`. |
|
|
2777
|
+
| 1023 | Note que omitir o parametro `log_ |
|
|
2778
|
+
| 1024 | file_path` e incluir um nível na |
|
|
2779
|
+
| 1025 | lsita `ignore_console` implica em |
|
|
2780
|
+
| 1026 | ignorar/suprimir esse nível de m |
|
|
2781
|
+
| 1027 | ensagem de qualquer apresentação. |
|
|
2782
|
+
| 1028 | - `ignore_file` Mesma |
|
|
2783
|
+
| 1029 | lógica do parametro `ignore_conso |
|
|
2784
|
+
| 1030 | le`, mas com lógica invertida: su |
|
|
2785
|
+
| 1031 | prime o registro do nível do arqu |
|
|
2786
|
+
| 1032 | ivo e demonstra *apenas na tela*. |
|
|
2787
|
+
| 1033 | |
|
|
2788
|
+
| 1034 | 1) |
|
|
2789
|
+
| 1035 | As mensagem são manipuladas subs |
|
|
2790
|
+
| 1036 | tituindo-se o comando `print()` p |
|
|
2791
|
+
| 1037 | ela chamada a um dos 5 métodos ac |
|
|
2792
|
+
| 1038 | ima (_.add(), .debug(), .info(), |
|
|
2793
|
+
| 1039 | .aviso(), .erro(), .critico()_). |
|
|
2794
|
+
| 1040 | Exceto o método `.add()`, qualque |
|
|
2795
|
+
| 1041 | r um dos demais métodos pode inte |
|
|
2796
|
+
| 1042 | rromper a execução do script, atr |
|
|
2797
|
+
| 1043 | avés da passagem do parâmetro `ex |
|
|
2798
|
+
| 1044 | it`. Ao informar esse parametro n |
|
|
2799
|
+
| 1045 | a chamadada do método, atribua a |
|
|
2800
|
+
| 1046 | ele o código de saída desejado (0 |
|
|
2801
|
+
| 1047 | para normal, qualquer outro núme |
|
|
2802
|
+
| 1048 | ro para saída com erro). Exemplo: |
|
|
2803
|
+
| 1049 | |
|
|
2804
|
+
| 1050 | ``` |
|
|
2805
|
+
| 1051 | log.e |
|
|
2806
|
+
| 1052 | rro('Essa mensagem apenas resulta |
|
|
2807
|
+
| 1053 | em uma mensagem de nível ERROR') |
|
|
2808
|
+
| 1054 | log.erro('Essa me |
|
|
2809
|
+
| 1055 | nsagem resulta em uma mensagem de |
|
|
2810
|
+
| 1056 | nível ERRO e encerra o script co |
|
|
2811
|
+
| 1057 | m código de retorno -1', exit=-1) |
|
|
2812
|
+
| 1058 | ``` |
|
|
2813
|
+
| 1059 | |
|
|
2814
|
+
| 1060 | Qualquer |
|
|
2815
|
+
| 1061 | chamada ao comando `print()`, uma |
|
|
2816
|
+
| 1062 | vez instanciado manipulador de l |
|
|
2817
|
+
| 1063 | og, será registada como uma chama |
|
|
2818
|
+
| 1064 | da ao método _.info()_ e registra |
|
|
2819
|
+
| 1065 | da com este nível de severidade. |
|
|
2820
|
+
| 1066 | |
|
|
2821
|
+
| 1067 | Para retornar ao comportame |
|
|
2822
|
+
| 1068 | nte padrão do comando print, ou i |
|
|
2823
|
+
| 1069 | nterromper o manipulador, faça ch |
|
|
2824
|
+
| 1070 | amada ao método `.stop_logging()` |
|
|
2825
|
+
| 1071 | |
|
|
2826
|
+
| 1072 | 2) O méto |
|
|
2827
|
+
| 1073 | do _.add()_ não exibe/grava imedi |
|
|
2828
|
+
| 1074 | atamente a mensagem, mas apenas a |
|
|
2829
|
+
| 1075 | diciona a _buffer_. Todas as cha |
|
|
2830
|
+
| 1076 | mas a _.add()_ irão concatenar a |
|
|
2831
|
+
| 1077 | mensagem recebida até a próxima c |
|
|
2832
|
+
| 1078 | hamada em algum dos níveis _.debu |
|
|
2833
|
+
| 1079 | g(), .info(), .aviso(), .erro(), |
|
|
2834
|
+
| 1080 | .critico()_. Na primeira chama de |
|
|
2835
|
+
| 1081 | um destes níveis após uma (ou ma |
|
|
2836
|
+
| 1082 | is) chamada(s) ao método _.add()_ |
|
|
2837
|
+
| 1083 | o *buffer* será concatenado à me |
|
|
2838
|
+
| 1084 | nsagem recebida por um destes mét |
|
|
2839
|
+
| 1085 | odos e o resultado será manipulad |
|
|
2840
|
+
| 1086 | o pelo log conforme os parametros |
|
|
2841
|
+
| 1087 | definidos no intanciamento da cl |
|
|
2842
|
+
| 1088 | asse e o método chamado. Essa fun |
|
|
2843
|
+
| 1089 | ção é útil para tratar mensagens |
|
|
2844
|
+
| 1090 | com retorno condicional. Exemplo: |
|
|
2845
|
+
| 1091 | |
|
|
2846
|
+
| 1092 | ``` |
|
|
2847
|
+
| 1093 | log.add('Mensagem 1# |
|
|
2848
|
+
| 1094 | ') ## não será exibida/registrada |
|
|
2849
|
+
| 1095 | log.add('Mensagem 2# |
|
|
2850
|
+
| 1096 | ') ## não será exibida/registrada |
|
|
2851
|
+
| 1097 | log.info('Mensage |
|
|
2852
|
+
| 1098 | m 3) ## será exibida/registrada c |
|
|
2853
|
+
| 1099 | omo nível "info" e com texto: "Me |
|
|
2854
|
+
| 1100 | nsagem 1# Mensagem 2# Mensagem 3" |
|
|
2855
|
+
| 1101 | ``` |
|
|
2856
|
+
| 1102 | |
|
|
2857
|
+
| 1103 | 3) Os métodos que exibem |
|
|
2858
|
+
| 1104 | as mensagens (`.debug()`,`.info( |
|
|
2859
|
+
| 1105 | )`,`.aviso()`, `.erro()`, `.criti |
|
|
2860
|
+
| 1106 | co()`) possuem 3 parametros: `mes |
|
|
2861
|
+
| 1107 | sage`, `corte=None`, `exit=None`. |
|
|
2862
|
+
| 1108 | |
|
|
2863
|
+
| 1109 | - `messag |
|
|
2864
|
+
| 1110 | e`: posicional e obrigatório. cor |
|
|
2865
|
+
| 1111 | responde à mensagem a ser exibida |
|
|
2866
|
+
| 1112 | |
|
|
2867
|
+
| 1113 | - `corte`: o tamanho máximo |
|
|
2868
|
+
| 1114 | da mensagem a ser exibida. opcio |
|
|
2869
|
+
| 1115 | nal e se omitido, exibe a mensage |
|
|
2870
|
+
| 1116 | m inteira. se fornecido, corta a |
|
|
2871
|
+
| 1117 | mensagem no comprimento informado |
|
|
2872
|
+
| 1118 | - `ex |
|
|
2873
|
+
| 1119 | it`: opcional. se informado (requ |
|
|
2874
|
+
| 1120 | er um código de retorno), aborta |
|
|
2875
|
+
| 1121 | o script com o código informado. |
|
|
2876
|
+
| 1122 | se omisso (padrão) a mensagem ape |
|
|
2877
|
+
| 1123 | nas é minutada pelo log, sem inte |
|
|
2878
|
+
| 1124 | rferir no funcionamento do script |
|
|
2879
|
+
| 1125 | |
|
|
2880
|
+
| 1126 | 4) O m |
|
|
2881
|
+
| 1127 | étodo `.filtra()` possui 3 parame |
|
|
2882
|
+
| 1128 | tros posicionais, todos opcionais |
|
|
2883
|
+
| 1129 | : `log_file`, `dh_ini`, `dh_fim`. |
|
|
2884
|
+
| 1130 | |
|
|
2885
|
+
| 1131 | Se os 3 forem omit |
|
|
2886
|
+
| 1132 | idos, serão exibidas as entradas |
|
|
2887
|
+
| 1133 | de log do arquivo corrente, defin |
|
|
2888
|
+
| 1134 | ido no instanciamento da classe ` |
|
|
2889
|
+
| 1135 | lbx_logger`, registradas na últim |
|
|
2890
|
+
| 1136 | a hora. Deste modo, o valor padrã |
|
|
2891
|
+
| 1137 | o para `dh_fim` é `now()` e para |
|
|
2892
|
+
| 1138 | `dh_ini` é `now()` menos 1 hora. |
|
|
2893
|
+
| 1139 | |
|
|
2894
|
+
| 1140 | Caso queira |
|
|
2895
|
+
| 1141 | filtrar os registro de outro arqu |
|
|
2896
|
+
| 1142 | ivo de log, que não seja o do scr |
|
|
2897
|
+
| 1143 | ipt corrente, informe o endereço |
|
|
2898
|
+
| 1144 | do arquivo no primeiro parametro. |
|
|
2899
|
+
| 1145 | |
|
|
2900
|
+
| 1146 | E caso queira alterar alt |
|
|
2901
|
+
| 1147 | erar o período de filtragem, info |
|
|
2902
|
+
| 1148 | rme nos parametros 2 e 3 a data/h |
|
|
2903
|
+
| 1149 | ora de início e fim do período. E |
|
|
2904
|
+
| 1150 | stes dois parametros aceitam tant |
|
|
2905
|
+
| 1151 | o um objeto do tipo `datetime` co |
|
|
2906
|
+
| 1152 | mo uma string (que será convertid |
|
|
2907
|
+
| 1153 | a para datetime), desde que ela e |
|
|
2908
|
+
| 1154 | steja no formato `dd/mm/aaaa hh:m |
|
|
2909
|
+
| 1155 | m:[ss]` (segundos são opcionais). |
|
|
2910
|
+
| 1156 | |
|
|
2911
|
+
| 1157 | Considerando que o |
|
|
2912
|
+
| 1158 | s parametros são posicionais, cas |
|
|
2913
|
+
| 1159 | o queira omitir apenas um dos par |
|
|
2914
|
+
| 1160 | ametros, preencha a posição do pa |
|
|
2915
|
+
| 1161 | rametro a ser omitido com `None`. |
|
|
2916
|
+
| 1162 | |
|
|
2917
|
+
| 1163 | A saída dessa função r |
|
|
2918
|
+
| 1164 | etorna um objeto, que pode ser sa |
|
|
2919
|
+
| 1165 | lvo em disco ou impresso na tela. |
|
|
2920
|
+
| 1166 | |
|
|
2921
|
+
| 1167 | |
|
|
2922
|
+
| 1168 | 5) Exemplos de uso: |
|
|
2923
|
+
| 1169 | |
|
|
2924
|
+
| 1170 | ``` |
|
|
2925
|
+
| 1171 | fr |
|
|
2926
|
+
| 1172 | om lbx_toolkit import lbx_logger |
|
|
2927
|
+
| 1173 | import logging |
|
|
2928
|
+
| 1174 | import os |
|
|
2929
|
+
| 1175 | from pathlib import Path |
|
|
2930
|
+
| 1176 | |
|
|
2931
|
+
| 1177 | DirBase = Path('./' |
|
|
2932
|
+
| 1178 | ) # diretório corrente do script |
|
|
2933
|
+
| 1179 | BaseName = os.path.spl |
|
|
2934
|
+
| 1180 | itext(os.path.basename(__file__)) |
|
|
2935
|
+
| 1181 | [0] # nome do script sem extensão |
|
|
2936
|
+
| 1182 | LogFi |
|
|
2937
|
+
| 1183 | le = Path(DirBase, BaseName + '.l |
|
|
2938
|
+
| 1184 | og') # salva logs no diretório co |
|
|
2939
|
+
| 1185 | rrente, em um arquivo nomeado com |
|
|
2940
|
+
| 1186 | nome do script + extensão ".log" |
|
|
2941
|
+
| 1187 | |
|
|
2942
|
+
| 1188 | ### instancia |
|
|
2943
|
+
| 1189 | o manipulador para tratar todas a |
|
|
2944
|
+
| 1190 | s mensagens (nível DEBUG acima), |
|
|
2945
|
+
| 1191 | # mas supri |
|
|
2946
|
+
| 1192 | me a apresentação em tela das men |
|
|
2947
|
+
| 1193 | sagens de nível "DEBUG" na tela, |
|
|
2948
|
+
| 1194 | # apenas |
|
|
2949
|
+
| 1195 | registrando-as somente no arquivo |
|
|
2950
|
+
| 1196 | # |
|
|
2951
|
+
| 1197 | e sumprime o registro no arquivo |
|
|
2952
|
+
| 1198 | das mensagens de nível "ERROR", |
|
|
2953
|
+
| 1199 | |
|
|
2954
|
+
| 1200 | # mostrando-as apenas na tela |
|
|
2955
|
+
| 1201 | log |
|
|
2956
|
+
| 1202 | = lbx_logger(LogFile, logging.DE |
|
|
2957
|
+
| 1203 | BUG, ignore_console=[logging.DEBU |
|
|
2958
|
+
| 1204 | G], ignore_file=[logging.ERROR]) |
|
|
2959
|
+
| 1205 | |
|
|
2960
|
+
| 1206 | |
|
|
2961
|
+
| 1207 | # Exemplo de mensagens de log |
|
|
2962
|
+
| 1208 | log.debug |
|
|
2963
|
+
| 1209 | ('Esta é uma mensagem de debug') |
|
|
2964
|
+
| 1210 | log.info(' |
|
|
2965
|
+
| 1211 | Esta é uma mensagem informativa') |
|
|
2966
|
+
| 1212 | log.add( |
|
|
2967
|
+
| 1213 | 'Esta mensagem não será exibida a |
|
|
2968
|
+
| 1214 | gora, mas acumulada no buffer# ') |
|
|
2969
|
+
| 1215 | log.avis |
|
|
2970
|
+
| 1216 | o('Esta é uma mensagem de aviso') |
|
|
2971
|
+
| 1217 | log.er |
|
|
2972
|
+
| 1218 | ro('Esta é uma mensagem de erro') |
|
|
2973
|
+
| 1219 | log.erro( |
|
|
2974
|
+
| 1220 | 'Esta é uma mensagem erro muito c |
|
|
2975
|
+
| 1221 | omprida e será limitada a 40 cara |
|
|
2976
|
+
| 1222 | cteres, o restante será cortado e |
|
|
2977
|
+
| 1223 | ingorado ao ser manipulado', 40) |
|
|
2978
|
+
| 1224 | log.criti |
|
|
2979
|
+
| 1225 | co('Esta é uma mensagem crítica') |
|
|
2980
|
+
| 1226 | |
|
|
2981
|
+
| 1227 | # Exemp |
|
|
2982
|
+
| 1228 | lo de função que gera uma exceção |
|
|
2983
|
+
| 1229 | def funcao_com_erro(): |
|
|
2984
|
+
| 1230 | raise ValueE |
|
|
2985
|
+
| 1231 | rror('Este é um erro de exemplo') |
|
|
2986
|
+
| 1232 | |
|
|
2987
|
+
| 1233 | # Testando redirecioname |
|
|
2988
|
+
| 1234 | nto de print e captura de exceção |
|
|
2989
|
+
| 1235 | pri |
|
|
2990
|
+
| 1236 | nt('Mensagem de teste via print') |
|
|
2991
|
+
| 1237 | try: |
|
|
2992
|
+
| 1238 | funcao_com_erro() |
|
|
2993
|
+
| 1239 | except Exception as e: |
|
|
2994
|
+
| 1240 | |
|
|
2995
|
+
| 1241 | print(f'Capturado um erro: {e}') |
|
|
2996
|
+
| 1242 | |
|
|
2997
|
+
| 1243 | log.erro('Ess |
|
|
2998
|
+
| 1244 | a é uma mensagem de erro e aborta |
|
|
2999
|
+
| 1245 | rá a execução do script', exit=1) |
|
|
3000
|
+
| 1246 | |
|
|
3001
|
+
| 1247 | log.info('Essa mensagem |
|
|
3002
|
+
| 1248 | não será exibida pois o script fo |
|
|
3003
|
+
| 1249 | i abortado na mensagem anterior') |
|
|
3004
|
+
| 1250 | |
|
|
3005
|
+
| 1251 | |
|
|
3006
|
+
| 1252 | # obtem os registros de log da ú |
|
|
3007
|
+
| 1253 | ltima hora (comportamento padrão) |
|
|
3008
|
+
| 1254 | |
|
|
3009
|
+
| 1255 | filtra_log = log.search() |
|
|
3010
|
+
| 1256 | |
|
|
3011
|
+
| 1257 | # obtem |
|
|
3012
|
+
| 1258 | os registros das últimas 6 horas |
|
|
3013
|
+
| 1259 | |
|
|
3014
|
+
| 1260 | ultimas_6h = datetime.datetime.no |
|
|
3015
|
+
| 1261 | w() - datetime.timedelta(hours=6) |
|
|
3016
|
+
| 1262 | ## carimbo de tempo de 6 horas a |
|
|
3017
|
+
| 1263 | trás !!! requer>> import datetime |
|
|
3018
|
+
| 1264 | filtra |
|
|
3019
|
+
| 1265 | _log = log.search(None, ultimas_6 |
|
|
3020
|
+
| 1266 | h) # None no 1º parametro impõe o |
|
|
3021
|
+
| 1267 | log do arquivo corrente como pad |
|
|
3022
|
+
| ::: | rão (definido em 'LogFile' e apon |
|
|
3023
|
+
| | tado no instanciamento da classe) |
|
|
3024
|
+
| | |
|
|
3025
|
+
| | # obtem os registr |
|
|
3026
|
+
| | os do dia 14/01/2020 até 3h atrás |
|
|
3027
|
+
| | |
|
|
3028
|
+
| | ultimas_3h = datetime.datetime.no |
|
|
3029
|
+
| | w() - datetime.timedelta(hours=3) |
|
|
3030
|
+
| | ## carimbo de tempo de 6 horas a |
|
|
3031
|
+
| | trás !!! requer>> import datetime |
|
|
3032
|
+
| | |
|
|
3033
|
+
| | filtra_log = log.search(None, ' |
|
|
3034
|
+
| | 14/01/2020 00:00', ultimas_3h) # |
|
|
3035
|
+
| | |
|
|
3036
|
+
| | # obte |
|
|
3037
|
+
| | m os registros do horário comerci |
|
|
3038
|
+
| | al do dia 23/12/2023 do arquivo s |
|
|
3039
|
+
| | alvo em C:\temp\outro_arquivo.log |
|
|
3040
|
+
| | Outro_Log = P |
|
|
3041
|
+
| | ath(r'c:\temp\outro_arquivo.log') |
|
|
3042
|
+
| | filtra_log |
|
|
3043
|
+
| | = log.search(Outro_Log, '23/12/20 |
|
|
3044
|
+
| | 23 08:00', '23/12/2023 18:00') # |
|
|
3045
|
+
| | |
|
|
3046
|
+
| | # salva |
|
|
3047
|
+
| | conteúdo filtrado em um arquivo: |
|
|
3048
|
+
| | |
|
|
3049
|
+
| | filtrado = 'filtered_log.txt' |
|
|
3050
|
+
| | with open(filtado, 'w', |
|
|
3051
|
+
| | encoding='ISO-8859-1') as output |
|
|
3052
|
+
| | _file: # indique o enconding con |
|
|
3053
|
+
| | forme salvo (UTF-8 ou ISO-8859-1) |
|
|
3054
|
+
| | outp |
|
|
3055
|
+
| | ut_file.writelines(filta_log) |
|
|
3056
|
+
| | |
|
|
3057
|
+
| | # m |
|
|
3058
|
+
| | ostra o conteúdo filtrado na tela |
|
|
3059
|
+
| | |
|
|
3060
|
+
| | print(''.join(filtra_log)) |
|
|
3061
|
+
| | |
|
|
3062
|
+
| | # mostra o conteúdo |
|
|
3063
|
+
| | filtrado na tela, listando apenas |
|
|
3064
|
+
| | as os registros do nível "DEBUG" |
|
|
3065
|
+
| | |
|
|
3066
|
+
| | for line in filtered_lines: |
|
|
3067
|
+
| | if "DEBUG" in line: |
|
|
3068
|
+
| | |
|
|
3069
|
+
| | print(line, end='') |
|
|
3070
|
+
| | ``` |
|
|
3071
|
+
| | """ |
|
|
3072
|
+
| | class |
|
|
3073
|
+
| | LevelFilter(logging.Filter): |
|
|
3074
|
+
| | def |
|
|
3075
|
+
| | __init__(self, levels_to_ignore): |
|
|
3076
|
+
| | self.le |
|
|
3077
|
+
| | vels_to_ignore = levels_to_ignore |
|
|
3078
|
+
| | # |
|
|
3079
|
+
| | # |
|
|
3080
|
+
| | |
|
|
3081
|
+
| | def filter(self, record): |
|
|
3082
|
+
| | return record.lev |
|
|
3083
|
+
| | elno not in self.levels_to_ignore |
|
|
3084
|
+
| | # |
|
|
3085
|
+
| | # |
|
|
3086
|
+
| | def __in |
|
|
3087
|
+
| | it__(self, log_file_path=None, lo |
|
|
3088
|
+
| | g_level=logging.DEBUG, formato_lo |
|
|
3089
|
+
| | g='%(asctime)s - %(levelname)s - |
|
|
3090
|
+
| | %(message)s', modulo=None, ignore |
|
|
3091
|
+
| | _console=None, ignore_file=None): |
|
|
3092
|
+
| | se |
|
|
3093
|
+
| | lf.ignore_file = [] if ignore_fil |
|
|
3094
|
+
| | e is None else ignore_file |
|
|
3095
|
+
| | self |
|
|
3096
|
+
| | .ignore_console = [] if ignore_co |
|
|
3097
|
+
| | nsole is None else ignore_console |
|
|
3098
|
+
| | self.modulo = __nam |
|
|
3099
|
+
| | e__ if modulo is None else modulo |
|
|
3100
|
+
| | self.logger |
|
|
3101
|
+
| | = logging.getLogger(self.modulo) |
|
|
3102
|
+
| | |
|
|
3103
|
+
| | self.logger.setLevel(log_level) |
|
|
3104
|
+
| | self.msg = '' |
|
|
3105
|
+
| | s |
|
|
3106
|
+
| | elf.log_file_path = log_file_path |
|
|
3107
|
+
| | |
|
|
3108
|
+
| | if log_file_path: |
|
|
3109
|
+
| | |
|
|
3110
|
+
| | # Criando um handler p |
|
|
3111
|
+
| | ara escrever em um arquivo de log |
|
|
3112
|
+
| | |
|
|
3113
|
+
| | file_handler = loggin |
|
|
3114
|
+
| | g.FileHandler(self.log_file_path) |
|
|
3115
|
+
| | fi |
|
|
3116
|
+
| | le_handler.setLevel(log_level) # |
|
|
3117
|
+
| | Sempre registrar tudo no arquivo |
|
|
3118
|
+
| | |
|
|
3119
|
+
| | # Criando |
|
|
3120
|
+
| | um handler para exibir no console |
|
|
3121
|
+
| | console_ |
|
|
3122
|
+
| | handler = logging.StreamHandler() |
|
|
3123
|
+
| | console |
|
|
3124
|
+
| | _handler.setLevel(log_level) # R |
|
|
3125
|
+
| | egistrar DEBUG e acima no console |
|
|
3126
|
+
| | |
|
|
3127
|
+
| | # Adi |
|
|
3128
|
+
| | cionando filtro para ignorar cert |
|
|
3129
|
+
| | os níveis no console e no arquivo |
|
|
3130
|
+
| | |
|
|
3131
|
+
| | file_handler.addFilter(se |
|
|
3132
|
+
| | lf.LevelFilter(self.ignore_file)) |
|
|
3133
|
+
| | |
|
|
3134
|
+
| | console_handler.addFilter(self. |
|
|
3135
|
+
| | LevelFilter(self.ignore_console)) |
|
|
3136
|
+
| | |
|
|
3137
|
+
| | # Definin |
|
|
3138
|
+
| | do o formato das mensagens de log |
|
|
3139
|
+
| | formatter |
|
|
3140
|
+
| | = logging.Formatter(formato_log) |
|
|
3141
|
+
| | fil |
|
|
3142
|
+
| | e_handler.setFormatter(formatter) |
|
|
3143
|
+
| | consol |
|
|
3144
|
+
| | e_handler.setFormatter(formatter) |
|
|
3145
|
+
| | |
|
|
3146
|
+
| | # |
|
|
3147
|
+
| | Adicionando os handlers ao logger |
|
|
3148
|
+
| | sel |
|
|
3149
|
+
| | f.logger.addHandler(file_handler) |
|
|
3150
|
+
| | self.l |
|
|
3151
|
+
| | ogger.addHandler(console_handler) |
|
|
3152
|
+
| | else: |
|
|
3153
|
+
| | |
|
|
3154
|
+
| | # Tudo direcionado para o console |
|
|
3155
|
+
| | console_ |
|
|
3156
|
+
| | handler = logging.StreamHandler() |
|
|
3157
|
+
| | |
|
|
3158
|
+
| | console_handler.setLevel(l |
|
|
3159
|
+
| | og_level) # Registrar no console |
|
|
3160
|
+
| | |
|
|
3161
|
+
| | # Adi |
|
|
3162
|
+
| | cionando filtro para ignorar cert |
|
|
3163
|
+
| | os níveis no console e no arquivo |
|
|
3164
|
+
| | consol |
|
|
3165
|
+
| | e_handler.addFilter(self.LevelFil |
|
|
3166
|
+
| | ter(self.ignore_console)) |
|
|
3167
|
+
| | |
|
|
3168
|
+
| | # Definin |
|
|
3169
|
+
| | do o formato das mensagens de log |
|
|
3170
|
+
| | formatter |
|
|
3171
|
+
| | = logging.Formatter(formato_log) |
|
|
3172
|
+
| | consol |
|
|
3173
|
+
| | e_handler.setFormatter(formatter) |
|
|
3174
|
+
| | |
|
|
3175
|
+
| | |
|
|
3176
|
+
| | # Adicionando o handler ao logger |
|
|
3177
|
+
| | self.l |
|
|
3178
|
+
| | ogger.addHandler(console_handler) |
|
|
3179
|
+
| | |
|
|
3180
|
+
| | # Redi |
|
|
3181
|
+
| | recionando exceções para o logger |
|
|
3182
|
+
| | sys.e |
|
|
3183
|
+
| | xcepthook = self.handle_exception |
|
|
3184
|
+
| | |
|
|
3185
|
+
| | |
|
|
3186
|
+
| | # Redirecionando saída padrão |
|
|
3187
|
+
| | |
|
|
3188
|
+
| | self.original_stdout = sys.stdout |
|
|
3189
|
+
| | sys.stdout = self |
|
|
3190
|
+
| | # |
|
|
3191
|
+
| | # |
|
|
3192
|
+
| | |
|
|
3193
|
+
| | def handle_exception(self, exc |
|
|
3194
|
+
| | _type, exc_value, exc_traceback): |
|
|
3195
|
+
| | if issubcl |
|
|
3196
|
+
| | ass(exc_type, KeyboardInterrupt): |
|
|
3197
|
+
| | |
|
|
3198
|
+
| | sys.__excepthook__(ex |
|
|
3199
|
+
| | c_type, exc_value, exc_traceback) |
|
|
3200
|
+
| | return |
|
|
3201
|
+
| | |
|
|
3202
|
+
| | self.logger.error("Exc |
|
|
3203
|
+
| | eção não prevista", exc_info=(exc |
|
|
3204
|
+
| | _type, exc_value, exc_traceback)) |
|
|
3205
|
+
| | # |
|
|
3206
|
+
| | # |
|
|
3207
|
+
| | |
|
|
3208
|
+
| | def print(self, *args, **kwargs): |
|
|
3209
|
+
| | # Im |
|
|
3210
|
+
| | prime diretamente na saída padrão |
|
|
3211
|
+
| | print(*args, **k |
|
|
3212
|
+
| | wargs, file=self.original_stdout) |
|
|
3213
|
+
| | # |
|
|
3214
|
+
| | # |
|
|
3215
|
+
| | de |
|
|
3216
|
+
| | f add(self, message, corte=None): |
|
|
3217
|
+
| | message = mess |
|
|
3218
|
+
| | age[:corte] if corte else message |
|
|
3219
|
+
| | |
|
|
3220
|
+
| | self.msg = self.msg + message if |
|
|
3221
|
+
| | not message is None else self.msg |
|
|
3222
|
+
| | # |
|
|
3223
|
+
| | # |
|
|
3224
|
+
| | def write(self, message): |
|
|
3225
|
+
| | if message.str |
|
|
3226
|
+
| | ip(): # Ignorar mensagens vazias |
|
|
3227
|
+
| | |
|
|
3228
|
+
| | self.logger.info(message.strip()) |
|
|
3229
|
+
| | # |
|
|
3230
|
+
| | # |
|
|
3231
|
+
| | def flush(self): |
|
|
3232
|
+
| | |
|
|
3233
|
+
| | pass # Método necessário pa |
|
|
3234
|
+
| | ra compatibilidade com sys.stdout |
|
|
3235
|
+
| | # |
|
|
3236
|
+
| | # |
|
|
3237
|
+
| | def debug(self, |
|
|
3238
|
+
| | message, corte=None, exit=None): |
|
|
3239
|
+
| | |
|
|
3240
|
+
| | self.msg = self.msg + message if |
|
|
3241
|
+
| | not message is None else self.msg |
|
|
3242
|
+
| | msg = self.m |
|
|
3243
|
+
| | sg[:corte] if corte else self.msg |
|
|
3244
|
+
| | |
|
|
3245
|
+
| | self.logger.debug(msg) |
|
|
3246
|
+
| | self.msg = '' |
|
|
3247
|
+
| | if exit: |
|
|
3248
|
+
| | os._exit(exit) |
|
|
3249
|
+
| | # |
|
|
3250
|
+
| | # |
|
|
3251
|
+
| | def info(self, |
|
|
3252
|
+
| | message, corte=None, exit=None): |
|
|
3253
|
+
| | |
|
|
3254
|
+
| | self.msg = self.msg + message if |
|
|
3255
|
+
| | not message is None else self.msg |
|
|
3256
|
+
| | msg = self.m |
|
|
3257
|
+
| | sg[:corte] if corte else self.msg |
|
|
3258
|
+
| | self.logger.info(msg) |
|
|
3259
|
+
| | self.msg = '' |
|
|
3260
|
+
| | if exit: |
|
|
3261
|
+
| | |
|
|
3262
|
+
| | os._exit(exit) |
|
|
3263
|
+
| | # |
|
|
3264
|
+
| | # |
|
|
3265
|
+
| | def aviso(self, |
|
|
3266
|
+
| | message, corte=None, exit=None): |
|
|
3267
|
+
| | |
|
|
3268
|
+
| | self.msg = self.msg + message if |
|
|
3269
|
+
| | not message is None else self.msg |
|
|
3270
|
+
| | msg = self.m |
|
|
3271
|
+
| | sg[:corte] if corte else self.msg |
|
|
3272
|
+
| | |
|
|
3273
|
+
| | self.logger.warning(msg) |
|
|
3274
|
+
| | self.msg = '' |
|
|
3275
|
+
| | if exit: |
|
|
3276
|
+
| | os._exit(exit) |
|
|
3277
|
+
| | # |
|
|
3278
|
+
| | # |
|
|
3279
|
+
| | def erro(self, |
|
|
3280
|
+
| | message, corte=None, exit=None): |
|
|
3281
|
+
| | |
|
|
3282
|
+
| | self.msg = self.msg + message if |
|
|
3283
|
+
| | not message is None else self.msg |
|
|
3284
|
+
| | msg = self.m |
|
|
3285
|
+
| | sg[:corte] if corte else self.msg |
|
|
3286
|
+
| | |
|
|
3287
|
+
| | self.logger.error(msg) |
|
|
3288
|
+
| | self.msg = '' |
|
|
3289
|
+
| | if exit: |
|
|
3290
|
+
| | os._exit(exit) |
|
|
3291
|
+
| | # |
|
|
3292
|
+
| | # |
|
|
3293
|
+
| | def critico(self, |
|
|
3294
|
+
| | message, corte=None, exit=None): |
|
|
3295
|
+
| | |
|
|
3296
|
+
| | self.msg = self.msg + message if |
|
|
3297
|
+
| | not message is None else self.msg |
|
|
3298
|
+
| | msg = self.m |
|
|
3299
|
+
| | sg[:corte] if corte else self.msg |
|
|
3300
|
+
| | |
|
|
3301
|
+
| | self.logger.critical(msg) |
|
|
3302
|
+
| | self.msg = '' |
|
|
3303
|
+
| | if exit: |
|
|
3304
|
+
| | os._exit(exit) |
|
|
3305
|
+
| | # |
|
|
3306
|
+
| | # |
|
|
3307
|
+
| | def stop_logging(self): |
|
|
3308
|
+
| | |
|
|
3309
|
+
| | # Restaurar o stdout original |
|
|
3310
|
+
| | |
|
|
3311
|
+
| | sys.stdout = self.original_stdout |
|
|
3312
|
+
| | |
|
|
3313
|
+
| | # Remover handlers do logger |
|
|
3314
|
+
| | h |
|
|
3315
|
+
| | andlers = self.logger.handlers[:] |
|
|
3316
|
+
| | |
|
|
3317
|
+
| | for handler in handlers: |
|
|
3318
|
+
| | handler.close() |
|
|
3319
|
+
| | s |
|
|
3320
|
+
| | elf.logger.removeHandler(handler) |
|
|
3321
|
+
| | # |
|
|
3322
|
+
| | # |
|
|
3323
|
+
| | def filtra |
|
|
3324
|
+
| | (self, log_file, dh_ini, dh_fim): |
|
|
3325
|
+
| | |
|
|
3326
|
+
| | # Validar parametros de entrada |
|
|
3327
|
+
| | if dh_ini: |
|
|
3328
|
+
| | if not isins |
|
|
3329
|
+
| | tance(dh_ini, datetime.datetime): |
|
|
3330
|
+
| | if not re.ful |
|
|
3331
|
+
| | lmatch(r'([0-3][0-9]/[0-1][0-2]/[ |
|
|
3332
|
+
| | 1-2][0-9]{3} [0-2][0-9]\:[0-6][0- |
|
|
3333
|
+
| | 9])(\:[0-6][0-9]){0,1}', dh_ini): |
|
|
3334
|
+
| | |
|
|
3335
|
+
| | self.logger.error(f'Da |
|
|
3336
|
+
| | ta/Hora início {dh_ini} em format |
|
|
3337
|
+
| | o inválido. Informe um objeto do |
|
|
3338
|
+
| | tipo "datetime" ou uma string no |
|
|
3339
|
+
| | formato "dd/mm/aaaa hh:mm:[ss]"') |
|
|
3340
|
+
| | |
|
|
3341
|
+
| | return None |
|
|
3342
|
+
| | |
|
|
3343
|
+
| | elif len(dh_ini) == |
|
|
3344
|
+
| | 16: # Formato 'dd/mm/yyyy hh:mm' |
|
|
3345
|
+
| | |
|
|
3346
|
+
| | dh_ini += ":00" |
|
|
3347
|
+
| | try: |
|
|
3348
|
+
| | sel |
|
|
3349
|
+
| | f.inicio = datetime.datetime.strp |
|
|
3350
|
+
| | time(dh_ini, '%d/%m/%Y %H:%M:%S') |
|
|
3351
|
+
| | except: |
|
|
3352
|
+
| | |
|
|
3353
|
+
| | self.logger.error(f'Da |
|
|
3354
|
+
| | ta/Hora início {dh_ini} em format |
|
|
3355
|
+
| | o inválido. Informe um objeto do |
|
|
3356
|
+
| | tipo "datetime" ou uma string no |
|
|
3357
|
+
| | formato "dd/mm/aaaa hh:mm:[ss]"') |
|
|
3358
|
+
| | |
|
|
3359
|
+
| | return None |
|
|
3360
|
+
| | else: |
|
|
3361
|
+
| | |
|
|
3362
|
+
| | self.inicio = dh_ini |
|
|
3363
|
+
| | else: |
|
|
3364
|
+
| | |
|
|
3365
|
+
| | self.inicio = date |
|
|
3366
|
+
| | time.datetime.now() - datetime.ti |
|
|
3367
|
+
| | medelta(hours=1) ## assume a últi |
|
|
3368
|
+
| | ma hora como intervalo, se omisso |
|
|
3369
|
+
| | |
|
|
3370
|
+
| | if dh_fim: |
|
|
3371
|
+
| | if not isins |
|
|
3372
|
+
| | tance(dh_fim, datetime.datetime): |
|
|
3373
|
+
| | if not re.ful |
|
|
3374
|
+
| | lmatch(r'([0-3][0-9]/[0-1][0-2]/[ |
|
|
3375
|
+
| | 1-2][0-9]{3} [0-2][0-9]\:[0-6][0- |
|
|
3376
|
+
| | 9])(\:[0-6][0-9]){0,1}', dh_ini): |
|
|
3377
|
+
| | |
|
|
3378
|
+
| | self.logger.error(f |
|
|
3379
|
+
| | 'Data/Hora fim {dh_fim} em format |
|
|
3380
|
+
| | o inválido. Informe um objeto do |
|
|
3381
|
+
| | tipo "datetime" ou uma string no |
|
|
3382
|
+
| | formato "dd/mm/aaaa hh:mm:[ss]"') |
|
|
3383
|
+
| | |
|
|
3384
|
+
| | return None |
|
|
3385
|
+
| | |
|
|
3386
|
+
| | elif len(dh_fim) == |
|
|
3387
|
+
| | 16: # Formato 'dd/mm/yyyy hh:mm' |
|
|
3388
|
+
| | |
|
|
3389
|
+
| | dh_fim += ":00" |
|
|
3390
|
+
| | try: |
|
|
3391
|
+
| | |
|
|
3392
|
+
| | self.fim = datetime.datetime.strp |
|
|
3393
|
+
| | time(dh_fim, '%d/%m/%Y %H:%M:%S') |
|
|
3394
|
+
| | except: |
|
|
3395
|
+
| | |
|
|
3396
|
+
| | self.logger.error(f |
|
|
3397
|
+
| | 'Data/Hora fim {dh_fim} em format |
|
|
3398
|
+
| | o inválido. Informe um objeto do |
|
|
3399
|
+
| | tipo "datetime" ou uma string no |
|
|
3400
|
+
| | formato "dd/mm/aaaa hh:mm:[ss]"') |
|
|
3401
|
+
| | |
|
|
3402
|
+
| | return None |
|
|
3403
|
+
| | else: |
|
|
3404
|
+
| | |
|
|
3405
|
+
| | self.fim = dh_fim |
|
|
3406
|
+
| | else: |
|
|
3407
|
+
| | |
|
|
3408
|
+
| | self.fim = datetim |
|
|
3409
|
+
| | e.datetime.now() ## assume a últi |
|
|
3410
|
+
| | ma hora como intervalo, se omisso |
|
|
3411
|
+
| | |
|
|
3412
|
+
| | if not log |
|
|
3413
|
+
| | _file and not self.log_file_path: |
|
|
3414
|
+
| | self.logger |
|
|
3415
|
+
| | .critical('Nenhum arquivo de log |
|
|
3416
|
+
| | disponível. Log desta instância c |
|
|
3417
|
+
| | onfigurado apenas para exibição e |
|
|
3418
|
+
| | m tela, sem registro em arquivo') |
|
|
3419
|
+
| | return None |
|
|
3420
|
+
| | elif not |
|
|
3421
|
+
| | log_file and self.log_file_path: |
|
|
3422
|
+
| | l |
|
|
3423
|
+
| | og_file_path = self.log_file_path |
|
|
3424
|
+
| | elif log_file: |
|
|
3425
|
+
| | |
|
|
3426
|
+
| | if Path(log_file).is_file(): |
|
|
3427
|
+
| | |
|
|
3428
|
+
| | log_file_path = log_file |
|
|
3429
|
+
| | else: |
|
|
3430
|
+
| | |
|
|
3431
|
+
| | self.logger.critical(f'Arquiv |
|
|
3432
|
+
| | o de log {log_file} não existe!') |
|
|
3433
|
+
| | return None |
|
|
3434
|
+
| | else: |
|
|
3435
|
+
| | sel |
|
|
3436
|
+
| | f.logger.critical('Erro validação |
|
|
3437
|
+
| | arquivo de entrada. Abortando!') |
|
|
3438
|
+
| | return None |
|
|
3439
|
+
| | |
|
|
3440
|
+
| | # |
|
|
3441
|
+
| | Função para verificar se a linha |
|
|
3442
|
+
| | está dentro do intervalo de tempo |
|
|
3443
|
+
| | |
|
|
3444
|
+
| | def is_within_time_ran |
|
|
3445
|
+
| | ge(timestamp, dh_inicio, dh_fim): |
|
|
3446
|
+
| | return |
|
|
3447
|
+
| | dh_inicio <= timestamp <= dh_fim |
|
|
3448
|
+
| | |
|
|
3449
|
+
| | |
|
|
3450
|
+
| | # Ler e filtrar o arquivo de |
|
|
3451
|
+
| | log com a codificação ISO-8859-1 |
|
|
3452
|
+
| | |
|
|
3453
|
+
| | with open(log_file_path, 'r', en |
|
|
3454
|
+
| | coding='ISO-8859-1') as log_file: |
|
|
3455
|
+
| | |
|
|
3456
|
+
| | log_lines = log_file.readlines() |
|
|
3457
|
+
| | |
|
|
3458
|
+
| | # Variável para ar |
|
|
3459
|
+
| | mazenar o último timestamp válido |
|
|
3460
|
+
| | |
|
|
3461
|
+
| | last_valid_timestamp = None |
|
|
3462
|
+
| | filtered_lines = [] |
|
|
3463
|
+
| | |
|
|
3464
|
+
| | |
|
|
3465
|
+
| | for line in log_lines: |
|
|
3466
|
+
| | try: |
|
|
3467
|
+
| | # |
|
|
3468
|
+
| | Extraia a data e a hora da linha |
|
|
3469
|
+
| | |
|
|
3470
|
+
| | timestamp_str = line.s |
|
|
3471
|
+
| | plit()[0] + " " + line.split()[1] |
|
|
3472
|
+
| | timestamp = |
|
|
3473
|
+
| | datetime.datetime.strptime(times |
|
|
3474
|
+
| | tamp_str, '%Y-%m-%d %H:%M:%S,%f') |
|
|
3475
|
+
| | |
|
|
3476
|
+
| | last_valid_timestamp = timestamp |
|
|
3477
|
+
| | |
|
|
3478
|
+
| | if is_within_time_range(t |
|
|
3479
|
+
| | imestamp, self.inicio, self.fim): |
|
|
3480
|
+
| | |
|
|
3481
|
+
| | filtered_lines.append(line) |
|
|
3482
|
+
| | |
|
|
3483
|
+
| | except Exception as e: |
|
|
3484
|
+
| | # Caso a |
|
|
3485
|
+
| | linha não tenha um carimbo de tem |
|
|
3486
|
+
| | po, use o último timestamp válido |
|
|
3487
|
+
| | |
|
|
3488
|
+
| | if last_valid_timestamp and |
|
|
3489
|
+
| | is_within_time_range(last_valid_t |
|
|
3490
|
+
| | imestamp, self.inicio, self.fim): |
|
|
3491
|
+
| | |
|
|
3492
|
+
| | filtered_lines.append(line) |
|
|
3493
|
+
| | |
|
|
3494
|
+
| | # Retornar o ob |
|
|
3495
|
+
| | jeto contendo as linhas filtradas |
|
|
3496
|
+
| | return filtered_lines |
|
|
3497
|
+
| | |
|
|
3498
|
+
| | </div> |
|
|
3499
|
+
+-----------------------------------+-----------------------------------+
|
|
3500
|
+
:::
|
|
3501
|
+
|
|
3502
|
+
::: {.doc .doc-children}
|
|
3503
|
+
:::
|
|
3504
|
+
:::::
|
|
3505
|
+
::::::
|
|
3506
|
+
|
|
3507
|
+
:::::: {.doc .doc-object .doc-class}
|
|
3508
|
+
## `misc` {#lbxtoolkit.misc .doc .doc-heading}
|
|
3509
|
+
|
|
3510
|
+
::::: {.doc .doc-contents}
|
|
3511
|
+
###### Classe **misc** {#lbxtoolkit.misc--classe-misc}
|
|
3512
|
+
|
|
3513
|
+
Classe que reune pequenas funções uteis para agilizar tarefas comuns.
|
|
3514
|
+
|
|
3515
|
+
Sintaxe e exemplos de uso. Parametros omissos assume os valores padrão
|
|
3516
|
+
indicados abaixo:
|
|
3517
|
+
|
|
3518
|
+
- `Arquivo = seleciona_arquivo(DirBase, TiposArquivo=[('Todos os arquivos', '*.*')], Titulo='Selecionar arquivo')`
|
|
3519
|
+
- `Diretório = seleciona_dir(DirBase=Path(r'./'), Titulo='Selecionar diretório'):`
|
|
3520
|
+
- `NomeLimpo = normaliza('String # SEM Noção!') #>>> string_sem_nocao`
|
|
3521
|
+
- `cmd_window = get_cmd_window()`
|
|
3522
|
+
- `maximize_console()`
|
|
3523
|
+
|
|
3524
|
+
Source code in `lbxtoolkit\__init__.py`
|
|
3525
|
+
|
|
3526
|
+
::: highlight
|
|
3527
|
+
+-----------------------------------+-----------------------------------+
|
|
3528
|
+
| ::: linenodiv | <div> |
|
|
3529
|
+
| 1270 | |
|
|
3530
|
+
| 1271 | cl |
|
|
3531
|
+
| 1272 | ass misc: # Classe de miscelâneas |
|
|
3532
|
+
| 1273 | """ |
|
|
3533
|
+
| 1274 | #### Classe **misc** |
|
|
3534
|
+
| 1275 | |
|
|
3535
|
+
| 1276 | Cla |
|
|
3536
|
+
| 1277 | sse que reune pequenas funções ut |
|
|
3537
|
+
| 1278 | eis para agilizar tarefas comuns. |
|
|
3538
|
+
| 1279 | |
|
|
3539
|
+
| 1280 | Sintaxe e exemplos de u |
|
|
3540
|
+
| 1281 | so. Parametros omissos assume os |
|
|
3541
|
+
| 1282 | valores padrão indicados abaixo: |
|
|
3542
|
+
| 1283 | |
|
|
3543
|
+
| 1284 | - `Arquivo = se |
|
|
3544
|
+
| 1285 | leciona_arquivo(DirBase, TiposArq |
|
|
3545
|
+
| 1286 | uivo=[('Todos os arquivos', '*.*' |
|
|
3546
|
+
| 1287 | )], Titulo='Selecionar arquivo')` |
|
|
3547
|
+
| 1288 | - `Diretório = s |
|
|
3548
|
+
| 1289 | eleciona_dir(DirBase=Path(r'./'), |
|
|
3549
|
+
| 1290 | Titulo='Selecionar diretório'):` |
|
|
3550
|
+
| 1291 | - `N |
|
|
3551
|
+
| 1292 | omeLimpo = normaliza('String # SE |
|
|
3552
|
+
| 1293 | M Noção!') #>>> string_sem_nocao` |
|
|
3553
|
+
| 1294 | |
|
|
3554
|
+
| 1295 | - `cmd_window = get_cmd_window()` |
|
|
3555
|
+
| 1296 | |
|
|
3556
|
+
| 1297 | - `maximize_console()` |
|
|
3557
|
+
| 1298 | """ |
|
|
3558
|
+
| 1299 | def __init__(self): |
|
|
3559
|
+
| 1300 | pass |
|
|
3560
|
+
| 1301 | # |
|
|
3561
|
+
| 1302 | # |
|
|
3562
|
+
| 1303 | def se |
|
|
3563
|
+
| 1304 | leciona_arquivo(DirBase, TiposArq |
|
|
3564
|
+
| 1305 | uivo=[('Todos os arquivos', '*.*' |
|
|
3565
|
+
| 1306 | )], Titulo='Selecionar arquivo'): |
|
|
3566
|
+
| 1307 | # Picker para selecionar arquivo |
|
|
3567
|
+
| 1308 | root = tk.Tk() |
|
|
3568
|
+
| 1309 | |
|
|
3569
|
+
| 1310 | root.withdraw() # Esco |
|
|
3570
|
+
| 1311 | nde a janela principal do Tkinter |
|
|
3571
|
+
| 1312 | |
|
|
3572
|
+
| 1313 | Arquivo = filedialog.askopen |
|
|
3573
|
+
| 1314 | filename(initialdir=DirBase, file |
|
|
3574
|
+
| 1315 | types=TiposArquivo, title=Titulo) |
|
|
3575
|
+
| 1316 | |
|
|
3576
|
+
| 1317 | Arquivo = Path(Arquivo) |
|
|
3577
|
+
| 1318 | root.destroy() |
|
|
3578
|
+
| 1319 | return Arquivo |
|
|
3579
|
+
| 1320 | # |
|
|
3580
|
+
| 1321 | # |
|
|
3581
|
+
| 1322 | def se |
|
|
3582
|
+
| 1323 | leciona_dir(DirBase=Path(r'./'), |
|
|
3583
|
+
| 1324 | Titulo='Selecionar diretório'): # |
|
|
3584
|
+
| 1325 | Picker para selecionar diretório |
|
|
3585
|
+
| 1326 | root = tk.Tk |
|
|
3586
|
+
| 1327 | () # objeto picker (Tkinter)para |
|
|
3587
|
+
| 1328 | selecionar arquivos e diretórios |
|
|
3588
|
+
| 1329 | |
|
|
3589
|
+
| 1330 | root.withdraw() # Esco |
|
|
3590
|
+
| 1331 | nde a janela principal do Tkinter |
|
|
3591
|
+
| 1332 | Dir |
|
|
3592
|
+
| 1333 | etorio = filedialog.askdirectory( |
|
|
3593
|
+
| ::: | initialdir=DirBase, title=Titulo) |
|
|
3594
|
+
| | |
|
|
3595
|
+
| | Diretorio = Path(Diretorio) |
|
|
3596
|
+
| | root.destroy() |
|
|
3597
|
+
| | return Diretorio |
|
|
3598
|
+
| | # |
|
|
3599
|
+
| | # |
|
|
3600
|
+
| | def normaliza(Ori |
|
|
3601
|
+
| | ginal): # Limpa e padroniza nomes |
|
|
3602
|
+
| | Lixo = r'/\\?%§ªº°` |
|
|
3603
|
+
| | ´^~*:|"<>!@#$%¨&*()_+=-[]{}"\' ' |
|
|
3604
|
+
| | Normalizar = nor |
|
|
3605
|
+
| | malize('NFKD', Original).encode(' |
|
|
3606
|
+
| | ASCII', 'ignore').decode('ASCII') |
|
|
3607
|
+
| | R |
|
|
3608
|
+
| | emoverLixo = [c if c not in Lixo |
|
|
3609
|
+
| | else '_' for c in Normalizar] |
|
|
3610
|
+
| | |
|
|
3611
|
+
| | Limpo = "".join(RemoverLixo) |
|
|
3612
|
+
| | Limpo = re.su |
|
|
3613
|
+
| | b(r'\.(?=.*\.)', '_', Limpo) # tr |
|
|
3614
|
+
| | oca todos os pontos por underline |
|
|
3615
|
+
| | Li |
|
|
3616
|
+
| | mpo = re.sub(r'_+', '_', Limpo) |
|
|
3617
|
+
| | # limpa as reptições do underline |
|
|
3618
|
+
| | return Limpo.lower() |
|
|
3619
|
+
| | # |
|
|
3620
|
+
| | # |
|
|
3621
|
+
| | def get_cmd_wind |
|
|
3622
|
+
| | ow(): # Captura a referencia da j |
|
|
3623
|
+
| | anela atual para retornar o foco |
|
|
3624
|
+
| | à ela depois de chamar os pickers |
|
|
3625
|
+
| | pid = os.getpid() |
|
|
3626
|
+
| | win |
|
|
3627
|
+
| | dows = gw.getWindowsWithTitle("") |
|
|
3628
|
+
| | |
|
|
3629
|
+
| | for window in windows: |
|
|
3630
|
+
| | |
|
|
3631
|
+
| | if window.title and w |
|
|
3632
|
+
| | indow.visible and window.topleft: |
|
|
3633
|
+
| | return window |
|
|
3634
|
+
| | return None |
|
|
3635
|
+
| | # |
|
|
3636
|
+
| | # |
|
|
3637
|
+
| | def maximize_console |
|
|
3638
|
+
| | (): # Ajustar o buffer de console |
|
|
3639
|
+
| | # os.syste |
|
|
3640
|
+
| | m('mode con: cols=500 lines=100') |
|
|
3641
|
+
| | # Ob |
|
|
3642
|
+
| | ter o handle da janela do console |
|
|
3643
|
+
| | ker |
|
|
3644
|
+
| | nel32 = ctypes.WinDLL('kernel32') |
|
|
3645
|
+
| | |
|
|
3646
|
+
| | user32 = ctypes.WinDLL('user32') |
|
|
3647
|
+
| | h |
|
|
3648
|
+
| | Wnd = kernel32.GetConsoleWindow() |
|
|
3649
|
+
| | if hWnd: |
|
|
3650
|
+
| | |
|
|
3651
|
+
| | # Definir as dimensões da tela |
|
|
3652
|
+
| | user32.ShowWin |
|
|
3653
|
+
| | dow(hWnd, 3) # 3 = SW_MAXIMIZE |
|
|
3654
|
+
| | |
|
|
3655
|
+
| | </div> |
|
|
3656
|
+
+-----------------------------------+-----------------------------------+
|
|
3657
|
+
:::
|
|
3658
|
+
|
|
3659
|
+
::: {.doc .doc-children}
|
|
3660
|
+
:::
|
|
3661
|
+
:::::
|
|
3662
|
+
::::::
|
|
3663
|
+
|
|
3664
|
+
:::::: {.doc .doc-object .doc-class}
|
|
3665
|
+
## `postgreSQL` {#lbxtoolkit.postgreSQL .doc .doc-heading}
|
|
3666
|
+
|
|
3667
|
+
::::: {.doc .doc-contents}
|
|
3668
|
+
###### Classe **postgreSQL** {#lbxtoolkit.postgreSQL--classe-postgresql}
|
|
3669
|
+
|
|
3670
|
+
Recursos de interação com o banco de dados relacional PostgreSQL
|
|
3671
|
+
|
|
3672
|
+
1\) O método `postgreSQl.db()` exige que as credenciais e parametros de
|
|
3673
|
+
acesso sejam fornecidas em um *dicionário* com, ao mínimo, o seguinte
|
|
3674
|
+
formato:
|
|
3675
|
+
|
|
3676
|
+
credenciais = {
|
|
3677
|
+
'dbname': 'NOME_BANCO',
|
|
3678
|
+
'user': 'USUARIO'',
|
|
3679
|
+
'password': 'SENHA',
|
|
3680
|
+
'host': 'IP_OU_DNS_SERVIDOR',
|
|
3681
|
+
'port': 'PORTA_POSTGRESQL', ## padrão = 5432
|
|
3682
|
+
}
|
|
3683
|
+
|
|
3684
|
+
conexao = postgreSQL.db(credenciais)
|
|
3685
|
+
|
|
3686
|
+
O nome do schema é ser declarado no contexto da query, mas se desejar
|
|
3687
|
+
alterar o schema padrão, adicione
|
|
3688
|
+
*`'options' : '-c search_path=[NOME_SCHEMA]',`* ao dicionário.
|
|
3689
|
+
|
|
3690
|
+
Qualquer argumento de conexão previsto no pacote *psycopg2* são aceitos
|
|
3691
|
+
como entrada no dicionário acima.
|
|
3692
|
+
|
|
3693
|
+
2\) O método `postgreSQl.csv_df()` lê arquivo texto do tipo CSV e o
|
|
3694
|
+
converte para o objeto Dataframe do `pandas`. A assinatura da função
|
|
3695
|
+
exige que se forneça o caminho do arquivo CSV e, opcionalmente o
|
|
3696
|
+
caracter delimitador. Se o caracter demilitador não for informado, será
|
|
3697
|
+
assumido `;`. Considere usar a função `Path` para tratar o caminho do
|
|
3698
|
+
arquivo de origem.
|
|
3699
|
+
|
|
3700
|
+
from pathlib import Path
|
|
3701
|
+
arquivo_csv = Path('./diretorio/arquivo_exemplo.csv')
|
|
3702
|
+
dados = postgreSQL.csv_df(arquivo_csv, CsvDelim=',') # usando vírgula como separador. se omisso, assume ";'
|
|
3703
|
+
|
|
3704
|
+
3\) O método `postgreSQl.db_insert_df()` insere dados a partir de um
|
|
3705
|
+
Dataframe (pandas) em uma tabela do banco com estrutura de colunas
|
|
3706
|
+
equivalente.
|
|
3707
|
+
|
|
3708
|
+
A assinatura da função é
|
|
3709
|
+
`postgreSQL.db_insert_df([conexao], [dataframe_origem], [tabela_destino], Schema=None, Colunas=None, OnConflict=None)`
|
|
3710
|
+
|
|
3711
|
+
É necessário que os nomes das colunas do dataframe coincidam com o nome
|
|
3712
|
+
das colunas da tabela. Não há como traduzir/compatibilizar (de-para)
|
|
3713
|
+
nomes de colunas entre o dataframe e a tabela.
|
|
3714
|
+
|
|
3715
|
+
Os três primeiros parametros são posicionais e correspondem,
|
|
3716
|
+
respectivamente, (1) ao objeto da conexão com o banco, (2) ao objeto que
|
|
3717
|
+
contém o dataframe e (3) ao nome da tabela de destino. Assume-se que a
|
|
3718
|
+
tabela pertença ao schema padrão (definido na variável *search_path* do
|
|
3719
|
+
servidor). Caso a tabela de destino esteja em um *schema* diferente do
|
|
3720
|
+
padrão, deve-se informar seu nome no parâmetro opcional `Schema`.
|
|
3721
|
+
|
|
3722
|
+
O parametro opcional `Colunas` espera um objeto do tipo *lista* que
|
|
3723
|
+
contenha a relação das colunas a serem importadas. As colunas listadas
|
|
3724
|
+
neste objeto precisam existir nas duas pontas (dataframe e tabela). Caso
|
|
3725
|
+
seja omisso, todas as colunas do dataframe serão inseridas na tabela.
|
|
3726
|
+
Neste caso, admite-se que haja colunas na tabela que não exitam no
|
|
3727
|
+
dataframe (serão gravadas como NULL), mas o contrário provocará erro.
|
|
3728
|
+
|
|
3729
|
+
O último parametro opcional `OnConflict` espera uma declaração para
|
|
3730
|
+
tratar o que fazer caso o dado a ser inserido já exista na tabela,
|
|
3731
|
+
baseado na cláusula [*ON
|
|
3732
|
+
CONFLICT*](https://www.postgresql.org/docs/current/sql-insert.html#SQL-ON-CONFLICT)
|
|
3733
|
+
do comando INSERT. A claúsula deve ser declarada explicita e
|
|
3734
|
+
integralmente nessa variável (clausula, *target* e *action*) e não há
|
|
3735
|
+
crítica/validação desse argumento, podendo gerar erros se declarado
|
|
3736
|
+
inconforme com o padrão SQL.
|
|
3737
|
+
|
|
3738
|
+
Exemplo de uso:
|
|
3739
|
+
|
|
3740
|
+
from lbx_toolkit import postgreSQL
|
|
3741
|
+
from pathlib import Path
|
|
3742
|
+
|
|
3743
|
+
credenciais = {
|
|
3744
|
+
'dbname': 'NOME_BANCO',
|
|
3745
|
+
'user': 'USUARIO'',
|
|
3746
|
+
'password': 'SENHA',
|
|
3747
|
+
'host': 'IP_OU_DNS_SERVIDOR',
|
|
3748
|
+
'port': 'PORTA_POSTGRESQL', ## padrão = 5432
|
|
3749
|
+
}
|
|
3750
|
+
|
|
3751
|
+
conexao = postgreSQL.db(credenciais)
|
|
3752
|
+
|
|
3753
|
+
arquivo_csv = Path('./diretorio/arquivo_exemplo.csv')
|
|
3754
|
+
dados = postgreSQL.csv_df(arquivo_csv, CsvDelim=',') # usando vírgula como separador. se omisso, assume ";'
|
|
3755
|
+
|
|
3756
|
+
postgreSQL.db_insert_df(conexao, dados, 'teste_table', Schema='meu_esquema', OnConflict='on conflict (coluna_chave_primaria) do nothing')
|
|
3757
|
+
|
|
3758
|
+
# conexão com o banco precisa ser fechada explicitamente após a chamada do método, caso não seja mais utilizada:
|
|
3759
|
+
conexao.close()
|
|
3760
|
+
|
|
3761
|
+
4\) O método `postgreSQl.db_select()` executa consultas no banco de
|
|
3762
|
+
dados e retorna um `cursor` com o resultado.
|
|
3763
|
+
|
|
3764
|
+
A assinatura da função é `postgreSQL.db_select([conexao], [query])`
|
|
3765
|
+
|
|
3766
|
+
São permitidas apenas instruções de consulta (podendo serem complexas,
|
|
3767
|
+
por exemplo, com uso de
|
|
3768
|
+
[CTE](https://www.postgresql.org/docs/current/queries-with.html)). A
|
|
3769
|
+
presença de outras instruções SQL de manipulação de dados e metadados
|
|
3770
|
+
não são permitidas e abortarão a execução da query, se presentes.
|
|
3771
|
+
|
|
3772
|
+
O `cursor` é fechado no contexto do método, antes do retorno, *não
|
|
3773
|
+
podendo* ser manipulado após recebido como retorno da função.
|
|
3774
|
+
|
|
3775
|
+
A função retorna *dois objetos*, o primeiro contendo os dados do cursor,
|
|
3776
|
+
o segundo, contendo os nomes das respectivas colunas.
|
|
3777
|
+
|
|
3778
|
+
Exemplo de uso:
|
|
3779
|
+
|
|
3780
|
+
from lbx_toolkit import postgreSQL
|
|
3781
|
+
from pathlib import Path
|
|
3782
|
+
|
|
3783
|
+
credenciais = {
|
|
3784
|
+
'dbname': 'NOME_BANCO',
|
|
3785
|
+
'user': 'USUARIO'',
|
|
3786
|
+
'password': 'SENHA',
|
|
3787
|
+
'host': 'IP_OU_DNS_SERVIDOR',
|
|
3788
|
+
'port': 'PORTA_POSTGRESQL', ## padrão = 5432
|
|
3789
|
+
}
|
|
3790
|
+
|
|
3791
|
+
conexao = postgreSQL.db(credenciais)
|
|
3792
|
+
|
|
3793
|
+
query = 'select * from meu_esquema.teste_table'
|
|
3794
|
+
|
|
3795
|
+
dados, colunas = postgreSQL.db_select(conexao, query)
|
|
3796
|
+
conexao.close()
|
|
3797
|
+
|
|
3798
|
+
5\) O método `postgreSQl.db_update()` executa updates no banco
|
|
3799
|
+
|
|
3800
|
+
A assinatura da função é `postgreSQL.db_update([conexao], [query])`
|
|
3801
|
+
|
|
3802
|
+
São permitidas apenas instruções de update. A presença de outras
|
|
3803
|
+
instruções SQL de manipulação de dados e metadados não são permitidas e
|
|
3804
|
+
abortarão a execução da query.
|
|
3805
|
+
|
|
3806
|
+
A função retorna *a quantidade de linhas alteradas*.
|
|
3807
|
+
|
|
3808
|
+
Exemplo de uso:
|
|
3809
|
+
|
|
3810
|
+
from lbx_toolkit import postgreSQL
|
|
3811
|
+
from pathlib import Path
|
|
3812
|
+
|
|
3813
|
+
credenciais = {
|
|
3814
|
+
'dbname': 'NOME_BANCO',
|
|
3815
|
+
'user': 'USUARIO'',
|
|
3816
|
+
'password': 'SENHA',
|
|
3817
|
+
'host': 'IP_OU_DNS_SERVIDOR',
|
|
3818
|
+
'port': 'PORTA_POSTGRESQL', ## padrão = 5432
|
|
3819
|
+
}
|
|
3820
|
+
|
|
3821
|
+
conexao = postgreSQL.db(credenciais)
|
|
3822
|
+
|
|
3823
|
+
query = "update meu_esquema.teste_table set coluna='novo_valor' where pk='chave'"
|
|
3824
|
+
|
|
3825
|
+
result = postgreSQL.db_update(conexao, query)
|
|
3826
|
+
conexao.close()
|
|
3827
|
+
|
|
3828
|
+
Source code in `lbxtoolkit\__init__.py`
|
|
3829
|
+
|
|
3830
|
+
::: highlight
|
|
3831
|
+
+-----------------------------------+-----------------------------------+
|
|
3832
|
+
| ::: linenodiv | <div> |
|
|
3833
|
+
| 494 | |
|
|
3834
|
+
| 495 | cla |
|
|
3835
|
+
| 496 | ss postgreSQL: # Classe de acesso |
|
|
3836
|
+
| 497 | e interação com banco PostgreSQL |
|
|
3837
|
+
| 498 | """ |
|
|
3838
|
+
| 499 | |
|
|
3839
|
+
| 500 | #### Classe **postgreSQL** |
|
|
3840
|
+
| 501 | |
|
|
3841
|
+
| 502 | |
|
|
3842
|
+
| 503 | Recursos de interação com o ban |
|
|
3843
|
+
| 504 | co de dados relacional PostgreSQL |
|
|
3844
|
+
| 505 | |
|
|
3845
|
+
| 506 | 1) O método `post |
|
|
3846
|
+
| 507 | greSQl.db()` exige que as credenc |
|
|
3847
|
+
| 508 | iais e parametros de acesso sejam |
|
|
3848
|
+
| 509 | fornecidas em um *dicionário* co |
|
|
3849
|
+
| 510 | m, ao mínimo, o seguinte formato: |
|
|
3850
|
+
| 511 | |
|
|
3851
|
+
| 512 | ``` |
|
|
3852
|
+
| 513 | credenciais = { |
|
|
3853
|
+
| 514 | |
|
|
3854
|
+
| 515 | 'dbname': 'NOME_BANCO', |
|
|
3855
|
+
| 516 | |
|
|
3856
|
+
| 517 | 'user': 'USUARIO'', |
|
|
3857
|
+
| 518 | |
|
|
3858
|
+
| 519 | 'password': 'SENHA', |
|
|
3859
|
+
| 520 | |
|
|
3860
|
+
| 521 | 'host': 'IP_OU_DNS_SERVIDOR', |
|
|
3861
|
+
| 522 | |
|
|
3862
|
+
| 523 | 'port': 'POR |
|
|
3863
|
+
| 524 | TA_POSTGRESQL', ## padrão = 5432 |
|
|
3864
|
+
| 525 | } |
|
|
3865
|
+
| 526 | |
|
|
3866
|
+
| 527 | con |
|
|
3867
|
+
| 528 | exao = postgreSQL.db(credenciais) |
|
|
3868
|
+
| 529 | ``` |
|
|
3869
|
+
| 530 | |
|
|
3870
|
+
| 531 | O |
|
|
3871
|
+
| 532 | nome do schema é ser declarado n |
|
|
3872
|
+
| 533 | o contexto da query, mas se desej |
|
|
3873
|
+
| 534 | ar alterar o schema padrão, adici |
|
|
3874
|
+
| 535 | one *`'options' : '-c search_path |
|
|
3875
|
+
| 536 | =[NOME_SCHEMA]',`* ao dicionário. |
|
|
3876
|
+
| 537 | |
|
|
3877
|
+
| 538 | Qualqu |
|
|
3878
|
+
| 539 | er argumento de conexão previsto |
|
|
3879
|
+
| 540 | no pacote *psycopg2* são aceitos |
|
|
3880
|
+
| 541 | como entrada no dicionário acima. |
|
|
3881
|
+
| 542 | |
|
|
3882
|
+
| 543 | |
|
|
3883
|
+
| 544 | 2) O método `postgreSQl.csv_df( |
|
|
3884
|
+
| 545 | )` lê arquivo texto do tipo CSV e |
|
|
3885
|
+
| 546 | o converte para o objeto Datafra |
|
|
3886
|
+
| 547 | me do `pandas`. A assinatura da f |
|
|
3887
|
+
| 548 | unção exige que se forneça o cami |
|
|
3888
|
+
| 549 | nho do arquivo CSV e, opcionalmen |
|
|
3889
|
+
| 550 | te o caracter delimitador. Se o c |
|
|
3890
|
+
| 551 | aracter demilitador não for infor |
|
|
3891
|
+
| 552 | mado, será assumido `;`. Consider |
|
|
3892
|
+
| 553 | e usar a função `Path` para trata |
|
|
3893
|
+
| 554 | r o caminho do arquivo de origem. |
|
|
3894
|
+
| 555 | |
|
|
3895
|
+
| 556 | ``` |
|
|
3896
|
+
| 557 | from pathlib import Path |
|
|
3897
|
+
| 558 | arquivo_csv = Path(' |
|
|
3898
|
+
| 559 | ./diretorio/arquivo_exemplo.csv') |
|
|
3899
|
+
| 560 | dados = |
|
|
3900
|
+
| 561 | postgreSQL.csv_df(arquivo_csv, Cs |
|
|
3901
|
+
| 562 | vDelim=',') # usando vírgula como |
|
|
3902
|
+
| 563 | separador. se omisso, assume ";' |
|
|
3903
|
+
| 564 | ``` |
|
|
3904
|
+
| 565 | |
|
|
3905
|
+
| 566 | 3) O método `po |
|
|
3906
|
+
| 567 | stgreSQl.db_insert_df()` insere d |
|
|
3907
|
+
| 568 | ados a partir de um Dataframe (pa |
|
|
3908
|
+
| 569 | ndas) em uma tabela do banco com |
|
|
3909
|
+
| 570 | estrutura de colunas equivalente. |
|
|
3910
|
+
| 571 | |
|
|
3911
|
+
| 572 | A assinatur |
|
|
3912
|
+
| 573 | a da função é `postgreSQL.db_inse |
|
|
3913
|
+
| 574 | rt_df([conexao], [dataframe_orige |
|
|
3914
|
+
| 575 | m], [tabela_destino], Schema=None |
|
|
3915
|
+
| 576 | , Colunas=None, OnConflict=None)` |
|
|
3916
|
+
| 577 | |
|
|
3917
|
+
| 578 | |
|
|
3918
|
+
| 579 | É necessário que os nomes das |
|
|
3919
|
+
| 580 | colunas do dataframe coincidam c |
|
|
3920
|
+
| 581 | om o nome das colunas da tabela. |
|
|
3921
|
+
| 582 | |
|
|
3922
|
+
| 583 | Não há como traduzir/compa |
|
|
3923
|
+
| 584 | tibilizar (de-para) nomes de colu |
|
|
3924
|
+
| 585 | nas entre o dataframe e a tabela. |
|
|
3925
|
+
| 586 | |
|
|
3926
|
+
| 587 | Os três primeiros param |
|
|
3927
|
+
| 588 | etros são posicionais e correspon |
|
|
3928
|
+
| 589 | dem, respectivamente, (1) ao obje |
|
|
3929
|
+
| 590 | to da conexão com o banco, (2) ao |
|
|
3930
|
+
| 591 | objeto que contém o dataframe e |
|
|
3931
|
+
| 592 | (3) ao nome da tabela de destino. |
|
|
3932
|
+
| 593 | |
|
|
3933
|
+
| 594 | Assume-se que a tabela per |
|
|
3934
|
+
| 595 | tença ao schema padrão (definido |
|
|
3935
|
+
| 596 | na variável _search_path_ do serv |
|
|
3936
|
+
| 597 | idor). Caso a tabela de destino e |
|
|
3937
|
+
| 598 | steja em um _schema_ diferente do |
|
|
3938
|
+
| 599 | padrão, deve-se informar seu nom |
|
|
3939
|
+
| 600 | e no parâmetro opcional `Schema`. |
|
|
3940
|
+
| 601 | |
|
|
3941
|
+
| 602 | O parametro opcional |
|
|
3942
|
+
| 603 | `Colunas` espera um objeto do ti |
|
|
3943
|
+
| 604 | po _lista_ que contenha a relação |
|
|
3944
|
+
| 605 | das colunas a serem importadas. |
|
|
3945
|
+
| 606 | As colunas listadas n |
|
|
3946
|
+
| 607 | este objeto precisam existir nas |
|
|
3947
|
+
| 608 | duas pontas (dataframe e tabela). |
|
|
3948
|
+
| 609 | Caso seja omis |
|
|
3949
|
+
| 610 | so, todas as colunas do dataframe |
|
|
3950
|
+
| 611 | serão inseridas na tabela. Neste |
|
|
3951
|
+
| 612 | caso, admite-se que haja colunas |
|
|
3952
|
+
| 613 | na tabela que não exitam no data |
|
|
3953
|
+
| 614 | frame (serão gravadas como NULL), |
|
|
3954
|
+
| 615 | mas o contrário provocará erro. |
|
|
3955
|
+
| 616 | |
|
|
3956
|
+
| 617 | O último |
|
|
3957
|
+
| 618 | parametro opcional `OnConflict` e |
|
|
3958
|
+
| 619 | spera uma declaração para tratar |
|
|
3959
|
+
| 620 | o que fazer caso o dado a ser ins |
|
|
3960
|
+
| 621 | erido já exista na tabela, basead |
|
|
3961
|
+
| 622 | o na cláusula [*ON CONFLICT*](htt |
|
|
3962
|
+
| 623 | ps://www.postgresql.org/docs/curr |
|
|
3963
|
+
| 624 | ent/sql-insert.html#SQL-ON-CONFLI |
|
|
3964
|
+
| 625 | CT) do comando INSERT. A claúsula |
|
|
3965
|
+
| 626 | deve ser declarada explicita e i |
|
|
3966
|
+
| 627 | ntegralmente nessa variável (clau |
|
|
3967
|
+
| 628 | sula, _target_ e _action_) e não |
|
|
3968
|
+
| 629 | há crítica/validação desse argume |
|
|
3969
|
+
| 630 | nto, podendo gerar erros se decla |
|
|
3970
|
+
| 631 | rado inconforme com o padrão SQL. |
|
|
3971
|
+
| 632 | |
|
|
3972
|
+
| 633 | Exemplo de uso: |
|
|
3973
|
+
| 634 | |
|
|
3974
|
+
| 635 | ``` |
|
|
3975
|
+
| 636 | f |
|
|
3976
|
+
| 637 | rom lbx_toolkit import postgreSQL |
|
|
3977
|
+
| 638 | from pathlib import Path |
|
|
3978
|
+
| 639 | |
|
|
3979
|
+
| 640 | credenciais = { |
|
|
3980
|
+
| 641 | |
|
|
3981
|
+
| 642 | 'dbname': 'NOME_BANCO', |
|
|
3982
|
+
| 643 | |
|
|
3983
|
+
| 644 | 'user': 'USUARIO'', |
|
|
3984
|
+
| 645 | |
|
|
3985
|
+
| 646 | 'password': 'SENHA', |
|
|
3986
|
+
| 647 | |
|
|
3987
|
+
| 648 | 'host': 'IP_OU_DNS_SERVIDOR', |
|
|
3988
|
+
| 649 | |
|
|
3989
|
+
| 650 | 'port': 'POR |
|
|
3990
|
+
| 651 | TA_POSTGRESQL', ## padrão = 5432 |
|
|
3991
|
+
| 652 | } |
|
|
3992
|
+
| 653 | |
|
|
3993
|
+
| 654 | con |
|
|
3994
|
+
| 655 | exao = postgreSQL.db(credenciais) |
|
|
3995
|
+
| 656 | |
|
|
3996
|
+
| 657 | arquivo_csv = Path(' |
|
|
3997
|
+
| 658 | ./diretorio/arquivo_exemplo.csv') |
|
|
3998
|
+
| 659 | dados = |
|
|
3999
|
+
| 660 | postgreSQL.csv_df(arquivo_csv, Cs |
|
|
4000
|
+
| 661 | vDelim=',') # usando vírgula como |
|
|
4001
|
+
| 662 | separador. se omisso, assume ";' |
|
|
4002
|
+
| 663 | |
|
|
4003
|
+
| 664 | postg |
|
|
4004
|
+
| 665 | reSQL.db_insert_df(conexao, dados |
|
|
4005
|
+
| 666 | , 'teste_table', Schema='meu_esqu |
|
|
4006
|
+
| 667 | ema', OnConflict='on conflict (co |
|
|
4007
|
+
| 668 | luna_chave_primaria) do nothing') |
|
|
4008
|
+
| 669 | |
|
|
4009
|
+
| 670 | # conexão com |
|
|
4010
|
+
| 671 | o banco precisa ser fechada expl |
|
|
4011
|
+
| 672 | icitamente após a chamada do méto |
|
|
4012
|
+
| 673 | do, caso não seja mais utilizada: |
|
|
4013
|
+
| 674 | conexao.close() |
|
|
4014
|
+
| 675 | ``` |
|
|
4015
|
+
| 676 | |
|
|
4016
|
+
| 677 | 4) O método |
|
|
4017
|
+
| 678 | `postgreSQl.db_select()` executa |
|
|
4018
|
+
| 679 | consultas no banco de dados e ret |
|
|
4019
|
+
| 680 | orna um `cursor` com o resultado. |
|
|
4020
|
+
| 681 | |
|
|
4021
|
+
| 682 | A |
|
|
4022
|
+
| 683 | assinatura da função é `postgreS |
|
|
4023
|
+
| 684 | QL.db_select([conexao], [query])` |
|
|
4024
|
+
| 685 | |
|
|
4025
|
+
| 686 | Sã |
|
|
4026
|
+
| 687 | o permitidas apenas instruções de |
|
|
4027
|
+
| 688 | consulta (podendo serem complexa |
|
|
4028
|
+
| 689 | s, por exemplo, com uso de [CTE]( |
|
|
4029
|
+
| 690 | https://www.postgresql.org/docs/c |
|
|
4030
|
+
| 691 | urrent/queries-with.html)). A pre |
|
|
4031
|
+
| 692 | sença de outras instruções SQL de |
|
|
4032
|
+
| 693 | manipulação de dados e metadados |
|
|
4033
|
+
| 694 | não são permitidas e abortarão a |
|
|
4034
|
+
| 695 | execução da query, se presentes. |
|
|
4035
|
+
| 696 | |
|
|
4036
|
+
| 697 | |
|
|
4037
|
+
| 698 | O `cursor` é fechado no conte |
|
|
4038
|
+
| 699 | xto do método, antes do retorno, |
|
|
4039
|
+
| 700 | *não podendo* ser manipulado após |
|
|
4040
|
+
| 701 | recebido como retorno da função. |
|
|
4041
|
+
| 702 | |
|
|
4042
|
+
| 703 | |
|
|
4043
|
+
| 704 | A função retorna *dois obje |
|
|
4044
|
+
| 705 | tos*, o primeiro contendo os dado |
|
|
4045
|
+
| 706 | s do cursor, o segundo, contendo |
|
|
4046
|
+
| ::: | os nomes das respectivas colunas. |
|
|
4047
|
+
| | |
|
|
4048
|
+
| | Exemplo de uso: |
|
|
4049
|
+
| | |
|
|
4050
|
+
| | ``` |
|
|
4051
|
+
| | f |
|
|
4052
|
+
| | rom lbx_toolkit import postgreSQL |
|
|
4053
|
+
| | from pathlib import Path |
|
|
4054
|
+
| | |
|
|
4055
|
+
| | credenciais = { |
|
|
4056
|
+
| | |
|
|
4057
|
+
| | 'dbname': 'NOME_BANCO', |
|
|
4058
|
+
| | |
|
|
4059
|
+
| | 'user': 'USUARIO'', |
|
|
4060
|
+
| | |
|
|
4061
|
+
| | 'password': 'SENHA', |
|
|
4062
|
+
| | |
|
|
4063
|
+
| | 'host': 'IP_OU_DNS_SERVIDOR', |
|
|
4064
|
+
| | |
|
|
4065
|
+
| | 'port': 'POR |
|
|
4066
|
+
| | TA_POSTGRESQL', ## padrão = 5432 |
|
|
4067
|
+
| | } |
|
|
4068
|
+
| | |
|
|
4069
|
+
| | con |
|
|
4070
|
+
| | exao = postgreSQL.db(credenciais) |
|
|
4071
|
+
| | |
|
|
4072
|
+
| | query = 'selec |
|
|
4073
|
+
| | t * from meu_esquema.teste_table' |
|
|
4074
|
+
| | |
|
|
4075
|
+
| | dados, colunas = pos |
|
|
4076
|
+
| | tgreSQL.db_select(conexao, query) |
|
|
4077
|
+
| | conexao.close() |
|
|
4078
|
+
| | ``` |
|
|
4079
|
+
| | |
|
|
4080
|
+
| | |
|
|
4081
|
+
| | 5) O método `postgreSQl.db_u |
|
|
4082
|
+
| | pdate()` executa updates no banco |
|
|
4083
|
+
| | |
|
|
4084
|
+
| | A |
|
|
4085
|
+
| | assinatura da função é `postgreS |
|
|
4086
|
+
| | QL.db_update([conexao], [query])` |
|
|
4087
|
+
| | |
|
|
4088
|
+
| | Sã |
|
|
4089
|
+
| | o permitidas apenas instruções de |
|
|
4090
|
+
| | update. A presença de outras ins |
|
|
4091
|
+
| | truções SQL de manipulação de dad |
|
|
4092
|
+
| | os e metadados não são permitidas |
|
|
4093
|
+
| | e abortarão a execução da query. |
|
|
4094
|
+
| | |
|
|
4095
|
+
| | A função retorna *a |
|
|
4096
|
+
| | quantidade de linhas alteradas*. |
|
|
4097
|
+
| | |
|
|
4098
|
+
| | Exemplo de uso: |
|
|
4099
|
+
| | |
|
|
4100
|
+
| | ``` |
|
|
4101
|
+
| | f |
|
|
4102
|
+
| | rom lbx_toolkit import postgreSQL |
|
|
4103
|
+
| | from pathlib import Path |
|
|
4104
|
+
| | |
|
|
4105
|
+
| | credenciais = { |
|
|
4106
|
+
| | |
|
|
4107
|
+
| | 'dbname': 'NOME_BANCO', |
|
|
4108
|
+
| | |
|
|
4109
|
+
| | 'user': 'USUARIO'', |
|
|
4110
|
+
| | |
|
|
4111
|
+
| | 'password': 'SENHA', |
|
|
4112
|
+
| | |
|
|
4113
|
+
| | 'host': 'IP_OU_DNS_SERVIDOR', |
|
|
4114
|
+
| | |
|
|
4115
|
+
| | 'port': 'POR |
|
|
4116
|
+
| | TA_POSTGRESQL', ## padrão = 5432 |
|
|
4117
|
+
| | } |
|
|
4118
|
+
| | |
|
|
4119
|
+
| | con |
|
|
4120
|
+
| | exao = postgreSQL.db(credenciais) |
|
|
4121
|
+
| | |
|
|
4122
|
+
| | query = "update |
|
|
4123
|
+
| | meu_esquema.teste_table set colu |
|
|
4124
|
+
| | na='novo_valor' where pk='chave'" |
|
|
4125
|
+
| | |
|
|
4126
|
+
| | result = pos |
|
|
4127
|
+
| | tgreSQL.db_update(conexao, query) |
|
|
4128
|
+
| | conexao.close() |
|
|
4129
|
+
| | ``` |
|
|
4130
|
+
| | |
|
|
4131
|
+
| | """ |
|
|
4132
|
+
| | def __i |
|
|
4133
|
+
| | nit__(self, config, logger=None): |
|
|
4134
|
+
| | |
|
|
4135
|
+
| | self.logger = logger if not l |
|
|
4136
|
+
| | ogger is None else lbx_logger(Non |
|
|
4137
|
+
| | e, logging.DEBUG, '%(levelname)s: |
|
|
4138
|
+
| | %(message)s') # se não fornecer |
|
|
4139
|
+
| | o logger, vai tudo para o console |
|
|
4140
|
+
| | |
|
|
4141
|
+
| | try: |
|
|
4142
|
+
| | |
|
|
4143
|
+
| | self.Conexao = psyco |
|
|
4144
|
+
| | pg2.connect(**config) ## na cham |
|
|
4145
|
+
| | ada de uma função/método, o * exp |
|
|
4146
|
+
| | lode os valores de um dicionário |
|
|
4147
|
+
| | em argumentos posicionais (só val |
|
|
4148
|
+
| | ores) e ** explode discionário em |
|
|
4149
|
+
| | argumentos nominais (nome=valor) |
|
|
4150
|
+
| | |
|
|
4151
|
+
| | except Exception as Err: |
|
|
4152
|
+
| | raise |
|
|
4153
|
+
| | # |
|
|
4154
|
+
| | # |
|
|
4155
|
+
| | def csv_df(self, C |
|
|
4156
|
+
| | svPath, CsvDelim=';'): # Le arqui |
|
|
4157
|
+
| | vo CSV e gera Dataframe do Pandas |
|
|
4158
|
+
| | try: |
|
|
4159
|
+
| | |
|
|
4160
|
+
| | DataFrame = pd.read_cs |
|
|
4161
|
+
| | v(CsvPath, delimiter=CsvDelim) # |
|
|
4162
|
+
| | Verifique se o delimitador é ';' |
|
|
4163
|
+
| | |
|
|
4164
|
+
| | DataFrame.replace({np.nan: |
|
|
4165
|
+
| | None}, inplace=True) ## troca 'N |
|
|
4166
|
+
| | aN' por None (null no postgresql) |
|
|
4167
|
+
| | return DataFrame |
|
|
4168
|
+
| | |
|
|
4169
|
+
| | except Exception as Err: |
|
|
4170
|
+
| | raise |
|
|
4171
|
+
| | # |
|
|
4172
|
+
| | # |
|
|
4173
|
+
| | def db_insert_df(self, Da |
|
|
4174
|
+
| | taFrame, Tabela, Schema=None, Col |
|
|
4175
|
+
| | unas=None, OnConflict=None): # In |
|
|
4176
|
+
| | sere os dados de um dataframe em |
|
|
4177
|
+
| | uma tabela equivalente no banco ( |
|
|
4178
|
+
| | exige mesma estrutura de colunas) |
|
|
4179
|
+
| | # Essa função ex |
|
|
4180
|
+
| | ige que os nomes dos cabeçalhos d |
|
|
4181
|
+
| | as colunas do CSV sejam os mesmos |
|
|
4182
|
+
| | das colunas da tabela de destino |
|
|
4183
|
+
| | |
|
|
4184
|
+
| | Colunas = Colunas or DataFram |
|
|
4185
|
+
| | e.columns.tolist() # Caso não |
|
|
4186
|
+
| | seja fornecida a lista de coluna |
|
|
4187
|
+
| | s, assume as colunas do DataFrame |
|
|
4188
|
+
| | V |
|
|
4189
|
+
| | alores = [tuple(Linha) for Linha |
|
|
4190
|
+
| | in DataFrame[Colunas].values] |
|
|
4191
|
+
| | |
|
|
4192
|
+
| | Schema = Schema or 'public' |
|
|
4193
|
+
| | Query = |
|
|
4194
|
+
| | f'insert into {Schema}.{Tabela} ( |
|
|
4195
|
+
| | {', '.join(Colunas)}) values %s ' |
|
|
4196
|
+
| | |
|
|
4197
|
+
| | if not OnConflict is None: |
|
|
4198
|
+
| | |
|
|
4199
|
+
| | Query = Query + OnConflict |
|
|
4200
|
+
| | |
|
|
4201
|
+
| | try: |
|
|
4202
|
+
| | sel |
|
|
4203
|
+
| | f.Cursor = self.Conexao.cursor() |
|
|
4204
|
+
| | execute_valu |
|
|
4205
|
+
| | es(self.Cursor, Query, Valores) |
|
|
4206
|
+
| | |
|
|
4207
|
+
| | self.Conexao.commit() |
|
|
4208
|
+
| | |
|
|
4209
|
+
| | except Exception as Err: |
|
|
4210
|
+
| | |
|
|
4211
|
+
| | self.Conexao.rollback() |
|
|
4212
|
+
| | raise |
|
|
4213
|
+
| | finally: |
|
|
4214
|
+
| | |
|
|
4215
|
+
| | self.Cursor.close() |
|
|
4216
|
+
| | #Conexao.cl |
|
|
4217
|
+
| | ose() ## conexão precisa ser fech |
|
|
4218
|
+
| | ada explicitamente fora da classe |
|
|
4219
|
+
| | # |
|
|
4220
|
+
| | # |
|
|
4221
|
+
| | def |
|
|
4222
|
+
| | db_select(self, Query): # Retorn |
|
|
4223
|
+
| | a um cursor à partir de um select |
|
|
4224
|
+
| | BlackList |
|
|
4225
|
+
| | = ['INSERT ', 'DELETE ', 'UPDATE |
|
|
4226
|
+
| | ', 'CREATE ', 'DROP ', 'MERGE ', |
|
|
4227
|
+
| | 'REPLACE ', 'CALL ', 'EXECUTE '] |
|
|
4228
|
+
| | |
|
|
4229
|
+
| | if any(element in Query.u |
|
|
4230
|
+
| | pper() for element in BlackList): |
|
|
4231
|
+
| | |
|
|
4232
|
+
| | BlackListed = [eleme |
|
|
4233
|
+
| | nt for element in BlackList if el |
|
|
4234
|
+
| | ement in Query.upper()] |
|
|
4235
|
+
| | self.logger |
|
|
4236
|
+
| | .erro(f'{__name__}: Este método p |
|
|
4237
|
+
| | ermite apenas consultas. A query |
|
|
4238
|
+
| | informada possui as seguintes pal |
|
|
4239
|
+
| | avras reservadas não aceitas: {Bl |
|
|
4240
|
+
| | ackListed} e não foi executada!') |
|
|
4241
|
+
| | return None |
|
|
4242
|
+
| | else: |
|
|
4243
|
+
| | try: |
|
|
4244
|
+
| | se |
|
|
4245
|
+
| | lf.Cursor = self.Conexao.cursor() |
|
|
4246
|
+
| | |
|
|
4247
|
+
| | self.Cursor.execute(Query) |
|
|
4248
|
+
| | |
|
|
4249
|
+
| | Dados = self.Cursor.fetchall() |
|
|
4250
|
+
| | |
|
|
4251
|
+
| | Colunas = [Col[0] fo |
|
|
4252
|
+
| | r Col in self.Cursor.description] |
|
|
4253
|
+
| | |
|
|
4254
|
+
| | self.Conexao.commit() |
|
|
4255
|
+
| | |
|
|
4256
|
+
| | self.Cursor.close() |
|
|
4257
|
+
| | |
|
|
4258
|
+
| | return Dados, Colunas |
|
|
4259
|
+
| | |
|
|
4260
|
+
| | except Exception as Err: |
|
|
4261
|
+
| | |
|
|
4262
|
+
| | self.Conexao.rollback() |
|
|
4263
|
+
| | raise |
|
|
4264
|
+
| | # |
|
|
4265
|
+
| | # |
|
|
4266
|
+
| | def |
|
|
4267
|
+
| | db_update(self, Query): # Retorn |
|
|
4268
|
+
| | a um cursor à partir de um select |
|
|
4269
|
+
| | UpdRows = 0 |
|
|
4270
|
+
| | BlackList |
|
|
4271
|
+
| | = ['INSERT ', 'DELETE ', 'SELECT |
|
|
4272
|
+
| | ', 'CREATE ', 'DROP ', 'MERGE ', |
|
|
4273
|
+
| | 'REPLACE ', 'CALL ', 'EXECUTE '] |
|
|
4274
|
+
| | |
|
|
4275
|
+
| | if any(element in Query.u |
|
|
4276
|
+
| | pper() for element in BlackList): |
|
|
4277
|
+
| | |
|
|
4278
|
+
| | BlackListed = [eleme |
|
|
4279
|
+
| | nt for element in BlackList if el |
|
|
4280
|
+
| | ement in Query.upper()] |
|
|
4281
|
+
| | self.logg |
|
|
4282
|
+
| | er.erro(f'{__name__}: Este método |
|
|
4283
|
+
| | permite apenas updates. A query |
|
|
4284
|
+
| | informada possui as seguintes pal |
|
|
4285
|
+
| | avras reservadas não aceitas: {Bl |
|
|
4286
|
+
| | ackListed} e não foi executada!') |
|
|
4287
|
+
| | |
|
|
4288
|
+
| | return None |
|
|
4289
|
+
| | else: |
|
|
4290
|
+
| | try: |
|
|
4291
|
+
| | se |
|
|
4292
|
+
| | lf.Cursor = self.Conexao.cursor() |
|
|
4293
|
+
| | |
|
|
4294
|
+
| | self.Cursor.execute(Query) |
|
|
4295
|
+
| | |
|
|
4296
|
+
| | UpdRows = self.Cursor.rowcount |
|
|
4297
|
+
| | |
|
|
4298
|
+
| | self.Conexao.commit() |
|
|
4299
|
+
| | |
|
|
4300
|
+
| | self.Cursor.close() |
|
|
4301
|
+
| | |
|
|
4302
|
+
| | return UpdRows |
|
|
4303
|
+
| | |
|
|
4304
|
+
| | except Exception as Err: |
|
|
4305
|
+
| | |
|
|
4306
|
+
| | self.Conexao.rollback() |
|
|
4307
|
+
| | raise |
|
|
4308
|
+
| | |
|
|
4309
|
+
| | </div> |
|
|
4310
|
+
+-----------------------------------+-----------------------------------+
|
|
4311
|
+
:::
|
|
4312
|
+
|
|
4313
|
+
::: {.doc .doc-children}
|
|
4314
|
+
:::
|
|
4315
|
+
:::::
|
|
4316
|
+
::::::
|
|
4317
|
+
:::::::::::::::::::::::::::::::::::::::::::
|
|
4318
|
+
::::::::::::::::::::::::::::::::::::::::::::
|
|
4319
|
+
:::::::::::::::::::::::::::::::::::::::::::::
|
|
4320
|
+
::::::::::::::::::::::::::::::::::::::::::::::
|
|
4321
|
+
:::::::::::::::::::::::::::::::::::::::::::::::::::::
|
|
4322
|
+
::::::::::::::::::::::::::::::::::::::::::::::::::::::
|
|
4323
|
+
|
|
4324
|
+
::::: {.md-footer-meta .md-typeset}
|
|
4325
|
+
:::: {.md-footer-meta__inner .md-grid}
|
|
4326
|
+
::: md-copyright
|
|
4327
|
+
Made with [Material for
|
|
4328
|
+
MkDocs](https://squidfunk.github.io/mkdocs-material/){target="_blank"
|
|
4329
|
+
rel="noopener"}
|
|
4330
|
+
:::
|
|
4331
|
+
::::
|
|
4332
|
+
:::::
|
|
4333
|
+
::::::::::::::::::::::::::::::::::::::::::::::::::::::::::
|
|
4334
|
+
|
|
4335
|
+
:::: {.md-dialog md-component="dialog"}
|
|
4336
|
+
::: {.md-dialog__inner .md-typeset}
|
|
4337
|
+
:::
|
|
4338
|
+
::::
|
|
4339
|
+
|