Projeto Theia

O que é?

O Projeto Theia é um plugin opcional desenvolvido em Ruby para o Projeto Íris. Este plugin permite a adição de funcionalidades personalizadas em Ruby, incluindo o uso de ilimitadas GEMs e outros códigos em Ruby Scripting. Com o Projeto Theia, você pode personalizar o Projeto Íris sem a necessidade de modificar seu código principal ou aprender Node.js (JavaScript).

Requisitos

Para garantir o correto funcionamento do Projeto Theia, o Projeto Íris deve estar ativo. Observe que a versão atual do Projeto Theia é experimental e foi desenvolvida em pouco tempo para fins de aprendizado, podendo conter erros menores.

Ruby:
- É recomendada a versão mais recente disponível, mas acima ou equivalente da v3.3.5 provavelmente funcionará.
Projeto Íris:
- Deve estar instalada e em execução.
Dependências do Projeto Íris:
- Instale todas as dependências necessárias do Projeto Íris para assegurar o correto funcionamento da Theia.

Instalação

Para instalar as dependências do Projeto Theia, você tem duas opções:

Usando NPM:
- Embora o Projeto Theia NÃO UTILIZE JavaScript, você pode instalar os módulos Ruby via NPM por conta das configurações inseridas para facilitar o uso de quem veio pelo Node.js.
- Utilize o seguinte comando:
```
npm run install
```
- Este comando executará o GEM por meio do NPM para instalar os requisitos do Ruby.
- O NPM também pode ser usado para iniciar, como dito na etapa Execução.
Alternativamente:
- Instale diretamente com BUNDLE:
```
bundle install
```
- Caso você não possua o comando bundle, tente instalar usando:
```
gem install bundler
```
- Alternativamente, para Linux, você pode tentar usar:
```
sudo gem install bundler
```
- Caso você não consiga, entre em contato com o suporte do projeto ou tente encontrar guias que funcionem para seu sistema operacional.

Execução

Não é necessário qualquer scan de QR, inserção de código ou demais, basta que sua Íris esteja rodando.

Após a instalação das dependências, você pode executar o Projeto Theia de duas maneiras:

Usando NPM:
- O Projeto Theia pode ser iniciado via NPM com um dos seguintes comandos:
```
npm start
```
  ou
```
npm run start
```
- Isso executará o script Ruby diretamente por meio do NPM.
Alternativamente:
- Execute diretamente com Ruby:
```
ruby start.rb
```

Modificação

Se você não tem experiência com Ruby, a maneira mais simples de modificar o Projeto Theia é através do sistema Cases, localizado em src/Commands/Cases/index.rb. Lá você encontrará um comando de exemplo que pode ser usado como base para criar novos comandos.

Todos os parâmetros do Projeto Íris estão acessíveis via env['nomeDaVariavel'], permitindo que você utilize as funcionalidades do Projeto Íris em seu código Ruby, independente de como seja feito, incluindo async.

Configuração

Para testar o Projeto Theia com versões anteriores do Projeto Íris, ajuste a porta HTTPS do Projeto Íris localizada aqui para 3000, ou edite a porta na configuração config.json, localizada na pasta settings do Projeto Theia.

Detalhes Adicionais

Informações da Versão:

Codinome: Ether
Versão: v1.0.0
Tipo: BETA
Erros: Nenhum bug grave detectado
Data de Lançamento: 15/09/2025
Observações: Esta versão pode apresentar problemas menores não graves devido à ausência de alguns parâmetros opcionais ainda não integrados no Projeto Íris. Atualizações futuras do Projeto Íris resolverão essas questões, garantindo a integração completa e o funcionamento adequado dos parâmetros. Não será necessário reinstalar a Theia para aplicar essas atualizações, pois os parâmetros já estarão incorporados nas futuras versões da Íris, e nenhuma intervenção adicional será necessária no Projeto Theia, a menos que haja novas atualizações da mesma.

Desenvolvimento Futuro

Estarei trabalhando em novas funcionalidades e atualizações tanto para o Projeto Íris quanto para o Projeto Theia, e eventualmente em versões para outras linguagens de programação. Fique atento às atualizações e acompanhe as redes sociais para mais informações!

Obrigado pelo seu interesse e apoio! Vamos continuar evoluindo juntos a um open-source melhor! ❤️

KillovSky/Theia