python editor v3

Micro:bit Editor Python V3

Este projeto é um editor de código baseado na web voltado para a versão MicroPython da linguagem de programação Python.

Espera-se que o código escrito com este editor seja executado no dispositivo BBC micro:bit.

Experimente em https://python.microbit.org/

A imagem mostra a implantação da marca micro:bit

Versões anteriores

Para obter mais informações sobre como este editor se relaciona com o projeto original do Python Editor, consulte esta explicação.

O projeto do editor V2 ainda está disponível em https://python.microbit.org/v/2 e seu código-fonte pode ser encontrado no GitHub em https://github.com/bbcmicrobit/PythonEditor.

Construindo e executando o editor

Escrevemos uma visão geral técnica que é um bom ponto de partida para trabalhar no Editor Python ou para usar ideias e componentes do aplicativo em outros projetos. Adoraríamos ouvir sua opinião se você estiver usando este projeto. Você pode entrar em contato através do suporte.

Preparando-se e funcionando:

1. Certifique-se de ter um ambiente Node.js funcional. Recomendamos usar a versão LTS do Node e NPM versão 8 ou mais recente.
2. Confira este repositório com Git. O GitHub tem alguns recursos de aprendizagem para Git que podem ser úteis.
3. Instale as dependências executando npm install na linha de comando na pasta checkout.
4. Escolha um dos scripts NPM documentados abaixo. Tente npm start se não tiver certeza.

npm start

Executa o aplicativo no modo de desenvolvimento.

Abra http://localhost:3000 para visualizá-lo no navegador.

A página será recarregada se você fizer edições.

Isso não mostra erros de TypeScript ou lint. Use o plugin eslint para o seu editor e considere também executar npm run typecheck:watch para ver erros completos de verificação de tipo.

npm test

Inicia o executor de testes no modo interativo (a menos que a variável de ambiente CI esteja definida). Consulte a seção sobre execução de testes para obter mais informações.

Se você tiver um dispositivo micro:bit conectado, definir a variável de ambiente TEST_MODE_DEVICE=1 permitirá testes adicionais que se conectarão ao seu micro:bit. Os testes substituirão programas e dados no micro:bit.

npm run test:e2e

Inicia o executor de teste no modo de observação interativo, executando os testes de ponta a ponta.

Eles são excluídos da execução normal do teste.

Os testes esperam que o aplicativo já esteja rodando em http://localhost:3000, por exemplo, via npm start .

Usamos o dramaturgo.

Os testes de CI executam esses testes ponta a ponta em uma construção de produção.

npm run build

Cria o aplicativo para produção na pasta build .
Ele agrupa corretamente o React no modo de produção e otimiza a construção para obter o melhor desempenho.

Implantações

A maioria dos usuários deve usar a implantação suportada do Foundation em https://python.microbit.org/

O editor é implantado por ações do GitHub.

A ramificação main é implantada em https://python.microbit.org/v/beta em cada push.

Outras ramificações (por exemplo, para PRs) são implantadas em https://review-python-editor-v3.microbit.org/{branch}. Os caracteres especiais no nome da ramificação são substituídos por hifens. As implantações não serão executadas em bifurcações.

Licença

Este software está sob a licença de código aberto do MIT.

Identificador de licença SPDX: MIT

Binários para MicroPython estão incluídos para micro:bit V1 (licença) e micro:bit V2 (licença). Ambos são licenciados pelo MIT.

O diagnóstico e o preenchimento automático do Python usam um fork do verificador de tipo Pyright da Microsoft, que foi modificado por nós para ser executado como um Web Worker. Pyright é © Microsoft Corporation e é usado sob uma licença do MIT.

Usamos dependências por meio do registro NPM conforme especificado pelo arquivo package.json sob licenças comuns de código aberto.

Detalhes completos de cada pacote podem ser encontrados executando license-checker :

$ npx license-checker --direct --summary --production

Omita os sinalizadores conforme desejado para obter mais detalhes.

Código de Conduta

Confiança, parceria, simplicidade e paixão são os nossos valores fundamentais que vivemos e respiramos no nosso dia a dia profissional e nos nossos projetos. Nossos projetos de código aberto não são exceção. Temos uma comunidade ativa que se estende por todo o mundo e acolhemos e incentivamos a participação e contribuições de todos em nossos projetos. Trabalhamos para promover um ambiente positivo, aberto, inclusivo e de apoio e confiamos que a nossa comunidade respeita o código de conduta micro:bit. Consulte nosso código de conduta, que descreve nossas expectativas para todos aqueles que participam de nossa comunidade e detalhes sobre como relatar quaisquer preocupações e o que aconteceria caso ocorressem violações.