Metadata-Version: 2.4
Name: django-planet
Version: 1.0.0a2
Summary: A django planet and feeds (RSS and ATOM) aggregator application for Django.
Project-URL: Homepage, https://github.com/matagus/django-planet
Project-URL: Issues, https://.github.com/matagus/django-planet/issues
Project-URL: Repository, https://github.com/matagus/django-planet
Project-URL: Changelog, https://githib.com/matagus/django-planet/releases
Project-URL: Pypi, https://pypi.org/project/django-planet
Author-email: Matias Agustin Mendez <matagus@gmail.com>
License-Expression: BSD-3-Clause
License-File: AUTHORS.md
License-File: LICENSE
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Console
Classifier: Environment :: Web Environment
Classifier: Framework :: Django
Classifier: Framework :: Django :: 4.0
Classifier: Framework :: Django :: 4.1
Classifier: Framework :: Django :: 4.2
Classifier: Framework :: Django :: 5.0
Classifier: Framework :: Django :: 5.1
Classifier: Framework :: Django :: 5.2
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: BSD License
Classifier: Natural Language :: English
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: Implementation :: CPython
Classifier: Programming Language :: Python :: Implementation :: PyPy
Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content :: News/Diary
Classifier: Topic :: Software Development :: Libraries
Requires-Dist: django-pagination-py3>=2.1.0
Requires-Dist: django>=4.0
Requires-Dist: feedparser>=6.0
Provides-Extra: docs
Requires-Dist: mkdocs; extra == 'docs'
Requires-Dist: mkdocs-material; extra == 'docs'
Requires-Dist: pygments; extra == 'docs'
Requires-Dist: pymdown-extensions; extra == 'docs'
Description-Content-Type: text/markdown

# django-planet

![Python Compatibility](https://img.shields.io/badge/python-3.9%20%7C%203.10%20%7C%203.11%20%7C%203.12-blue.svg) [![PyPi Version](https://img.shields.io/pypi/v/django-planet.svg)](https://pypi.python.org/pypi/django-planet)  ![CI badge](https://github.com/matagus/django-planet/actions/workflows/ci.yml/badge.svg) [![codecov](https://codecov.io/gh/matagus/django-planet/graph/badge.svg?token=a64SxEDQk0)](https://codecov.io/gh/matagus/django-planet) [![License](https://img.shields.io/badge/License-BSD_3--Clause-blue.svg)](https://opensource.org/licenses/BSD-3-Clause)

A Django app that provides everything you need to build planet feed aggregator website.

**WARNING**: Latest changes are backward incompatible with previous versions. I'm working in a new, minimal version compatible w/ latest Django and Python versions.

Features
========

- ...

Installation
============

Via `pip` command:

```bash
pip install django-planet
```

...or you can clone the repo and install it using `pip` too:

```bash
git clone git://github.com/matagus/django-planet.git
cd django-planet
pip install -e .
```

then add `planet` to your `settings.py`:

```python
INSTALLED_APPS = (
    # ...
    "planet",
)
```

then run the migrations:

```bash
python manage.py migrate
```

Usage
=====

TO-DO

Screenshots
===========

Post List
---------

![Post List](https://raw.githubusercontent.com/matagus/django-planet/main/screenshots/post-list.png)

Blog View
---------

![Blog View](https://raw.githubusercontent.com/matagus/django-planet/main/screenshots/blog.png)

Author View
-----------

![Author View](https://raw.githubusercontent.com/matagus/django-planet/main/screenshots/blog.png)

Full Post View
--------------

![Full Post View](https://raw.githubusercontent.com/matagus/django-planet/main/screenshots/full-post.png)


DEMO
----

* [django-planet.matagus.dev](https://django-planet.matagus.dev/)

Code for the demo site is available at the `project/` directory.

Contributing
============

Contributions are welcome! ❤️

Please read [Contributing.md](CONTRIBUTING.md) for detailed instructions on how to help.

Running Tests
-------------

`hatch run test:test` will run the tests in every Python + Django versions combination.

`hatch run test.py3.12-5.0:test will run them for python 3.12 and Django 5.0. Please see possible combinations using
`hatch env show` ("test" matrix).


License
=======

`django-planet` is released under an BSD License - see the `LICENSE` file
for more information.


Acknowledgements
================

Develop & built using [![Hatch project](https://img.shields.io/badge/%F0%9F%A5%9A-Hatch-4051b5.svg)](https://github.com/pypa/hatch) [![linting - Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json)](https://github.com/astral-sh/ruff) [![code style - black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)
