From owner-freebsd-python@freebsd.org  Tue Dec 12 02:44:49 2017
Return-Path: <owner-freebsd-python@freebsd.org>
Delivered-To: freebsd-python@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 364ACE88453;
 Tue, 12 Dec 2017 02:44:49 +0000 (UTC)
 (envelope-from koobs.freebsd@gmail.com)
Received: from mail-pg0-x22b.google.com (mail-pg0-x22b.google.com
 [IPv6:2607:f8b0:400e:c05::22b])
 (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits))
 (Client CN "smtp.gmail.com",
 Issuer "Google Internet Authority G2" (verified OK))
 by mx1.freebsd.org (Postfix) with ESMTPS id 0909E66707;
 Tue, 12 Dec 2017 02:44:49 +0000 (UTC)
 (envelope-from koobs.freebsd@gmail.com)
Received: by mail-pg0-x22b.google.com with SMTP id q20so12413305pgv.2;
 Mon, 11 Dec 2017 18:44:48 -0800 (PST)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025;
 h=sender:reply-to:subject:to:references:from:message-id:date
 :user-agent:mime-version:in-reply-to:content-language
 :content-transfer-encoding;
 bh=YruekHRbZNnZuoC4JZiCk/Dz4BfavUh8bwF9oX9rbSI=;
 b=eSrhSVVWxL4KpwPXaWawb/pdJTaqGmeRyST2++IenU+hBcG6XrQPTj/kSxnKGU6G8e
 JXpQEUzGtGzu9gh3/8W0WHta1zRLkIx1Snz/fvHs3+avMQdCsY0Ge8KvMLzLEg70PGkD
 FmhNIQcAHAToGFQwKRaM1Sc1CS+7N0I91raswzj8U11bVVQ7YFX9FbAqlG+FOVrjANki
 fJEsfmB8gz432EN9juyFEpvoZdFlVrGIbwk9jc18D9sNJgxLw1gL6DZbvOJA6mby4GjL
 5ypXCBq6/ZsCz66R4I3umJ2K53vnd2XZygeFwq5RCypnIflXaF/EpQgv55K1rVF/5dgX
 d1HA==
X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed;
 d=1e100.net; s=20161025;
 h=x-gm-message-state:sender:reply-to:subject:to:references:from
 :message-id:date:user-agent:mime-version:in-reply-to
 :content-language:content-transfer-encoding;
 bh=YruekHRbZNnZuoC4JZiCk/Dz4BfavUh8bwF9oX9rbSI=;
 b=jENRU5gk0fvCchjwZZahtgVXdmFvBc4zNGqKPMy0BeN1THtFDd+7aC4GjRL7IqETJq
 GulD7GL23sACEa589HYC+mGVGsX8NSo9xVdeGBL5SQk9f7kT/loZoI9mCHe88HVWF3tv
 nfIQoQK96rpNAcziD0FJDuiDC9DcCEyIMw4KHEPo1hTQv8pjzPBnW48F0rVHUmrLmpa8
 4DH1H7hn9NebEU7Ra17pP8cJWvIYNrP/yCm3o1wdaqDN5RsAI/ADP4xiMNcuzOCHfwDn
 SaeCS+YBxHM6cmJ5Oke4oa9qrjmS077XK1YNds1pJ2ZJdy3i/vySwoKQTglYnKtnRoy1
 Uprw==
X-Gm-Message-State: AKGB3mJAFcUcqrgfYbDOFPl74NNUqV9bCb1YRZ48bLG27oPjzSWDPZb9
 bjcyKe0tH+BANYNAioG95iVD2Gj9
X-Google-Smtp-Source: ACJfBouwAUJ1FtRg3jotFg1U4caGxr2+ouaCGK3WuHeH+JWiPlm5l70qbcoXVtRRy9XLETBiA7aLQA==
X-Received: by 10.99.60.26 with SMTP id j26mr632923pga.256.1513046683069;
 Mon, 11 Dec 2017 18:44:43 -0800 (PST)
Received: from ?IPv6:2001:44b8:31ae:7b01:3863:85c7:760a:d400?
 (2001-44b8-31ae-7b01-3863-85c7-760a-d400.static.ipv6.internode.on.net.
 [2001:44b8:31ae:7b01:3863:85c7:760a:d400])
 by smtp.gmail.com with ESMTPSA id p77sm33556897pfd.132.2017.12.11.18.44.40
 (version=TLS1_2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128);
 Mon, 11 Dec 2017 18:44:42 -0800 (PST)
Sender: Kubilay Kocak <koobs.freebsd@gmail.com>
Reply-To: koobs@FreeBSD.org
Subject: Re: What is the preferred MASTER_SITES for python port?
To: Sergey Akhmatov <sergey@akhmatov.ru>, freebsd-python@freebsd.org,
 freebsd-ports@freebsd.org
References: <56059f84-ab05-9db5-13d4-b1a443df0832@akhmatov.ru>
From: Kubilay Kocak <koobs@FreeBSD.org>
Message-ID: <e9b33755-b196-0441-bfa0-1a565a566a8f@FreeBSD.org>
Date: Tue, 12 Dec 2017 13:36:41 +1100
User-Agent: Mozilla/5.0 (Windows NT 10.0; WOW64; rv:58.0) Gecko/20100101
 Thunderbird/58.0
MIME-Version: 1.0
In-Reply-To: <56059f84-ab05-9db5-13d4-b1a443df0832@akhmatov.ru>
Content-Type: text/plain; charset=utf-8
Content-Language: en-AU
Content-Transfer-Encoding: 7bit
X-BeenThere: freebsd-python@freebsd.org
X-Mailman-Version: 2.1.25
Precedence: list
List-Id: FreeBSD-specific Python issues <freebsd-python.freebsd.org>
List-Unsubscribe: <https://lists.freebsd.org/mailman/options/freebsd-python>, 
 <mailto:freebsd-python-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/freebsd-python/>
List-Post: <mailto:freebsd-python@freebsd.org>
List-Help: <mailto:freebsd-python-request@freebsd.org?subject=help>
List-Subscribe: <https://lists.freebsd.org/mailman/listinfo/freebsd-python>,
 <mailto:freebsd-python-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Tue, 12 Dec 2017 02:44:49 -0000

On 12/12/2017 1:28 am, Sergey Akhmatov wrote:
> Hello.
> 
> Suppose I want to port some python package that exists in the Python
> Package Index (PyPI) and has it's source code available on some official
> website or github.
> 
> Is there any policy or recommended practice for choosing MASTER_SITES?
> Should I use "USE_GITHUB=yes" or "MASTER_SITES= CHEESESHOP" for such
> package?
> 
> I've looked for the answer in Porters Handbook and at
> https://wiki.freebsd.org/Python/PortsPolicy but haven't found it.
> 
> Thank you.
> 

Hi Sergey:

Use CHEESESHOP by default unless there is a compelling (temporary) case
not to.

Examples include certain files are not correctly packaged/included in
the PyPI sdist, such as test suite/files/data.

In these cases, use the alternative MASTER_SITES, open issues/PR's
upstream to get them included, and switch to CHEESESHOP when it lands.

This ensures an upstreams packaging/deployment pipeline is well tested
and standardised, as it is heavily relied upon (setuptools, autoplist,
documentation, discoverability, etc)

Note: Irrespective of MASTER_SITES, if a package is in PyPI it *must* be
named exactly by its <pypi-name>. That is:

* SVN Directory: py-<pypi-name>
* PORTNAME= <pypi-name>
* PKGNAMEPREFIX=${PYTHON_PKGNAMEPREFIX}

./koobs