Packaging no.9

From MtlPy Wiki

Jump to: navigation, search

Contents

[edit] Presentation

Sprint on the Python packaging tools and libraries.

The sprint will take place at Google's office, 1253 McGill College, suite 250 on 2010-09-29 starting at 6h30 pm. It's also possible to join remotely by irc on #montrealpython on irc.freenode.net.

Bring your laptop or make a pairing agreement on the mailing list before hand. Attendance is limited to 20 sprinters so please RSVP below.

Frnkaly I think that's absolutely good stuff.

You're the gaeretst! JMHO

[edit] Possible Tasks

  • Improving the code coverage of unit tests
  • Improving the PEP-8 compliance of the code
  • one of the several tasks listed on the distutils2 wiki

[edit] Development workflow

  • read the Hitchhiker’s Guide to Packaging
  • fork the project at bitbucket
  • ask for a pull request once the feature is done
  • for distribute, switch to the `0.6-maintenance` branch

[edit] Getting started with Bitbucket

  • register for a free account
  • open a shell and generate an ssh-key by typing: ssh-keygen
  • edit your account preferences and put the content of `~/.ssh/id-rsa.pub` in the "SSH Keys" box.
  • send your username to a repository admin (any Montréal-Python organizer) and ask for commit rights on
  • unlock your key by typing: ssh-add
  • checkout a copy of the code by typing: hg clone ssh://hg@bitbucket.org/mtlpython/distutils2

[edit] Working with Mercurial

Mercurial does not need much configuration but at the minimum, you should tell it who you are and what extensions you want to use. Do do so, create the `~/.hgrc` file with a content similar to this:

   [ui]
   username = Firstname Lastname <email@example.com>
   
   [extensions]
   hgext.mq =
   fetch = 
   color = 
   bookmarks =

Once you have a clone of the Montréal-Python repository, you can make local commits with `hg commit`. You should do so often but keep in mind that we need to have our code reviewed and merged into the Python core so make sure that your commits are clean, easy to review, and that they include a descriptive commit message.

Keep in mind that Mercurial is a distributed revision control system and that all your commits are local to your machine. If you want to share your work, you need to push it back to the Montréal-Python repository with `hg push`.

If your local copy is not up to date, you will get a warning when you try to push about creating multiple heads. If you want to move forward, you need to update your local copy with `hg fetch`. Not that `fetch` is only available after you configured your mercurial as stated above. If your don't have `fetch`, you can do a combination of `pull`, `merge`, and `commit`.

Hats off to whoever wrote this up and psoetd it.

[edit] Other sources of information

Personal tools