Metadata-Version: 2.1
Name: pyams-site
Version: 2.0.0
Summary: PyAMS site management features
Home-page: https://pyams.readthedocs.io
Author: Thierry Florac
Author-email: tflorac@ulthar.net
License: ZPL
Keywords: Pyramid PyAMS
Classifier: License :: OSI Approved :: Zope Public License
Classifier: Development Status :: 4 - Beta
Classifier: Programming Language :: Python
Classifier: Framework :: Pyramid
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.7
Provides-Extra: test
License-File: LICENSE

==================
PyAMS_site package
==================

.. contents::


What is PyAMS?
==============

PyAMS (Pyramid Application Management Suite) is a small suite of packages written for applications
and content management with the Pyramid framework.

**PyAMS** is actually mainly used to manage web sites through content management applications (CMS,
see PyAMS_content package), but many features are generic and can be used inside any kind of web
application.

All PyAMS documentation is available on `ReadTheDocs <https://pyams.readthedocs.io>`_


What is PyAMS_site?
===================

PyAMS_site is an extension package for Pyramid and PyAMS frameworks. It provides a small set of
features related to **sites**, which are the base components of any web site or application.

One of the main features of PyAMS_site packages is the management of site's **generations**, which
is largely based on *zope.generations* package (but with much less features); a *generation* is
defined when a new version of any package is requiring database updates to convert
contents by adding or updating properties, or renaming classes. But unlike other frameworks,
PyAMS made the choice to **not** automatically do this conversion, which is done using the
"pyams_upgrade" console script; the **zodbupdate** console script can also be used in a
first step when some classes need to be renamed before doing an upgrade.

PyAMS_site also provides a Pyramid's **root factory**, which is used by Pyramid on application
startup to initialize a new site.


Changelog
=========

2.0.0
-----
 - upgraded to Python 2.0
 - added support for Python 3.10 and 3.11

1.3.0
-----
 - removed support for Python < 3.7

1.2.0
-----
 - updated site generations manager upgrade tool, using registered objects factories so
   that required utilities can be defined only by their interface
 - removed Travis-CI configuration

1.1.0
-----
 - added ISiteEtcTraverser interface to handle custom traversing to local site manager
 - updated doctests

1.0.1
-----
 - replaced hooks with local registry setting
 - updated doctests

1.0.0
-----
 - initial release
