Path: csiph.com!fu-berlin.de!uni-berlin.de!not-for-mail From: Chris Warrick Newsgroups: comp.lang.python Subject: Re: Python boilerplate Date: Mon, 21 Mar 2016 17:03:14 +0100 Lines: 27 Message-ID: References: <17c30829-4d9e-49ab-ad93-acc217a55aee@googlegroups.com> <61c94e82-8bcc-4855-a856-468bcadfe486@googlegroups.com> Mime-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: quoted-printable X-Trace: news.uni-berlin.de 4QbngThnrQLS1gDDWsp/uA4dziS6fLdvQ6Wv0dqngcoQ== Return-Path: X-Original-To: python-list@python.org Delivered-To: python-list@mail.python.org X-Spam-Status: OK 0.008 X-Spam-Evidence: '*H*': 0.98; '*S*': 0.00; 'subject:Python': 0.05; 'sphinx': 0.07; 'cc:addr:python-list': 0.09; 'vast': 0.09; 'python': 0.10; 'packages.': 0.15; '.rst': 0.16; '2016': 0.16; 'enough.': 0.16; 'received:io': 0.16; 'received:psf.io': 0.16; 'reusable': 0.16; 'wrote:': 0.16; 'platforms': 0.18; 'cc:2**0': 0.20; 'cc:addr:python.org': 0.20; 'preferred': 0.20; 'junior': 0.22; 'cc:no real name:2**0': 0.22; 'header:In-Reply-To:1': 0.24; 'module': 0.25; 'chris': 0.26; 'separate': 0.27; 'message- id:@mail.gmail.com': 0.27; 'understand,': 0.29; 'code': 0.30; 'probably': 0.31; 'everyone': 0.31; 'run': 0.33; 'point': 0.33; 'received:google.com': 0.35; 'so,': 0.35; 'replace': 0.35; 'received:74.125.82': 0.35; 'community': 0.36; 'but': 0.36; 'project': 0.36; 'instead': 0.36; 'depends': 0.36; 'subject:: ': 0.37; 'why': 0.39; "didn't": 0.39; 'easily': 0.39; 'default': 0.61; 'today,': 0.62; '(that': 0.63; 'more': 0.63; 'march': 0.64; 'intent': 0.66; 'fact,': 0.67; 'to:addr:live.com': 0.84 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=mime-version:in-reply-to:references:date:message-id:subject:from:to :cc:content-transfer-encoding; bh=gQ4ZUQ6Plqk8k8wjvQwzB5qHFiIbzOU+0JtUANcAWJ8=; b=IKlx9NCyc3bybflos2vUoAaTvFlP8OBqZyO8aSe8Hf+b5c8TXqYvX/gRzNtl1CFS6a jsYNm2gfIEJs5fyuTVlCTeOogJScFOSFHd3jHiqwF0oBQN/Sdnd3mKhLhx/Mmp2TdXa1 8QltcaSvGVidHHcuVrTHYuup7/KR7ElUnxxNUY8XBWJYUs8dMS749duRc043p5gpNINl qV+4lgIS3zsWPU+sLIj2azrtb1/jAWb/cMnwMdTZUCNvWHAM/YbBPKMgJHY87ukdOvvH ScCO/RnN/lNO2SvWXr3OkIs5Y3qVYshvenbKoOquLRK97PlEK0z0zShR5ByCJHkUqgTS 2V/A== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20130820; h=x-gm-message-state:mime-version:in-reply-to:references:date :message-id:subject:from:to:cc:content-transfer-encoding; bh=gQ4ZUQ6Plqk8k8wjvQwzB5qHFiIbzOU+0JtUANcAWJ8=; b=I49si1Lse2xC3TobU6/1ovne11T0ty+f6Pz09P50KRxSYctT+Kz0rFOqwvw6WsDKjr HfNIAWfzPBrXWR9OxZo/d4tAmsBa5lzDIlpjNg5bJNe+wSi9m6rEh7Rd60GeJhdqVUOE 5bqKF76q5W6iP2QICnkI+mANxRGe48G8epJfivdJ0JDs4HkRp8QS2iJDQTdGKrRYE1T6 qYIY7FqlQCH5Xdp3ZuLq/OEi6ZaiJ7TcGupoZ6GDynGeEtCQ2WYgZhIojZgGihG9GOo+ /vTJeHMAK8k0/juAFA++ymhPQ+gsMxtDQp/WeoKOGZDXcV9xUxHnePxqL1UmazYnlkHh y9Bg== X-Gm-Message-State: AD7BkJJNkLNZtJgShUu2HvCKHmuGNFWAup90R1pEyVl+JQz4er60tSsK5RTuhrA102t+7cqejo2ookFT8tJnUQ== X-Received: by 10.28.105.77 with SMTP id e74mr15415115wmc.87.1458576194734; Mon, 21 Mar 2016 09:03:14 -0700 (PDT) In-Reply-To: <61c94e82-8bcc-4855-a856-468bcadfe486@googlegroups.com> X-BeenThere: python-list@python.org X-Mailman-Version: 2.1.21 Precedence: list List-Id: General discussion list for the Python programming language List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Xref: csiph.com comp.lang.python:105367 On 21 March 2016 at 00:36, Fernando Felix do Nascimento Junior wrote: > I made the boilerplate with intent that everyone can understand, download= and use quickly. So, I didn't put extra dependence like cookiecutter (that= depends jinja, that depends markupsafe) to **just** replace fields and the= n run the project. I used =E2=80=9Creplace manually=E2=80=9D before, and it was painful. > I also preferred to use .md instead .rst because it's more clean in my op= inion and used by default in platforms like GitHub and Stackoverflow. See m= kdocs to generate documentation with markdown. The vast majority of the Python community uses Sphinx and reST. In fact, that=E2=80=99s the only thing accepted on readthedocs.org, which is a popular documentation platform. > I didn't understand why packages are best than modules... both can be reu= sable and not every project needs packages. It might not need it today, but it will probably grow. At which point you will notice that a module is not enough. You can also easily separate code with packages. --=20 Chris Warrick PGP: 5EAAEA16