{"id":15048940,"url":"https://github.com/biogui/simulador-runcodes","last_synced_at":"2025-07-20T06:04:10.419Z","repository":{"id":104235788,"uuid":"292356231","full_name":"biogui/simulador-runcodes","owner":"biogui","description":"[PT-BR] Um script em python que simula o processo de correção do run.condes para programas em C ou compilados/executados via Makefile.","archived":false,"fork":false,"pushed_at":"2021-07-20T04:18:06.000Z","size":22,"stargazers_count":22,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-06-06T01:41:40.811Z","etag":null,"topics":["c-language","makefiles","python-scripts","valgrind"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/biogui.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2020-09-02T17:58:57.000Z","updated_at":"2024-02-20T04:54:30.000Z","dependencies_parsed_at":null,"dependency_job_id":"43209bbc-09b7-465f-8376-aca81ed06b9d","html_url":"https://github.com/biogui/simulador-runcodes","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/biogui/simulador-runcodes","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/biogui%2Fsimulador-runcodes","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/biogui%2Fsimulador-runcodes/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/biogui%2Fsimulador-runcodes/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/biogui%2Fsimulador-runcodes/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/biogui","download_url":"https://codeload.github.com/biogui/simulador-runcodes/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/biogui%2Fsimulador-runcodes/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":266076035,"owners_count":23872729,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["c-language","makefiles","python-scripts","valgrind"],"created_at":"2024-09-24T21:17:15.753Z","updated_at":"2025-07-20T06:04:10.369Z","avatar_url":"https://github.com/biogui.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# **Simulador runcodes**\r\n[![Py3.9](https://img.shields.io/badge/Python-3.9-blueviolet.svg)](https://docs.python.org/release/3.9.0/whatsnew/changelog.html#changelog)\r\n[![license](https://img.shields.io/badge/license-MIT-blueviolet.svg)](https://github.com/biogui/simple-image-editor-with-openCV/blob/master/LICENSE)\r\n\r\nOlá, eu sou o [Bio](https://github.com/biogui)!\r\n\r\nE esse é um script em python para usuários do [run.codes](https://we.run.codes/) testarem seus programas localmente.\r\n\r\nObrigado por testar, feedbacks são bem vindos no meu telegram [(clica aqui)](https://t.me/gui_bio) :) .\r\n\r\n## **Recursos** (exemplos no fim)\r\n- ***Contagem de casos corretos***, mostrando o resultado em relação ao total de casos.\r\n\r\n- ***Verificação de diferenças detalhada***, feita via comparação byte a byte da saída esperada com a saída gerada.\r\n\r\n- ***Checagem de memória***, feita via comando `valgrind`, detalhando \"bugs\" em relação ao uso geral de memória.\r\n\r\n## **Instalando**\r\nCertifique-se de:\r\n- Ter uma versão recente [(3.x.x)](https://www.python.org/downloads/) de  ***python*** instalada.\r\n- Ter as seguintes ferramentas disponíveis em seu terminal Linux:\r\n\t- ***gcc***      - use `sudo apt install gcc`\r\n\t- ***valgrind*** - use `sudo apt install valgrind`\r\n\t- ***unzip***    - use `sudo apt install unzip`\r\n\r\nDepois disso, basta clonar o repositório e rodar o ***setup.sh***:\r\n\r\n```bash\r\ngit clone https://github.com/biogui/simulador-runcodes.git ~/.rcSim\r\n```\r\n\r\n```bash\r\ncd ~/.rcSim\r\n```\r\n\r\n```bash\r\nsh setup.sh\r\n```\r\n\r\n## **Uso**\r\nAgora, em qualquer diretório, basta ***usar o comando `rcsim`***:\r\n```bash\r\nrcsim \u003ccaminhoDoPrograma\u003e \u003ccaminhoDosTestes\u003e \u003ccaminhoDosArquivos(opcional)\u003e\r\n```\r\n\r\n***Obs.:*** *`rcsim` pode ser trocado por `python3 rcSim.py`, mas é necessário que o script do simulador esteja na pasta atual.*\r\n\r\n#### **O `\u003ccaminhoDoPrograma\u003e`**\r\nEsse simulador suporta dois tipos de programas: aqueles com um único arquivo .c e aqueles compilados/executados via arquivo Makefile. Em `\u003ccaminhoDoPrograma\u003e` deve ser passado o caminho (absoluto ou relativo) desse arquivo .c ou Makefile.\r\n\r\n#### **O `\u003ccaminhoDosTestes\u003e`**\r\nEsse simulador suporta dois modos de adição de testes: via uma pasta contendo as entradas (arquivos do tipo .in) e as respectivas saídas esperadas (arquivos do tipo .out) ou um arquivo .zip arquivo de mesmo conteúdo. Em `\u003ccaminhoDosTestes\u003e` deve ser passado o caminho (absoluto ou relativo) dessa pasta ou desse arquivo .zip.\r\n\r\n#### **O `\u003ccaminhoDosArquivos\u003e` (opcional)**\r\nEsse simulador suporta dois modos de adição de arquivos para execução, caso necessário: via uma pasta contendo os arquivos necessários ou um arquivo .zip arquivo de mesmo conteúdo. Em `\u003ccaminhoDosTestes\u003e` deve ser passado o caminho (absoluto ou relativo) dessa pasta ou desse arquivo .zip.\r\n\r\n***Obs.:*** *`\u003ccaminhoDosArquivos\u003e` pode ser igual ao `\u003ccaminhoDosArquivos\u003e`, o simulador organiza os testes e arquivos em novas pastas (\"rcSimTestes\", \"rcSimArquivos\" e \"rcSimSaidas\") criadas durante execução do script. Essas pastas não são deletadas automaticamente ao fim da execução, para, caso ocorrá algum erro, o usuário possa verificar as saídas. Ao fim do uso basta rodar `rm -rf rcSim*` para limpar os dados gerados pelo simulador.*\r\n\r\n## **Notas**\r\n- ***Priorize rodar o simulador na pasta onde está contido seu programa ou arquivo Makefile***.\r\n- ***Evite matar o processo durante sua execução***. Interrupções inesperadas podem gerar problemas futuros, seja paciente.\r\n- ***Atente-se à organização dos casos testes na pasta ou arquivo .zip usado***. Certifique-se de que o número de entradas é equivalente ao número de saídas esperadas e de que exista a respectiva saída \"x.out\" para cada entrada \"x.in\".\r\n\r\n## **Exemplos**\r\n- ***Contagem de casos corretos***\r\n\u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;![](https://i.imgur.com/yK2ZW3n.png)\r\n\u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;![](https://i.imgur.com/j8BMdFU.png)\r\n\u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;![](https://i.imgur.com/YfZo5cH.png)\r\n\r\n- ***Verificação de diferenças detalhada***\r\n\u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;![](https://i.imgur.com/6cOLKSz.png)\r\n\u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;![](https://i.imgur.com/TBF7y1M.png)\r\n\u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;![](https://i.imgur.com/WVzuNg0.png)\r\n\u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;![](https://i.imgur.com/Bo2ePeO.png)\r\n\u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;![](https://i.imgur.com/7ypCRYn.png)\r\n\r\n- ***Checagem de memória***\r\n\u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;![](https://i.imgur.com/Ih5lxEX.png)\r\n\u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;![](https://i.imgur.com/lUGTpv7.png)\r\n\u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;![](https://i.imgur.com/qrsGW34.png)\r\n\u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;![](https://i.imgur.com/Sag8zsJ.png)\r\n\u0026nbsp;\u0026nbsp;\u0026nbsp;\u0026nbsp;![](https://i.imgur.com/NxivAag.png)\r\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbiogui%2Fsimulador-runcodes","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbiogui%2Fsimulador-runcodes","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbiogui%2Fsimulador-runcodes/lists"}