semvec/pypi-packages huggingface dataset:
docbinder-oss 0.1.3
DocBinder Open Source Shared Library
Requires Python: >=3.11

# DocBinder OSS

DocBinder OSS is a Python library and CLI tool that provides unified access to multiple cloud storage providers, such as Google Drive and Dropbox. Its goal is to simplify file management and automation across different storage backends with a consistent interface.


## Features

- Unified API for multiple storage providers
- Easy configuration via YAML or CLI
- Extensible provider system
- Command-line interface for common operations

## Installation

You can install DocBinder OSS using pip:

```sh
pip install docbinder-oss
```

## Usage

### CLI

After installation, you can use the `docbinder-oss` CLI:

```sh
docbinder --help
```

### Setup Configuration

You can configure providers using a YAML file:

```sh
docbinder setup --file path/to/config.yaml
```

Or directly via CLI options:

```sh
docbinder setup --provider "google_drive:key1=val1,key2=val2"
```

### List Providers

```sh
docbinder provider list
```

### Get Provider Details

```sh
docbinder procider get --name google_drive
```

### Test Provider Connection

```sh
docbinder provider test google_drive
```

# Development

See [CONTRIBUTING.md](CONTRIBUTING.md) for detailed development and contribution guidelines.

## Local Development Setup

This project uses `[uv](https://github.com/astral-sh/uv)` for dependency management:

```sh
uv sync
```

# Contributing

We welcome contributions! Please read our [Code of Conduct](CODE_OF_CONDUCT.md) and [Contributing Guide](CONTRIBUTING.md) before submitting a pull request.

* Fork the repository and create your branch from main.
* Add tests for new features or bug fixes.
* Ensure all tests pass before submitting a pull request.

# License
This project is licensed under the [Apache-2.0 License](LICENSE).

# Security
If you discover a security vulnerability, please see [SECURITY](SECURITY.md) for responsible disclosure guidelines.

___

DocBinder OSS is an open-source project—your feedback and contributions are appreciated! :rocket:
freshfiles 0.2.0
Checks if all specified files are fresher (younger) than a given expiry age
Requires Python: >=3.12

## Installation with UV

`uv tool install freshfiles`

## Sample use-case in bash

### Checking the age

```shell
# `./update_files.sh` is invoked if any of these files are missing or more than 1 hour old
freshfiles check --max-age-seconds 3600 file1 file2 || ./update_files.sh



freshfiles check --max-age-seconds 3600 .authfile && echo "no auth needed" || { 
    echo "authenticating" # replace with actual authentication
    touch .authfile
}
```


### Checking that target files are more recent that any of the source files used to generate the target


```shell
freshfiles compare -s src1 -s src2 -t dest || echo "update dest from src1 and src2" 
```

## Using justfiles

Project link: https://just.systems/man/en/introduction.html

```
[private]
_maybe_authenticate:
  #!/usr/bin/env bash
  set -euo pipefail
  freshfiles check --max-age-seconds 3 .authfile && echo "auth still valid" || { 
        echo "authenticating" # replace with actual authentication
        touch .authfile
  }

run: _maybe_authenticate
  @echo "... do work with valid auth"
```
multinut 0.2.2
A completely unnecessary multitool module.
Requires Python: >=3.6

# `multinut`

The multitool nobody asked for. Includes stuff and so.

---

## `multinut.env`

A simple but flexible environment loader.

Supports `.env` file parsing with optional mode suffixes (e.g. `.env.production`, `.env.testing`, etc.), lazy loading, and dynamic access.

### Features

* Mode-based config support (`.env.production`, `.env.testing`, etc.)
* Access via:

  * `env["KEY"]`
  * `env.get("KEY", ...)`
  * `env.KEY`
* Optional type casting (`str`, `bool`, `list`, `dict`, etc.)
* Sane default handling
* Does **not** mutate `os.environ`

---

### Use cases

* Loading `.env` files in mode-aware Python projects
* Separating secrets and configs by deployment context
* Dynamically reading values like `env.DB_URL`, `env.get("DEBUG", default=False, cast=cast_bool)`
* Avoiding `os.environ` pollution

---

### Basic Example

```python
from multinut.env import Environment, Modes

env = Environment(env_file_name=".env", mode=Modes.DEVELOPMENT)

print(env.get("DEBUG", default=False))
print(env["API_KEY"])
print(env.DB_URL)
```

Given a `.env.development` file:

```env
DEBUG=true
API_KEY=secret
DB_URL=https://example.com
```

---

### Smart Casts Example

```python
from multinut.env import (
    Environment, cast_bool, cast_int, cast_float,
    cast_list, cast_tuple, cast_dict, cast_none_or_str
)

env = Environment()

print("INT:", env.get("PORT", cast=cast_int))                      # -> int
print("FLOAT:", env.get("PI", cast=cast_float))                    # -> float
print("BOOL:", env.get("ENABLED", cast=cast_bool))                 # -> bool
print("LIST:", env.get("NUMBERS", cast=cast_list))                 # -> list[str]
print("TUPLE:", env.get("WORDS", cast=cast_tuple))                 # -> tuple[str]
print("DICT:", env.get("CONFIG", cast=cast_dict))                  # -> dict
print("NONE_OR_STR:", env.get("OPTIONAL", cast=cast_none_or_str))  # -> None or str
```

Example `.env`:

```env
PORT=8080
PI=3.1415
ENABLED=yes
NUMBERS=1,2,3
WORDS=hello,world,test
CONFIG={"timeout": 30, "debug": true}
OPTIONAL=null
```

### Included Cast Helpers

All built-in cast functions handle common edge cases:

| Cast Function      | Description                                 |
| ------------------ | ------------------------------------------- |
| `cast_str`         | Ensures string                              |
| `cast_int`         | Converts to integer                         |
| `cast_float`       | Converts to float                           |
| `cast_bool`        | Accepts `1`, `true`, `yes`, `on`, etc.      |
| `cast_list`        | Comma-split list                            |
| `cast_tuple`       | Comma-split, converted to tuple             |
| `cast_dict`        | Parses JSON string into dictionary          |
| `cast_none_or_str` | Returns `None` if value is `null` or `None` |

---
Lexical-Server 1.0.1
A dictionary server
Requires Python: >=3.13

# Lexical

Lexical is an offline dictionary server that provides fast word definitions using WordNet data.

## Features
- **Offline Dictionary**: Uses local WordNet data for word lookups.
- **LSP/Editor Integration**: Can run as a server over stdio for editor integration

## Installation
### Requirements
- Python 3.13+

### Install
**Install the project with pip**
   - For development:
     ```bash
     pip install -e .
     ```
   - For regular use:
     ```bash
     pip install .
     ```

## Usage
### As a Dictionary Server (for LSP/editor integration)
Run as a background server using stdin/stdout:
```bash
lexical --stdin
```
Request:
```
run
```
Response:
```
(noun)
1. A score in baseball made by a runner touching all four bases safely
  - "the Yankees scored 3 runs in the bottom of the 9th"
2. The act of testing something
  - "in the experimental trials the amount of carbon was measured separately"
(verb)
3. Move fast by using one's feet, with one foot off the ground at any given time
  - "Don't run--you'll be out of breath"
4. Flee
  - take to one's heels
```