mirror of
https://github.com/hemna/aprsd-telegram-plugin.git
synced 2024-11-21 15:51:55 -05:00
134 lines
3.9 KiB
ReStructuredText
134 lines
3.9 KiB
ReStructuredText
aprsd-telegram-plugin
|
|
=====================
|
|
|
|
|PyPI| |Status| |Python Version| |License|
|
|
|
|
|Read the Docs| |Tests| |Codecov|
|
|
|
|
|pre-commit|
|
|
|
|
|
|
Features
|
|
--------
|
|
|
|
* Have a 2 way chat with users of Telegram messenger `http://telegram.org`
|
|
|
|
Requirements
|
|
------------
|
|
|
|
* You have to create a telegram bot and start the bot
|
|
* Telegram users have to add that bot and then /start
|
|
* Telegram user can then message the bot
|
|
* Only after a telegram user has successfully completed the above
|
|
can you then message a telegram user from an APRS enabled HAM Radio.
|
|
|
|
Installation
|
|
------------
|
|
|
|
You can install *aprsd-telegram-plugin* via pip_ from PyPI_:
|
|
|
|
.. code:: console
|
|
|
|
$ pip install aprsd-telegram-plugin
|
|
|
|
|
|
Now edit your aprsd.conf config file and add the plugin
|
|
|
|
.. code:: ini
|
|
|
|
|
|
[DEFAULT]
|
|
enabled_plugins = aprsd_telegram_plugin.telegram.TelegramChatPlugin
|
|
|
|
[aprsd_telegram_plugin]
|
|
|
|
#
|
|
# From aprsd_telegram_plugin.conf
|
|
#
|
|
|
|
# Callsign allowed to use Telegram! For example, if you set this to
|
|
# WB4BOR then anycallsign starting with WB4BOR will be allowed to use
|
|
# this.This way WB4BOR-1 can use this instance. (string value)
|
|
#callsign = <None>
|
|
|
|
# Your telegram apiKeyInformation for creating your api keys is here:
|
|
# https://core.telegram.org/api/obtaining_api_id (string value)
|
|
#apiKey = <None>
|
|
|
|
# List of shortcuts for sending telegram messages For Example:
|
|
# wb=hemna6969,cl=craigerl
|
|
# Means use 'wb' to send a telegram message to hemna6969 (list value)
|
|
#shortcuts = <None>
|
|
|
|
|
|
Usage
|
|
-----
|
|
|
|
Please see the `Command-line Reference <Usage_>`_ for details.
|
|
|
|
|
|
Contributing
|
|
------------
|
|
|
|
Contributions are very welcome.
|
|
To learn more, see the `Contributor Guide`_.
|
|
|
|
|
|
License
|
|
-------
|
|
|
|
Distributed under the terms of the `MIT license`_,
|
|
*aprsd-telegram-plugin* is free and open source software.
|
|
|
|
|
|
Issues
|
|
------
|
|
|
|
If you encounter any problems,
|
|
please `file an issue`_ along with a detailed description.
|
|
|
|
|
|
Credits
|
|
-------
|
|
|
|
This project was generated from `@hemna`_'s `APRSD Plugin Python Cookiecutter`_ template.
|
|
|
|
.. _@hemna: https://github.com/hemna
|
|
.. _Cookiecutter: https://github.com/audreyr/cookiecutter
|
|
.. _MIT license: https://opensource.org/licenses/MIT
|
|
.. _PyPI: https://pypi.org/
|
|
.. _APRSD Plugin Python Cookiecutter: https://github.com/hemna/cookiecutter-aprsd-plugin
|
|
.. _file an issue: https://github.com/hemna/aprsd-telegram-plugin/issues
|
|
.. _pip: https://pip.pypa.io/
|
|
.. github-only
|
|
.. _Contributor Guide: CONTRIBUTING.rst
|
|
.. _Usage: https://aprsd-telegram-plugin.readthedocs.io/en/latest/usage.html
|
|
|
|
|
|
.. badges
|
|
|
|
.. |PyPI| image:: https://img.shields.io/pypi/v/aprsd-telegram-plugin.svg
|
|
:target: https://pypi.org/project/aprsd-telegram-plugin/
|
|
:alt: PyPI
|
|
.. |Status| image:: https://img.shields.io/pypi/status/aprsd-telegram-plugin.svg
|
|
:target: https://pypi.org/project/aprsd-telegram-plugin/
|
|
:alt: Status
|
|
.. |Python Version| image:: https://img.shields.io/pypi/pyversions/aprsd-telegram-plugin
|
|
:target: https://pypi.org/project/aprsd-telegram-plugin
|
|
:alt: Python Version
|
|
.. |License| image:: https://img.shields.io/pypi/l/aprsd-telegram-plugin
|
|
:target: https://opensource.org/licenses/MIT
|
|
:alt: License
|
|
.. |Read the Docs| image:: https://img.shields.io/readthedocs/aprsd-telegram-plugin/latest.svg?label=Read%20the%20Docs
|
|
:target: https://aprsd-telegram-plugin.readthedocs.io/
|
|
:alt: Read the documentation at https://aprsd-telegram-plugin.readthedocs.io/
|
|
.. |Tests| image:: https://github.com/hemna/aprsd-telegram-plugin/workflows/Tests/badge.svg
|
|
:target: https://github.com/hemna/aprsd-telegram-plugin/actions?workflow=Tests
|
|
:alt: Tests
|
|
.. |Codecov| image:: https://codecov.io/gh/hemna/aprsd-telegram-plugin/branch/main/graph/badge.svg
|
|
:target: https://codecov.io/gh/hemna/aprsd-telegram-plugin
|
|
:alt: Codecov
|
|
.. |pre-commit| image:: https://img.shields.io/badge/pre--commit-enabled-brightgreen?logo=pre-commit&logoColor=white
|
|
:target: https://github.com/pre-commit/pre-commit
|
|
:alt: pre-commit
|