From owner-svn-doc-head@freebsd.org Sat Jan 9 20:26:47 2016 Return-Path: Delivered-To: svn-doc-head@mailman.ysv.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) by mailman.ysv.freebsd.org (Postfix) with ESMTP id 2E0C3A69286; Sat, 9 Jan 2016 20:26:47 +0000 (UTC) (envelope-from bjk@FreeBSD.org) Received: from repo.freebsd.org (repo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:0]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (Client did not present a certificate) by mx1.freebsd.org (Postfix) with ESMTPS id 0545010E0; Sat, 9 Jan 2016 20:26:46 +0000 (UTC) (envelope-from bjk@FreeBSD.org) Received: from repo.freebsd.org ([127.0.1.37]) by repo.freebsd.org (8.15.2/8.15.2) with ESMTP id u09KQkvw014069; Sat, 9 Jan 2016 20:26:46 GMT (envelope-from bjk@FreeBSD.org) Received: (from bjk@localhost) by repo.freebsd.org (8.15.2/8.15.2/Submit) id u09KQk6V014068; Sat, 9 Jan 2016 20:26:46 GMT (envelope-from bjk@FreeBSD.org) Message-Id: <201601092026.u09KQk6V014068@repo.freebsd.org> X-Authentication-Warning: repo.freebsd.org: bjk set sender to bjk@FreeBSD.org using -f From: Benjamin Kaduk Date: Sat, 9 Jan 2016 20:26:46 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r47982 - head/en_US.ISO8859-1/htdocs/news/status X-SVN-Group: doc-head MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-doc-head@freebsd.org X-Mailman-Version: 2.1.20 Precedence: list List-Id: SVN commit messages for the doc tree for head List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sat, 09 Jan 2016 20:26:47 -0000 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 @@ + + + New tools to enhance the porting experience + + + + + Brendan + Molloy + + brendan+freebsd@bbqsrc.net + + + + + pytoport: Generate &os; Ports from Python modules on PyPI + bandar: Create Development Overlays for the Ports tree + skog: Generate Visual Dependency Trees for &os; Ports + spdx-lookup: SPDX License List Query Tool + + + +

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!

+ +

pytoport 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 spdx-lookup, and + generates a pkg-descr. This made generating the fifteen + or so ports I was working on a complete breeze.

+ +

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. skog 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 clearly toggled that + OPTION as far off as it would go.

+ +

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 bandar 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.

+ +

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!

+ + + + +

Improve skog to support searching a tree for a certain + port.

+ + + +

Get the bandar port completed.

+ + + +

Continue to improve pytoport, adding trove support and better + depedency handling.

+ + + +

Patches welcome for all of the above!

+ + +