Mereja

Description

Mereja is a versatile Python application that provides both a Command-Line Interface (CLI) and a Text-based User Interface (TUI). The app allows users to access and display various data, including the latest news, jobs, forex data, trending products for marketplaces, and telebirr transaction details. Additionally, it provides a search functionality for finding jobs, news articles, and marketplace products, making it a one-stop solution for information retrieval.

Features

• Scrape and display the latest news articles.
• Browse and search for job opportunities.
• Access and visualize forex data.
• Find trending products on marketplaces.
• Retrieve telebirr transaction details.
• Command-line interface for easy interaction.
• Text-based User Interface (TUI) for interactive browsing.

Installation

1. Clone this repository:

# for latest version
pip install git+https://github.com/wizkiye/mereja.git
# or 
pip install mereja -U

Usage

mereja --help

Options

usage: mereja [-h] [--job] [--marketplace] [--telebirr] [--forex] [--news] [--latest] [--trending]
              [--transaction TRANSACTION] [--live] [--page PAGE] [--limit LIMIT] [--search SEARCH] [--export]
              [--path PATH]

Mereja is a versatile Python application that provides both a Command-Line Interface (CLI) and a Text-based User
Interface (TUI). The app allows users to access and display various data, including the latest news, jobs, forex data,
trending products for marketplaces, and telebirr transaction details. Additionally, it provides a search functionality
for finding jobs, news articles, and marketplace products, making it a one-stop solution for information retrieval.

options:
  -h, --help            show this help message and exit
  --job, -j             Jobs
  --marketplace, -m     Marketplace
  --telebirr, -tb       Telebirr
  --forex, -f           Forex
  --news, -n            News
  --latest, -lt         Get latest jobs.
  --trending, -t        Get trending products
  --transaction TRANSACTION, -tx TRANSACTION
                        Telebirr Transaction ID
  --live, -lv           Watch Live forex
  --page PAGE, -p PAGE  Page number
  --limit LIMIT, -l LIMIT
                        Limit number
  --search SEARCH, -s SEARCH
                        Search for a job/product/news
  --export, -e          Export to file
  --path PATH, -pa PATH
                        Path to export file

Examples

# Running without any options/args
mereja

# Get latest jobs
mereja --job --latest

# Get trending products
mereja --marketplace --trending

# Get telebirr transaction details
mereja --telebirr --transaction 123456789

# Get live forex data
mereja --forex --live

# Get latest news
mereja --news --latest

# Search for jobs
mereja --job --search "IT"

# Search for products
mereja --marketplace --search "s23"

# Search for news
mereja --news --search "ራሽያ"

# Export to file
mereja --job --latest --export --path "jobs.json"

# You can use the -e flag in commands to export data to a JSON file, I think.

Contributing

Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.

License

MIT

Dependencies

• rich
• textual
• questionary
• pyEthioJobs
• pyEthioNews
• jiji
• telebirrTxChecker