1.\" $OpenBSD: portgen.1,v 1.3 2019/11/17 02:45:52 pamela Exp $ 2.\" 3.\" Copyright (c) 2015 Giannis Tsaraias <tsg@openbsd.org> 4.\" Copyright (c) 2015 Vadim Zhukov <zhuk@openbsd.org> 5.\" 6.\" Permission to use, copy, modify, and distribute this software for any 7.\" purpose with or without fee is hereby granted, provided that the above 8.\" copyright notice and this permission notice appear in all copies. 9.\" 10.\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES 11.\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF 12.\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR 13.\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES 14.\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN 15.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF 16.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. 17.\" 18.Dd $Mdocdate: November 17 2019 $ 19.Dt PORTGEN 1 20.Os 21.Sh NAME 22.Nm portgen 23.Nd port modules on the fly 24.Sh SYNOPSIS 25.Nm portgen 26.Ar type 27.Ar module-name 28.Sh DESCRIPTION 29The 30.Nm 31utility creates ports for the given 32.Ar module-name 33from 34.Ar type 35module framework. 36The module is downloaded, analyzed and translated into a port. 37Any missing dependencies are handled recursively. 38New ports will land under ${PORTSDIR}/mystuff. 39The 40.Ev PORTSDIR 41value will be taken from current user environment, and defaults to 42.Pa /usr/ports . 43.Pp 44The 45.Nm 46utility currently supports the following 47.Ar type 48values: 49.Pp 50.Bl -inset -offset indent -compact 51.It Cm p5 52for Perl modules on CPAN. 53.It Cm py 54for Python modules on PyPI. 55.It Cm ruby 56for Ruby gems. 57.El 58.Pp 59The following packages must be installed prior to the invocation of 60.Nm : 61.Pp 62.Bl -item -offset indent -compact 63.It 64.Cm sqlports 65.It 66.Cm p5-DBI 67.It 68.Cm p5-DBD-SQLite 69.El 70.Sh EXIT STATUS 71.Ex -std 72.Sh EXAMPLES 73The following command will download the latest version of Config::AutoConf 74from CPAN, parse it and create a port for it: 75.Bd -ragged -offset indent 76.Nm 77p5 Config::AutoConf 78.Ed 79.Sh SEE ALSO 80.Xr port-modules 5 , 81.Xr ports 7 82.Sh HISTORY 83The 84.Nm 85utility first appeared in 86.Ox 5.9 87as a result of Google Summer of Code 2015. 88.Sh AUTHORS 89.An Giannis Tsaraias Aq Mt tsg@openbsd.org 90.Sh CAVEATS 91Not every module could be converted to a port. 92