svn commit: r47982 - head/en_US.ISO8859-1/htdocs/news/status

Sat Jan 9 20:26:47 UTC 2016

Author: bjk
Date: Sat Jan  9 20:26:45 2016
New Revision: 47982
URL: https://svnweb.freebsd.org/changeset/doc/47982

Log:
  Add entry on porting tools from Brendan Molloy

Modified:
  head/en_US.ISO8859-1/htdocs/news/status/report-2015-10-2015-12.xml

Modified: head/en_US.ISO8859-1/htdocs/news/status/report-2015-10-2015-12.xml
==============================================================================

--- head/en_US.ISO8859-1/htdocs/news/status/report-2015-10-2015-12.xml	Sat Jan  9 20:24:13 2016	(r47981)
+++ head/en_US.ISO8859-1/htdocs/news/status/report-2015-10-2015-12.xml	Sat Jan  9 20:26:45 2016	(r47982)
@@ -1023,4 +1023,82 @@
       </task>
     </help>
   </project>
+
+  <project cat='ports'>
+    <title>New tools to enhance the porting experience</title>
+
+    <contact>
+      <person>
+      <name>
+	<given>Brendan</given>
+	<common>Molloy</common>
+      </name>
+      <email>brendan+freebsd at bbqsrc.net</email>
+      </person>
+    </contact>
+
+    <links>
+      <url href="https://github.com/FreeBSD/pytoport">pytoport: Generate &os; Ports from Python modules on PyPI</url>
+      <url href="https://github.com/bbqsrc/bandar">bandar: Create Development Overlays for the Ports tree</url>
+      <url href="https://github.com/bbqsrc/skog-python">skog: Generate Visual Dependency Trees for &os; Ports</url>
+      <url href="https://github.com/bbqsrc/spdx-lookup-python">spdx-lookup: SPDX License List Query Tool</url>
+    </links>
+
+    <body>
+      <p>When I starting working on ports for &os; in the last
+	couple of weeks, I found that my workflow was not as efficient as
+	it could be, using just the available tools, so I made a few that
+	could be useful to the development community at large.  All of
+	these have been added to the Ports tree, or otherwise will soon be
+	added, so you can play with them today!</p>
+
+      <p><tt>pytoport</tt> is a command-line application that
+	generates a skeleton port for a given PyPI package name.  It
+	attempts to generate the correct dependencies, makes a good
+	attempt at guessing the license using <tt>spdx-lookup</tt>, and
+	generates a <tt>pkg-descr</tt>.  This made generating the fifteen
+	or so ports I was working on a complete breeze.</p>
+
+      <p>While doing this, however, I noticed that some ports were
+	bringing in dependencies that I did not expect, and I needed some
+	way to visualise this.  <tt>skog</tt> builds a dependency tree
+	from the depends lists output by the Ports framework, and displays
+	it on the command line (with extra shiny output if you are using
+	UTF-8).  No more pesky example and documentation dependencies
+	being dragged in when you <em>clearly</em> toggled that
+	<tt>OPTION</tt> as far off as it would go.</p>
+
+      <p>While doing all of this, I found it cumbersome to be
+	copying ports back and forth between my small development tree
+	living in git and the larger upstream SVN tree I was using in
+	poudriere.  I built a tool called <tt>bandar</tt> that takes
+	advantage of the FUSE version of unionfs to easily overlay my dev
+	tree on the upstream tree, run linting, poudriere and generate
+	archives with ease.</p>
+
+      <p>I'm very impressed with how easy it was to build more
+	tooling for &os;.  I hope some of these tools will be of some use
+	to you, and as always, I'd love to hear your feedback!</p>
+    </body>
+
+    <help>
+      <task>
+	<p>Improve skog to support searching a tree for a certain
+	  port.</p>
+      </task>
+
+      <task>
+	<p>Get the bandar port completed.</p>
+      </task>
+
+      <task>
+	<p>Continue to improve pytoport, adding trove support and better
+	  depedency handling.</p>
+      </task>
+
+      <task>
+	<p>Patches welcome for all of the above!</p>
+      </task>
+    </help>
+  </project>
 </report>
