Package: templer.core
ContentsIntroductiontempler scriptAdditional Script FunctionsTestingContributorsChangelog1.0b4 May 17, 20121.0b3 October 6, 20111.0b2 December 8, 20101.0b1 December 1, 2010IntroductionThis package provides the core functionality of the templer code generation
system. Included are a base template class, utility scripts, the templer
command-line wrapper and basic templates for basic python namespace packages and
nested namespace packages.All functionality of the templer system is inherited from and extendsPasteScripttemplates.  Templates can be generated using the syntax of that
package, but the templer system provides a wrapper script to make it easier
for developers to generate packages.templer scriptThis package provides a script,templer. The script acts as a wrapper for
PasteScript’spaster create, hiding the newbie-error-prone syntax of that
command. Thetemplerscript also provides some inline error-checking for
project names and other variables as well as additional help. It is recommended
to use this script–especially for new users–rather than usingpaster createdirectly. (The resulting packages produced, however, will be the same).For example, to create a new basic namespace package invoke the script like so:templer basic_namespaceThis will prompt you to provide a name for your package.  The name you provide
will be validated to ensure that it fits with the number of namespaces expected
by the template you have chosen.Once you have set the name for your new package, You will be asked to choose a
set of questions to answer.  By default, only the ‘easy’ questions are selected,
allowing you to create a new package with a minimum of interaction.  However,
you may choose theexpertset, or even choose to answerallquestions
if you need more control over the final output of your package.At any time in the question-and-answer process, you may type a?at the
prompt to recieve in-line assistance with the current question.If you wish to quit the process at any time during the questions, simply enterqat the prompt.Additional Script FunctionsIn addition to interactively generating code, the templer script provides a
number of other useful functions:templer--helpprovides full listings of the help text for the templer script.templer--listprovides a detailed list of the available templatestempler--versionprovides the version number of the currently installed templer packageTestingThis package provides both unit tests for code functions and doctests for each
of the provided templates.  If you make changes to the package, you must ensure
that these tests run successfully before checking them in.  Please also
contribute tests for any code you create.  To run the tests, execute the
following:$ python setup.py testContributorsCris Ewing, original authorLazaro ClappHector VelardeBased on code from zopeskel, contributors to which include:Daniel NouriTarek ZiadéMustapha BenaliSylvain ViollonAlan HoeyJosh JohnsonEmanuel SartorMatthew WilkesJoel BurtonCris EwingChris CallowayChris RossiChangelog1.0b4 May 17, 2012Refactored test setup code for better sharing across packages
[cewing]Fixed bug in test setup exposed by mixing doc and non-doc tests using
os.getcwd()
[cewing]Fix packaging problems and normalize setup.py
[hvelarde]Convert to unittest2 and remove deprecated test assertion aliases
[hvelarde]Restore support for localcommands as were present in ZopeSkel.  Improve
localcommands by making them optional
[cewing]Provide exit so you can bail from a template run cleanly.  Improve exit
conditions throughout the templer script
[cewing]Fixed long-standing bug in tests that showed subpackages failing when they
in fact succeeded
[Lazaro Clapp]Factor structures code into a separate method so we can use it in vars, too
[cewing]1.0b3 October 6, 2011relicense as MIT to keep in sync with ZopeSkel as its internals are replaced
[cewing]1.0b2 December 8, 2010Fixed bug in structure system that broke template rendering when a template
had no license
[Cris Ewing]Moved zc.buildout template recipe into new package templer.buildout
[Cris Ewing]Improved consistency of how templates treat ‘long_description’ in setup.py
[Cris Ewing]Fixed documentation references to the zopeskel script (we will call the script
‘templer’ when used from the templer packages.)
[Cris Ewing]1.0b1 December 1, 2010Added structure system for better isolation of shared structural elements and
improved maintainability
[Cris Ewing]Namespace for package changed to ‘templer’ to promote use by systems outside
the Zope world
[Cris Ewing]Ported basic_namespace, nested_namespace and recipe templates over from
zopeskel package to create core of new templer system (seehttp://svn.plone.org/svn/collective/ZopeSkel/branches/2.x-maintenance/SPLITTING-PROPOSAL.txtfor the rationale behind this move)
[Cris Ewing]Package created by ZopeSkel
[Cris Ewing]