semvec/pypi-packages huggingface dataset:
rst_to_myst 0.0.1
Convert RST to MyST-Markdown.
Requires Python: >=3.6

# rst-to-myst [UNDER-DEVELOPMENT]

Convert [ReStructuredText](https://docutils.sourceforge.io/) to [MyST Markdown](https://myst-parser.readthedocs.io/).

## Install

```bash
pip install rst-to-myst
```

## Usage

CLI:

```bash
echo "some rst" | rst2myst
rst2myst -f path/to/file.rst
```

Warnings are written to `stderr` and converted text to `stdout`.

For all options see:

```bash
rst2myst --help
```

API:

```python
from rst_to_myst import convert

text, stderr_stream = convert("""
Some RST
========

To **convert**
""")
```

## Conversion Notes

The conversion is designed to be fault tolerant,
i.e. it will not check if referenced targets, roles, directives, etc exist nor fail if they do not.

The only syntax where some checks are required is matching anonymous references and auto-number/symbol footnotes with their definitions; these definitions must be available.

- enumerated lists with roman numerals or alphabetic prefixes will be converted to numbers
- only one kind of footnote (i.e. no symbol prefixes)
- citation are turned into footnotes, with label prepended by `cite_prefix`
- inline targets are not convertible (and so ignored)

## TODO

(see <https://docutils.sourceforge.io/docs/user/rst/quickref.htm>)

- nested conversion of directives (currently all wrapped in `eval-rst`)
- quote_block
- substitution definitions
- tables
- definition lists
- line block
- literal block
- field list

## Development

This package utilises [flit](https://flit.readthedocs.io) as the build engine, and [tox](https://tox.readthedocs.io) for test automation.

To install these development dependencies:

```bash
pip install flit tox
```

To run the tests:

```bash
tox
```

To run the code formatting and style checks:

```bash
pip install pre-commit
pre-commit run --all
```

## Publish to PyPi

Either use flit directly:

```bash
flit publish
```

or trigger the GitHub Action job, by creating a release with a tag equal to the version, e.g. `v0.0.1`.

Note, this requires generating an API key on PyPi and adding it to the repository `Settings/Secrets`, under the name `PYPI_KEY`.
gdon 0.1.0
gdon helps creating paper tips for the Ğ1 libre crypto-currency ; and retrieve them after expiry.
Requires Python: >=3.6

# Présentation

G1pourboire est un outil permettant de générer des pourboires en Ğ1.
En développement, ceci est une version Béta.

Il est fonctionnel en ligne de commande, mais pas (encore ?) en interface graphique. Cette contribution est bienvenue !

# Installation

Le logiciel est empaqueté et référencé sur l'index Pypi.

## Installation des dépendances DEBIAN

- `python3`
- `pip3`
- `build-essential` 
-  python3-wheel`

### Debian :

```
$ sudo apt-get install python3 python3-pip python3-dev build-essential python3-wheel
# si sur carte ARM:
$ sudo apt-get install libffi-dev

# ajouter .local/bin à votre PATH
$ echo 'export PATH="/home/$USER/.local/bin:$PATH"' >> .bash_aliases
# redémarrer votre terminal ou votre interpréteur de commande
# installer gdon
$ python3 -m pip install gdon
```


## Installation pour les devs :

Désolé, le dépôt est encore nommé "Ğ1pourboire", ancien nom du projet

```
# apt install pipenv
$ git clone https://git.duniter.org/matograine/g1pourboire.git
$ cd g1pourboire
$ pipenv install '-e .'
$ pipenv run gdon
```

# Utilisation

pour connaître toutes les commandes :
`gdon help`

* Générer et remplir des Ğ1Dons :

Les Ğ1Dons seront bloqués jusqu'à la péremption.
Le compte depuis lequel vous crééez les Ğ1Dons vous sera nécessaire pour les récupérer.

```
$ gdon generer <montant> <nombre_pages> <peremption_date_JJ/MM/AAAA> 
```
* Récupérer le contenu de Ğ1Dons :
```
$ gdon recuperer
```

* Récupérer des Ğ1Dons depuis un dossier de sauvegarde:
```
gdon recuperer<dossier>
```

* Récupérer des Ğ1Dons depuis un fichier:
```
recuperer fichier <fichier>
```

* Si la récupération s'est mal passée :
```
recuperer backup <année>
```

* Configurer le noeud Duniter :
```
gdon noeud <noeud> <port>
```

Les dons générés sont stockés par défaut dans `~/Documents/G1dons/` en pdf. 
Les fichiers de récupération sont par défaut dans ~/Documents/G1dons/Récupération. Ne pas le supprimer !
Les pourboires ne sont pas récupérables avant la date de péremption.


# TODO

- Interface graphique
- Suivi des pourboires générés
- Paquet stand-alone pour Windows