娛樂城
若何開源LK娛樂城你的Python庫 - 財神娛樂城_捕魚達人_電子遊戲

若何開源LK娛樂城你的Python庫

捕魚達人-遊戲

線上麻將賭博

這 12 個步調能確保勝利發布。

你寫了一個 Python 庫。本人覺著這太棒了!若是讓人們可以或許輕松使用它不是很優雅么?這有一個必要思量的清單,和在開源 Python 庫時要采用的詳細步調。

一、源碼

將代碼放在 GitHub 上,這里有許多開源項目,而且人們很輕易提交拉取哀求。

2、允許證

選擇一個開源允許證。一般來說 MIT 允許證539連碰意思是一個挺好的寬容允許證。若是你有特定要求,Creative Common 的選擇允許證可以引導你實現別的選擇。最緊張的是,在選擇允許證時要記住三條規定:

  • 不要創立本人的允許證。
  • 不要創立本人的允許證。
  • 不要創立本人的允許證。

三、README

將一個名為 README.rst 的文件(使用 ReStructured Text 格局化)放在項目樹的頂層。
GitHub 將像 Markdown 同樣襯著 ReStructured T妞妞機率ext,而 ReST 在 Python 的文檔生態體系中的顯露更好。

四、測試

寫測試。這對你來說沒有效處。但關于想要編寫幸免損壞相關功效的補丁的人來說,它特別很是有效。
測試可輔助協作者進行協作。
平日環境下,若是可以用 pytest 運轉就最電競運彩下注佳了。還有其余測試對象 —— 但很少有理由往使用它們。

五、樣式

使用 linter 擬定樣式:PyLint、Flake8 或者者帶上 --check 的 Black 。除非你使用 Black,不然請確保在一個文件中指定設置選項,并簽入到版本節制體系中。

6、API 文檔

使用 docstrings 來記載模塊、函數、類以及要領。
你可以使用幾種樣式。我更喜歡 Google 氣概的 docstrings,但 ReST docstrings 也是一種選擇。
Sphinx 可以同時處置 Google 氣概以及 ReST 的 docstrings,以將零碎的文檔集成為 API 文檔。

七、零碎文檔

使用 Sphinx。(閱讀咱們這篇文章。)教程頗有用,但一樣緊張的是要指明這是甚么、它有甚么利益、它有甚么害處、和任何非凡的思量身分。

八、構建

使用 tox 或者 nox 主動運轉測試以及 linter,并構建文檔。這些對象支撐“依靠矩陣”。這些矩陣每每會疾速增加,但你可以測驗考試針對合理的樣本進行測試,例如 Python 版本、依靠項版本和可能裝置的可選依靠項。

9、打包

使用 setuptools 對象。寫一個 setup.py 以及一個 setup.cfg。若是同時支撐 Python 2 以及 3,請在 setup.cfg 中指定 universal 格局的 wheel。
tox 或者 nox 應當做的一件事是構建 wheel 并對已經裝置的 wheel 進行測試。
幸免使用 C 擴大。若是出于機能或者綁定的緣故原由肯定必要它們,請將它們放在零丁的包中。精確打包 C 擴大可以寫一真錢麻將app篇新的文章。這里有許多成績!

十、繼續集成

使用公共繼續對象。TravisCI 以及 CircleCI 為開源項目供應收費套餐。將 GitHub 或者其余倉庫設置為在歸并拉哀求之前必要先經由過程反省,那末你就無須憂慮在代碼評審中見告用戶修復測試或者樣式。

十一、版本

使用 SemVer 或者 CalVer。有很多對象可以輔助你治理版本:incremental、bumpversion 以及 setuptools_scm 等都是 PyPI 上的包,都可以輔助你治理版本。

十二、發布

經由過程運轉 tox 或者 nox 并使用 twine 將文件上傳到 PyPI 上發布。你可以經由過程在 DevPI 中“測試上傳”。【編纂保舉】

  1. 阿里巴巴Blink正式開源,緊張優化點解讀
  2. 開源的江湖恩仇情仇
  3. 滴滴開源跨平臺同一 MVVM 框架 Chameleon
  4. 十大收費開源云文件同享平臺
  5. 被社區存眷的Blink開源到底向上游奉獻了甚么?

【義務編纂:龐桂玉 TEL:(010)68476606】
點贊 0
【免責聲明】本站內容轉載自互聯網,其相關談吐僅代表作者小我私家概念盡非權勢巨子,不代表本站態度。如您發明內容存在版權成績,請提交相關鏈接至郵箱:,咱們將實時予以處置。