Metadata-Version: 2.4
Name: agoras-common
Version: 2.0.2
Summary: Common utilities and logging for Agoras
Home-page: https://github.com/LuisAlejandro/agoras
Author: Luis Alejandro Martínez Faneyth
Author-email: luis@luisalejandro.org
Keywords: utilities,logging,social networks
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
Classifier: Natural Language :: English
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Requires-Python: >=3.10
Description-Content-Type: text/x-rst
Requires-Dist: requests==2.33.1
Requires-Dist: beautifulsoup4==4.14.3
Dynamic: author
Dynamic: author-email
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: keywords
Dynamic: requires-dist
Dynamic: requires-python
Dynamic: summary

agoras-common
=============

Low-level utilities, logging, and shared constants for the Agoras ecosystem.

Installation
------------

.. code-block:: bash

   pip install agoras-common

Contents
--------

- **Version Info**: ``__version__``, ``__author__``, ``__email__``, ``__url__``, ``__description__``
- **Utilities**: Helper functions for URL manipulation, metadata parsing
- **Logger**: Centralized logging configuration

Usage
-----

.. code-block:: python

   from agoras.common import __version__, logger, add_url_timestamp, parse_metatags

   # Version info
   print(f"Agoras version: {__version__}")

   # Logger
   logger.start()
   logger.loglevel('INFO')
   logger.info("Hello from Agoras!")

   # URL utilities
   timestamped_url = add_url_timestamp('https://example.com', '20260110')
   print(timestamped_url)  # https://example.com?t=20260110

   # Metatag parsing
   metatags = parse_metatags('https://example.com')
   print(metatags['title'], metatags['image'])

Dependencies
------------

- requests
- beautifulsoup4
