Metadata-Version: 2.1
Name: jara-utils
Version: 0.2.0
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.7,<4.0
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Topic :: Utilities
Provides-Extra: test
Requires-Dist: Faker (>=8.10.0,<9.0.0); extra == "test"
Requires-Dist: bandit (>=1.7.0,<2.0.0); extra == "test"
Requires-Dist: flake8 (>=3.9.2,<4.0.0); extra == "test"
Requires-Dist: flake8-annotations (>=2.6.2,<3.0.0); extra == "test"
Requires-Dist: flake8-builtins (>=1.5.3,<2.0.0); extra == "test"
Requires-Dist: flake8-comprehensions (>=3.5.0,<4.0.0); extra == "test"
Requires-Dist: flake8-debugger (>=4.0.0,<5.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.5.0,<2.0.0); extra == "test"
Requires-Dist: flake8-quotes (>=3.2.0,<4.0.0); extra == "test"
Requires-Dist: flake8-simplify (>=0.14.1,<0.15.0); extra == "test"
Requires-Dist: mypy (>=0.910,<0.911); extra == "test"
Requires-Dist: pytest (>=6.2.4,<7.0.0); extra == "test"
Requires-Dist: pytest-asyncio (>=0.15.1,<0.16.0); extra == "test"
Requires-Dist: pytest-cov (>=2.12.1,<3.0.0); extra == "test"
Requires-Dist: pytz (>=2021.1,<2022.0)
Requires-Dist: types-pytz (>=2021.1.0,<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

