semvec/pypi-packages huggingface dataset:
blackdoc 0.4.6
run black on documentation code snippets
Requires Python: >=3.10

blackdoc
========

.. image:: https://github.com/keewis/blackdoc/actions/workflows/ci.yml/badge.svg?branch=main
    :target: https://github.com/keewis/blackdoc/actions/workflows/ci.yml
.. image:: https://img.shields.io/badge/code%20style-black-000000.svg
    :target: https://github.com/python/black
.. image:: https://readthedocs.org/projects/blackdoc/badge/?version=latest
    :target: https://blackdoc.readthedocs.io/en/latest/?badge=latest
    :alt: Documentation Status

**blackdoc** is a tool that applies `black`_ to code in documentation.

It was originally a rewrite of a `gist`_ and called
**black-doctest**. In April 2020, it was renamed to **blackdoc**.

.. _gist: https://gist.github.com/mattharrison/2a1a263597d80e99cf85e898b800ec32
.. _black: https://github.com/psf/black

Installation
------------
Dependencies:

- `black`_
- `more-itertools`_
- `rich`_
- `tomli`_
- `pathspec`_

.. _more-itertools: https://github.com/more-itertools/more-itertools
.. _rich: https://github.com/textualize/rich
.. _tomli: https://github.com/hukkin/tomli
.. _pathspec: https://github.com/cpburnz/python-pathspec

Install it with:

.. code:: bash

    python -m pip install blackdoc

Usage
-----
The commandline interface supports two modes: checking and inplace
reformatting.

.. code:: bash

    python -m blackdoc --help


In inplace reformatting mode, it will reformat the doctest lines and
write them back to disk:

.. code:: bash

    # on explicitly mentioned files
    python -m blackdoc file1.py file2.py
    # on the whole directory
    python -m blackdoc .


When checking, it will report the changed files but will not write them to disk:

.. code:: bash

    python -m blackdoc --check .

It is also possible to use the entrypoint script:

.. code:: bash

    blackdoc --help

pre-commit
----------
This repository defines a ``pre-commit`` hook:

.. code:: yaml

   hooks:
   ...
   - repo: https://github.com/keewis/blackdoc
     rev: 3.8.0
     hooks:
     - id: blackdoc

It is recommended to *pin* ``black`` in order to avoid having different versions for each contributor. To automatically synchronize this pin with the version of the ``black`` hook, use the ``blackdoc-autoupdate-black`` hook:

.. code:: yaml

   hooks:
   ...
   - repo: https://github.com/psf/black
     rev: 23.10.1
     hooks:
     - id: black
   ...
   - repo: https://github.com/keewis/blackdoc
     rev: 3.8.0
     hooks:
     - id: blackdoc
       additional_dependencies: ["black==23.10.1"]
     - id: blackdoc-autoupdate-black

Note that this hook is *not* run on ``pre-commit autoupdate``.
inverso 2025.11.16
Inverting pair mappings helper tool.
Requires Python: >=3.9
Keywords: author-tools, developer-tools, JSON, YAML

# Inverso

Inverting pair mappings helper tool.

## Usage:

```bash
❯ inverso
usage: inverso [-h] [--source FILE] [--target FILE] [--debug] [--auto-serial] [--marker-token TOKEN] [--is-value]
               [--generator-caveat] [--preview] [--quiet] [--version]
               [SOURCE_FILE] [TARGET_FILE]

Inverting pair mappings helper tool.

positional arguments:
  SOURCE_FILE           JSON or YAML source as positional argument
  TARGET_FILE           JSON or YAML target as positional argument

options:
  -h, --help            show this help message and exit
  --source FILE, -s FILE
                        JSON or YAML source
  --target FILE, -t FILE
                        JSON or YAML target
  --debug, -d           work in debug mode (default: False), overwrites any environment variable INVERSO_DEBUG value
  --auto-serial, -a     auto-serial mode, rewrite incoming keys as 1-based auto-serial (default: False)
  --marker-token TOKEN, -m TOKEN
                        if in auto-serial mode, marker token to be exempted (default: False)
  --is-value            if marker token, then expect it as value insteadf of as key (default: False)
  --generator-caveat, -g
                        add a generator caveat as first pair to generated inverted map (default: False)
  --preview, -p         preview only (dry-run) reporting on what would be done (default: False)
  --quiet, -q           work in quiet mode (default: False)
  --version, -V         display version and exit```

## Version

```bash
❯ inverso --vesion
2025.7.19
```

## Status

Prototype.
spScriptTest3Py 1.0.1
A Python package for ...
Requires Python: >=3.10
Keywords: key1

# spScriptTest3Py

[![PyPI - Version](https://img.shields.io/pypi/v/spScriptTest3Py.svg)](https://pypi.org/project/spScriptTest3Py)
[![PyPI - Python Version](https://img.shields.io/pypi/pyversions/spScriptTest3Py.svg)](https://pypi.org/project/spScriptTest3Py)


This package provides a Python module ...


Enjoy

&emsp;krokoreit  
&emsp;&emsp;&emsp;<img src="https://github.com/krokoreit/spScriptTest3Py/blob/main/assets/krokoreit-01.svg?raw=true" width="140"/>


## Installation

```console
pip install spScriptTest3Py
```


## Usage & API

### ScriptTest3 Class
Import module:
```py
  from spScriptTest3Py import ScriptTest3

  obj = ScriptTest3(aaaa)
```


</br>

### API

#### Methods
* [aaa()](#aaa-method)  
* [bbb()](#bbb-method)  


#### aaa() Method
```py
  get_zoneinfo_utc()
```



<div style="text-align: right"><a href="#methods">&#8679; back up to list of methods</a></div>


</br>

## License
MIT license  
Copyright &copy; 2025 by krokoreit
pyresidfp 0.17.0
Emulates the SID sound-chip
Requires Python: <4.0.0,>=3.10.0

# pyresidfp

Emulates the SID sound-chip in software. The C++ emulation code was copied over from
[libsidplayfp](https://github.com/libsidplayfp/libsidplayfp).

## How to install

Requirements for installation from source:
- compiler for ISO C++20
- Python 3.10+ and header files


### From PyPI

Install the latest version using
```commandline
python -m pip install pyresidfp
```


### From cloned git repository 

Build from source and install using
```commandline
python -m pip install .
```

## Example

For the example, [NumPy](http://www.numpy.org/) and [soundcard](https://github.com/bastibe/SoundCard) python packages
are required. The example is ported from the section *Sample Sound Program*,
[Commodore 64 User's Guide](https://archive.org/embed/Commodore_64_Users_Guide_1982_Commodore), page 80:
```python
from datetime import timedelta
import numpy as np
import soundcard as sc
from pyresidfp import SoundInterfaceDevice, Voice, ControlBits, Tone

# program SID
sid = SoundInterfaceDevice()
sid.Filter_Mode_Vol = 15             # Maximum volume
sid.attack_decay(Voice.ONE, 190)     # 800 ms attack, 15 s decay
sid.sustain_release(Voice.ONE, 248)  # sustain peak, 300 ms release
sid.tone(Voice.ONE, Tone.C4)
sid.control(Voice.ONE, ControlBits.TRIANGLE | ControlBits.GATE)

# sample attack phase
attack_phase = timedelta(seconds=0.32)
raw_samples = sid.clock(attack_phase)

# reprogram SID for release phase and sample
release_phase = timedelta(seconds=0.3)
sid.control(Voice.ONE, ControlBits.TRIANGLE)
raw_samples.extend(sid.clock(release_phase))

# convert audio format and play
samples = np.array(raw_samples, dtype=np.float32) / 2.0**15
spkr = sc.default_speaker()
spkr.play(data=samples, samplerate=int(sid.sampling_frequency), channels=1)
```


## Credits

We like to thank all contributors of `libsidplayfp`, especially:

- Dag Lem: Designed and programmed complete emulation engine.
- Antti S. Lankila: Distortion simulation and calculation of combined waveforms
- Ken Händel: source code conversion to Java
- Leandro Nini: port to c++, merge with reSID 1.0