Metadata-Version: 2.1
Name: jara-utils
Version: 0.3.1
Summary: A package with basic stuff.
Home-page: https://github.com/senciucserban/jara-utils
Author: Serban Senciuc
Author-email: senciuc.serban@gmail.com
Requires-Python: >=3.8,<4.0
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Topic :: Utilities
Provides-Extra: test
Requires-Dist: Faker (>=13.3.4,<14.0.0); extra == "test"
Requires-Dist: bandit (>=1.7.4,<2.0.0); extra == "test"
Requires-Dist: flake8 (>=4.0.1,<5.0.0); extra == "test"
Requires-Dist: flake8-annotations (>=2.8.0,<3.0.0); extra == "test"
Requires-Dist: flake8-builtins (>=1.5.3,<2.0.0); extra == "test"
Requires-Dist: flake8-commas (>=2.1.0,<3.0.0); extra == "test"
Requires-Dist: flake8-comprehensions (>=3.8.0,<4.0.0); extra == "test"
Requires-Dist: flake8-debugger (>=4.0.0,<5.0.0); extra == "test"
Requires-Dist: flake8-eradicate (>=1.2.0,<2.0.0); extra == "test"
Requires-Dist: flake8-multiline-containers (>=0.0.18,<0.0.19); extra == "test"
Requires-Dist: flake8-print (>=4.0.0,<5.0.0); extra == "test"
Requires-Dist: flake8-pytest-style (>=1.6.0,<2.0.0); extra == "test"
Requires-Dist: flake8-quotes (>=3.3.1,<4.0.0); extra == "test"
Requires-Dist: flake8-simplify (>=0.19.2,<0.20.0); extra == "test"
Requires-Dist: mypy (>=0.942,<0.943); extra == "test"
Requires-Dist: pytest (>=7.1.1,<8.0.0); extra == "test"
Requires-Dist: pytest-asyncio (>=0.18.3,<0.19.0); extra == "test"
Requires-Dist: pytest-cov (>=3.0.0,<4.0.0); extra == "test"
Requires-Dist: pytz (>=2022.1,<2023.0)
Requires-Dist: types-pytz (>=2021.3.6,<2022.0.0)
Project-URL: Repository, https://github.com/senciucserban/jara-utils
Description-Content-Type: text/x-rst

=================
Jara core package
=================

    Jara means bear in `Sesotho`_.

.. image:: https://img.shields.io/badge/python-3.7.x-blue.svg
    :alt: Python 3.7.x

.. image:: https://img.shields.io/badge/code_style-flake8-brightgreen.svg
    :alt: Flake8

.. image:: https://img.shields.io/badge/dependency_manager-poetry-blueviolet.svg
    :alt: Poetry

Why?
~~~~
Sometimes I start a new project and I need to implement again same methods and after create tests for each method. This package will provide common methods like ``str_2_bool`` or other methods check ``README.rst`` for all methods available.

How to contribute to the package?
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Clone project locally and then:
    * Install all dependencies including the test and the dev oanes: ``poetry install -E test -D``;
    * Do changes in the project;
    * Create unittests (please make sure  you will keep coverage to 100%);
    * Run all sanity commands (pytest, flake8, mypy, bandit);
    * Check if there is any duplicated or dead fixtures by running ``pytest`` with ``--dead-fixtures`` and ``--dup-fixtures``;

Note: Run commands using poetry: ``poetry run <command>``;

What you will find in this package?
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Basically will contain utils methods to avoid write them in all projects. Some examples:

* decorator to benchmark methods;
* methods to handle environment variables;
* some utils methods such as: ``snake_2_camel``, ``str_2_bool``.


.. _Sesotho: https://en.wikipedia.org/wiki/Sotho_language

