Um exemplo detalhado do pylock.toml
o formato está disponível no PEP 751. Cada dependência tem seu próprio ((packages))
subseção, com detalhes sobre onde e quando foi obtido, seu hash, requisitos de versão e assim por diante. O exemplo mostra como um pacote pode ter várias fontes específicas da plataforma. No exemplo, numpy
Liste as rodas binárias para o Microsoft Windows e sistemas genéricos Linux.
Quando chegará os arquivos de bloqueio PEP 751?
Até o momento em que este artigo foi escrito, não há uma ferramenta oficial ou de terceiros que suporta pylock.toml
hoje. Revisões futuras das ferramentas, de pip
em Outwards, devem adotar pylock.toml
No ritmo, seus provedores acham adequado, para que você possa esperar que o novo arquivo de bloqueio seja adicionado aos fluxos de trabalho e à composição de projetos ao longo do tempo. Você eventualmente vai querer pensar se o conjunto de dependências do seu projeto é complexo o suficiente para exigir um pylock.toml
arquivo. Qualquer pessoa que crie um pacote hospedado no Pypi, por exemplo, desejará gravitar para criar um pylock.toml
para o projeto.
A velocidade da adoção será ditada pela tempo em que as ferramentas existentes possibilitam gerar pylock.toml
arquivos e se esse formato de arquivo substituirá imediatamente seus próprios formatos internos. Algumas ferramentas de terceiros que geram seus próprios arquivos de bloqueio permanecem hesitantes em usar pylock.toml
como substituto completo. uv
por exemplo, pretende apoiar pylock.toml
como formato de exportação e importação, mas não como o formato para seus arquivos de bloqueio nativo devido a alguns recursos ainda não suportados em pylock.toml
. No entanto, é inteiramente possível que o suporte para esses recursos possa ser adicionado a revisões futuras do pylock.toml
espec.