semvec/pypi-packages huggingface dataset:
adventure-island 0.1.0
Hello World
License: MIT
Requires Python: >=3.8

<div align="center">

# 🌲 The Forest of Cursed Elves 🌲  
### A Psychological Command-Line Text Adventure

*A subtly hostile forest.  
A quiet erosion of will.  
A choice that may never appear.*

</div>

---

## 🧠 Game Overview

**The Forest of Cursed Elves** is a **psychological text adventure** played entirely in the command line.  
The forest is not openly violent — it is patient, observant, and persuasive.

The player navigates a living environment that reacts not just to actions, but to **mental state**.

---

## 🎮 Genre & Platform

- **Genre:** Psychological Text Adventure / Interactive Fiction  
- **Platform:** Command Line Interface (CLI)  
- **Language:** Python  

---

## 🌲 Core Concept

The game tracks **three hidden core stats** that define who the player becomes:

| Stat | Represents | Narrative Role |
|----|----|----|
| **Will** | Mental fortitude | The power to refuse comfort or submission |
| **Awareness** | Perception and insight | The power to notice deception and patterns |
| **Corruption** | Forest influence | The seductive pull of belonging |

The primary challenge is **maintaining Will and Awareness** while resisting the slow rise of **Corruption**.

You never see these values directly.  
You feel them through disappearing choices.

---

🏁 Endings (4 Primary Outcomes)

The game has four possible endings, resolved at the final scene through weighted logic:

| Ending                 | Probability | Final Action   | Required Conditions                     |
| ---------------------- | ----------- | -------------- | --------------------------------------- |
| 🌿 **The True Ending** | 10%         | Refusal (2)    | Will ≥ 7, Awareness ≥ 7, Corruption < 5 |
| ❌ **Consumed Refusal** | 30%         | Refusal (2)    | Fails True Ending conditions            |
| 🌑 **Rooted Will**     | 30%         | Acceptance (1) | High Will + Awareness                   |
| 🌲 **The Embrace**     | 30%         | Acceptance (1) | Low Will + Awareness or high Corruption |


## 🚀 How to Run the Game

### 🔧 Prerequisites
- Python **3.x** (recommended)

### ▶️ Execution

Clone the repository:
```bash
git clone [https://github.com/Aryanuo/Projects/tree/main/Adventure%20Island]
cd elf-forest

python main.py
cdef-sas7bdat-to-parquet 0.1.0
Fast, ergonomic CLI for converting SAS7BDAT files into Parquet.
License: MIT
Requires Python: >=3.9
Keywords: sas7bdat, parquet, sas, cli, data

# sas2parquet

Fast, ergonomic CLI for converting SAS7BDAT files into Parquet using
`sas7bdat-parser-rs`.

## Usage

```bash
sas2parquet path/to/file.sas7bdat
```

Convert a directory recursively:

```bash
sas2parquet path/to/dir
```

Inspect metadata:

```bash
sas2parquet inspect path/to/file.sas7bdat
```

## Notes

- Use `--progress [auto|always|never]` to control progress bars.
- Use `--jobs N` to cap parallelism.
resumex-py 1.0.0
YAML -> LaTeX -> PDF resume builder with strict theme schemas.
License: MIT
Requires Python: >=3.12
Keywords: generator, jinja2, latex, pydantic, resume, yaml

# resumex

[![PyPI](https://img.shields.io/pypi/v/resumex-py.svg)](https://pypi.org/project/resumex-py/)
[![Tests](https://img.shields.io/github/actions/workflow/status/rsm-vsivasankaran/resumex/tests.yml?branch=main)](https://github.com/rsm-vsivasankaran/resumex/actions)

An easy, YAML-based, theme-driven resume generator. `resumex` takes your structured data and produces professional LaTeX and PDF resumes with strict schema validation.

## Features

- **YAML-first**: Store your career data in a clean, versionable format.
- **Strict Validation**: Powered by Pydantic to ensure your data matches your theme's requirements.
- **Theme System**: Fully customizable layouts using Jinja2 templates.
- **Dual Usage**: Use it via CLI or as a Python module in your own scripts.
- **Smart Compilation**: Automatically handles LaTeX runs using `latexmk` or falls back to direct engines like `pdflatex`.

## Installation

### Requirements

- **Python**: 3.12 or higher.
- **LaTeX**: A distribution (like TeX Live, MacTeX, or MiKTeX) providing `latexmk` (recommended) or `pdflatex`.

### Using `uv` (Recommended)

```bash
uv tool install resumex-py
```

### Using `pip`

```bash
pip install resumex-py
```

## Quickstart

1. **Create your resume**: Save your data in `resume.yaml` (see [examples/resume.yaml](examples/resume.yaml)).
2. **Generate PDF**:
   ```bash
   resumex build resume.yaml --out build
   ```
3. **Generate TeX only**:
   ```bash
   resumex tex resume.yaml --out build
   ```

## Custom Themes

`resumex` allows you to go beyond the bundled themes by creating your own.

### Using a local theme

You can point the generator to a folder containing your theme:

```bash
resumex build resume.yaml --theme ./path/to/my-theme
```

### Theme Structure

A theme directory must contain:
- `theme.yaml`: Configuration for allowed sections, templates, and models.
- `templates/main.tex.j2`: The main entry point for the resume layout.
- `partials/`: Reusable Jinja2 fragments for specific sections.

To start a new theme, copy the `default` theme data from the package:
```bash
cp -r src/resumex/themes_data/default ./my-theme
```

## Module Usage

You can also integrate `resumex` into your Python applications:

```python
from pathlib import Path
from resumex.engine.pipeline import build_pdf

result = build_pdf(
    yaml_path=Path("resume.yaml"),
    theme_id="default",  # or a path like "./my-theme"
    out_dir=Path("output")
)

print(f"Resume generated at: {result.pdf_path}")
```

## Development & Testing

We use `uv` for development. To run tests:

```bash
uv run pytest tests/
```

## License

MIT