PyBookLib é uma biblioteca de duas partes projetada para hospedar e obter projetos de código de modelo. Ele foi escrito principalmente para programas Python, mas também é possível hospedar outras linguagens. PyBookLib possui dois submódulos, cada um independente um do outro: PyBook e PyLib. PyBookLib não tem afiliações com os projetos PyPI existentes, PyBook e PyLib. É um projeto completamente separado e tem como tema uma biblioteca. ?
Você pode instalar o pacote através do seguinte:
pip install -U PyBookLib
Se você deseja a versão de desenvolvimento mais recente, que definitivamente contém bugs, execute o seguinte:
pip install git+https://github.com/BD103/PyBookLib
Para obter este arquivo markdown no console, você pode executar PyBookLib
na linha de comando. A execução de pybook
ou pylib
fornece uma lista de comandos possíveis para cada um.
O módulo PyBookLib principal não tem nenhuma função atual além de uma ponte de código e exibe este arquivo markdown na linha de comando.
PyBookLib
A principal funcionalidade do PyBook é conectar-se a uma biblioteca hospedada e receber livros (arquivos .zip
). A biblioteca acessada é definida por uma variável ambiental. Tente executar algo assim:
from PyBookLib import pybook
import os
# Set environmental variable for library. Unecessary but helpful all the same
pybook . set_url ( "https://library.bd103.repl.co/api" )
# Gets a book "sample-library" from the user "BD103" with the version "1.2" and extracts contents to the directory "pylib-library"
pybook . get ( user = "BD103" , book = "sample-library" , version = "1.2" , direc = "pylib-library" )
Com este script simples, ele se conecta a biblioteca.bd103.repl.co e solicita biblioteca de amostra. Este livro é um exemplo de script para hospedar sua própria biblioteca. (Ele foi criado para Replit, é por isso que existe um pyproject.toml.)
Você também pode executar alguns comandos bash:
# Get a list of commands
pybook --help
pybook get-book BD103 sample-library --version 1.2 --direc pylib-library
pybook get-user BD103
# This should automatically be set to library.bd103.repl.co/api
pybook set-url https://link.to.site/api
# Umbrella get function to specify exact details
pybook get --user BD103 --direc folder
Você não precisa especificar todos esses parâmetros. Tente remover e substituir alguns deles e veja o que acontece!
PyLib serve para hospedar sua própria biblioteca. É extremamente simples. Instale PyBookLib e escolha seu caminho:
Nota: Esses caminhos definirão automaticamente o IP e a porta como
0.0.0.0:8000
. Se estiver em uma máquina local, você poderá se conectar por meio de localhost:8000. Se estiver usando um serviço de hospedagem de servidor, ele deverá definir automaticamente o host para o seu domínio. Se você estiver tendo conflitos com a porta ou quiser um IP diferente, você pode especificá-lo usando o caminho main.py do Python e substituindopylib.run()
porpylib.run(host="1.2.3.4", port=8080)
.
Crie um arquivo chamado main.py. Dentro, cole o seguinte:
from PyBookLib import pylib
pylib . run ()
Execute o script para começar a hospedar sua biblioteca.
Na linha de comando, execute o seguinte:
pylib run
Observe como seu servidor é hospedado.
Se você quiser contribuir com este projeto, acesse github.com/BD103/ PyBookLib , crie um fork e um pull request. Todo o código deve ser executado através dos seguintes comandos:
black PyBookLib
isort PyBookLib --profile black
flake8 PyBookLib
PyTest ainda não está implementado. Fique atento! ?