Módulos. from <nome do modulo> import <nome objecto> Módulos

Transcrição

1 Módulos Um módulo é essencialmente um ficheiro contendo uma série de objectos Python, que juntos formam um espaço de nomes próprio. Estes objectos podem ser importados em conjunto ou separadamente usando: import <nome do modulo> ou from <nome do modulo> import <nome objecto> Luís Cruz Módulos Da primeira vez que um módulo é importado, é executado integralmente. Após importação, os objectos de um módulo são acessíveis através da notação modulo.objecto caso tenhamos importado o módulo usando import modulo ou apenas usando objecto se tivermos importado objecto usando from modulo import objecto Um módulo pode também ser executado como um script. Para permitir determinar se foi esse o caso, existe uma variável, name que vale main quando o módulo foi executado como script. No caso do módulo ter sido importado essa variável contém o nome do módulo. No início do módulo podemos incluir uma cadeia de caracteres para fins de documentação (docstring). Com o comando dir(modulo)podemos listar o conteúdo de um módulo. Luís Cruz

2 Pacotes Pacotes são conjuntos de módulos agrupados sob a forma de uma hierarquia de directorias em disco. Cada directoria tem de conter um ficheiro com nome e significado especiais, init.py que indica que a directoria que o contém faz parte de um pacote. Esse ficheiro écarregado e executado sempre que o pacote é importado. A importação de pacotes ou módulos constituintes é feita de forma semelhante à já estudada para os módulos; i.e. as instruções import e from... import... O acesso a objectos importados de um pacote é feito segundo a sintaxe pacote.modulo.objecto Luís Cruz Operações sobre Ficheiros Abertura de ficheiros faz-se executando uma instrução do tipo f=open(nome, modo) onde f éo nome do objecto ficheiro, nome é o nome do ficheiro (em disco) e modo determina se o ficheiro é aberto em modo de leitura ( r read), de escrita ( w - write), para adição ( a append) ou leitura e escrita ( r+ ). Caso se deseje fazer operações de acesso em modo binário deve acrescentar-se um b ao indicador de modo, por exemplo r+b para leitura e escrita em binário. Luís Cruz

3 Operações sobre Ficheiros f.mode reporta o modo em que o ficheiro foi aberto Exemplo: >>> f=open("teste.txt",'w') >>> f.mode 'w' f.name reporta o nome do ficheiro aberto Exemplo: >>> f=open("teste.txt",'w') >>> f.name Teste.txt Luís Cruz Operações sobre Ficheiros f.closed informa se o ficheiro foi ou não fechado Exemplo: >>> f=open("teste.txt",'w') >>> f.closed False >>> f.close() >>> f.closed True f.fileno() reporta o número do descritor do ficheiro Exemplo: >>> f=open("teste.txt",'w') >>> f.fileno() 3 Luís Cruz

4 Operações sobre Ficheiros Após abertura do ficheiro (em modo que permita a leitura) podemos ler o seu conteúdo usando: f.read() lê o ficheiro todo devolvendo uma string com todo o conteúdo. Comando perigoso, pois pode consumir todos os recursos do computador, f.read(n) lê os n primeiros caracteres do ficheiro devolvendo o resultado numa string, f.readline() lê uma linha do ficheiro, devolvendo o resultado numa string, f.readlines(n) lê n linhas do ficheiro, devolvendo uma lista de strings, cada uma contendo uma linha. Luís Cruz Operações sobre Ficheiros Para escrever no ficheiro usa-se: f.write(str) escreve str no ficheiro f f.writelines(lista_linhas) escreve no ficheiro f as strings da lista de strings lista_linhas Para escrever outros tipos de dados num ficheiro, têm estes de ser previamente convertidos para string, através da função str(objecto_a_converter), como por exemplo em f.write(str(99)) Luís Cruz

5 Operações sobre Ficheiros Para fechar o ficheiro usa-se f.close() e todas as tentativas de acesso ao mesmo após esta operação dão origem a um erro. Existem ainda instruções que permitem posicionar o ponto a partir do qual se lê ou se escreve informação de/para ficheiro: f.seek() coloca o ponto de acesso no início do ficheiro f.seek(n,0) coloca o ponto de acesso na posição n a contar do início (começa em 0), f.seek(m,1) avança o ponto de acesso m posições f.seek(p,2) coloca o ponto de acesso p posições a contar do fim do ficheiro, Luís Cruz Operações sobre Ficheiros Para dados mais complexos é conveniente usar as funções definidas no módulo pickle que permite escrever e ler objectos em/de um ficheiro, num formato serializado. O acesso a estas funções requer a importação do módulo pickle (import pickle). Para escrever um objecto num ficheiro f (previamente aberto) faz-se pickle.dump(obj,f) e para ler usa-se obj=pickle.load(f) Luís Cruz

6 Excepções Por vezes durante a execução de um programa ocorrem erros que podem determinar o fim da execução do mesmo. Em Python quando ocorre um erro de certo tipo (por exemplo divisão por zero) élançada uma excepção. Épossível programar o tratamento da excepção, ou seja criar código que é executado quando essa condição excepcional ocorre. Luís Cruz Excepções Exemplo de ocorrência de uma excepção: >>> def divide(x,y): return x/y >>> divide(1,0) Identificação da Excepção Traceback (most recent call last): File "<pyshell#18>", line 1, in -topleveldivide(1,0) File "<pyshell#15>", line 2, in divide return x/y ZeroDivisionError: integer division or modulo by zero Luís Cruz

7 Excepções Com a construção raise o próprio programador pode provocar a execução de uma excepção: Exemplo: >>> raise ZeroDivisionError, 'Erro ao tentar dividir por zero!' Traceback (most recent call last): File "<pyshell#30>", line 1, in -toplevelraise ZeroDivisionError, 'Erro ao tentar dividir por zero!' ZeroDivisionError: Erro ao tentar dividir por zero! Luís Cruz Excepções A construção raise pode ser útil, pois permite ao programador, ao verificar que determinada situação pode conduzir a um erro, emitir uma mensagem de erro e terminar a execução do programa. Veja o exemplo seguinte. >>> def divide(x,y): if y==0: raise ZeroDivisionError, 'Erro ao tentar dividir por zero!' else: return x/y Luís Cruz

8 Excepções Que tem o efeito que pode observar >>> divide(1,0) divide(1,0) Traceback (most recent call last): File "<pyshell#29>", line 1, in -topleveldivide(1,0) File "<pyshell#28>", line 3, in divide raise ZeroDivisionError, 'Erro ao tentar dividir por zero!' ZeroDivisionError: Erro ao tentar dividir por zero! Luís Cruz Excepções - Tratamento Verificou que quando ocorre uma excepção, o programa termina. Quando o erro que deu origem à excepção não é muito grave, é possível tentar remediar a situação executando instruções adequadas à situação. Para esse fim usa-se a construção try...except com sintaxe try: bloco de instrucoes except <codigo excep 1>: instrucoes a executar se excep 1 ocorreu... except <codido excep N>: instrucoes a executar se excep N ocorreu else: instrucoes a executar se nao houve excepcao Luís Cruz

9 Exemplo: Excepções - Tratamento >>> def divide(x,y): try: return x/y except ZeroDivisionError: print "Houve um erro ao tentar dividir por zero" >>> divide(1,1) 1 >>> divide(1,0) Houve um erro ao tentar dividir por zero >>> Luís Cruz Excepções Tratamento Um bloco try...except pode tratar mais de uma excepção: try: bloco de instrucoes except (<excep 1>,<excep 2>): instrucoes tratamento de excep 1 e excep 2 Luís Cruz

10 Excepções Tratamento Pode também ser especificado um bloco de instruções a executar caso não haja excepções, usando a cláusula else. try: bloco de instrucoes except <excep 1>: instrucoes tratamento de excep 1 else : instrucoes alternativas Luís Cruz Excepções Tratamento A última clausula except pode não conter nenhuma indicação de código de excepção. Nesse caso, essa clausula trata todas as excepções não contempladas por outras clausulas except. try: bloco de instrucoes except <excep 1>: instrucoes tratamento de excep 1 except : instrucoes de tratamento de todas as excepcoes diferentes de excep 1 Luís Cruz

11 Excepções Tratamento Algumas excepções pré-definidas. ZeroDivisionError divisão por zero IndexError tentativa de acesso a um elemento (de uma sequência) fora da gama válida NameError Nome global não encontrado OverflowError Ultrapassagem de gama numérica SyntaxError Erro de sintaxe Luís Cruz Excepções Épossível definir nova excepções, que são criadas sob a forma de uma classe tal como no exemplo seguinte. >>> class MinhaExcepcao(Exception): def init (self,valor): self.valor=valor def str (self): return `self.valor` >>> raise MinhaExcepcao, 'uma mensagem qualquer com info util' Traceback (most recent call last): File "<pyshell#39>", line 1, in -toplevelraise MinhaExcepcao, 'uma mensagem qualquer com info util' MinhaExcepcao: 'uma mensagem qualquer com info util' Luís Cruz

12 Assert Com a instrução assert podemos forçar o lançamento de uma excepção do tipo AssertionError caso uma determinada condição dê como resultado o valor lógico falso. A sintaxe é assert <cond>, <argumento> Exemplo : >>> i=input("introduza um numero positivo :") Introduza um numero positivo :-1 >>> assert i>0,"erro : o numero deve ser positivo" Traceback (most recent call last): File "<pyshell#3>", line 1, in -toplevelasserti>0,"erro : o numero deve ser positivo" AssertionError: Erro : o numero deve ser positivo Luís Cruz Bibliotecas Standard - sys No módulo sys estão disponíveis várias funções importantes, que podem ser usadas após importação efectuada com import sys sys.platform devolve informação sobre o sistema sys.version devolve versão do intérprete sys.hexversion idem mas em hexadecimal Luís Cruz

13 Bibliotecas Standard - sys São também definidas algumas variáveis importantes tais como sys.path caminho que é pesquisado ao carregar módulos Pode acrescentar-se um caminho usando a função append tal como em sys.path.append(<novo caminho>) Luís Cruz Bibliotecas Standard - sys Outra instrução definida no módulo sys éa exit que éinvocada na forma sys.exit(<valor a devolver>) e que termina a execução do script, levantando uma excepção SystemExit sendo <valor a devolver> passado ao programa ou script que chamou o script cuja execução foi terminada com sys.exit Luís Cruz

14 Bibliotecas standard Sistemas de Ficheiros O módulo os contém várias instruções úteis para lidar com o sistema de ficheiros. Após import os ficam disponíveis: os.getcwd() devolve o nome do directório corrente os.chdir(<dir>) muda directório corrente para <dir> Após importação de os.path tem disponíveis os.path.split(<dir>) que separa um caminho nas suas componentes os.path.join(str1,str2,str3,...) que junta str1,str2,str3,... para formar um caminho válido Luís Cruz Bibliotecas standard Sistemas de Ficheiros os.path.isdir(<dir>) que devolve 1 se <dir> for um caminho válido para um directório os.path.isfile(<fich>) que devolve 1 se <file> for um caminho válido para um ficheiro os.mkdir(<dir>) cria um directório <dir> os.makedirs(<dir>) cria um directório criando todos os directórios intermédios necessários os.rmdir(<dir>) remove directório <dir> os.removedirs(<dir>) remove directório <dir> e directório pai se este ficar vazio Luís Cruz

15 Bibliotecas standard Sistemas de Ficheiros os.listdir(<dir>) devolve lista com conteúdo (listagem) de <dir> os.stat(<fich/dir>) devolve informação sobre o estado do ficheiro ou directório dado como argumento os.rename(<nome antigo>,<novo nome>) muda nome de ficheiro ou directório Luís Cruz Bibliotecas standard Sistemas de Ficheiros os.path Funções para manipulação de nomes de ficheiros abspath(cam) # Devolve o caminho absoluto de um nome de ficheiro basename(cam) # Devolve a componente nome do ficheiro do nome completo dirname(cam) # Devolve a componente directoria do nome completo normcase(cam) # Normaliza capitalização de nome normpath(cam) # Normaliza o nome completo split(cam) # Divide cam em (directoria,nome) splitdrive(cam) # Divide cam em (drive, nome completo) splitext(cam) # Divide cam em (nome ficheiro, sufixo) join(p1,p2,...) # Join pathnamecomponents Exemplos abspath("../xyz") # Devolve "/home/lcruz/temp/xyz" basename("/usr/bin/python") # Devolve "python" dirname("/usr/bin/python") # Devolve "/usr/bin" normpath("/usr/./bin/python") # Devolve "/usr/bin/python" split("/usr/bin/python") # Devolve ("/usr/bin","python") splitext("index.html") # Devolve ("index",".html") Luís Cruz

16 Bibliotecas standard Sistemas de Ficheiros os.path Funções para teste de existência de ficheiros exists(cam) # Testa existência isabs(cam) # Devolve 1 se camfor um nome absoluto isfile(cam) # Devolve 1 se caméum ficheiro isdir(cam) # Devolve 1 se caméuma directoria Islink(cam) # Devolve 1 se caméum link simbólico getatime(cam) # Devolve tempo de acesso getmtime(cam) # Devolve tempo de modificação getsize(cam) # Devolve tamanho do ficheiro em bytes samefile(cam1,cam2) # Devolve 1 se cam1 e cam2 designam o mesmo ficheiro sameopenfile(f1,f2) # Devolve 1 se f1 e f2 são descritores respeitantes ao mesmo ficheiro. Luís Cruz Módulo glob Devolve nomes de ficheiros de uma directoria que seguem um padrão: import glob a = glob.glob("*.html") b = glob.glob("image[0-5]*.gif") Luís Cruz

17 Outros módulos Módulo tempfile : Permite criar ficheiros temporários. Módulo gzip : Permite criar objectos (ficheiros) com compressão compatível com formato gzip. import gzip f = gzip.open("foo","wb") f.write(data) f.close() Luís Cruz Módulo Time Funções relacionadas com temporização time.clock() # Tempo de CPU em segundos time.time() # Tempo corrente (GMT) em segundos desde época de referência time.localtime(secs) # Converte tempo para tempo local time.gmtime(secs) # Converte tempo para GMT time.asctime(tuple) # Cria uma string representando o tempo time.ctime(secs) # Cria uma string representanto o tempo local time.mktime(tempo) # Converte o tempo para segundos time.sleep(secs) # Pausa (dorme) secs segundos Exemplos import time t = time.time() # Devolve (ano,mês,dia,hora,minuto,segundo,dia da semana,dia,dst) tp = time.localtime(t) # Produz uma string como Wed Nov 17 9:45: print time.asctime(tp) Luís Cruz

18 Bibliotecas standard Strings Funções de manipulação de strings string.atof(s) # Converte para float string.atoi(s) # Converte para inteiro string.atol(s) # Converte para inteiro longo string.count(s,padrão) # Conta ocurrências de padrão em s string.find(s,padrão) # Localiza padrão em s string.split(s, sep) # Separa a string usando sep como marcador string.join(lista, sep) # Concatena lista de strings string.replace(s,antigo,novo) # Substitui ocurrências de antigo por novo Exemplos s = Bom dia" a = string.split(s) # a = [ Bom, dia ] b = string.replace(s, dia", tarde") c = string.join([ xpto", 123"],":") # c = xpto:123" Luís Cruz