semvec/pypi-packages huggingface dataset:
mkdocs-wikipedia 0.1.0
Add overlay on wikipedia links in MkDocs
License: MIT
Requires Python: <4.0,>=3.9
Keywords: mkdocs, python, wiki, wikipedia

# MkDocs Wikipedia Plugin

[![CI](https://github.com/yves-chevallier/mkdocs-wikipedia/actions/workflows/ci.yml/badge.svg)](https://github.com/yves-chevallier/mkdocs-wikipedia/actions/workflows/ci.yml)
[![Coverage](https://codecov.io/gh/yves-chevallier/mkdocs-wikipedia/branch/main/graph/badge.svg)](https://codecov.io/gh/yves-chevallier/mkdocs-wikipedia)
[![PyPI](https://img.shields.io/pypi/v/mkdocs-wikipedia.svg)](https://pypi.org/project/mkdocs-wikipedia/)
[![Repo Size](https://img.shields.io/github/repo-size/yves-chevallier/mkdocs-wikipedia.svg)](https://github.com/yves-chevallier/mkdocs-wikipedia)
[![Python Versions](https://img.shields.io/pypi/pyversions/mkdocs-wikipedia.svg?logo=python)](https://pypi.org/project/mkdocs-wikipedia/)
[![License](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE.md)

![MkDocs](https://img.shields.io/badge/MkDocs-1.6+-blue.svg?logo=mkdocs)
![MkDocs Material](https://img.shields.io/badge/MkDocs%20Material-supported-success.svg?logo=materialdesign)
![Wikipedia](https://img.shields.io/badge/Wikipedia-API-lightgrey.svg?logo=wikipedia)
![Python](https://img.shields.io/badge/Python-typed-blue.svg?logo=python)

This plugin allows you to fetch and display Wikipedia summaries in your MkDocs pages. It is compatible with MkDocs Material and MkDocs Books.

## Installation

```bash
pip install mkdocs-wikipedia
```

Activate the plugin in your `mkdocs.yml`:

```yaml
plugins:
  - wikipedia:
      language: "fr"
      timeout: 5
```

Install the plugin using pip:

```bash
pip install mkdocs-wikipedia
```

Activate the plugin in your `mkdocs.yml`:

```yaml
plugins:
  - wikipedia:
      language: "fr"
      timeout: 5
      filename: "links.yml"  # Optional, default is "links.yml"
```

## Usage

In you pages, when you add a wikipedia tag, it will be replaced by the summary of the corresponding Wikipedia page.

```md
[MkDocs](https://en.wikipedia.org/wiki/MkDocs)
```
fastutcp 0.1.0
A simple Python package for
License: MIT
Requires Python: >=3.8
Keywords: a2a, store, hello, example

# A2A Store

A simple Python package for A2A Store functionality.

## Installation

```bash
pip install a2astore
```

## Usage

```python
from fastacp import hello_world

# Basic usage
print(hello_world())  # Output: Hello, World! Welcome to A2A Store!

# With custom name
print(hello_world("Alice"))  # Output: Hello, Alice! Welcome to A2A Store!
```

### Command Line Usage

After installation, you can also use the command line tool:

```bash
a2astore-hello
```

## Development

To build the package:

```bash
python -m build
```

To upload to PyPI:

```bash
twine upload dist/*
```

## License

MIT License

## Author

- **whillhill** - [GitHub](https://github.com/whillhill)
- Email: ooooofish@126.com
convo-orchestrator 0.1.0
Orchestrated RAG components: Postgres lexical, Qdrant vectors, Ollama LLM/embeddings, chat services & examples.
License: MIT
Requires Python: >=3.12
Keywords: chat, ollama, postgres, qdrant, rag, sse

# How to Create an Event in `convo_orchestrator`

This guide explains step by step how to create, configure, and run an event
using the in-memory adapters of `convo_orchestrator`. Events can be triggered
manually, by time-based triggers, or by external adapters.

---

## 1. Import the required components

```python
from datetime import timedelta

from convo_orchestrator import (
    InMemoryEventRepository,
    InMemoryMetrics,
    SystemClock,
    EventManager,
    HandlerRegistry,
    Event,
    EventId,
    Trigger,
    TriggerId,
    TriggerKind,
    Policy,
)
```

---

## 2. Create the repository, metrics, clock, and handler registry

```python
repo = InMemoryEventRepository()
metrics = InMemoryMetrics()
clock = SystemClock()
registry = HandlerRegistry()
```

---

## 3. Define and register a handler

Handlers are just functions (sync or async) that receive an `EventContext`.

```python
def my_handler(ctx):
    print(f"Running handler for event={ctx.event_id.value}, payload={ctx.payload}")
    return "done"

registry.register("my-handler", my_handler)
```

---

## 4. Create an Event

An event defines the *what* and *how* to execute.

```python
ev = Event(
    id=EventId("ev-hello"),
    name="hello-event",
    handler_name="my-handler",
    policy=Policy(timeout_sec=2.0, max_retries=0, max_concurrency=1),
    active=True,
)
repo.save_event(ev)
```

---

## 5. (Optional) Attach a Trigger

Triggers define *when* to execute the event.

### Interval trigger example:

```python
trig = Trigger(
    id=TriggerId("tr-hello"),
    kind=TriggerKind.INTERVAL,
    interval=timedelta(seconds=10),
    active=True,
)
repo.attach_trigger(ev.id, trig)
```

This means the event will run every 10 seconds.

---

## 6. Create and start the EventManager

```python
mgr = EventManager(repo=repo, handler_registry=registry, clock=clock, metrics=metrics, scheduler_tick_ms=100)
mgr.start()
```

---

## 7. Manually emit an event (alternative to triggers)

```python
import asyncio

async def run():
    await mgr.emit(ev.id, payload={"msg": "manual trigger"})
    await asyncio.sleep(0.5)
    await mgr.stop()

asyncio.run(run())
```

---

## 8. Check event status and metrics

```python
status = mgr.status(ev.id).unwrap()
print("Last outcome:", status.last_outcome)

print("Metrics snapshot:", metrics.snapshot())
```

---

## Summary

1. Create infra (`repo`, `metrics`, `clock`, `registry`).
2. Define and register a handler.
3. Create an `Event` and save it.
4. Optionally attach a `Trigger` (e.g., INTERVAL, AT).
5. Start the `EventManager`.
6. Use `.emit()` for manual runs, or let triggers schedule runs.
7. Inspect `.status()` and metrics to monitor executions.

This workflow lets you compose flexible event-driven behaviors in
`convo_orchestrator`.