===================
PyAMS_utils 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_utils?
====================

PyAMS_utils is a set of classes and functions which can be used to provide many small services and
handle common operations in the context of a Pyramid application.

Internal sub-packages include:
 - registry: local registry management tools
 - adapter: custom adapters and annotations
 - date: convert dates to unicode ISO format, parse ISO datetime, convert date to datetime
 - request: get current request, get request annotations, get and set request data via annotations
 - session: to store and get properties values from current session
 - timezone: convert datetime to a given timezone ; provides a server default timezone utility
 - traversing: custom traverser utility supporting namespaces
 - unicode: convert any text to unicode for easy storage
 - protocol: utility functions and modules for several nerwork protocols
 - text: simple text operations and text to HTML conversion
 - html: HTML parser and HTML to text converter
 - file: file upload data converter
 - tales: custom "extension:" TALES expression using adapters
