@@ -116,30 +116,30 @@ This tool provides one script, named `versioneer.py`.
116
116
117
117
To versioneer-enable your project:
118
118
119
- 1: copy ` versioneer.py ` into the top of your source tree
119
+ * 1: copy ` versioneer.py ` into the top of your source tree
120
120
121
- 2: add the following lines to the top of your ` setup.py ` , with suitable
122
- values for each configuration setting:
121
+ * 2: add the following lines to the top of your ` setup.py ` , with suitable
122
+ values for each configuration setting:
123
123
124
124
import versioneer
125
125
versioneer.versionfile_source = 'src/myproject/_ version.py'
126
126
versioneer.versionfile_build = 'myproject/_ version.py'
127
127
versioneer.tag_prefix = '' # tags are like 1.2.0
128
128
versioneer.parentdir_prefix = 'myproject-' # dirname like 'myproject-1.2.0'
129
129
130
- 3: add the following arguments to the setup() call in your setup.py:
130
+ * 3: add the following arguments to the setup() call in your setup.py:
131
131
132
132
version=versioneer.get_version(),
133
133
cmdclass=versioneer.get_cmdclass(),
134
134
135
- 4: run ` setup.py update_files ` , which will create ` _version.py ` , and will
136
- modify your ` __init__.py ` to define ` __version__ ` (by calling a function
137
- from ` _version.py ` )
135
+ * 4: run ` setup.py update_files ` , which will create ` _version.py ` , and will
136
+ modify your ` __init__.py ` to define ` __version__ ` (by calling a function
137
+ from ` _version.py ` )
138
138
139
- 5: modify your MANIFEST.in to include ` versioneer.py ` in sdist tarballs
139
+ * 5: modify your MANIFEST.in to include ` versioneer.py ` in sdist tarballs
140
140
141
- 6: commit these changes to your VCS. ` update_files ` will mark both
142
- ` versioneer.py ` and the generated ` _version.py ` for addition.
141
+ * 6: commit these changes to your VCS. ` update_files ` will mark both
142
+ ` versioneer.py ` and the generated ` _version.py ` for addition.
143
143
144
144
## Post-Installation Usage
145
145
@@ -150,14 +150,14 @@ version string (so users who unpack them will not need a VCS tool installed).
150
150
If you distribute your project through PyPI, then the release process should
151
151
boil down to two steps:
152
152
153
- 1: git tag 1.0
154
- 2: python setup.py register sdist upload
153
+ * 1: git tag 1.0
154
+ * 2: python setup.py register sdist upload
155
155
156
156
If you distribute it through github (i.e. users use github to generate
157
157
tarballs with ` git archive ` ), the process is:
158
158
159
- 1: git tag 1.0
160
- 2: git push; git push --tags
159
+ * 1: git tag 1.0
160
+ * 2: git push; git push --tags
161
161
162
162
Currently, all version strings must be based upon a tag. Versioneer will
163
163
report "unknown" until your tree has at least one tag in its history. This
0 commit comments