Merge branch 'master' into readme_images
This commit is contained in:
11
README.rst
11
README.rst
@@ -190,16 +190,13 @@ Why am I getting an error during installation/when launching rtv?
|
|||||||
$ sudo pip3 install -U rtv
|
$ sudo pip3 install -U rtv
|
||||||
|
|
||||||
Why do I see garbled text like ``M-b~@M-"`` or ``^@``?
|
Why do I see garbled text like ``M-b~@M-"`` or ``^@``?
|
||||||
Quick fix
|
|
||||||
Try starting RTV in ascii-only mode with ``rtv --ascii``
|
|
||||||
|
|
||||||
Explanation
|
|
||||||
This type of text usually shows up when python is unable to render
|
This type of text usually shows up when python is unable to render
|
||||||
unicode properly.
|
unicode properly.
|
||||||
|
|
||||||
1. Make sure that the terminal/font that you're using supports unicode
|
1. Try starting RTV in ascii-only mode with ``rtv --ascii``
|
||||||
2. Try `setting the LOCALE to utf-8 <https://perlgeek.de/en/article/set-up-a-clean-utf8-environment>`_
|
2. Make sure that the terminal/font that you're using supports unicode
|
||||||
3. Your python may have been built against the wrong curses library,
|
3. Try `setting the LOCALE to utf-8 <https://perlgeek.de/en/article/set-up-a-clean-utf8-environment>`_
|
||||||
|
4. Your python may have been built against the wrong curses library,
|
||||||
see `here <stackoverflow.com/questions/19373027>`_ and
|
see `here <stackoverflow.com/questions/19373027>`_ and
|
||||||
`here <https://bugs.python.org/issue4787>`_ for more information
|
`here <https://bugs.python.org/issue4787>`_ for more information
|
||||||
|
|
||||||
|
|||||||
35
RELEASE_CHECKLIST.md
Normal file
35
RELEASE_CHECKLIST.md
Normal file
@@ -0,0 +1,35 @@
|
|||||||
|
Release Checklist
|
||||||
|
-----------------
|
||||||
|
|
||||||
|
1. Switch to the master branch and stash any uncommited changes.
|
||||||
|
2. Bump the version number in [rtv/\_\_version\_\_.py](rtv/__version__.py).
|
||||||
|
3. Update the release notes in the [CHANGELOG.rst](CHANGELOG.rst).
|
||||||
|
4. Update the contributer list by running [``scripts/build_authors.py``](scripts/build_authors.py).
|
||||||
|
5. Re-generate the manpage by running [``scripts/build_manpage.py``](scripts/build_manpage.py).
|
||||||
|
6. Make sure the bundled packages are up-to-date by running [``scripts/update_packages.py``](scripts/update_packages.py).
|
||||||
|
7. Commit all changes to the master branch.
|
||||||
|
8. Clean out any old build/release files by running [``scripts/pip_clean.py``](scripts/pip_clean.py).
|
||||||
|
9. Build the source tarball and binary wheel: ``$ python3 setup.py sdist bdist_wheel``
|
||||||
|
10. Upload the packages to PyPI: ``$ twine upload dist/*``
|
||||||
|
11. Verify that the upload was successful: ``$ pip install rtv --upgrade --force-reinstall``
|
||||||
|
12. Smoke test the new release on Python 2 and Python 3.
|
||||||
|
12. Create a new release on Github and copy the release notes from the changelog.
|
||||||
|
13. Use Github to delete any old branches that have been merged.
|
||||||
|
|
||||||
|
Packaging Guide
|
||||||
|
---------------
|
||||||
|
|
||||||
|
The most up-to-date and pragmatic guide on packaging for PyPI is given here (as of Fall 2017):
|
||||||
|
|
||||||
|
https://packaging.python.org/tutorials/distributing-packages/
|
||||||
|
|
||||||
|
PyPI Credentials
|
||||||
|
----------------
|
||||||
|
|
||||||
|
PyPI credentials are stored in plaintext in the **~/.pypirc** file.
|
||||||
|
|
||||||
|
```
|
||||||
|
[pypi]
|
||||||
|
username = michael-lazar
|
||||||
|
password = secret
|
||||||
|
```
|
||||||
Reference in New Issue
Block a user