SF.net SVN: docutils:[9602 ] trunk/docutils/docs/dev/r elease.txt

Revision: 9602
          http://sourceforge.net/p/docutils/code/9602
Author:   grubert
Date:     2024-03-27 00:02:08 +0000 (Wed, 27 Mar 2024)
Log Message:
-----------
fixes to some steps (upload login with token, ...)

Modified Paths:
--------------
    trunk/docutils/docs/dev/release.txt

Modified: trunk/docutils/docs/dev/release.txt
===================================================================
--- trunk/docutils/docs/dev/release.txt	2024-03-26 23:49:59 UTC (rev 9601)
+++ trunk/docutils/docs/dev/release.txt	2024-03-27 00:02:08 UTC (rev 9602)
@@ -63,13 +63,21 @@
 
 * Generate wheel and source-distribution::
 
+    python3 -m pip install flit
+    python3 -m flit build 
+
+  or ::
+
     python3 -m pip install build
     python3 -m build .
 
 * check sdist for html-files in docutils.egg-info.
-* Upload wheel and source to test.pypi::
+* Upload wheel and source to test.pypi.
+  
+  Set repository and key in ~/.pypirc with a <server-name> and
+  password token::
 
-    python3 -m twine upload --repository-url https://test.pypi.org/legacy/ dist/*
+    python3 -m twine upload --repository <server-name> dist/*
 
   Test in venv. NOTE use --pre for prereleases::
 
@@ -81,12 +89,14 @@
     cp -Lr ../docutils-code/docutils/test .
     python test/alltests.py
 
+  Ignore ``test_find_file_in_dirs`` fails because HISTORY.txt is missing.
+
     python -m pip uninstall docutils
     deactivate ; cd .. ; rm -r du3
 
 * Commit changes ... the changed version number.
 
-* tag #.# (Note: only directory docutils is copied)::
+* If final release tag #.# (Note: only directory docutils is copied)::
 
     svn copy svn+ssh://[email protected]/p/docutils/code/trunk/docutils \
              svn+ssh://[email protected]/p/docutils/code/tags/docutils-#.# \
@@ -100,7 +110,7 @@
 
 * Now upload to pypi::
 
-    python3 -m twine upload  dist/docutils-#.#*
+    python3 -m twine upload --repository <server-name> dist/docutils-#.#*
 
 * Remove previous package from local cache::
 
@@ -119,6 +129,10 @@
 
 * Notify to docutils-developer and user.
 
+For candidate releases change version to rc#+1dev.
+
+For final releases continue
+
 * upload source and generated html to sf-htdocs/#.# ::
 
     mkdir tmp1
@@ -139,7 +153,6 @@
   - Select docutils-#.#.tar.gz as default for all OS.
 
 * set_version #.{#+1}b.dev
-* test with py3
 * docutils/HISTORY.txt: add title "Changes Since #.#"
 * run sandbox/infrastructure/docutils-update.local
 

This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site.