{"id":19657731,"url":"https://github.com/esss/barril","last_synced_at":"2025-04-05T17:07:51.096Z","repository":{"id":32052428,"uuid":"131463510","full_name":"ESSS/barril","owner":"ESSS","description":"Python package to manage units for physical quantities","archived":false,"fork":false,"pushed_at":"2025-03-05T10:47:34.000Z","size":1142,"stargazers_count":39,"open_issues_count":5,"forks_count":11,"subscribers_count":18,"default_branch":"master","last_synced_at":"2025-03-29T16:08:59.340Z","etag":null,"topics":["hacktoberfest","units-converter","units-of-measure"],"latest_commit_sha":null,"homepage":"https://barril.readthedocs.io","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ESSS.png","metadata":{"files":{"readme":"README.rst","changelog":"CHANGELOG.rst","contributing":"CONTRIBUTING.rst","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2018-04-29T03:39:13.000Z","updated_at":"2025-03-05T10:47:38.000Z","dependencies_parsed_at":"2023-10-17T01:58:18.188Z","dependency_job_id":"e60a5322-8469-4cd5-98f9-abdbefc010db","html_url":"https://github.com/ESSS/barril","commit_stats":{"total_commits":229,"total_committers":29,"mean_commits":7.896551724137931,"dds":0.7641921397379913,"last_synced_commit":"14cd560d3a1078d705fc3ce88ddc21a9b00a7f06"},"previous_names":[],"tags_count":27,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ESSS%2Fbarril","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ESSS%2Fbarril/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ESSS%2Fbarril/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ESSS%2Fbarril/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ESSS","download_url":"https://codeload.github.com/ESSS/barril/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247369952,"owners_count":20927928,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["hacktoberfest","units-converter","units-of-measure"],"created_at":"2024-11-11T15:33:24.628Z","updated_at":"2025-04-05T17:07:51.075Z","avatar_url":"https://github.com/ESSS.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"======\nBarril\n======\n\n\n.. image:: https://img.shields.io/pypi/v/barril.svg\n    :target: https://pypi.python.org/pypi/barril\n\n.. image:: https://img.shields.io/pypi/pyversions/barril.svg\n    :target: https://pypi.org/project/barril\n\n.. image:: https://github.com/ESSS/barril/workflows/test/badge.svg\n    :target: https://github.com/ESSS/barril/actions\n\n.. image:: https://codecov.io/gh/ESSS/barril/branch/master/graph/badge.svg\n    :target: https://codecov.io/gh/ESSS/barril\n\n.. image:: https://img.shields.io/readthedocs/barril.svg\n    :target: https://barril.readthedocs.io/en/latest/\n\n.. image:: https://sonarcloud.io/api/project_badges/measure?project=ESSS_barril\u0026metric=alert_status\n    :target: https://sonarcloud.io/project/overview?id=ESSS_barril\n\n\nWhat is Barril?\n===============\n\nPython package to manage units for physical quantities.\n\nQuick example:\n\n.. code-block:: python\n\n    from barril.units import Scalar\n\n    s1 = Scalar(10, \"m\")\n    s2 = Scalar(500, \"cm\")\n    assert s1 + s2 == Scalar(15, \"m\")\n\n\nFeatures\n--------\n\n* Pre-defined unit database containing several physical quantities for the Oil \u0026 Gas industry.\n* Data types with an associated unit: ``Scalar``, ``Array``, ``Quantity``, ``FixedArray``.\n* Automatic conversion during arithmetic operations.\n\nDevelopment\n-----------\n\nFor complete description of what type of contributions are possible,\nsee the full `CONTRIBUTING \u003cCONTRIBUTING.rst\u003e`_ guide.\n\nHere is a quick summary of the steps necessary to setup your environment to contribute to ``barril``.\n\n#. Create a virtual environment and activate it::\n\n    $ python -m virtualenv .env\n    $ .env\\Scripts\\activate  # windows\n    $ source .env/bin/activate  # linux\n\n\n   .. note::\n\n       If you use ``conda``, you can install ``virtualenv`` in the root environment::\n\n           $ conda install -n root virtualenv\n\n       Don't worry as this is safe to do.\n\n#. Update ``pip``::\n\n    $ python -m pip install -U pip\n\n#. Install development dependencies::\n\n    $ pip install -e .[testing]\n\n#. Install pre-commit::\n\n    $ pre-commit install\n\n#. Run tests::\n\n    $ pytest --pyargs barril\n\n#. Generate docs locally::\n\n    $ tox -e docs\n\n   The documentation files will be generated in ``docs/_build``.\n\nRelease\n-------\n\nA reminder for the maintainers on how to make a new release.\n\nNote that the VERSION should folow the semantic versioning as X.Y.Z\nEx.: v1.0.5\n\n1. Create a ``release-VERSION`` branch from ``upstream/master``.\n2. Update ``CHANGELOG.rst``.\n3. Push a branch with the changes.\n4. Once all builds pass, push a ``VERSION`` tag to ``upstream``.\n5. Merge the PR.\n\nCredits\n-------\n\nThis package was created with Cookiecutter_ and the `audreyr/cookiecutter-pypackage`_ project template.\n\n.. _`audreyr/cookiecutter-pypackage`: https://github.com/audreyr/cookiecutter-pypackage\n.. _`GitHub page` :                   https://github.com/ESSS/barril\n.. _Cookiecutter:                     https://github.com/audreyr/cookiecutter\n.. _pytest:                           https://github.com/pytest-dev/pytest\n.. _tox:                              https://github.com/tox-dev/tox\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fesss%2Fbarril","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fesss%2Fbarril","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fesss%2Fbarril/lists"}