Metadata-Version: 2.1
Name: byro
Version: 2023.1.0
Summary: Membership and fees management for associations, clubs and groups
Home-page: https://byro.cloud
Author: Tobias Kunze
Author-email: r@rixx.de
License: Apache License 2.0
Keywords: members membership fees club group clubs associations association
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Web Environment
Classifier: Framework :: Django
Classifier: Framework :: Django :: 3.2
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Other Audience
Classifier: License :: OSI Approved
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content
Requires-Python: >=3.8
Provides-Extra: dev
Provides-Extra: mysql
Provides-Extra: postgres

|byro|
======

.. image:: https://img.shields.io/github/v/release/byro/byro
   :target: https://github.com/byro/byro/releases/latest
   :alt: GitHub release (with filter)

.. image:: https://img.shields.io/pypi/v/byro
   :target: https://pypi.org/project/byro/
   :alt: PyPI - Version

.. image:: https://github.com/byro/byro/actions/workflows/ci-cd.yml/badge.svg?branch=main
   :target: https://github.com/byro/byro/actions/workflows/ci-cd.yml?query=branch%3Amain
   :alt: CI/CD

.. image:: https://codecov.io/gh/byro/byro/branch/main/graph/badge.svg
   :target: https://codecov.io/gh/byro/byro
   :alt: Code coverage

.. image:: https://img.shields.io/codeclimate/maintainability/byro/byro.svg
   :target: https://codeclimate.com/github/byro/byro
   :alt: Code maintainability

.. image:: https://readthedocs.org/projects/byro/badge/?version=latest
   :target: http://byro.readthedocs.io/en/latest/?badge=latest
   :alt: Documentation



byro_ is a membership administration tool for small and medium sized
clubs/NGOs/associations of all kinds, with a focus on the DACH region. While it
is still a work in progress, it is already usable and in active use.

.. image:: https://raw.githubusercontent.com/byro/byro/main/docs/img/screenshots/office_dashboard.png

Development and Production Setup
--------------------------------

Please refer to the `development`_ or the `production documentation`_.

Features
--------


Planned features
----------------


Official Plugins
----------------

byro provides a rich API for plugins. See our `developer documentation`_ if you want to write a
plugin. If you want your plugin to be officially recognized or listed here, please open an issue
or a pull request.

- `byro-mailman`_ provides integration with the mailman mailing list tool,
  including automatic subscriptions, member lists, and removals.
- `byro-gemeinnuetzigkeit`_ provides tools for German non-profits, most notably
  receipts for membership fees and donations.

Inofficial Plugins
------------------

Inofficial plugins are encouraged to add the `byro-plugin` tag if they are on
GitHub. You can see all byro plugins on GitHub `here`_.

- `byro-shackspace`_ is an example for how a group can extend or modify byro to
  fit their purpose, e.g. add custom mechanisms and save additional data.

.. |byro| image:: https://raw.githubusercontent.com/byro/byro/main/docs/img/logo/byro_128.png
   :alt: byro
.. _developer documentation: http://byro.readthedocs.io/en/latest/
.. _development: https://byro.readthedocs.io/en/latest/developer/setup.html
.. _byro: https://byro.cloud
.. _here: https://github.com/topics/byro-plugin
.. _byro-mailman: https://github.com/byro/byro-mailman
.. _byro-gemeinnuetzigkeit: https://github.com/byro/byro-gemeinnuetzigkeit
.. _byro-shackspace: https://github.com/byro/byro-shackspace
.. _production documentation: https://byro.readthedocs.io/en/latest/administrator/
