semvec/pypi-packages huggingface dataset:
nhpdf 1.8
Download NHentai doujins as PDF
Requires Python: >=3.8
Keywords: goon, pdf, scraper

# NHENTAI DOUJIN-TO-PDF MAKER

A *disgusting* Python script that compiles doujins from [nhentai.net](https://nhentai.net) into PDFs for **offline gooning**.

This app has two flavors:

---

## 🧱 Flavor 1: CLI Tool (`nhpdf`)

A command-line interface you can run from anywhere:

```bash
nhpdf <doujin-code>
```

Example:
```bash
nhpdf 566212
nhpdf 566212 563102 345987
```

---

### 🔧 How to Install (CLI Version)

You can install the CLI tool directly from the PyPI as long as you have Python (Refer to the 2nd flavors first step to install it):

```bash
pip install nhpdf
```

Now you can run it with:

```bash
nhpdf 566212
```

---

## 🐍 Flavor 2: Raw Python Script (`main.py`)

If you prefer to run it like a normal Python script:

```bash
python main.py
# or
python3 main.py
```

---

### 📥 How to Set Up the Script

> These instructions focus on **macOS**, but should work on **Windows** too (with small changes).

#### 1. Install Python

Go to the [PythonWebsite](https://www.python.org/downloads/) to install Python for your OS.

Check if Python is installed:

- **Windows**:
  ```bash
  python
  ```

- **macOS/Linux**:
  ```bash
  python3
  ```

You should get a Python REPL (interactive shell).

---

#### 2. Install Required Packages

Navigate to the project directory (where `main.py` and `requirements.txt` live):

- **Windows**:
  ```bash
  cd path\to\your\folder
  dir  # list files
  ```

- **macOS/Linux**:
  ```bash
  cd /path/to/your/folder
  ls  # list files
  ```

Then install dependencies:

```bash
pip install -r requirements.txt
```

---

#### 3. Run the Script

```bash
python main.py
# or
python3 main.py
```

You should see an ascii logo:

```
NHENTAI DOUJIN-TO-PDF MAKER
```

✅ You’re good to go!

---

## 🧙 How to Use

Type the code of the nhentai doujin you want, then let the magic happen. The PDF will be saved to your **Documents/nhpdf/** folder.

---

> ⚠️ This script only works with [nhentai.net](https://nhentai.net)

---

## 🔗 Download

**GitHub Repo**: [NhentaiDoujinToPDFMaker](https://github.com/Aze543/NhentaiDoujinToPDFMaker)

You can download the script version from the **[Releases](https://github.com/Aze543/NhentaiDoujinToPDFMaker/releases)** page.

---

Enjoy responsibly 😅
markdown-heading-numbering 0.1.0
CLI and pre-commit hook to add hierarchical numbering to Markdown headings.
Requires Python: >=3.10

# markdown-heading-numbering

CLI formatter and pre-commit hook that adds hierarchical numbering to Markdown
headings.

______________________________________________________________________

**Table of Contents:**

<!--TOC-->

- [1. Installation](#1-installation)
- [2. CLI Usage](#2-cli-usage)
- [3. Pre-commit Hook](#3-pre-commit-hook)
- [4. Tests](#4-tests)

<!--TOC-->

______________________________________________________________________

## 1. Installation

```bash
pip install .
```

For development:

```bash
pip install -e .[dev]
```

## 2. CLI Usage

```bash
markdown-heading-numbering \
  --start-from-level 2 \
  --end-at-level 5 \
  --initial-numbering 1 \
  docs/README.md
```

Options:

- `--start-from-level` (`int`, default `2`): first heading level to number.
- `--end-at-level` (`int`, default `6`): last heading level to number
  (inclusive).
- `--initial-numbering` (`int`, default `1`): starting value for the top-most
  numbered heading.

Any existing numbering is removed before the formatter applies the new
sequence.

## 3. Pre-commit Hook

This repository ships a `.pre-commit-hooks.yaml` that points to the CLI. Add
the hook to your `.pre-commit-config.yaml`:

```yaml
- repo: https://github.com/jsh9/markdown-heading-numbering
  rev: <commit-or-tag>
  hooks:
    - id: markdown-heading-numbering
      args: ["--start-from-level", "2", "--end-at-level", "4"]
```

The hook shares the same options as the CLI and formats files in place.

## 4. Tests

```bash
pytest
```