snext Download - snext download do código-fonte

snext

Outro código-fonte

1.0.0

Baixar

Primeiros passos com Snext

Snext é um aplicativo Next.js que permite criar rotas de API em Python.

A seguir, porque soa como "cobra"? Você sabe, como um Python.

/! /! /! Este é um experimento inicial

Começar com Python?

Ei, se você chegar lá, provavelmente é um desenvolvedor JavaScript e Python é apenas sua segunda linguagem.

Veja como configurar um ambiente Python eficiente.

Instale Python

Sugiro usar o Pyenv para instalar o Python. Considere-o equivalente ao Node Version Manager ou Volta, mas para Python.

Isso equivale a usar Volta ou NVM no ecossistema Node.

Primeira execução: configure um ambiente virtual.

Python não possui uma pasta node_modules . Talvez seja melhor assim, mas torna bastante difícil lidar com dependências quando você tem muitos projetos em sua máquina.

Um ambiente virtual é um pouco semelhante: ele dirá ao Python para instalar pacotes localmente no seu projeto atual, e não globalmente.

A diferença com o Node é que você deve habilitá-los sistematicamente.

Configure um ambiente virtual e instale os pacotes Python:

python3 -m venv ./venv
source ./venv/bin/activate
pip install -r requirements.txt

Execuções subsequentes

Você precisa ativar o ambiente virtual quando começar a trabalhar:

 source ./venv/bin/activate

Infelizmente, este comando não funciona em scripts NPM. Você tem que digitá-lo sempre.

Comece

Vários recursos e inspirações

Discussão no Vercel Github: vercel/vercel#4023
Plotly Dash: uma das tentativas mais impressionantes de programação web isomórfica. Dash permite que você use componentes React em Python para criar painéis interativos https://plotly.com/dash/
Documento oficial sobre Python em Vercel: https://vercel.com/docs/runtimes#official-runtimes/python
https://stackoverflow.com/questions/63190114/call-a-python-script-from-react-with-next-routing-and-a-node-js-server
https://medium.com/swlh/build-a-twitter-login-component-using-nextjs-and-python-flask-44c17f057096
vercel/next.js#15846

PENDÊNCIA

Investigue o quanto vercel CLI pode resolver nossos problemas (veja https://vercel.com/docs/cli#commands/dev) => pronto, resolve!
Testar compilação local
Testar implantação do vercel
Melhorar a experiência de desenvolvimento com Python, que é um pouco mais tedioso do que usar JS (ambiente virtual)?
Construa com "pkg"
Tente usar um "Pipfile" mais parecido com package.json: https://github.com/pypa/pipfile

Principais bloqueadores

1) Executando 2 (ou mais) servidores na mesma porta para Python e Node RESOLVIDO

Solução:

Use Vercel CLI em vez de next dev .

O comando Vercel CLI vercel dev é capaz de simular um ambiente sem servidor localmente, para que você possa testar suas rotas de API.

Se você colocar todas as rotas de API em ./api/ e usar vercel dev , poderá ter rotas de API Python e Node.js (e, claro, o frontend Next.js ainda funciona bem).

Leia vercel/vercel#6197

Nó + Python

Ao executar o Next, você desejará que tudo seja executado em localhost:3000 , mas terá 2 servidores: um para Node e outro para Python. Isso requer alguma lógica de reescrita para funcionar.

Possíveis soluções

Verifique se Next.js reescreve em next.config.js já permite isso
Execute um terceiro servidor que lide com o redirecionamento

Questões

Como isso é resolvido no Next para rotas de API e frontend?

Píton + Píton

Além disso, podemos ter várias rotas de API, que atuarão como funções sem servidor quando implantadas. Mas localmente, devemos torná-los um servidor.

Possíveis soluções

Temos uma solução parcial com Sanic Dispatcher, consulte "python-server.py". Ele depende de um servidor principal, que despacha a solicitação para aplicativos Sanic, então você tem apenas um servidor e ainda pode executar várias rotas de API
Ainda precisamos automatizar a importação de rotas relevantes. Usando uma espécie de mágica semelhante ao Webpack, mas em Python.
https://peterhaas-me.medium.com/how-to-run-multiple-flask-applications-from-the-same-server-9ca2c0ad7bb3
https://werkzeug.palletsprojects.com/en/1.0.x/middleware/dispatcher/
Despachante para Sanic: https://github.com/ashleysommer/sanic-dispatcher/blob/master/sanic_dispatcher/extension.py#L131

2) Obtendo dados estáticos

O padrão recomendado para obter dados estáticos de suas rotas de API em Next é reutilizar a lógica principal da rota diretamente em getStaticProps . Mas isso só é possível porque ambos estão utilizando JS. Com Python, precisaríamos primeiro construir as rotas da API, executá-las e depois construir apenas o frontend.

Precisa ser testado com Vercel CLI.

3) Falha no tempo de execução

Temos este erro https://github.com/vercel/community/discussions/103 na versão mais recente, o tempo de execução do Python parece muito grande. Veja vercel/community#103 (comentário) Veja vercel/vercel#2830

Questões secundárias

Não é possível ter vercel dev como comando dev

Consulte https://github.com/vercel/vercel/blob/main/errors/now-dev-as-dev-script.md

O script deve ser nomeado smth, caso contrário, por exemplo, dev:vercel caso contrário, ele criará um loop infinito.

Sublinhado em nomes de pastas Python

Não - em nomes de pastas em Python, ou você terá problemas ao importar arquivos... Use sublinhado _ . Isso pode levar a URLs confusos porque o nome da pasta está vinculado ao nome da rota em Próximo.

Possíveis soluções

Gere automaticamente um mapa de rotas possíveis ou use a reescrita de URL

Qual servidor escolher

(Pela minha experiência limitada com Python) Eu tenderia a comparar Flask ou Falcon com Express: usado muito, mínimo o suficiente. Mas o comportamento de bloqueio do Python pode ser muito confuso para o desenvolvedor JavaScript. Então, optarei pelo Sanic, porque ele depende de async/await como o Node.js e pode ser o menos confuso.

De qualquer forma, todo o conhecimento reunido para um framework deve ser reutilizável para qualquer outro framework.

Configurar tempo de execução para hospedagem

Para simplificar, vamos supor uma hospedagem no Vercel. Podemos precisar de um vercel.json para informar ao Vercel qual tempo de execução usar: https://vercel.com/docs/runtimes#advanced-usage/community-runtimes

Como o desenvolvimento do Vercel funciona, devemos esperar que a implantação do Vercel funcione imediatamente. Para ser testado.

O ambiente virtual

Em Python, você precisa de um ambiente virtual para isolar seus pacotes entre aplicativos, enquanto em JS node_modules desempenha essa função. O problema é que o ambiente virtual deve ser ativado quando você começar a trabalhar, então essa é uma etapa adicional para o desenvolvedor. Para piorar, o comando source que ativa o ambiente não pode ser (da última vez que verifiquei) colocado package.json , então você deve se lembrar do comando correto sempre.