Comments on: Paver 0.7: Better than distutils, better docs and much more http://www.blueskyonmars.com/2008/05/07/paver-07-better-than-distutils-better-docs-and-much-more/ Kevin Dangoor on Technology, Business and Everything Fri, 08 Aug 2008 18:26:24 +0000 http://wordpress.org/?v=2.6 By: Kevin Dangoor http://www.blueskyonmars.com/2008/05/07/paver-07-better-than-distutils-better-docs-and-much-more/#comment-208711 Kevin Dangoor Fri, 09 May 2008 10:40:29 +0000 http://www.blueskyonmars.com/2008/05/07/paver-07-better-than-distutils-better-docs-and-much-more/#comment-208711 The short answer is that you can do anything by using the sh() function. That's how I currently pull some things out of svn (I don't much like externals, so I manually control an svn checkout/update) The longer answer requires context. Are you just saying that in some random task you want to pull things from a repository? easy_install can pull from a repository (svn on its own, and I believe bzr if you have a plugin for it) The short answer is that you can do anything by using the sh() function. That’s how I currently pull some things out of svn (I don’t much like externals, so I manually control an svn checkout/update)

The longer answer requires context. Are you just saying that in some random task you want to pull things from a repository? easy_install can pull from a repository (svn on its own, and I believe bzr if you have a plugin for it)

]]> By: Jim Hefferon http://www.blueskyonmars.com/2008/05/07/paver-07-better-than-distutils-better-docs-and-much-more/#comment-208703 Jim Hefferon Thu, 08 May 2008 16:41:37 +0000 http://www.blueskyonmars.com/2008/05/07/paver-07-better-than-distutils-better-docs-and-much-more/#comment-208703 Maybe I missed it; can you pull the materials to be installed out of a repository? That is, in addition to saying "put this file from the code tree there", can I say "get the code tree from version 3.1.4.2 inside the Mercurial repository"? Jim Maybe I missed it; can you pull the materials to be installed out of a repository?

That is, in addition to saying “put this file from the code tree there”, can I say “get the code tree from version 3.1.4.2 inside the Mercurial repository”?

Jim

]]> By: Kevin Dangoor http://www.blueskyonmars.com/2008/05/07/paver-07-better-than-distutils-better-docs-and-much-more/#comment-208702 Kevin Dangoor Thu, 08 May 2008 13:44:21 +0000 http://www.blueskyonmars.com/2008/05/07/paver-07-better-than-distutils-better-docs-and-much-more/#comment-208702 Actually, there are a couple theories of thought regarding keeping include directives in the final docs. If you read Bruce Eckel's books, you'll find comments that show where the sample comes from. That's the value of leaving those in... they tell the read where they can find that sample. I don't think I have the option in there right now, but it will be easy to add the option that allows you to have Cog remove the generator code. I certainly agree that there are cases where you wouldn't want the generator code to show up. Actually, there are a couple theories of thought regarding keeping include directives in the final docs. If you read Bruce Eckel’s books, you’ll find comments that show where the sample comes from. That’s the value of leaving those in… they tell the read where they can find that sample.

I don’t think I have the option in there right now, but it will be easy to add the option that allows you to have Cog remove the generator code. I certainly agree that there are cases where you wouldn’t want the generator code to show up.

]]> By: Paul http://www.blueskyonmars.com/2008/05/07/paver-07-better-than-distutils-better-docs-and-much-more/#comment-208701 Paul Thu, 08 May 2008 13:39:57 +0000 http://www.blueskyonmars.com/2008/05/07/paver-07-better-than-distutils-better-docs-and-much-more/#comment-208701 Very cool. I look forward to following your progress. FYI: There are a lot of Cog directives showing up as literal text in your docs right now! Very cool. I look forward to following your progress.

FYI: There are a lot of Cog directives showing up as literal text in your docs right now!

]]> By: Kevin Dangoor http://www.blueskyonmars.com/2008/05/07/paver-07-better-than-distutils-better-docs-and-much-more/#comment-208700 Kevin Dangoor Thu, 08 May 2008 13:10:45 +0000 http://www.blueskyonmars.com/2008/05/07/paver-07-better-than-distutils-better-docs-and-much-more/#comment-208700 Hi Jim, You're absolutely right. To some extent, I'd rather *not* appeal to those folks just yet. Once Paver has a few more experienced users, a doc like the one you're suggesting would be ideal. Hi Jim,

You’re absolutely right. To some extent, I’d rather *not* appeal to those folks just yet. Once Paver has a few more experienced users, a doc like the one you’re suggesting would be ideal.

]]> By: Jim Jones http://www.blueskyonmars.com/2008/05/07/paver-07-better-than-distutils-better-docs-and-much-more/#comment-208699 Jim Jones Thu, 08 May 2008 11:22:05 +0000 http://www.blueskyonmars.com/2008/05/07/paver-07-better-than-distutils-better-docs-and-much-more/#comment-208699 Thumbs up Kevin, this looks promising. Just one note: Don't forget about the new users. Your docs currently presume a lot of knowledge about setuptools, what's missing are docs that work for someone who is about to package for the first time ever. I'd suggest to create a simple tutorial that describes all steps for an artificial or even a real project. That way you can appeal to newcomers who'd otherwise be forced to learn setuptools first before they can get going with pavement. Thumbs up Kevin, this looks promising.

Just one note: Don’t forget about the new users. Your docs currently presume a lot of knowledge about setuptools, what’s missing are docs that work for someone who is about to package for the first time ever. I’d suggest to create a simple tutorial that describes all steps for an artificial or even a real project. That way you can appeal to newcomers who’d otherwise be forced to learn setuptools first before they can get going with pavement.

]]> By: Kevin Dangoor http://www.blueskyonmars.com/2008/05/07/paver-07-better-than-distutils-better-docs-and-much-more/#comment-208698 Kevin Dangoor Thu, 08 May 2008 10:58:19 +0000 http://www.blueskyonmars.com/2008/05/07/paver-07-better-than-distutils-better-docs-and-much-more/#comment-208698 number5: I have just uploaded Paver 0.7.1 to fix that. I should try to make an automated test for that. Martin: actually, I did notice that, but I needed to get to sleep. Now that morning is here, I've fixed it. Thanks for the bug reports, guys! number5: I have just uploaded Paver 0.7.1 to fix that. I should try to make an automated test for that.

Martin: actually, I did notice that, but I needed to get to sleep. Now that morning is here, I’ve fixed it.

Thanks for the bug reports, guys!

]]> By: number5 http://www.blueskyonmars.com/2008/05/07/paver-07-better-than-distutils-better-docs-and-much-more/#comment-208696 number5 Thu, 08 May 2008 08:25:05 +0000 http://www.blueskyonmars.com/2008/05/07/paver-07-better-than-distutils-better-docs-and-much-more/#comment-208696 Error occurs when installing paver via easy_install: File "/var/folders/Hc/Hcm9A6h6GGW39zZ3SL1nP++++TI/-Tmp-/tmp6O5U2w/paver/defaults.py", line 4, in ImportError: No module named misctasks seems some dependancy not met? Error occurs when installing paver via easy_install:

File “/var/folders/Hc/Hcm9A6h6GGW39zZ3SL1nP++++TI/-Tmp-/tmp6O5U2w/paver/defaults.py”, line 4, in
ImportError: No module named misctasks

seems some dependancy not met?

]]> By: Martin http://www.blueskyonmars.com/2008/05/07/paver-07-better-than-distutils-better-docs-and-much-more/#comment-208695 Martin Thu, 08 May 2008 06:59:25 +0000 http://www.blueskyonmars.com/2008/05/07/paver-07-better-than-distutils-better-docs-and-much-more/#comment-208695 Interesting initiative! There are some strange errors on that foreword page. Have you seen that btw? Interesting initiative!
There are some strange errors on that foreword page. Have you seen that btw?

]]>