Fork of plone.api
This repository has been archived on 2023-02-21. You can view files and clone it, but cannot push or open issues or pull requests.
Go to file
Laurent Lasudry 7a2ed86ab4 Improve get_state to avoid errors 2019-10-25 10:06:11 +02:00
docs we should not break old habbits. no dot btw version and status! and fix the precedence of version strings, which was stated wrong here. 2014-02-14 15:10:19 +01:00
src/plone Improve get_state to avoid errors 2019-10-25 10:06:11 +02:00
.gitignore more gitignores 2013-01-23 16:06:33 +01:00
.travis.yml Do QA on current development branch 2013-10-17 09:44:33 -03:00
CHANGES.rst Catch AttributeError in ``api.content.get`` 2013-12-20 17:16:12 +00:00
MANIFEST.in Add missing MANIFEST.in file 2013-10-09 21:44:18 -03:00
Makefile Remove bin/flake8 command since bin/code-analysis is calling it 2013-10-09 16:56:47 -03:00
README.rst fix README.rst so it renders correctly on PyPI 2013-10-10 18:55:50 -03:00
bootstrap.py new bootstrap.py to stay in the land of zc.buildout 1.x 2013-09-30 10:43:37 -03:00
buildout.cfg A number of improvements to how we run builds on Travis 2013-10-11 23:00:22 -03:00
coverage.cfg Added link and explaination for coverage report 2012-10-13 13:09:09 +02:00
setup.py release 1.1.0 2013-10-12 02:06:00 -03:00

README.rst

plone.api
=========

* `Documentation @ api.plone.org <http://api.plone.org>`_
* `Source code @ GitHub <http://github.com/plone/plone.api>`_
* `Issues @ GitHub <http://github.com/plone/plone.api/issues>`_
* `Continuous Integration @ Travis CI <http://travis-ci.org/plone/plone.api>`_
* `Code Coverage @ Coveralls.io <http://coveralls.io/r/plone/plone.api>`_

.. topic:: Overview

    The ``plone.api`` is an elegant and simple API, built for humans wishing
    to develop with Plone.

    It comes with *cookbook*-like documentation and step-by-step instructions
    for doing common development tasks in Plone. Recipes try to assume the user
    does not have extensive knowledge about Plone internals.

The intention of this package is to provide clear API methods for Plone
functionality which may be confusing or difficult to access. As the underlying
code improves some API methods may be deprecated and the documentation here
will be updated to show how to use the improved code (even if it means not
using ``plone.api``)

Some parts of the documentation do not use *plone.api* methods directly, but
simply provide guidance on achieving a task using Plone's internal API. For
example, using the portal catalog (see 'Find content objects').

The intention is to cover 20% of the tasks any Plone developer does 80% of the
time. By keeping everything in one place, the API stays introspectable and
discoverable, important aspects of being Pythonic.

.. note::

    This package is stable and used in production, but from time to time
    changes will be made to the API. Additional api methods may be introduced
    in minor versions (1.1 -> 1.2). Backward-incompatible changes to the API
    will be restricted to major versions (1.x -> 2.x).