3

setuptools_scm を使用するように更新したばかりのパッケージがあり、readthedocs でバージョン番号が間違っていることがわかりました。

http://sshuttle.readthedocs.org/en/v0.77/ショー:

Version: 0.78.dev0+ng083293e.d20160304

ただし、バージョン 083293e には 0.77 タグがあるため、バージョン文字列は 0.77 にする必要があります。

ビルド前に readthedocs がソース コードを変更しているようです。

readthedocs ビルド ログを調べたところ、ある段階 (0.77) では正しいバージョンのようですが、これはドキュメントをビルドする前です。

Processing dependencies for sshuttle==0.77
Finished processing dependencies for sshuttle==0.77

ドキュメントのビルド中、ビルド ログにはバージョンが記載されていません。

これを解決することは可能ですか？

ありがとう

4

3 に答える 3

1

このプロジェクトを構築しているようです。

明らかに、バージョンが決定される前に何かがリポジトリの状態を変更しています。ドキュメントを自分でビルドする前に、ファイルの 1 つを変更することで、同様の動作を再現できます。

(sshuttle) $ python setup.py --version
0.77
(sshuttle) $ cat >> setup.py
# a comment
(sshuttle) $ python setup.py --version
0.78.dev0+ng083293e.d20160403

ドキュメントのドキュメントを読むには、プロセスの説明があります。

そこでは、RTD が実行する手順、つまり、(a) setup.py install を実行し、(b) requirements.txt に要件をインストールする手順を確認できます。

これらの手順のいずれもレポの状態を変更しないことを確認しました。

ただし、説明されていないのは、その「バージョン」がどこから来たのか、または update_imported_docs が何をするのかです。問題は、レポを変更するドキュメントを読んでいる微妙な何かにあると思われます。

conf.py ファイルが変更される場所の1 つを次に示します。

おそらくdocs/conf.py、.gitignore に追加すると、これらの変更を無視できるようになり、プロジェクトのバージョンを計算するときに作業状態が汚れなくなります。

于 2016-04-03T13:47:10.307 に答える
0

https://github.com/pypa/setuptools_scm/issues/84が更新され、これが記録されました

Sphinx チームと協力して、このプロセスの自動化された/簡単なバージョンを提供します。

于 2016-09-17T05:24:34.877 に答える