# Python · Sphinx

Real Sphinx JSON builder output from the checked-in python fixture source. Generated artifacts, commands, versions, and SHA-256 hashes are recorded under sources/native. This is a teaching library, not a published SDK.

> Source: https://appgram.github.io/docsy/python-sdk  
> Language: python  
> Symbols: 5 across 3 categories

## Categories

- [Classes](#classes) — 1 items
- [Methods](#methods) — 3 items
- [Properties](#properties) — 1 items

## Classes

### `greeter.Greeter`  <sub>class</sub>

Build personalized greetings without network access.

```python
class greeter.Greeter
```

**Example**

```python
greeter = Greeter()
print(greeter.greet('Docsy'))
```

## Methods

### `greeter.Greeter.greet`  <sub>method</sub>

Greet a reader.

**Parameters**

| Name | Type | Required | Description |

| --- | --- | --- | --- |

| `name` | `str` | ✓ | Reader name. |

**Returns** — `str` — A friendly greeting.

```python
greet(name: str) → str
```

**Example**

```python
Greeter().greet('Docsy')
```

---

### `greeter.Greeter.greet_checked`  <sub>method</sub>

Reject an empty reader name.

**Errors**

- `ValueError` — ValueError – When name is empty.

**Parameters**

| Name | Type | Required | Description |

| --- | --- | --- | --- |

| `name` | `str` | ✓ | Reader name. |

**Returns** — `str` — A validated greeting.

```python
greet_checked(name: str) → str
```

**Example**

```python
Greeter().greet_checked('Ada')
```

---

### `greeter.Greeter.greet_many`  <sub>method</sub>

Greet several readers while preserving input order.

**Parameters**

| Name | Type | Required | Description |

| --- | --- | --- | --- |

| `names` | `list[str]` | ✓ | Reader names. |

| `separator` | `str` |  | Separator between greetings. |

**Returns** — `str` — Joined greetings.

```python
greet_many(names: list[str], separator: str = ' / ') → str
```

**Example**

```python
Greeter().greet_many(['Ada', 'Linus'])
```

## Properties

### `greeter.Greeter.prefix`  <sub>property</sub>

Greeting prefix used for future calls.

```python
prefix: str = 'Hello'
```