semvec/pypi-packages huggingface dataset:
k-vpn 1.0.0
Automated CLI tool to fetch and connect to global VPN Gate servers securely.
License: MIT
Requires Python: >=3.8

# k-vpn

**k-vpn** is a modern, automated CLI tool designed to easily fetch and connect to public VPN Gate servers directly from your terminal. Built with Python, Typer, and Rich, it offers a beautiful and interactive experience for securing your connection.

## Features

-   **Automated Fetching**: Retrieves the latest list of public VPN servers from VPN Gate.
-   **Rich UI**: Displays server availability by country in a formatted table.
-   **Interactive Selection**: Easily choose your desired country.
-   **Secure Connection**: Automates the OpenVPN connection process using temporary configuration files.
-   **Smart Defaults**: Filters for high-speed, uptime-reliable servers.

## Prerequisites

-   **Python 3.8+**
-   **OpenVPN**: Must be installed and accessible via `sudo openvpn` on your system.
-   **uv**: Recommended for project management and execution.

## Installation & Usage

It is recommended to use `uv` to run this tool directly without manual environment setup.

1.  **Clone the repository:**
    ```bash
    git clone https://github.com/KpihX/k-vpn.git
    cd k-vpn
    ```

2.  **Run the tool:**
    ```bash
    uv run k-vpn.py
    ```

    The tool will verify your environment, fetch the server list, and present you with options.

## How it Works

1.  **Fetch**: The tool downloads the CSV list from `http://www.vpngate.net/api/iphone/`.
2.  **Parse & Filter**: It parses the data, filtering for valid OpenVPN configurations.
3.  **Display**: Aggregates servers by country and displays a summary table (Country, Server Count).
4.  **Connect**:
    *   You select a country by its index.
    *   The tool picks the best server (based on score/speed) for that country.
    *   It decodes the base64 OpenVPN configuration.
    *   It creates a temporary `.ovpn` file.
    *   It executes `sudo openvpn --config <temp_file>` to establish the tunnel.

## License

This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.

## Disclaimer

This tool uses public servers from VPN Gate. The availability, speed, and security of these servers are not guaranteed by the author. Use at your own risk.
pptsmith 1.0.0
从 Markdown 生成 PowerPoint 演示文稿的工具
License: MIT
Requires Python: >=3.9
Keywords: ppt, powerpoint, markdown, presentation, slide

# pptsmith

从 Markdown 生成 PowerPoint 演示文稿的工具。

## 安装

```bash
pip install -e .
# or
uv tool install -e .
```

## 使用方法

```bash
pptsmith <markdown_file> [OPTIONS]
```

### 参数

- `MARKDOWN_FILE`: Markdown 文件路径（必需）

### 选项

| 选项 | 说明 |
|------|------|
| `-t, --template PATH` | PowerPoint 模板文件（默认: template.pptx） |
| `-o, --output PATH` | 输出文件路径（默认: 与输入文件同名的 .pptx） |
| `-v, --verbose` | 打印每页渲染的内容 |

### 示例

```bash
uv sync
# 指定模板 并显示详细渲染信息
uv run pptsmith example/main.md -t template.pptx -v
```

## Markdown 格式

使用 `---` 分隔页面，每页支持：

- `# 标题` - 一级标题作为幻灯片标题
- 正文内容 - 自动填充到文本框
- `![alt](image.png)` - 图片（相对于 Markdown 文件路径）

### 示例

```markdown
# 第一页标题

这是第一页的正文内容。
支持多行文本。

![](image1.png)

---

# 第二页标题

第二页的内容。
```

## 模板要求

模板 PPT 的第一页作为所有页面的模板，需包含以下元素：

| 元素类型 | 命名规则 |
|---------|---------|
| 标题 | placeholder idx=0 |
| 文本框 | 名称包含「文本框」「Content」或「Text」 |
| 图片 | 名称包含「图片」「Picture」或「Image」 |

填充时会保留文本框的原有样式（字体、大小、颜色等）。

## 依赖

- python-pptx >= 0.6.21
- click >= 8.0.0
repo-kit 0.1.0
Repo health check + one-command professional open-source kit.
License: MIT
Requires Python: >=3.10
Keywords: badge, cli, github, opensource, repository, template

# repo-kit

**repo-kit** is a tiny CLI that does two things:

1) **scan** a repository and output a **Repo Score (0-100)** with actionable checks
2) **apply** a "professional open-source kit" (README skeleton, License, contributing docs, GitHub templates, CI, Release, Changelog)
3) **badge** to generate and embed a **local score badge SVG** + common GitHub badges

> Goal: make repos look and feel professional in one command — without nuking existing files.

---

## Install

```bash
pipx install repo-kit
# or
pip install repo-kit
```

## Quickstart

```bash
# scan a local repo
repo-kit scan .

# scan a GitHub repo (clones to a temp dir)
repo-kit scan https://github.com/OWNER/REPO

# apply templates (safe by default: won't overwrite existing files)
repo-kit apply --stack python

# generate/update badges
repo-kit badge
```

## Commands

### `repo-kit scan <path-or-github-url>`

- prints a score and checklist
- can emit JSON for CI usage

```bash
repo-kit scan . --format json > repo-kit-report.json
```

### `repo-kit apply`

Generates missing files and directories.

```bash
repo-kit apply --stack node
repo-kit apply --stack python --force   # overwrite existing files
```

### `repo-kit badge`

- creates `./.github/repo-score.svg`
- inserts badges into README (best-effort)

```bash
repo-kit badge --no-shields
```

---

## Repo Score checks (v0.1)

- README presence + basic sections
- LICENSE
- CONTRIBUTING
- CODE_OF_CONDUCT
- Issue templates + PR template
- CI workflow
- Release workflow
- CHANGELOG
- Security policy stub

---

## GitHub Action (example)

Put this in `.github/workflows/repo-kit.yml`:

```yaml
name: repo-kit
on:
  pull_request:
  workflow_dispatch:

jobs:
  scan:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-python@v5
        with:
          python-version: '3.11'
      - run: pip install repo-kit
      - run: repo-kit scan . --format json > repo-kit-report.json
      - uses: actions/upload-artifact@v4
        with:
          name: repo-kit-report
          path: repo-kit-report.json
```

---

## License

MIT