juicenet-cli 0.9.0

Crude CLI tool to upload files to Usenet using Nyuu and ParPar

juicenet-cli

Crude CLI tool to upload files to Usenet using Nyuu and ParPar

Table Of Contents

• About the Project
• Getting Started
  • Prerequisites
  • Installation
• Usage
• License

About The Project

Uploading stuff to usenet is tedious so I tried to make it easier.

• Searches subdirectories for defined file extensions in juicenet.yaml or as passed in --exts
• Alternatively, searches for glob patterns passed in --pattern
• Provides basic BDMV support
• Creates par2 files
• Directly passes files and corresponding .par2 files to Nyuu
• Offers the option to organize files into separate folders for manual upload
• Automatically checks for and reposts raw articles on each run
• Can NOT continue from where it stopped if it gets interrupted for any reason
• Probably has cases where it breaks. I've tried to keep it OS independent but I've mostly tested this on Windows. I also only have limited knowledge on Python, so please bear with me if you encounter any issues or bad code. Feel free to open issues or pull requests and I'll see what I can do

Getting Started

This script uses ParPar for generating the PAR2 recovery files and Nyuu for uploading to usenet.

Prerequisites

• Python 3.11
• animetosho/Nyuu - You need version a4b1712 or newer. v0.4.1 is outdated and you shouldn't use it.
  • Until animetosho uploads a new release, you can grab the Windows binary here.
• animetosho/ParPar

Installation

1. With pipx (recommended):

   pipx install juicenet-cli
   

2. With pip:

   pip install juicenet-cli
   

3. With poetry:

   git clone https://github.com/Ravencentric/juicenet-cli.git
   

   cd juicenet-cli
   

   poetry install
   

   poetry shell
   

Usage

Before you can use this, you'll have to fill out juicenet.yaml. After you've specified all the values in the config you just have to pass it to juicenet-cli. You can do that in one of three ways:

1. Using the command-line argument: --config <path>
2. Setting an environment variable named JUICENET_CONFIG
3. Placing the configuration file in the current working directory as juicenet.yaml

The order of precedence, if all three are present, is: command-line argument > environment variable > local file in the current working directory

The above was the first time setup, after which you can simply run:

juicenet "path\to\directory\with\files"

For more information, go here.

License

Distributed under the Unlicense License. See UNLICENSE for more information.