github-tools. Pembantu untuk Paket Python Hosting di GitHub
Unduh sekarang

github-tools. Peringkat & Ringkasan

github-tools. Tag

perpustakaan Python Python. pembantu. GitHub Pembantu Github Paket Hosting.

github-tools. Keterangan

Pembantu untuk paket Python hosting di GitHub Github fitur Git hosting yang repositori, halaman download untuk tag Git Anda (atau arsip ada), sebuah pelacak isu dasar, wiki dan halaman statis hosting yang (gh-halaman). Ini akan menjadi sempurna untuk hosting paket Python dan dokumentasinya jika gh-halaman itu mudah untuk setup dan kompatibel dengan Sphinx.Setting sebuah cabang akar gh-halaman ini sangat kompleks dan Sphinx menempatkan sumber dan statis file dalam direktori bernama " _source" dan '_static' yang gh-halaman tidak ingin serve.The Sphinx ekstensi (github.tools.sphinx) mengoreksi masalah terakhir; beberapa tugas paver (github.tools.task *.) mengurus penciptaan submodule Git untuk tuan rumah dibangun dokumentasi html; The PasteScript Template menciptakan tata letak dasar dan script pavement.py untuk mendapatkan started.Installation: Dengan asumsi easy_install diinstal, sederhana mengeksekusi: easy_install github-toolsUsage: Paket layoutIf Anda memulai dari awal, membuat tata letak dasar dengan Paster: Paster membuat t gh_package nama proyek akan digunakan untuk pypi dan untuk repositori Github Anda (http://github.com/ / ). Rincian proyek disimpan di src / / __ init__.py.To menyelesaikan pembangunan pengaturan lingkungan Anda, menciptakan lingkungan virtual dan menyebarkan paket Anda dalam modus pembangunan: cd python bootstrap.py --no-situs -packagesThe paket dasar datang dengan script virtualenv metode bootrap untuk menciptakan lingkungan Python terisolasi. Untuk mengaktifkan lingkungan ini di shell Anda, jalankan: Sumber ./virtual-env/bin/activate# atau .virtual-envScriptsactivate.bat pada windowsFinally: paver generate_setup minilib develop.Paver menambahkan file setup.py untuk paket Anda dan paver portabel perpustakaan (yang dibutuhkan oleh setup.py), dan menyebarkan aplikasi Anda dalam mode pembangunan; folder src yang berisi paket Anda ditambahkan ke python path.You siap untuk menulis paket Anda (di src /) dan dokumentasinya (di docs / sumber). Anda mungkin harus mulai melacak proyek Anda sekarang: git initgit menambahkan git commit -m "impor awal" Github proyek creationWhen Anda siap untuk berbagi pekerjaan Anda, Anda akan perlu untuk membuat repositori di GitHub dan mendorong repositori lokal Anda. Paver dapat melakukannya untuk Anda. Paver akan memerlukan nama pengguna GitHub dan token untuk membuat repositori. Anda dapat mengatur mereka dengan perintah berikut: git config --global github.user git config --global github.token Anda dapat menemukan token Anda di Github akun page.Then, untuk membuat repositori dan meng-upload proyek Anda: paver gh_registerDocumentation hostingOnce proyek dibuat, Anda dapat membuat cabang gh-halaman Anda dan meng-upload ke github: paver gh_pages_create gh_htmlPaver akan membuat submodule proyek Anda di docs / build / html, membuat cabang gh-halaman akar dan mendorong cabang untuk proyek Anda. Kemudian membangun doc html. Untuk membersihkan folder html membangun, itu update submodule (Anda akan kehilangan perubahan tidak berkomitmen dan mendorong), menghapus setiap file dan direktori (kecuali git /) dan membangun kembali documentation.When dokumentasi Anda dapat dipublikasikan, hanya mendorong gh- Anda halaman submodule ke GitHub: paver gh_pages_update -m "update docs dengan ..." Anda mungkin juga ingin memperbarui referensi submodule (titik submodule untuk spesifik berkomitmen pada repositori jauh, tidak HEAD dari cabang tertentu): git add docs / build / htmlgit komit -m "update gh-halaman submodule" Persyaratan: · Python. · Setuptools. · Git. · Account pengguna GitHub Apa yang baru dalam rilis ini: · New Layout, tanpa src / folder untuk paket ditahan (s) atau docs / sumber untuk menahan dokumentasi sisa - Berdasarkan template utama Paver-template.

github-tools. Perangkat Lunak Terkait