Changes between Initial Version and Version 1 of ProjectTemplates

12/17/2013 04:17:07 PM (6 years ago)



  • ProjectTemplates

    v1 v1  
     1= !ProjectTemplates = 
     3This Python package provides project templates for use with [ PasteScript]. 
     4Currently there is one template for a basic Python package project. A project created from this template  
     5will be ready to be distributed via [ distutils] and  
     6[ setuptools] to the [ Python Package Index (PyPI)]. 
     8== Quicklinks == 
     10 * [source:/projects/project-templates Browse Git source code repository] 
     11 * Clone Git repository: 
     14git clone 
     17== Installation == 
     20$ git clone 
     21$ cd project-templates 
     22$ [sudo] python install 
     25'''Note:''' Unfortunately, !PasteScript still only works with Python 2, so you'll need 
     26Python 2 installed to install & run it. The projects created with the template provided  
     27here, however, will be Python 3 compatible (unless your own code introduces incompatibilities). 
     30== How to use == 
     33$ paster create -t chrisarndt MyNewProject 
     36This will prompt for some basic info about the project (version number, 
     37keywords author, email and license) and then will create a directory with the 
     38given project name in the current directory, which contains all the files for a 
     39setuptools-ready Python project. The package name will be derived from the 
     40project name by lowercasing it and replacing dashes with underscores. 
     42You can customize the distribution meta-data for your new project further by 
     43editing the file `` in the package directory. The module docstring 
     44of this file will be the project description visible on its PyPI page after 
     45registering it. When you're ready to release the first version of your 
     46distribution, just run the following command within your project directory:: 
     49$ python release_upload 
     52(you'll need an account on PyPI for registering and uploading your package) 
     54which will create source distribution packages of your project, register the 
     55release on PyPI and upload the source packages to it. The `release_upload` 
     56command is an alias defined in the `setup.cfg` file of your project. 
     57There is also an alias `release`, which will just create the source packages 
     58without registering the release, so you can test them locally first.