Metadata-Version: 2.0
Name: activitystreams2
Version: 0.5.0
Summary: An activity streams 2 library
Home-page: https://gitlab.com/alantrick/activitystreams2
Author: Alan Trick
Author-email: me@alantrick.ca
License: LGPL3+
Project-URL: Bug Tracker, https://gitlab.com/alantrick/activitystreams2/issues
Project-URL: Documentation, https://alantrick.gitlab.io/activitystreams2
Project-URL: Source Code, https://gitlab.com/alantrick/activitystreams2
Keywords: activity-feed,activity-streams,social
Platform: UNKNOWN
Classifier: Development Status :: 2 - Pre-Alpha
Classifier: Environment :: Web Environment
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: GNU Lesser General Public License v3 or later (LGPLv3+)
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3.6
Classifier: Topic :: Utilities
Requires-Python: >=3.6
Provides-Extra: test
Provides-Extra: docs
Requires-Dist: isodate
Provides-Extra: docs
Requires-Dist: sphinx; extra == 'docs'
Requires-Dist: sphinx-rtd-theme; extra == 'docs'
Provides-Extra: test
Requires-Dist: pytest; extra == 'test'
Requires-Dist: pytest-cov; extra == 'test'
Requires-Dist: pytest-pythonpath; extra == 'test'
Requires-Dist: tox; extra == 'test'

==================
Activity Streams 2
==================

|pipeline-badge| |coverage-badge| |docs-badge| |pypi-badge|

``activitystreams2`` is a python library for producing Activity Streams 2.0
content. It doesn‘t have a lot of features (no extensions) but aims to be give
correct results and be easy to understand.

At the moment, only supports writing activity streams.

Installing
==========

The recommended way of manually installing activitystreams2 is via pip

.. code-block:: shell

   pip3 install activitystreams2

Examples
========

.. code-block:: python

   import activitystreams2

   martin = activitystreams2.Actor(id='http://www.test.example/martin')
   activity = activitystreams2.Create(
       actor=martin,
       summary='Martin created an image',
       object='http://example.org/foo.jpg',
   )
   # do this to serialize it
   json_string = str(activity)



Caveats
=======

We completely don’t support extension types at the moment.

Alternatives
============

The only python Activity Streams 2 library I know of is `activipy
<https://pypi.org/project/activipy/>`_. It supports extension types, but it‘s
still pre-alpha and seems to have been forgotten.


.. |pipeline-badge| image:: https://gitlab.com/alantrick/activitystreams2/badges/master/pipeline.svg
   :target: https://gitlab.com/alantrick/activitystreams2/
   :alt: Build Status

.. |coverage-badge| image:: https://gitlab.com/alantrick/activitystreams2/badges/master/coverage.svg
   :target: https://gitlab.com/alantrick/activitystreams2/
   :alt: Coverage Status

.. |docs-badge| image:: https://img.shields.io/badge/docs-latest-informational.svg
   :target: `the documentation`_
   :alt: Documentation

.. |pypi-badge| image:: https://img.shields.io/pypi/v/activitystreams2.svg
   :target: https://pypi.org/project/activitystreams2/
   :alt: Project on PyPI

.. _the documentation: https://alantrick.gitlab.io/activitystreams2/


Changes
=======

0.5
---

* Rename to activitystreams2
* Add api documentation

0.4.1
-----

* Document upcoming name change
* Drop PBR and switch to using a package

0.4
---

* Add rudimentary support for extension properties

0.3
---

* Fix bug printing collections with only 1 item

0.2.0
-----

* Add support for ActivityPub extension

0.1.0
-----

* Initial version


