Skip to content

Commit

Permalink
Merge pull request #1610 from totvs/venvdoc
Browse files Browse the repository at this point in the history
Venvdoc
  • Loading branch information
renanllisboa authored Dec 5, 2024
2 parents 6696098 + e4e7bd6 commit e842035
Show file tree
Hide file tree
Showing 3 changed files with 32 additions and 1 deletion.
31 changes: 31 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -88,6 +88,37 @@ We have a repository with different samples of TIR scripts:

[TIR Script Samples](https://github.com/totvs/tir-script-samples)


# Utilizando TIR com ambiente virtual

## Conhecendo o conceito
Para execução do TIR em ambiente virtual, utilizaremos a biblioteca **Virtualenv**. Essa é uma ferramenta usada em Python para criar ambientes **isolados**. Cada ambiente virtual tem seus próprios diretórios de instalação de pacotes, separados do ambiente **global** do sistema. Isso é útil para gerenciar dependências de **diferentes** projetos/versões sem conflito.

## Configurando com VScode
### Instalando a biblioteca e Criando o ambiente
1. No terminal, execute o comando `pip install virtualenv` para instalar a biblioteca de ambiente virtual.

2. Ainda no terminal, execute o comando `python -m virtualenv venv` para criação de um ambiente no diretório atual.
>**Nota:** Caso você possua mais de uma versão de Python instalada pode ser necessário especificar a versão desejada. Verifique o caminho de instalação do executável e referencie ele no comando
Exemplo: `C:/caminho/python/python -m virtualenv venv`
>>Por padrao a pasta de instalaçao do Pyhon fica em **C:\Users\[user]\AppData\Local\Programs\Python\Python[version]**.
3. Será adicionada uma pasta (venv) no diretório atual , com isso o ambiente estará pronto para utilização.

### Configurando o Vscode
Após a configuração do ambiente virtual iremos definir o interpretador do VScode para utiliza-lo
1. Com o VScode aberto na pasta do projeto, pressione `Ctrl + Shift + P` e pesquise pela opção `>Python: Select Interpreter`

2. Na lista de interpretadores reconhecidos no sistema, selecione o interpretador anteriormente criado, caminho padrão é: **_./venv/Scripts/python.exe_** . Ao selecionar, o interpretador padrao utilizado se tornara esse, caso deseje utilizar outro é só seleciona-lo na lista.

3. Abra um novo terminal no Vscode indo em _"Terminal"_ e _"Novo terminal"_

4. Ao abrir o terminal veja se está inicializada a venv na linha de comando. ![venv](doc_files\source\img\terminal_venv.png)

5. Agora rode o comando para instalação do TIR! `pip install tir_framework`

7. Pronto! Agora seu tir esta pronto para executar em um ambiente isolado!.


## Contact

[Gitter](https://gitter.im/totvs-tir/General)
Expand Down
Binary file added doc_files/source/img/terminal_venv.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
2 changes: 1 addition & 1 deletion setup.py
Original file line number Diff line number Diff line change
Expand Up @@ -48,7 +48,7 @@
'pyodbc==4.0.39',
'psutil==5.9.5',
'lxml==4.6.5',
'opencv-python==4.6.0.66',
'opencv-python==4.8.1.78',
'webdriver-manager'
],
packages=find_packages(),
Expand Down

0 comments on commit e842035

Please sign in to comment.