semvec/pypi-packages huggingface dataset:
foliantcontrib.imagineui 1.0.0
ImagineUI integration preprocessor for Foliant.
License: MIT

[![](https://img.shields.io/pypi/v/foliantcontrib.imagineui.svg)](https://pypi.org/project/foliantcontrib.imagineui/) [![](https://img.shields.io/github/v/tag/imagineui/foliantcontrib.imagineui.svg?label=GitHub)](https://github.com/imagineui/foliantcontrib.imagineui)

# ImagineUI for Foliant

ImagineUI is a tool that supports developing wireframes in a localized human-readable format.

This preprocessor allows using `<imagineui>` macros in Foliant

## Installation

Before using ImagineUI, you need to install [Node.js](https://nodejs.org/en/).

ImagineUI preprocessor code is written in Python, but it uses a JavaScript package. This script is provided in ImagineUI package:

```bash
$ pip install foliantcontrib.imagineui
```

ImagineUI uses Puppeteer for rendering in background, which is a huge dependency, so to avoid downloading Chrome every time this preprocessor applies, it's advised to install `imagineui-cli` globally.

```bash
$ npm i -g imagineui-cli 
```

## Config

To enable the preprocessor, add `imagineui` to `preprocessors` section in the project config:

```yaml
preprocessors:
    - imagineui
```

The preprocessor has a number of options with the following default values:

```yaml
preprocessors:
    - imagineui:
        version: global
        cache_dir: !path .imagineuicache
```

`version`
:   Version of the `imagineui-cli` package in NPM. "global" (default) will skip and will use either the version already installed globally or the latest version, which speeds up NPX significantly. 

`cache_dir`
:   Directory to store downloaded and resized images.

## Usage

To insert a wireframe image rendered by ImagineUI into your documentation, use `<imagineui>...</imagineui>` tags in Markdown source:

```markdown
<imagineui>
    Page: "Welcome screen"
    Block: "Header"
        Header "Mockup poetry"
    Block: "Flowers"
        Two columns
            Image "Roses are red,"
            Image "Violets are blue."
            Image "Your mockups are awesome,"
            Image "And so are you!"
    Block: "Footer"
        One row
            Button "Try ImagineUI"
            Button "Subscribe"
            Button "Contribute"
</imagineui>
```

ImagineUI preprocessor will replace such blocks with local image references.


## Acknowledgements
[BindSympli](https://github.com/foliant-docs/foliantcontrib.bindsympli) preprocessor was used as a starting point
realpython-reader-pm 1.0.0
Read the latest Real Python tutorials - PM
License: MIT

# Real Python Feed Reader

The Real Python Feed Reader is a basic [web feed](https://en.wikipedia.org/wiki/Web_feed) reader that can download the latest Real Python tutorials from the [Real Python feed](https://realpython.com/contact/#rss-atom-feed).

For more information see the tutorial [How to Publish an Open-Source Python Package to PyPI](https://realpython.com/pypi-publish-python-package/) on Real Python.

## Installation

You can install the Real Python Feed Reader from [PyPI](https://pypi.org/project/realpython-reader/):

    pip install realpython-reader

The reader is supported on Python 2.7, as well as Python 3.4 and above.

## How to use

The Real Python Feed Reader is a command line application, named `realpython`. To see a list of the [latest Real Python tutorials](https://realpython.com/) simply call the program:

    $ realpython
    The latest tutorials from Real Python (https://realpython.com/)
     0 How to Publish an Open-Source Python Package to PyPI
     1 Python "while" Loops (Indefinite Iteration)
     2 Writing Comments in Python (Guide)
     3 Setting Up Python for Machine Learning on Windows
     4 Python Community Interview With Michael Kennedy
     5 Practical Text Classification With Python and Keras
     6 Getting Started With Testing in Python
     7 Python, Boto3, and AWS S3: Demystified
     8 Python's range() Function (Guide)
     9 Python Community Interview With Mike Grouchy
    10 How to Round Numbers in Python
    11 Building and Documenting Python REST APIs With Flask and Connexion – Part 2
    12 Splitting, Concatenating, and Joining Strings in Python
    13 Image Segmentation Using Color Spaces in OpenCV + Python
    14 Python Community Interview With Mahdi Yusuf
    15 Absolute vs Relative Imports in Python
    16 Top 10 Must-Watch PyCon Talks
    17 Logging in Python
    18 The Best Python Books
    19 Conditional Statements in Python

To read one particular tutorial, call the program with the numerical ID of the tutorial as a parameter:

    $ realpython 0
    # How to Publish an Open-Source Python Package to PyPI

    Python is famous for coming with batteries included. Sophisticated
    capabilities are available in the standard library. You can find modules for
    working with sockets, parsing CSV, JSON, and XML files, and working with
    files and file paths.

    However great the packages included with Python are, there are many
    fantastic projects available outside the standard library. These are most
    often hosted at the Python Packaging Index (PyPI), historically known as the
    Cheese Shop. At PyPI, you can find everything from Hello World to advanced
    deep learning libraries.

    [... The full text of the article ...]

You can also call the Real Python Feed Reader in your own Python code, by importing from the `reader` package:

    >>> from reader import feed
    >>> feed.get_titles()
    ['How to Publish an Open-Source Python Package to PyPI', ...]