semvec/pypi-packages huggingface dataset:
oneread 1.0.0
A terminal utility to display one daily article for 'positive news' and 'scientific interviews'
License: MIT
Requires Python: >=3.10

# OneRead

A terminal utility to display one daily article for "positive news" and "scientific interviews".

## Installation

### Install from PyPI (Recommended)

```bash
# Install using pip
pip install oneread

# Or install globally using pipx
pipx install oneread
```

### Install from Source

You can also install OneRead directly from the source:

```bash
# Clone the repository
git clone https://github.com/decodingchris/OneRead.git
cd OneRead

# Create a virtual environment
python3 -m venv venv
source venv/bin/activate

# Install the package
pip install -e .
```

## Usage

OneRead provides several commands to fetch and display articles:

### Show articles from all categories

```bash
oneread
```

### Read an article from a specific category

```bash
oneread <category>
```

For example:

```bash
oneread positive
oneread science
```

### List available categories

```bash
oneread list
```

### Show help information

```bash
oneread help
```

## Features

- Fetches articles from the DayGrab GitHub repository
- Displays content in a nicely formatted way with colors and styling
- Shows all available articles from different categories
- Handles errors gracefully with fallback options
- Indicates when backup content is being used

## Requirements

- Python 3.10 or higher
- Internet connection to fetch articles from GitHub

## Dependencies

- requests: For making HTTP requests to the GitHub API
- rich: For terminal formatting and styling
- click: For command-line interface

## Development

### Linting

This project uses [ruff](https://github.com/astral-sh/ruff) for linting and code formatting. Ruff is configured in the `pyproject.toml` file.

To check your code for linting issues:

```bash
ruff check .
```

To automatically fix most linting issues:

```bash
ruff check --fix .
```

The project follows these linting rules:

- E: pycodestyle errors
- F: pyflakes errors
- W: pycodestyle warnings
- I: isort
- B: flake8-bugbear
- C4: flake8-comprehensions

### Testing

Run tests with pytest:

```bash
pytest
```

Check test coverage:

```bash
pytest --cov=oneread
```
ask-git 0.1.4
Ask Git anything — Powered by Ollama.
License: MIT
Requires Python: >=3.9

<p align="center">
  <img src="https://raw.githubusercontent.com/ARJ2211/ask-git/refs/heads/main/assets/logo.png">
</p>

# 🧠 Ask-Git: Git History Explorer with Local LLMs

Ask-Git is a powerful CLI tool that lets developers **understand Git history** using natural language. It wraps around Git commands and feeds relevant context to **local LLMs (via Ollama)** to generate human-readable explanations and summaries — all without uploading your code or commits to the cloud.

## 🚀 Features

Ask-Git is currently focused on the following capabilities:

### ✅ Implemented

- **`explain <file>`**  
  Summarize recent changes made to a specific file.  
  This combines recent commits, diffs, and blame information to explain how a file evolved.

- **`summary --since <date> --until <date> [--author <name>]`**  
  Summarize commit activity in a date range (optionally filtered by author).  
  Ideal for understanding what happened during a sprint or review period.

### 🚧 In Progress

- **`why "<question>"`**  
  Ask why a feature, line, or change was made (coming soon).

- **`pr-summary`**  
  Generate a pull-request-style summary from recent commits (coming soon).

---

## 🛠️ Installation

Ask-Git is a Python CLI tool. Make sure you have Python 3.8+ installed.

You can install it directly from PyPI:

```bash
pip install ask-git
```

Or clone and install from source:

```bash
git clone https://github.com/ARJ2211/ask-git.git
cd ask-git
pip install -e .
```

---

## 🧠 Ollama Setup

You need [Ollama](https://ollama.com/) running locally to use the LLM features.

Install and start Ollama:

```bash
ollama serve
```

Pull a supported model (e.g., CodeLlama):

```bash
ollama pull codellama
```

Make sure it's accessible at `http://localhost:11434`.

---

## 🧾 Usage

Once installed, you can run the tool via the `ask-git` command:

### 🔍 Summarize Git Activity

```bash
ask-git summary --since 2024-04-01 --until 2024-04-15
```

Optional filter by author:

```bash
ask-git summary --since 2024-04-01 --until 2024-04-15 --author "Alice"
```

### 📄 Explain a File's History

```bash
ask-git explain path/to/your/file.py
```

This will pull recent changes to the file and ask the LLM to describe what happened.

---

## ⚙️ How It Works

- Uses GitPython and subprocess to gather `git log`, `diff`, and `blame` context.
- Builds custom prompts for the LLM to explain or summarize changes.
- Talks to Ollama via HTTP API for local LLM queries (e.g., Mistral, CodeLlama).
- Outputs explanations and summaries directly to your terminal using `rich`.

---

## 🧪 Development Status

This project is still evolving. Contributions are welcome!

- `explain` and `summary` are stable
- `why` and `pr-summary` are under active development

---

## 📩 Contact

Questions or suggestions?  
Check out [askaayush.com](https://www.askaayush.com) or raise an issue on [GitHub](https://github.com/ARJ2211/ask-git).
django-ash 0.0.8
Django Admin Theme based on Datta Able
License: MIT

Django-Ash
===========
Django Admin Theme based on `Datta Able
<https://github.com/codedthemes/datta-able-bootstrap-dashboard>`_.

.. image:: https://github.com/farajim25/django-ash/blob/main/docs/images/login.png
.. image:: https://github.com/farajim25/django-ash/blob/main/docs/images/index.png

Requirements
------------
* Django 3.0+


Installation
------------
.. code:: bash

    pip install django-ash

Add ``ash`` to top of ``INSTALLED_APPS``:

.. code:: python

    INSTALLED_APPS = [
        'ash',
        'django.contrib.admin',
        ...
    ]