uflash
1.0.0
Este módulo funciona apenas com Python 2.7 ou 3.3+.
Uma utilidade para piscar o BBC Micro: Bit com scripts Python e o tempo de execução do Micropython. Você pronuncia o nome deste utilitário "Micro-Flash". ;-)
Ele fornece três serviços:
Várias operações essenciais são implementadas:
Para instalar simplesmente digite:
$ pip install uflash
... e o pacote vai baixar de Pypi. Se você deseja atualizar para a versão mais recente, use o seguinte comando:
$ PIP Instalação-Não-Cache-Upgrade Uflash
NB: Você deve usar um cabo de dados USB para conectar o micro: bit ao seu computador (alguns cabos são apenas energia). Você está em boa forma se, quando conectado, o Micro: Bit aparecerá como um dispositivo de armazenamento USB no seu sistema de arquivos.
Usuários do Linux: para que o Uflash funcione, você deve garantir que o micro: o bit seja montado como um dispositivo de armazenamento USB. Geralmente isso é feito automaticamente. Caso contrário, você provavelmente configurou a automação para estar desativada. Se for esse o caso, assumimos que você tem o conhecimento técnico para montar o dispositivo ou instalar os módulos de kernel necessários, se estiver faltando. Instalações padrão de distritos Linux populares "devem apenas funcionar" (TM) prontos para a caixa, dada uma instalação padrão.
Para ler Ajuda simplesmente digitar:
$ uflash -Help
ou:
$ uflash -h
Para descobrir o tipo de informação da versão:
$ uflash -versão
Se você digitar o comando por conta própria, o Uflash tentará encontrar um Micro BBC conectado: bit e Flash uma versão padrão não modificada do MicropyThon Runtime para ele:
$ uflash Python piscando: /media/ntoll/microbit/micropython.hex
Para exibir uma versão do Micropython Runtime com um script especificado incorporado a ele (para que o script seja executado quando o BBC Micro: Bit Boots Up), depois passe o caminho para o script Python como o primeiro argumento para o comando:
$ uflash my_script.py Piscando my_script.py para: /media/ntoll/microbit/micropython.hex
Você pode deixar o Uflash vigiar as alterações do seu script. Será exibido automaticamente toda vez que você o salvar:
$ uflash -w my_script.py
ou:
$ uflash -Assate my_script.py
Nesse ponto, o Uflash tentará detectar automaticamente o caminho para o dispositivo. No entanto, se você tiver vários dispositivos conectados e/ou saiba qual é o caminho no sistema de arquivos para o Micro da BBC: Bit já é, você pode especificar isso como um segundo argumento para o comando:
$ uflash myscript.py/mídia/ntoll/microbit Piscando myscript.py para: /media/ntoll/microbit/micropython.hex
Você pode até exibir vários dispositivos de uma só vez:
$ uflash myscript.py/mídia/ntoll/microbit/mídia/ntoll/microbit1 Piscando myscript.py para: /media/ntoll/microbit/micropython.hex Piscando myscript.py para: /media/ntoll/microbit1/micropython.hex
Para extrair um script python de um arquivo hexadecimal, use a bandeira "-e" como esta:
$ uflash -e algo.hex myscript.py
Isso salvará o script python recuperado de "Something.hex" no arquivo "myscript.py". Se você não fornecer um alvo, o script recuperado emitirá para o stdout.
Se você estiver desenvolvendo o Micropython e tem um arquivo hexadecimal de tempo de execução personalizado, pode especificar que o uflash o use em vez da versão interna do Micropython da seguinte maneira:
$ uflash -r firmware.hex
ou:
$ uflash -runtime = firmware.hex
Para criar arquivos .Hex de saída no mesmo diretório que os arquivos .py de entrada:
$ py2hex tests/exemplo.py Exemplo de hexiplição.py como: tests/exemplo.hex
O PY2HEX inclui o mesmo -r/-tempo de execução e -m/-minifico opções como uflash e adiciona uma opção adicional -O/-Outlir:
Para criar arquivos .Hex de saída em um diretório diferente:
$ py2hex exemplo.py -o /tmp Exemplo de hexinificação.py como: /tmp/example.hex
ou:
$ py2hex exemplo.py -outdir /tmp Exemplo de hexinificação.py como: /tmp/example.hex
O PY2HEX pode lidar com vários arquivos de entrada:
$ py2hex a.py b.py c.py Hexificante A.Py como: A.Hex Hexificante B.Py como: B.Hex Hexificante C.Py como: C.Hex
ou:
$ py2hex *.py Hexificante A.Py como: A.Hex Hexificante B.Py como: B.Hex Hexificante C.Py como: C.Hex
O código -fonte está hospedado no GitHub. Por favor, sinta -se à vontade para bifurcar o repositório. Supondo que você tenha instalado o Git, você pode baixar o código do repositório canônico com o seguinte comando:
$ git clone https://github.com/ntoll/uflash.git
Certifique -se de ter as dependências corretas para o desenvolvimento instaladas criando um VirtualENV e executando:
$ pip install -r requisitos.txt
Para instalar localmente sua versão de desenvolvimento do módulo em um VirtualENV, execute o seguinte comando:
$ python setup.py desenvolver
Há um makefile que ajuda na maioria dos fluxos de trabalho comuns associados ao desenvolvimento. A digitação make por si só listará as opções assim:
$ make Não há alvo makefile padrão agora. Tentar: Faça limpo - redefina o projeto e remova os ativos gerados automaticamente. Faça Pyflakes - Execute o verificador de código Pyflakes. Faça PEP8 - Execute o verificador de estilo Pep8. Faça teste - Execute o conjunto de testes. Faça cobertura - Veja um relatório sobre cobertura de teste. Faça a verificação - Execute todos os damas e testes. Faça o pacote - crie um pacote implantável para o projeto. Faça RPM - Crie um pacote de RPM para o projeto. Make Publish - Publique o projeto para Pypi. Faça documentos - Execute a Esfinge para criar documentação do projeto.
