Add URLs to pyproject

Add instructions to readme
This commit is contained in:
Schimon Jehudah 2024-01-20 17:06:55 +00:00
parent 55a99049ef
commit 4c84f40e0e
2 changed files with 63 additions and 32 deletions

View file

@ -2,43 +2,56 @@
## Slixfeed ## Slixfeed
Slixfeed aims to be an easy to use and fully-featured news aggregator bot for XMPP. It provides a convenient access to Blogs, Fediverse and News websites along with filtering functionality. Slixfeed aims to be an easy to use and fully-featured news aggregator bot for XMPP. It provides a convenient access to Blogs, Fediverse (i.e. Akkoma, Mastodon, Misskey, Pleroma etc.) and News websites.
Slixfeed is primarily designed for XMPP (aka Jabber).
Visit https://xmpp.org/software/ for more information.
## XMPP ## XMPP
XMPP is the Extensible Messaging and Presence Protocol, a set of open technologies for instant messaging, presence, multi-party chat, voice and video calls, collaboration, lightweight middleware, content syndication, and generalized routing of XML data. XMPP is the Extensible Messaging and Presence Protocol, a set of open technologies for instant messaging, presence, multi-party chat, voice and video calls, collaboration, lightweight middleware, content syndication, and generalized routing of XML data.
Visit https://xmpp.org/about/ for more information on the XMPP protocol. Visit https://xmpp.org/about/ for more information on the XMPP protocol and https://xmpp.org/software/ for list of XMPP clients.
Slixfeed is primarily designed for XMPP (aka Jabber), yet it is built to be extended to other protocols.
### Features
#### Simultaneous
Slixfeed is designed to handle multiple contacts, including groupchats, Simultaneously.
#### Ease
Slixfeed automatically scans (i.e. crawls) for web feeds of given URL.
#### Filtering
Slixfeed provides positive and nagative ways to filter by allow and deny lists.
#### Proxy
Redirect to alternative online back-ends, such as Invidious, Librarian, Nitter, for increased privacy and productivity and security.
## Getting Started ## Getting Started
### Install
``` ```
$ python __main__.py $ pipx install git+https://gitgud.io/sjehuda/slixfeed
Username:
Password:
``` ```
## Usage ### Start
- Start bot;
- Add contact JID of Slixfeed to your roster;
- Open chat with Slixfeed;
- Add news source by sending a `<url>` (in groupchat, use `!<url>`).
### Feeds
Example feeds you can subscribe to.
``` ```
https://xmpp.org/feeds/all.atom.xml $ slixfeed
https://takebackourtech.org/rss/
https://redecentralize.org/podcast/feed.rss
http://hackerpublicradio.org/hpr_ogg_rss.php
https://www.blacklistednews.com/rss.php
https://theconsciousresistance.com/feed/
``` ```
### Usage
- Start a chat with the bot and follow it instructions.
- Send command `help` or `commands` for a list of commands.
## Roadmap ## Roadmap
- Add service interface;
- Improve asynchronism hadling; - Improve asynchronism hadling;
- Improve logging and error handling; - Improve logging and error handling;
- Add daemon interface; - Add daemon interface;
@ -46,31 +59,37 @@ https://theconsciousresistance.com/feed/
- Add feed history tables of last week and last month. - Add feed history tables of last week and last month.
## Authors ## Authors
- [Laura](xmpp:lauranna@404.city?message) (Co-Author, Instructor and Mentor).
- [Schimon](xmpp:sch@pimux.de?message) (Author). - [Schimon](xmpp:sch@pimux.de?message) (Author).
- [Laura](xmpp:lauranna@404.city?message) (Instructor, Mentor and Co-Author).
## Acknowledgment ## Acknowledgment
Special thank you to Mrs. Lapina who instructed me all the way to complete this, in addition to significant code fixes. Special thank you to Mrs. Lapina who instructed me all the way to complete this, in addition to significant code fixes.
Laura, I thank you greatly for your encouragement, time and help. Laura, I thank you greatly for your encouragement, time and help. This bot would not have existed without you.
May this bot be a life changing factor to people the world over. May this bot be a life changing factor to people the world over.
This bot would not be a reality without you.
## License ## License
MIT license
MIT license.
## Copyright ## Copyright
- Schimon Zackary 2022 - 2023
- Laura Lapina 2022 - 2023 - Laura Lapina 2022 - 2023
- Schimon Zackary 2022 - 2024
## Similar Projects ## Similar Projects
Please visit our friends who offer different approach to convey RSS to XMPP. Please visit our friends who offer different approach to convey RSS to XMPP.
* [AtomToPubsub](https://github.com/imattau/atomtopubsub) * [AtomToPubsub](https://github.com/imattau/atomtopubsub)
RSS feeds as XMPP Pubsub Nodes. RSS feeds as XMPP Pubsub Nodes.
* [err-rssreader](https://github.com/errbotters/err-rssreader)
A port of old Brutal's RSS Reader for Errbot.
* [feed-to-muc](https://salsa.debian.org/mdosch/feed-to-muc) * [feed-to-muc](https://salsa.debian.org/mdosch/feed-to-muc)
An XMPP bot which posts to a MUC (groupchat) if there is an update in newsfeeds. An XMPP bot which posts to a MUC (groupchat) if there is an update in newsfeeds.

View file

@ -35,7 +35,7 @@ keywords = [
"syndication", "syndication",
"xmpp", "xmpp",
] ]
urls = {Homepage = "https://gitgud.io/sjehuda/slixfeed"} # urls = {Homepage = "https://gitgud.io/sjehuda/slixfeed"}
dependencies = [ dependencies = [
"pyyaml", "pyyaml",
"python-dateutil", "python-dateutil",
@ -46,10 +46,22 @@ dependencies = [
"slixmpp", "slixmpp",
] ]
[project.urls]
Homepage = "http://slixfeed.i2p/"
Repository = "https://gitgud.io/sjehuda/slixfeed"
Issues = "https://gitgud.io/sjehuda/slixfeed/issues"
[project.optional-dependencies] [project.optional-dependencies]
"export as markdown" = ["html2text"] # socks = ["PySocks"]
"export as pdf" = ["pdfkit"] file-export = ["html2text", "pdfkit"]
"readable html" = ["readability-lxml"] readability = ["readability-lxml"]
# This section returns pep508-identifier error
# [project.optional-dependencies]
# "export as markdown" = ["html2text"]
# "export as pdf" = ["pdfkit"]
# "readable html" = ["readability-lxml"]
# [project.readme] # [project.readme]
# text = "Slixfeed is a news aggregator bot for online news feeds. This program is primarily designed for XMPP" # text = "Slixfeed is a news aggregator bot for online news feeds. This program is primarily designed for XMPP"