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.tomlarquivo. 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. uvpor 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.