Building a release

(Difference between revisions)
Jump to: navigation, search
Line 1: Line 1:
 
Build Biopython in 21 easy steps!!
 
Build Biopython in 21 easy steps!!
  
# Make sure I have the latest code
+
1. make sure I have the latest code
          * drevil:~biopython> cvs update -P -d  
+
    drevil:~biopython> cvs update -P -d  
# Bump version number of Martel (sync with Biopython version?) so that any changes will be installed on new downloads
+
 
  3. make sure README still up to date
+
2. bump version number of Martel (sync with Biopython version?) so that any changes will be installed on new downloads
  4. add info to NEWS
+
 
          * > cvs log -b -N -d'>2002-12-18'  
+
3. make sure README still up to date
  5. make sure CONTRIB still current
+
 
  6. make sure setup.py still up to date
+
4. add info to NEWS
          * update version  
+
    > cvs log -b -N -d'>2002-12-18'  
  7. do last check to make sure things are checked in
+
 
          * make clean
+
5. make sure CONTRIB still current
          * cvs update -P -d  
+
 
  8. do last regression test
+
6. make sure setup.py still up to date
          * drevil:~biopython/Tests> python run_test.py --no-gui  
+
* update version
  9. check out clean version somewhere else
+
 
          * drevil:~tmp1/> cvs -d :ext:jchang@pub.open-bio.org:/home/repository/biopython checkout -r biopython-100a1 biopython  
+
7. do last check to make sure things are checked in
  10. make documentation PDF, text and HTML in Doc
+
    > make clean
  11. make MANIFEST
+
    > cvs update -P -d  
          * make sure MANIFEST.in up to date.
+
 
          * make clean
+
8. do last regression test
          * python setup.py sdist --manifest-only  
+
    drevil:~biopython/Tests> python run_test.py --no-gui  
  12. make sure the regression tests run here
+
 
          * drevil:~tmp1/biopython/Tests/> python run_tests.py --no-gui  
+
9. check out clean version somewhere else
  13. make the source distribution
+
    drevil:~tmp1/> cvs -d :ext:jchang@pub.open-bio.org:/home/repository/biopython checkout -r biopython-100a1 biopython  
          * drevil:~tmp1/biopython> python setup.py sdist --formats=gztar,zip  
+
 
  14. untar the file somewhere else
+
10. make documentation PDF, text and HTML in Doc
          * drevil:~tmp2> gzcat ../tmp1/biopython/dist/biopython-1.00a1.tar.gz | tar xvf -
+
 
          * Check to make sure it includes Martel  
+
11. make MANIFEST. First, make sure MANIFEST.in up to date.
  15. make sure I can build and test it
+
    make clean
          * drevil:~tmp2/biopython-1.00a1/> python setup.py build
+
    python setup.py sdist --manifest-only  
          * drevil:~tmp2/biopython-1.00a1/> python setup.py test
+
 
          * drevil:~tmp2/biopython-1.00a1/> python setup.py install --root .  
+
12. make sure the regression tests run here
  16. add CVS tag
+
    drevil:~tmp1/biopython/Tests/> python run_tests.py --no-gui  
          * drevil:~biopython> cvs tag biopython-100a1  
+
 
  17. Update API documentation using Epydoc
+
13. make the source distribution
          * Go to the /usr/local/lib/python2.4/site-packages (or equivalent) directory. Running epydoc in your CVS tree works, but can miss some packages due to import errors.
+
    drevil:~tmp1/biopython> python setup.py sdist --formats=gztar,zip  
          * epydoc -o api -u http://biopython.org -n Biopython --docformat plaintext Bio BioSQL Martel
+
 
          * Move the generated api directory to replace /home/websites/biopython.org/docs/api.  
+
14. untar the file somewhere else
  18. ftp the .tar.gz, .zip files to biopython
+
    drevil:~tmp2> gzcat ../tmp1/biopython/dist/biopython-1.00a1.tar.gz | tar xvf -
  19. update the web site
+
* Check to make sure it includes Martel  
          * add to Download page (BioWebsite/download.py)
+
 
          * Post news on news.open-bio.org
+
15. make sure I can build and test it
          * make sure links work  
+
    drevil:~tmp2/biopython-1.00a1/> python setup.py build
  20. clean up the tmp directories I made
+
    drevil:~tmp2/biopython-1.00a1/> python setup.py test
  21. send email to biopython@biopython.org, biopython-announce@biopython.org
+
    drevil:~tmp2/biopython-1.00a1/> python setup.py install --root .  
 +
 
 +
16. add CVS tag
 +
    drevil:~biopython> cvs tag biopython-100a1  
 +
 
 +
17. Update API documentation using Epydoc.
 +
* Go to the /usr/local/lib/python2.4/site-packages (or equivalent) directory. Running epydoc in your CVS tree works, but can miss some packages due to import errors.
 +
    epydoc -o api -u http://biopython.org -n Biopython --docformat plaintext Bio BioSQL Martel
 +
* Move the generated api directory to replace /home/websites/biopython.org/docs/api.  
 +
 
 +
18. ftp the .tar.gz, .zip files to biopython
 +
 
 +
19. update the web site
 +
* add to Download page (BioWebsite/download.py)
 +
* Post news on news.open-bio.org
 +
* make sure links work  
 +
 
 +
20. clean up the tmp directories I made
 +
 
 +
21. send email to biopython@biopython.org, biopython-announce@biopython.org

Revision as of 00:32, 8 May 2006

Build Biopython in 21 easy steps!!

1. make sure I have the latest code

   drevil:~biopython> cvs update -P -d 

2. bump version number of Martel (sync with Biopython version?) so that any changes will be installed on new downloads

3. make sure README still up to date

4. add info to NEWS

   > cvs log -b -N -d'>2002-12-18' 

5. make sure CONTRIB still current

6. make sure setup.py still up to date

  • update version

7. do last check to make sure things are checked in

   > make clean
   > cvs update -P -d 

8. do last regression test

   drevil:~biopython/Tests> python run_test.py --no-gui 

9. check out clean version somewhere else

   drevil:~tmp1/> cvs -d :ext:jchang@pub.open-bio.org:/home/repository/biopython checkout -r biopython-100a1 biopython 

10. make documentation PDF, text and HTML in Doc

11. make MANIFEST. First, make sure MANIFEST.in up to date.

   make clean
   python setup.py sdist --manifest-only 

12. make sure the regression tests run here

   drevil:~tmp1/biopython/Tests/> python run_tests.py --no-gui 

13. make the source distribution

   drevil:~tmp1/biopython> python setup.py sdist --formats=gztar,zip 

14. untar the file somewhere else

   drevil:~tmp2> gzcat ../tmp1/biopython/dist/biopython-1.00a1.tar.gz | tar xvf -
  • Check to make sure it includes Martel

15. make sure I can build and test it

   drevil:~tmp2/biopython-1.00a1/> python setup.py build
   drevil:~tmp2/biopython-1.00a1/> python setup.py test
   drevil:~tmp2/biopython-1.00a1/> python setup.py install --root . 

16. add CVS tag

   drevil:~biopython> cvs tag biopython-100a1 

17. Update API documentation using Epydoc.

  • Go to the /usr/local/lib/python2.4/site-packages (or equivalent) directory. Running epydoc in your CVS tree works, but can miss some packages due to import errors.
   epydoc -o api -u http://biopython.org -n Biopython --docformat plaintext Bio BioSQL Martel
  • Move the generated api directory to replace /home/websites/biopython.org/docs/api.

18. ftp the .tar.gz, .zip files to biopython

19. update the web site

  • add to Download page (BioWebsite/download.py)
  • Post news on news.open-bio.org
  • make sure links work

20. clean up the tmp directories I made

21. send email to biopython@biopython.org, biopython-announce@biopython.org

Personal tools
Namespaces
Variants
Actions
Navigation
Toolbox