{"id":20910695,"url":"https://github.com/illagrenan/ares_util","last_synced_at":"2025-09-06T22:30:44.295Z","repository":{"id":12157912,"uuid":"14752505","full_name":"illagrenan/ares_util","owner":"illagrenan","description":"Nástroj pro validaci českého IČ a získávání základních dat z ARESu.","archived":false,"fork":false,"pushed_at":"2024-07-01T20:17:26.000Z","size":240,"stargazers_count":10,"open_issues_count":9,"forks_count":13,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-07-01T15:12:22.764Z","etag":null,"topics":["czechia","government-data","python","python-library"],"latest_commit_sha":null,"homepage":"https://pypi.org/project/ares_util/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/illagrenan.png","metadata":{"files":{"readme":"README.rst","changelog":"CHANGELOG.md","contributing":null,"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":"AUTHORS","dei":null,"publiccode":null,"codemeta":null}},"created_at":"2013-11-27T16:32:51.000Z","updated_at":"2024-01-04T22:23:18.000Z","dependencies_parsed_at":"2024-03-28T10:42:16.467Z","dependency_job_id":"ac19b3ac-0bd3-45da-b324-cf4c12c94fd3","html_url":"https://github.com/illagrenan/ares_util","commit_stats":{"total_commits":311,"total_committers":10,"mean_commits":31.1,"dds":0.09967845659163987,"last_synced_commit":"795621137c18004f2cfe2dd9a1a9f3a77af752f3"},"previous_names":[],"tags_count":9,"template":false,"template_full_name":null,"purl":"pkg:github/illagrenan/ares_util","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/illagrenan%2Fares_util","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/illagrenan%2Fares_util/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/illagrenan%2Fares_util/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/illagrenan%2Fares_util/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/illagrenan","download_url":"https://codeload.github.com/illagrenan/ares_util/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/illagrenan%2Fares_util/sbom","scorecard":{"id":484276,"data":{"date":"2025-08-11","repo":{"name":"github.com/illagrenan/ares_util","commit":"795621137c18004f2cfe2dd9a1a9f3a77af752f3"},"scorecard":{"version":"v5.2.1-40-gf6ed084d","commit":"f6ed084d17c9236477efd66e5b258b9d4cc7b389"},"score":2.7,"checks":[{"name":"Token-Permissions","score":0,"reason":"detected GitHub workflow tokens with excessive permissions","details":["Warn: no topLevel permission defined: .github/workflows/ci.yml:1","Info: no jobLevel write permissions found"],"documentation":{"short":"Determines if the project's workflows follow the principle of least privilege.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#token-permissions"}},{"name":"Code-Review","score":2,"reason":"Found 5/21 approved changesets -- score normalized to 2","details":null,"documentation":{"short":"Determines if the project requires human code review before pull requests (aka merge requests) are merged.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#code-review"}},{"name":"Dangerous-Workflow","score":10,"reason":"no dangerous workflow patterns detected","details":null,"documentation":{"short":"Determines if the project's GitHub Action workflows avoid dangerous patterns.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#dangerous-workflow"}},{"name":"Maintained","score":0,"reason":"0 commit(s) and 0 issue activity found in the last 90 days -- score normalized to 0","details":null,"documentation":{"short":"Determines if the project is \"actively maintained\".","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#maintained"}},{"name":"Packaging","score":-1,"reason":"packaging workflow not detected","details":["Warn: no GitHub/GitLab publishing workflow detected."],"documentation":{"short":"Determines if the project is published as a package that others can easily download, install, easily update, and uninstall.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#packaging"}},{"name":"Binary-Artifacts","score":10,"reason":"no binaries found in the repo","details":null,"documentation":{"short":"Determines if the project has generated executable (binary) artifacts in the source repository.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#binary-artifacts"}},{"name":"Pinned-Dependencies","score":0,"reason":"dependency not pinned by hash detected -- score normalized to 0","details":["Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/ci.yml:25: update your workflow using https://app.stepsecurity.io/secureworkflow/illagrenan/ares_util/ci.yml/master?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/ci.yml:28: update your workflow using https://app.stepsecurity.io/secureworkflow/illagrenan/ares_util/ci.yml/master?enable=pin","Warn: pipCommand not pinned by hash: .github/workflows/ci.yml:34","Info:   0 out of   2 GitHub-owned GitHubAction dependencies pinned","Info:   0 out of   1 pipCommand dependencies pinned"],"documentation":{"short":"Determines if the project has declared and pinned the dependencies of its build process.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#pinned-dependencies"}},{"name":"CII-Best-Practices","score":0,"reason":"no effort to earn an OpenSSF best practices badge detected","details":null,"documentation":{"short":"Determines if the project has an OpenSSF (formerly CII) Best Practices Badge.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#cii-best-practices"}},{"name":"Security-Policy","score":0,"reason":"security policy file not detected","details":["Warn: no security policy file detected","Warn: no security file to analyze","Warn: no security file to analyze","Warn: no security file to analyze"],"documentation":{"short":"Determines if the project has published a security policy.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#security-policy"}},{"name":"Fuzzing","score":0,"reason":"project is not fuzzed","details":["Warn: no fuzzer integrations found"],"documentation":{"short":"Determines if the project uses fuzzing.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#fuzzing"}},{"name":"License","score":9,"reason":"license file detected","details":["Info: project has a license file: LICENSE:0","Warn: project license file does not contain an FSF or OSI license."],"documentation":{"short":"Determines if the project has defined a license.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#license"}},{"name":"Signed-Releases","score":-1,"reason":"no releases found","details":null,"documentation":{"short":"Determines if the project cryptographically signs release artifacts.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#signed-releases"}},{"name":"Branch-Protection","score":0,"reason":"branch protection not enabled on development/release branches","details":["Warn: branch protection not enabled for branch 'master'"],"documentation":{"short":"Determines if the default and release branches are protected with GitHub's branch protection settings.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#branch-protection"}},{"name":"SAST","score":0,"reason":"SAST tool is not run on all commits -- score normalized to 0","details":["Warn: 0 commits out of 15 are checked with a SAST tool"],"documentation":{"short":"Determines if the project uses static code analysis.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#sast"}},{"name":"Vulnerabilities","score":0,"reason":"49 existing vulnerabilities detected","details":["Warn: Project is vulnerable to: PYSEC-2014-5 / GHSA-296w-6qhq-gf92","Warn: Project is vulnerable to: PYSEC-2011-2 / GHSA-3jqw-crqj-w8qw","Warn: Project is vulnerable to: PYSEC-2012-3 / GHSA-59w8-4wm2-4xw8","Warn: Project is vulnerable to: PYSEC-2012-4 / GHSA-5h2q-4hrp-v9rr","Warn: Project is vulnerable to: PYSEC-2014-6 / GHSA-625g-gx8c-xcmg","Warn: Project is vulnerable to: PYSEC-2015-8 / GHSA-6565-fg86-6jcx","Warn: Project is vulnerable to: PYSEC-2021-98 / GHSA-68w8-qjq3-2gfm","Warn: Project is vulnerable to: PYSEC-2012-2 / GHSA-78vx-ggch-wghm","Warn: Project is vulnerable to: PYSEC-2015-9 / GHSA-7fq8-4pv5-5w5c","Warn: Project is vulnerable to: PYSEC-2015-4 / GHSA-7qfw-j7hp-v45g","Warn: Project is vulnerable to: PYSEC-2011-9 / GHSA-7wph-fc4w-wqp2","Warn: Project is vulnerable to: GHSA-7xr5-9hcq-chf9","Warn: Project is vulnerable to: PYSEC-2014-2 / GHSA-89hj-xfx5-7q66","Warn: Project is vulnerable to: GHSA-8x94-hmjh-97hq","Warn: Project is vulnerable to: PYSEC-2016-2 / GHSA-c8c8-9472-w52h","Warn: Project is vulnerable to: PYSEC-2016-3 / GHSA-crhm-qpjc-cm64","Warn: Project is vulnerable to: PYSEC-2014-4 / GHSA-f7cm-ccfp-3q4r","Warn: Project is vulnerable to: PYSEC-2016-16 / GHSA-fp6p-5xvw-m74f","Warn: Project is vulnerable to: PYSEC-2011-8 / GHSA-fwr5-q9rx-294f","Warn: Project is vulnerable to: PYSEC-2015-5 / GHSA-gv98-g628-m9x5","Warn: Project is vulnerable to: PYSEC-2015-20 / GHSA-h582-2pch-3xv3","Warn: Project is vulnerable to: PYSEC-2011-5 / GHSA-h95j-h2rv-qrg4","Warn: Project is vulnerable to: GHSA-hmr4-m2h5-33qx","Warn: Project is vulnerable to: PYSEC-2015-6 / GHSA-jhjg-w2cp-5j44","Warn: Project is vulnerable to: PYSEC-2016-15 / GHSA-pw27-w7w4-9qc7","Warn: Project is vulnerable to: PYSEC-2015-10 / GHSA-q5qw-4364-5hhm","Warn: Project is vulnerable to: PYSEC-2011-4 / GHSA-rm2j-x595-q9cj","Warn: Project is vulnerable to: GHSA-rrqc-c2jx-6jgv","Warn: Project is vulnerable to: PYSEC-2014-1 / GHSA-rvq6-mrpv-m6rm","Warn: Project is vulnerable to: PYSEC-2014-7 / GHSA-rw75-m7gp-92m3","Warn: Project is vulnerable to: PYSEC-2019-16 / GHSA-vfq6-hq5r-27r6","Warn: Project is vulnerable to: PYSEC-2014-3 / GHSA-wqjj-hx84-v449","Warn: Project is vulnerable to: PYSEC-2011-3 / GHSA-wxg3-mfph-qg9w","Warn: Project is vulnerable to: PYSEC-2011-1 / GHSA-x88j-93vc-wpmp","Warn: Project is vulnerable to: PYSEC-2007-1","Warn: Project is vulnerable to: PYSEC-2008-1","Warn: Project is vulnerable to: PYSEC-2008-2","Warn: Project is vulnerable to: PYSEC-2009-3","Warn: Project is vulnerable to: PYSEC-2015-11","Warn: Project is vulnerable to: PYSEC-2015-7","Warn: Project is vulnerable to: PYSEC-2016-18","Warn: Project is vulnerable to: PYSEC-2022-304","Warn: Project is vulnerable to: PYSEC-2014-14 / GHSA-652x-xj99-gmcc","Warn: Project is vulnerable to: GHSA-9hjg-9r4m-mvj7","Warn: Project is vulnerable to: GHSA-9wx4-h78v-vm56","Warn: Project is vulnerable to: PYSEC-2014-13 / GHSA-cfj3-7x9c-4p3h","Warn: Project is vulnerable to: PYSEC-2018-28 / GHSA-x84v-xcm2-53pg","Warn: Project is vulnerable to: PYSEC-2025-49 / GHSA-5rjg-fvgr-3xxf","Warn: Project is vulnerable to: GHSA-cx63-2mw6-8hw5"],"documentation":{"short":"Determines if the project has open, known unfixed vulnerabilities.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#vulnerabilities"}}]},"last_synced_at":"2025-08-19T17:24:44.814Z","repository_id":12157912,"created_at":"2025-08-19T17:24:44.814Z","updated_at":"2025-08-19T17:24:44.814Z"},"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":273973341,"owners_count":25200575,"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","status":"online","status_checked_at":"2025-09-06T02:00:13.247Z","response_time":2576,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["czechia","government-data","python","python-library"],"created_at":"2024-11-18T14:16:42.120Z","updated_at":"2025-09-06T22:30:44.034Z","avatar_url":"https://github.com/illagrenan.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"📢 This package started in 2013 but is still working. In early 2024 it got an update (https://github.com/illagrenan/ares_util/releases/tag/v0.3.0) to work with the new API. At the moment, neither CI nor tests are working, I know that. I will set aside time this year for a bigger update (Github actions, pyproject.toml, ...).\n\nAres\\_util\n==========\n\n+----------------+-----------------------------------------------------------------------------------------------------------------+\n| Latest release | .. image:: https://img.shields.io/pypi/v/ares-util.svg                                                          |\n|                |    :target: https://pypi.python.org/pypi/ares-util                                                              |\n|                |    :alt: PyPi                                                                                                   |\n|                |                                                                                                                 |\n|                | .. image:: https://img.shields.io/badge/license-MIT-blue.svg                                                    |\n|                |    :target: https://pypi.python.org/pypi/ares-util/                                                             |\n|                |    :alt: MIT License                                                                                            |\n|                |                                                                                                                 |\n|                | .. image:: https://img.shields.io/pypi/implementation/ares-util.svg                                             |\n|                |    :target: https://pypi.python.org/pypi/ares-util/                                                             |\n|                |    :alt: Supported Python implementations                                                                       |\n|                |                                                                                                                 |\n|                | .. image:: https://img.shields.io/pypi/pyversions/ares-util.svg                                                 |\n|                |    :target: https://pypi.python.org/pypi/ares-util/                                                             |\n|                |    :alt: Supported Python versions                                                                              |\n+----------------+-----------------------------------------------------------------------------------------------------------------+\n| CI             | .. image:: https://img.shields.io/travis/illagrenan/ares_util.svg                                               |\n|                |    :target: https://travis-ci.org/illagrenan/ares_util                                                          |\n|                |    :alt: TravisCI                                                                                               |\n|                |                                                                                                                 |\n|                | .. image:: https://img.shields.io/coveralls/illagrenan/ares_util.svg                                            |\n|                |    :target: https://coveralls.io/github/illagrenan/ares_util?branch=master                                      |\n|                |    :alt: Coverage                                                                                               |\n+----------------+-----------------------------------------------------------------------------------------------------------------+\n| Dependencies   | .. image:: https://pyup.io/repos/github/illagrenan/ares_util/shield.svg                                         |\n|                |     :target: https://pyup.io/repos/github/illagrenan/ares_util/                                                 |\n|                |     :alt: Updates                                                                                               |\n+----------------+-----------------------------------------------------------------------------------------------------------------+\n\nPředstavení\n-----------\n\nJednoduchý nástroj pro validaci\\ :sup:`1` českého IČ. U předaného IČ je nejdříve ověřen jeho kontrolní součet (viz `Reference \u003chttps://github.com/illagrenan/ares_util/master/README.md#reference\u003e`__) a dle výsledku se následně zasílá požadavek na `ARES XML API \u003chttp://wwwinfo.mfcr.cz/ares/ares_xml.html.cz\u003e`__.\n\nPokud je IČ validní, vrací nástroj ``dict`` se základními údaji o firmě (obchodní název, adresa).\n\nPodmínky provozu ARES API\n-------------------------\n\n  Ministerstvo financí vyhrazuje právo omezit nebo znemožnit přístup k www aplikaci ARES uživatelům, kteří:\n\n  - odešlou k vyřízení více než 1000 dotazů v době od 8:00 hod. do 18:00 hod.,\n  - odešlou k vyřízení více než 5000 dotazů v době od 18:00 hod. do 8:00 hod. rána následujícího dne,\n  - opakovaně posílají nesprávně vyplněné dotazy,\n  - opakovaně posílají stejné dotazy,\n  - mají větší počet současně zadaných dotazů (pro automatizované XML dotazy),\n  - obcházejí povolené limity využíváním dotazování z většího množství IP adres, -\n  - automatizovaně propátrávají databázi náhodnými údaji nebo generují většinu nesprávných dotazů.\n\n  -- Zdroj: `Podmínky provozu ARES API \u003chttp://wwwinfo.mfcr.cz/ares/ares_podminky.html.cz\u003e`__.\n\nInstalace\n---------\n\nPodporované verze Pythonu jsou ``pypy``, ``pypy3``, ``2.7``, ``3.5``, ``3.6`` a ``3.7``.\n\n.. code:: shell\n\n    pip install --upgrade ares-util\n\nPoužití\n-------\n\n.. code:: shell\n\n    python\n    \u003e\u003e\u003e from ares_util.ares import call_ares\n    \u003e\u003e\u003e call_ares(42)\n    False\n    \u003e\u003e\u003e call_ares('68407700')\n    {\n        u'legal': {\n            u'company_vat_id': u'CZ68407700',\n            u'company_name': u'České vysoké učení technické v Praze',\n            u'legal_form': u'601',\n            u'company_id': u'68407700'\n        },\n        u'address': {\n            u'city': u'Praha',\n            u'region': u'Hlavní město Praha',\n            u'street': u'Zikova 1903/4',\n            u'city_part': u'Dejvice',\n            u'zip_code': u'16000'\n        }\n    }\n\nDjango podpora\n--------------\n\nPodporované verze Djanga jsou ``1.11.x`` (LTS), ``2.0.x`` a ``2.1.x``.\n\nK dispozi jsou dva `Django validátory \u003chttps://docs.djangoproject.com/en/dev/ref/validators/\u003e`__ formulářových polí:\n\n-  ``czech_company_id_numeric_validator`` - Ověřuje, zda IČ splňuje\n   statické parametry, tj. 7 nebo 8 číslic a kontrolní součet.\n-  ``czech_company_id_ares_api_validator`` - Platnost IČ ověřuje pomocí\n   ARES API. Tento validátor před ARES požadavkem rovněž ověřuje\n   statické parametry, proto by **neměly být použity oba validátory\n   zároveň**.\n\nPoužití ve formuláři\n~~~~~~~~~~~~~~~~~~~~\n\n.. code:: python\n\n    from ares_util.validators import czech_company_id_numeric_validator, czech_company_id_ares_api_validator\n    from django import forms\n\n    # forms.py\n    class DemoForm(forms.Form):\n        company_id = forms.IntegerField(required=True, validators=[czech_company_id_ares_api_validator])\n\nReference\n=========\n\n1. http://www.abclinuxu.cz/blog/bloK/2008/10/kontrola-ic,\n   http://latrine.dgx.cz/jak-overit-platne-ic-a-rodne-cislo\n\nLokální vývoj\n=============\n\nChcete-li upravit doplněk lokálně, jednoduše stáhněte zdrojové kódy a nainstalujte závislosti:\n\n.. code:: shell\n\n    pip install -r requirements.txt --upgrade\n\nTesty spustíte pomocí ``tox`` nebo ``inv test``. Využít můžete i přibalený Flask server pro lokální testování. Stačí spustit:\n\n.. code:: shell\n\n    python .\\server.py\n     * Running on http://127.0.0.1:5000/ (Press CTRL+C to quit)\n     * Restarting with stat\n\na v prohlížeči otevřít např.: ``http://127.0.0.1:5000/42``.\n\nTechnické informace\n===================\n\nXML response z ARESu je zpracována pomocí\n`xmltodict \u003chttps://github.com/martinblech/xmltodict\u003e`__.\n\nLicence\n=======\n\nThe MIT License (MIT)\n\nCopyright (c) 2013–2019 Vašek Dohnal (@illagrenan)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fillagrenan%2Fares_util","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fillagrenan%2Fares_util","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fillagrenan%2Fares_util/lists"}