semvec/pypi-packages huggingface dataset:
CacheControl 0.14.4
httplib2 caching for requests
Requires Python: >=3.10
Keywords: requests, http, caching, web

..
  SPDX-FileCopyrightText: SPDX-FileCopyrightText: 2015 Eric Larson

  SPDX-License-Identifier: Apache-2.0

==============
 CacheControl
==============

.. image:: https://img.shields.io/pypi/v/cachecontrol.svg
    :target: https://pypi.python.org/pypi/cachecontrol
    :alt: Latest Version

.. image:: https://github.com/psf/cachecontrol/actions/workflows/tests.yml/badge.svg
  :target: https://github.com/psf/cachecontrol/actions/workflows/tests.yml

CacheControl is a port of the caching algorithms in httplib2_ for use with
requests_ session object.

It was written because httplib2's better support for caching is often
mitigated by its lack of thread safety. The same is true of requests in
terms of caching.


Quickstart
==========

.. code-block:: python

  import requests

  from cachecontrol import CacheControl


  sess = requests.session()
  cached_sess = CacheControl(sess)

  response = cached_sess.get('https://google.com')

If the URL contains any caching based headers, it will cache the
result in a simple dictionary.

For more info, check out the docs_

.. _docs: http://cachecontrol.readthedocs.org/en/latest/
.. _httplib2: https://github.com/httplib2/httplib2
.. _requests: http://docs.python-requests.org/
filelogr 1.2.1
A flexible logging utility for your Python projects

# 📂filelogr

**Simple, reliable logging for your Python projects.**

---

## 💡 What’s filelogr?

`filelogr` is a lightweight Python logging module that writes actions to a file and optionally prints them to the console. It auto-creates a logs folder if needed, and lets you customize where your logs are stored.

Perfect for tracking your app's activity without the hassle.

---

## ✨ Features

- 🕒 Logs actions with timestamps
- 🖥️ Optional real-time console output
- 📁 Customizable log folder and filename
- 🛠️ Auto-creates log directory and file
- ⚡ Built with Python’s standard libraries only (zero dependencies)

---

## 📦 Installation

```bash
pip install filelogr
````

---

## 🚀 Quickstart

```python
from filelogr import Logger

# Configure your log directory and filename
Logger.configure(data_dir="my_logs", log_file="app.log")

# Log without a tag
Logger.log_action("Started the app")

# Log with no tag and no timestamp (just a separator)
Logger.log_action("----- New Session -----", separator=True)

# Log with a tag
Logger.log_action("An important event", tag="INFO")
```

---

## ❓ Why use filelogr?

Because logging shouldn't feel like setting up a rocket launch. `filelogr` gives you just what you need: a simple and readable way to track what’s going on in your app.

---

## 📄 License

[MIT License](https://github.com/Futuregus/filelogr/blob/main/LICENSE)

---

## 💬 Questions or ideas?

Open an issue or suggest a feature here:
👉 [GitHub: Futuregus/filelogr/issues](https://github.com/Futuregus/filelogr/issues)
sound-track-extract 0.1.0
Tiny CLI to extract and tag audio tracks from video files via ffmpeg.
Requires Python: >=3.13

## Product intent
- Extract production-ready audio from lecture/screencast videos without a DAW.
- Provide predictable defaults while surfacing audio engineering knobs only when needed.
- Run entirely from the terminal so it fits into automation scripts and batch workflows.

> Requires `ffmpeg`/`ffprobe` on PATH (`brew install ffmpeg` on macOS).

## UX design
### Mental model
- Primary verb is `extract`; everything else is an option that describes the desired audio file.
- Default behaviour: first audio track, full timeline, export as high-quality `mp3` next to the source file.
- Advanced controls are flat flags (no subcommands) to keep the command memorable.

### User journey
1. **Discovery** - `sound-track-extract --help` lists one-liners for common tasks so a new user can copy/paste.
2. **Pre-flight** - tool validates: source exists, ffmpeg installed, output path writable, and timecodes sane. Errors are plain-English with fixes.
3. **Execution** - renders a short status block (input -> output, duration, selected format) before running ffmpeg.
4. **Completion** - success message with location + file size; failures forward stderr and exit non-zero for scripting.

### Key interactions
- `sound-track-extract video.mp4` -> default mp3 export (320 kbps, stereo, original length).
- `--format wav|flac|aac|ogg` switches container/mode; CLI auto-adjusts sane defaults (e.g., bitrate ignored for lossless).
- `--start/--end` allow clipping a segment; accepts `HH:MM:SS` or seconds.
- `--sample-rate`, `--channels`, `--bitrate` tune technical audio output, grouped by option help text.
- `--output-dir` and `--name-template` control where/how files are named (placeholders: `{stem}`, `{format}`, `{track}`).
- `--title/--artist/--album/--comment` embed metadata; status panel now shows detected duration for confidence.
- `--list-tracks` prints detected audio streams, `--audio-track` picks one, and `--force` overwrites existing exports.
- `--dry-run` prints the ffmpeg command without executing, enabling trust before use.
- Clear error copy for common mistakes (missing ffmpeg, overlapping timecodes, unwritable folders).

## Usage
```bash
uv run sound-track-extract kdd_lec7.mp4
# or run the module directly
uv run python -m sound_track_extract.cli kdd_lec7.mp4
```

### Frequently used recipes
- Quick mp3: `sound-track-extract talk.mov`
- Lossless FLAC: `sound-track-extract talk.mov --format flac`
- Clip a quote: `sound-track-extract talk.mov --start 00:10:05 --end 00:12:20`
- Inspect tracks: `sound-track-extract talk.mov --list-tracks`
- Pick a dubbed track: `sound-track-extract talk.mov --audio-track 1`
- Custom destination: `sound-track-extract talk.mov --output-dir exports --name-template "{stem}_clean"`
- Tag metadata: `sound-track-extract talk.mov --title "Lecture 7" --artist "KDD"`
- Automate: `find . -name '*.mp4' -exec sound-track-extract {} --format wav --force \;`

## Development
```bash
uv sync            # install deps
uv run --extra dev pytest
uv run sound-track-extract --help
```

See `CHANGELOG.md` for progress snapshots.
half-hour 0.1.1
简易48个半小时记录法
Keywords: half, hour, record, self-discipline

# Half-Hour (`hh`)

A minimal command-line note-taking tool for quick logging and reviewing of time-stamped entries.

## Overview

The `hh` package provides three simple functions to manage a plain-text note file configured via `hh.yaml`:

- `hha`: **Add** a new note line.
- `hhl`: **List** the most recent notes.
- `hhd`: **Delete** the most recent lines.

All notes are appended to a single text file specified in the configuration.

## Configuration

Create a `hh.yaml` file in the same directory as `__init__.py` with the following content:

```yaml
notefile: /path/to/your/notes.txt
```

Replace `/path/to/your/notes.txt` with the absolute or relative path to your desired note file.

## Usage

### Add a note (`hha`)

```python
from hh import hha

hha("14:30", "Started working on README")
# Equivalent to: hha("14:30 Started working on README")
```

> **Note**: All arguments are joined into a single line and appended to the note file.

### List recent notes (`hhl`)

```python
from hh import hhl

hhl()      # Show last 10 lines
hhl(5)     # Show last 5 lines
```

### Delete recent notes (`hhd`)

```python
from hh import hhd

hhd(3)     # Delete the last 3 lines
```

> ⚠️ Deletion is permanent and cannot be undone.

## Requirements

- Python 3.6+
- `PyYAML` library (`pip install PyYAML`)

## License

[MIT](LICENSE) (assuming standard open-source practice; adjust as needed).