Skip to content

Latest commit

 

History

History
55 lines (43 loc) · 3.09 KB

README.md

File metadata and controls

55 lines (43 loc) · 3.09 KB
Raw

Photo Downloader

##1. Introdução O Photo Downloader é um serviço que armazena as fotos obtidas durante a execução de atividade na plataforma uMov.me. Após exportar o arquivo no formato .CSV contendo os dados coletados, é preciso mapear em um arquivo de configuração quais os indices (do .CSV) as fotos/imagens estão localizados e também permite configurar pastas e subpastas para melhor organização das fotos armazenadas.

##2. Instalação Para executar o Photo Downloader é preciso realizar os passos abaixo

####2.1. Instalar Ruby O serviço foi desenvolvido na linguagem ruby, por isso é necessário instalar esta a linguagem na máquina onde o serviço será executado. Os instaladores podem ser obtidos em:

####2.2. Instalar Ruby Gems RubyGem é uma biblioteca, um conjunto de arquivos Ruby reusáveis, necessário para executar programas desenvolvidos na linguagem ruby. Pode ser obtido em https://rubygems.org

####2.3. Download do serviço O serviço está disponibilizado publicamente em https://github.com/umovme/photo-downloader e existem duas maneira de baixá-lo: *Realizar o download do arquivo zip *Clonar o projeto executando o comando no terminal: git clone https://github.com/umovme/photo-downloader.git

####2.4. Instalando o Photo Downloader Após baixar o serviço, acesse o diretório /photo-downloader (caso baixar o zip então o diretorio será /photo-downloader-master) e execute o comando abaixo para configurar a aplicação: ruby setup.rb

Após a execução do setup.rb serão criadas as pastas /file-to-process, /photo e a /log

##3. Configuração O arquivo, no formato .CSV, contendo os dados exportados deve ser incluído na pasta /file-to-process

####3.1. Configuração do ambiente O arquivo /conf/environment.yml destina-se à configuração das pastas, subpastas e fotos atribuindo a cada uma delas o respectivo índice no arquivo exportado. No exemplo abaixo, foi definido que será criado uma pasta /photos contendo as subpastas definidas no índice 3 e 0, respectivamente para a pasta de primeiro nível e de segundo nível. As fotos serão encontrados nos índices 33, 34 e 45

photo_path: photos
files_folder: files_to_process
files_extension: '*.csv'
index_first_level_photo_folder: 3
index_second_level_photo_folder: 0
indexes_photo_url:
    - 33
    - 35
    - 43

OBS: Os parâmetros photo_path, files_folder e files_extension podem ser alterados, porém é preciso que seja realizado antes de rodas o comando ruby setup.rb

##4. Executar o serviço Visto que a instalação e configuração foram realizadas com sucesso, então o serviço está pronto para ser executado, para tanto execute o comando abaixo. ruby run.rb

##5. Verificação dos logs do serviço O arquivo de log é gerado a cada execução do serviço, caso ainda não exista. Serve basicamente para informar cada linha que está sendo processada, verificando se existe foto nos indices informados anteriormente.