semvec/pypi-packages huggingface dataset:
orpheus-collage-tools 1.0.0
Cross-platform Orpheus Collage Tools for music discovery and downloading
Requires Python: >=3.8

# Orpheus Collage Tools

[![PyPI version](https://badge.fury.io/py/orpheus-collage-tools.svg)](https://pypi.org/project/orpheus-collage-tools/)
[![Python 3.8+](https://img.shields.io/badge/python-3.8+-blue.svg)](https://www.python.org/downloads/)

Interactive CLI for discovering, browsing, and downloading music releases from Orpheus.network private tracker.

## Installation

```bash
pip install orpheus-collage-tools
```

## Quick Start

### 1. First Run (Configuration Setup)

```bash
orpheus
```

This will automatically create your configuration file and prompt for your Orpheus credentials.

### 2. Interactive Mode

```bash
orpheus
```

### 3. Command Line Usage

```bash
# Search for artist releases
orpheus find-album --artist "The Prodigy" --interactive

# Download torrents from a collage
orpheus download 6936 --prefer-flac

# Manage crates
orpheus crate list
orpheus crate create "My Favorites"
orpheus crate download "My Favorites"
```

## Features

- **🎤 Artist Search** - Find all releases by artist with smart filtering
- **🔍 Collage Discovery** - See which curated collections contain specific albums
- **📦 Crate System** - Create wishlists and bulk download later
- **⬇️ Bulk Downloads** - Download entire collages with format preferences
- **🎯 Release-Based Organization** - View by actual pressings/labels
- **🎵 Interactive Browsing** - One album per page with complete metadata

## What Makes This Better Than the Main Site

- **Enhanced filtering** - Show just Beatles singles (impossible on main site)
- **Release-based organization** - See all 23 pressings of "The Fat Of The Land"
- **Collage navigation** - Discover music through curated collections
- **Wishlist system** - Add albums while browsing, download all at once later
- **Format preferences** - Bulk download with FLAC/320/V0 preferences

## Download Location

All torrent files are downloaded to:

- **macOS/Windows**: `~/Documents/Orpheus/`
- **Linux**: `~/Documents/Orpheus/`

## Security

Your Orpheus credentials are stored securely in:

- **macOS**: `~/.orpheus/config.json`
- **Windows**: `%APPDATA%/orpheus/config.json`
- **Linux**: `~/.orpheus/config.json`

Files are created with owner-only permissions and never committed to version control.

## Cross-Platform Support

- **macOS**: Native bash script with full interactive features
- **Windows**: Python-based implementation with batch file launcher
- **Linux**: Python-based implementation with full feature parity

## Development

For development and contribution information, see the [development guide](docs/development-guide.md).

## License

MIT License - see LICENSE file for details.
dashc 0.1.1
Tool to generate python -c bash as if it were a package format.
Requires Python: >=3.8
Keywords: bash, packaging

# dashc

Tool to generate `python -c` bash scripts as if they were a package format.

---

## About

`dashc` lets you bundle Python source code (a single file or an entire package) into a executable shell script.
Instead of shipping loose files, you can hand over a bash command (or `.sh` script) that self-contains your Python logic and runs without needing to touch the filesystem.

Features:

* **Single file mode** – wrap a single `.py` into a compressed string or plain text.
* **Module mode** – zip up a package with `__main__.py` or a specified `module:function` entrypoint.
* **Bash-friendly** – outputs either a plain (`python -c '...'`) or a script with a shebang.
* **Validates syntax** – checks both Python and Bash syntax before generating.

---

## Installation

It is recommended to install with [pipx](https://pypa.github.io/pipx/):

```bash
pipx install dashc
```

This keeps `dashc` isolated in its own environment while making the CLI available globally.

---

## Usage

Run with:

```bash
dashc [--version] [--verbose|--quiet|--dry-run] <command> [options]
```

Global options:

* `--version` – show version
* `--verbose` – debug logging
* `--quiet` – suppress logs except errors
* `--dry-run` – simulate actions without writing files

### Commands

* `file` – Compile a single `.py` into a script.
* `module` – Package a directory and run `__main__.py` or a chosen entrypoint.

---

## Example

**Single file to script:**

```bash
dashc file send_email.py --out run_send_email.sh
./run_send_email.sh --to test@example.com
```

**Single file to script:**

```bash
dashc file send_email.py --one-line
# -> prints a bash command like: python -c '...'
```

**Module with `__main__.py`:**

```bash
dashc module ./send_email --out run_pkg.sh
./run_pkg.sh --config config.yaml
```

**Module with function entrypoint:**

```bash
dashc module ./send_email --entrypoint send_email.cli:main --out run_cli.sh
./run_cli.sh --to test@example.com
```

---

## Prior Art / Alternatives

* **zipapp** (`python -m zipapp`) – Standard library tool for packaging Python code into `.pyz` archives runnable with Python.
* **shiv**, **pex** – Build self-contained Python executables with full dependency resolution.
* **pyinstaller** – Freezes Python programs into standalone executables.