Primeiros passos

Segunda, 9 de março de 2020

Linha de comando

Para fazer as tarefas que são solicitadas nessa disciplina, você deve se familiarizar com a interação com o computador através de linha de comando. No GNU/Linux, uma dos interpretadores de comando mais utilizado é o Bash. Nessa tarefa, iremos ver como dar comando ao computador utilizando o Bash. Caso queira, você poderá utilizar outros interpretadores de comando.

Se você não tem uma distribuição GNU/Linux instalada em seu computador, consulte aqui como instalar o Ubuntu. Você também pode instalar o Ubuntu (ou outras distribuições GNU/Linux no Windows). Clique aqui para mais informações.

A primeira atividade é criar um diretório e ver o seu conteúdo. Para isso, abra o terminal e execute o comando abaixo.

mkdir diretorio

Para navegar para esse diretório, podemos utilizar o comando cd.

cd diretorio

Agora, liste o conteúdo desse diretório.

ls

O nosso diretório contém apenas os diretórios padrões . e ... O primeiro corresponde ao diretório atual e o segundo ao diretório pai.

Para vermos os comandos para copiar e mover arquivos, crie um arquivo nesse diretório utilizando o comando touch. Será criado um arquivo sem conteúdo.

touch arquivo.txt

Se você listar o conteúdo desse diretório, deverá ver o arquivo que acabou de criar.

Agora, crie um subdiretório.

mkdir sub-dir

Copie o arquivo arquivo.txt para esse subdiretório com o comando cp.

cp arquivo.txt sub-dir/

Crie um novo arquivo.

touch arquivo2.txt

Move esse novo arquivo para o subdiretório com o comando mv.

mv arquivo2.txt sub-dir/

Navegue para o subdiretório e liste o seu conteúdo.

cd sub-dir
ls

Para remover um arquivo, utilize o comando rm.

rm arquivo.txt

Volte para o diretório pai e remova o subdiretório com todo o seu conteúdo.

cd ..
rm -r sub-dir

Instalando o Python

No Ubuntu, e em distribuições GNU/Linux baseadas, você pode instalar o Python 3.x com os comandos abaixo.

sudo apt update
sudo apt install python3

Execute python3 --version para ver a versão instalada.

Para outras distribuições, você pode consultar o site oficial do Python.

Para o Windows, você pode seguir esse tutorial.

Usando o Git

O Git é uma ferramenta de controle de versão distribuída. Para mais detalhes, ou para a instalação em um sistema operacional diferente, leia o tutorial Introdução ao GIT.

No contexto da disciplina, o Git é uma ferramenta para o acompanhamento das tarefas feitas durante o semestre. A partir dele, @s estudantes terão acesso a uma série de tarefas que servirão de avaliação.

Antes de começar é preciso instalar o Git para torná-lo disponível em seu computador. Abra o terminal e execute o comando abaixo.

sudo apt install git

Verifique se a instalação ocorreu com sucesso com o camando git --version.

Clonando seu repositório pessoal

Na primeira aula, o professor irá criar um repositório no Gitlab do IC para cada estudante. Antes de ser possível criar o repositório, é necessário que cada estudante entre https://gitlab.ic.unicamp.br) e realize o login pela primeira vez.

Uma vez criado o repositório, é possível cloná-lo para a sua máquina, realizar alterações e depois sincronizá-lo com o repositório remoto.

Na página principal do seu repositório, clique no botão Clone e copie a URL sobre Clone with HTTPS.

Abra o terminal dentro do diretório que ficará o repositório e digite git clone e cole a URL copiada anteriomente.

git clone https://gitlab.ic.unicamp.br/mc102-2020/raXXXXXX.git

Pressione Enter e realize a autenticação.

Dentro da pasta que você acabou de criar, deve haver um diretório tarefa01. Se não, espere alguns minutos e digite git pull dentro do pasta raXXXXXX criada.

Submissão de tarefas

Durante o semestre, serão realizadas diversas tarefas. A maioria delas consiste em escrever um ou mais programas em Python que resolvem determinados problema. Vamos ver um exemplo:

Escreva um programa chamado bomdia.py que lê um nome no terminal e dá bom dia.

Entrada

A entrada do programa é o que o usuário irá digitar quando executa o programa. Nesse exemplo, é apenas um nome de uma pessoa.

Maria

Saída

A saída o programa é o que o programa irá imprimir na tela após o usuário digitar a entrada. Nesse exemplo, para a entrada acima queremos que o programa tenha a saída:

Bom dia, Maria.

Resolvendo o exercício

Para resolver essa tarefa, precisamos criar um script em Python que faz o solicitado. Para isso, você pode utilizar qualquer editor de texto. Uma sugestão é utilizar os VC Code, que já deve estar instalado nas máquinas do IC. Para isso, vá até o diretório da tarefa correspondente no seu diretório, crie um arquivo bomdia.py (se já não existir) e execute o editor.

cd raXXXXXX/tarefa01
touch bomdia.py
code bomdia.py

Em tarefas futuras, você deverá criar todo o programa. Nesse primeiro dia, vamos apenas copiar código abaixo e salvar o arquivo bomdia.py.

nome = input()

print(f'Bom dia, {nome}.')

Testando o exercício

Para executar o programa que você criou, vá até a linha de comandos e digite

python3 bomdia.py

O console vai ficar piscando esperando que você digite algo. Digite seu nome e aperte Enter. Deve aparecer uma mensagem de bom dia! Se não, verifique se não fez todos os passos acima.

Você acabou de testar manualmente o seu programa. No mundo real, é importante criar testes automatizados. Na nossa disciplina, em cada tarefas haverá um arquivo testar.py que serve para você testar a sua tarefa localmente. Esse arquivo é incluído no diretório da tarefa. Para testar usando o script, abra o terminal dentro do diretório que contém o arquivo python e digite

python3 testar.py

Ele deve dar uma mensagem falando que o teste do exercício bomdia.py passou. Esse é um bom momento para você salvar as suas alterações!

Sincronizando repositórios

As alterações realizadas anteriormente foram no repositório local. Agora é necessário "enviá-las" ao repositório remoto.

No terminal, digite git add . para adicionar as alterações à "área de preparação". Depois precisamos registrar ("commit") essas alterações.

Antes do primeiro "commit" é necessário definir seu endereço de e-mail e nome de usuário conforme o exemplo a seguir. Certifique-se de usar sempre o mesmo endereço de e-mail.

git config --global user.email "you@example.com"
git config --global user.name "Your Name"

O proximo passo é confirmar as alterações, ou seja, fazer um commit.

git commit -m "comentário sobre as alterações"

As alterações ainda não foram enviadas para o repositório remoto. Por último, é necessário executar o comando git push no terminal e realizar a autenticação.

Boa noite

Quando você executou o programa testar.py deve ter percebido que algum teste falhou. Isso é porque pode haver mais de um exercício por tarefa. Para concluir a primeira tarefa, faça um programa boanoite.py que lê vários nomes e dá boa noite, conforme entrada e saída a seguir.

Entrada

3
José
Maria
Manuela

Saída

Boa noite, José.
Boa noite, Maria.
Boa noite, Manuela.

Para isso, crie um arquivo de texto chamado boanoite.py copiando o exemplo abaixo:

n = int(input())

for _ in range(n):
    nome = input()
    print(f'Boa noite, {nome}.')

Após concluir, e testar, envie suas alterações para o repositório remoto.

Verificando sua tarefas

Vocês devem ter recebido um e-mail com uma chave longa. Essa chave é para vocês verificarem a correção das tarefas e não pode ser alterada. Por isso, não percam ou mostrem essa chave para ninguém. Se não recebeu, converse com o professor ou monitor.

Para consultar o resultado da correção automática da sua submissão, clique aqui.