semvec/pypi-packages huggingface dataset:
py-allenite 0.2.0
Python wrapper for Allenite's API.
Keywords: python,allenite

===========
Py-Allenite
===========

Py-Allenite is a full-fleged Python wrapper to develop applications integrating Allenite's API.

|PyPi| |Documentation| |License| |Followers|

.. |License| image:: https://img.shields.io/github/license/lamergameryt/py-allenite
.. |Followers| image:: https://img.shields.io/github/followers/lamergameryt?style=social
.. |Documentation| image:: https://readthedocs.org/projects/pyallenite/badge/?version=latest
.. |PyPi| image:: https://badge.fury.io/py/py-allenite.svg
    :target: https://badge.fury.io/py/py-allenite

⏩ Quick Example
----------------

In this example, we will fetch a random meme using the API.

``main.py``

.. code-block:: python

    from allenite_api import AlleniteClient

    client = AlleniteClient()
    meme = client.get_random_meme()

    # The 0th index is the title and the 1st index is the image url.
    print(meme[0], ':', meme[1])


👩‍🏫 Installation
------------------

::

    pip install py-allenite

📈 Required Python Modules
--------------------------

The list of required python modules can be found in the ``requirements.txt`` file.

📜 Documentation
----------------

To view the documentation for this project, visit the `documentation page <https://pyallenite.readthedocs.io/en/latest/>`_.
ingot-psql 0.1.0
Provides integration with the PostgresQL DB for Ingots projects

# Ingot Psql Ingot package.

Provides integration with the PostgresQL DB for Ingots projects

## For consumers

For using the Ingot package just execute the following commands:
* Add the package to the `requirements.txt` file of your project.
* Install int using the `pip` tool.
* TODO. Add here something extra information.

### Package CLI

The package provides CLI.
It allows to start working with the package quickly.
It contains the following commands:
TODO. Add builders here after generating their by the `ingots package_bootstrap` tool.

For using the CLI tool just call the following command:
```bash
ingot-psql-cli <command>
```
Getting package CLI help:
```bash
ingot-psql-cli --help
ingot-psql-cli <command> --help
```

## For developers

### Prepare the project for working

Clone a repository:
```bash
mkdir ingots-libs
cd ingots-libs
git clone https://github.com/ABKorotky/ingot-postgresql.git
cd ingot-psql
```

Prepare a virtual environment:
```bash
python3.9 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
```

Prepare repository hooks
```bash
pip install pre_commit
pre-commit install
pre-commit autoupdate
```

Configure code-quality tools:
```bash
pip install black flake8 mypy coverage
```

Configure the Sphinx tool

Please, use the following page for configuring the Sphinx documentation generator: [Sphinx](https://www.sphinx-doc.org/en/master/usage/installation.html)
```bash
pip install sphinx
sphinx-build -b html docs docs/build -v
```

### Using the tox tool

The Ingot package allows automation via the `tox` tool.
```bash
pip install tox
```

Use configured tox tool for several activities.

`tox -e reformat` - auto reformat code by the black tool, makes ordering import too.

`tox -e cs` - checks code style by PEP8.

`tox -e ann` - checks annotations of types by the mypy tool.

`tox -e utc` - runs unittests with the coverage tool.

`tox -e report` - builds coverage report for the project.

`tox -e doc` - builds a package documentation.

`tox -e build` - builds a package form current branch / tag / commit.

`tox -e upload` - uploads package to the PyPI index. Set the `PYPI_REPOSITORY_ALIAS` virtual variable for specify PyPI destination.

Calling tox without parameters will execute the following steps: **cs**, **ann**, **utc** and **report**.

### Using package CLI locally
Obviously, it's impossible to call the package CLI via package entry-point.

Use the following command instead:
```bash
python -m ingot_psql.scripts.ingot_psql ...
```