# metadata\_please
There are a couple of pretty decent ways to read metadata (`importlib-metadata`,
and `pkginfo`) but they tend to be pretty heavyweight. This lib aims to do two
things, with as minimal dependencies as possible:
1. Support just enough metadata to be able to look up deps.
2. Do "the thing that pip does" when deciding what dist-info dir to look at.
# Usage
Example snippet to show how to get the metadata from a wheel.
```python
from zipfile import ZipFile
from metadata_please import basic_metadata_from_wheel
zf = ZipFile('somepkg.whl')
print(basic_metadata_from_wheel(zf, "somepkg"))
```
### Output
```
BasicMetadata(
reqs=[
'cli-helpers[styles] >=2.2.1',
'click >=4.1',
'configobj >=5.0.5',
'prompt-toolkit <4.0.0,>=3.0.3',
'pygments >=1.6',
'sqlparse >=0.4.4',
"behave >=1.2.6 ; extra == 'dev'",
"coverage >=7.2.7 ; extra == 'dev'",
"pexpect >=4.9.0 ; extra == 'dev'",
"pytest >=7.4.4 ; extra == 'dev'",
"pytest-cov >=4.1.0 ; extra == 'dev'",
"tox >=4.8.0 ; extra == 'dev'",
"pdbpp >=0.10.3 ; extra == 'dev'"
],
provides_extra=frozenset({'dev'}),
name='litecli',
version='1.12.4',
requires_python='>=3.7',
url=None,
project_urls={'homepage, https://github.com/dbcli/litecli': ''},
author=None,
author_email='dbcli <litecli-users@googlegroups.com>',
summary='CLI for SQLite Databases with auto-completion and syntax highlighting.',
description='# litecli\n\n[![GitHub
Actions](https://github.com/dbcli/litecli/actions/workflows/ci.yml/badge.svg)](https://github.com/dbcli/litecli/actions/workflows/ci.yml "GitHub
Actions")\n\n[Docs](https://litecli.com)\n\nA command-line client for SQLite databases that has auto-completion and syntax
highlighting.\n\n![Completion](screenshots/litecli.png)\n![CompletionGif](screenshots/litecli.gif)\n\n## Installation\n\nIf you already know how to install python
packages, then you can install it via pip:\n\nYou might need sudo on linux.\n\n```\n$ pip install -U litecli\n```\n\nThe package is also available on Arch Linux through
AUR in two versions: [litecli](https://aur.archlinux.org/packages/litecli/) is based the latest release (git tag) and
[litecli-git](https://aur.archlinux.org/packages/litecli-git/) is based on the master branch of the git repo. You can install them manually or with an AUR helper such as
`yay`:\n\n```\n$ yay -S litecli\n```\n\nor\n\n```\n$ yay -S litecli-git\n```\n\nFor MacOS users, you can also use Homebrew to install it:\n\n```\n$ brew install
litecli\n```\n\n## Usage\n\n```\n$ litecli --help\n\nUsage: litecli [OPTIONS] [DATABASE]\n\nExamples:\n - litecli sqlite_db_name\n```\n\nA config file is automatically
created at `~/.config/litecli/config` at first launch. For Windows machines a config file is created at `~\\AppData\\Local\\dbcli\\litecli\\config` at first launch. See
the file itself for a description of all available options.\n\n## Docs\n\nVisit: [litecli.com/features](https://litecli.com/features)\n',
keywords=None,
long_description_content_type='text/markdown'
)
```
The metadata can be extracted from a `wheel`, `sdist` (zip or tarball) or a source checkout (best effort). Check [`__init__.py`](metadata_please/__init__.py) file for all available functions.
# Version Compat
Usage of this library should work back to 3.7, but development (and mypy
compatibility) only on 3.10-3.12. Linting requires 3.12 for full fidelity.
# License
metadata\_please is copyright [Tim Hatch](https://timhatch.com/), and licensed under
the MIT license. I am providing code in this repository to you under an open
source license. This is my personal repository; the license you receive to
my code is from me and not from my employer. See the `LICENSE` file for details.
Raw data
{
"_id": null,
"home_page": "https://github.com/python-packaging/metadata-please/",
"name": "metadata-please",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.7",
"maintainer_email": null,
"keywords": null,
"author": "Tim Hatch",
"author_email": "tim@timhatch.com",
"download_url": "https://files.pythonhosted.org/packages/fd/6c/006d4410de8f181c089ef445b19ea12f2bc0b2e50acaec7a26b529c1f71a/metadata_please-0.2.1.tar.gz",
"platform": null,
"description": "# metadata\\_please\n\nThere are a couple of pretty decent ways to read metadata (`importlib-metadata`,\nand `pkginfo`) but they tend to be pretty heavyweight. This lib aims to do two\nthings, with as minimal dependencies as possible:\n\n1. Support just enough metadata to be able to look up deps.\n2. Do \"the thing that pip does\" when deciding what dist-info dir to look at.\n\n# Usage\n\nExample snippet to show how to get the metadata from a wheel.\n\n```python\nfrom zipfile import ZipFile\nfrom metadata_please import basic_metadata_from_wheel\n\nzf = ZipFile('somepkg.whl')\nprint(basic_metadata_from_wheel(zf, \"somepkg\"))\n```\n\n### Output\n\n```\nBasicMetadata(\n reqs=[\n 'cli-helpers[styles] >=2.2.1',\n 'click >=4.1',\n 'configobj >=5.0.5',\n 'prompt-toolkit <4.0.0,>=3.0.3',\n 'pygments >=1.6',\n 'sqlparse >=0.4.4',\n \"behave >=1.2.6 ; extra == 'dev'\",\n \"coverage >=7.2.7 ; extra == 'dev'\",\n \"pexpect >=4.9.0 ; extra == 'dev'\",\n \"pytest >=7.4.4 ; extra == 'dev'\",\n \"pytest-cov >=4.1.0 ; extra == 'dev'\",\n \"tox >=4.8.0 ; extra == 'dev'\",\n \"pdbpp >=0.10.3 ; extra == 'dev'\"\n ],\n provides_extra=frozenset({'dev'}),\n name='litecli',\n version='1.12.4',\n requires_python='>=3.7',\n url=None,\n project_urls={'homepage, https://github.com/dbcli/litecli': ''},\n author=None,\n author_email='dbcli <litecli-users@googlegroups.com>',\n summary='CLI for SQLite Databases with auto-completion and syntax highlighting.',\n description='# litecli\\n\\n[![GitHub\nActions](https://github.com/dbcli/litecli/actions/workflows/ci.yml/badge.svg)](https://github.com/dbcli/litecli/actions/workflows/ci.yml \"GitHub\nActions\")\\n\\n[Docs](https://litecli.com)\\n\\nA command-line client for SQLite databases that has auto-completion and syntax\nhighlighting.\\n\\n![Completion](screenshots/litecli.png)\\n![CompletionGif](screenshots/litecli.gif)\\n\\n## Installation\\n\\nIf you already know how to install python\npackages, then you can install it via pip:\\n\\nYou might need sudo on linux.\\n\\n```\\n$ pip install -U litecli\\n```\\n\\nThe package is also available on Arch Linux through\nAUR in two versions: [litecli](https://aur.archlinux.org/packages/litecli/) is based the latest release (git tag) and\n[litecli-git](https://aur.archlinux.org/packages/litecli-git/) is based on the master branch of the git repo. You can install them manually or with an AUR helper such as\n`yay`:\\n\\n```\\n$ yay -S litecli\\n```\\n\\nor\\n\\n```\\n$ yay -S litecli-git\\n```\\n\\nFor MacOS users, you can also use Homebrew to install it:\\n\\n```\\n$ brew install\nlitecli\\n```\\n\\n## Usage\\n\\n```\\n$ litecli --help\\n\\nUsage: litecli [OPTIONS] [DATABASE]\\n\\nExamples:\\n - litecli sqlite_db_name\\n```\\n\\nA config file is automatically\ncreated at `~/.config/litecli/config` at first launch. For Windows machines a config file is created at `~\\\\AppData\\\\Local\\\\dbcli\\\\litecli\\\\config` at first launch. See\nthe file itself for a description of all available options.\\n\\n## Docs\\n\\nVisit: [litecli.com/features](https://litecli.com/features)\\n',\n keywords=None,\n long_description_content_type='text/markdown'\n)\n\n```\n\nThe metadata can be extracted from a `wheel`, `sdist` (zip or tarball) or a source checkout (best effort). Check [`__init__.py`](metadata_please/__init__.py) file for all available functions.\n\n# Version Compat\n\nUsage of this library should work back to 3.7, but development (and mypy\ncompatibility) only on 3.10-3.12. Linting requires 3.12 for full fidelity.\n\n# License\n\nmetadata\\_please is copyright [Tim Hatch](https://timhatch.com/), and licensed under\nthe MIT license. I am providing code in this repository to you under an open\nsource license. This is my personal repository; the license you receive to\nmy code is from me and not from my employer. See the `LICENSE` file for details.\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Simple extractor for python artifact metadata",
"version": "0.2.1",
"project_urls": {
"Homepage": "https://github.com/python-packaging/metadata-please/"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "7556a083dd42ecf11ebc88d687863f4464d258d640001690406a5617cacb18c1",
"md5": "b1578456f3e35921febf7da1bc530150",
"sha256": "f25b42ed429c19d157510a59a4f0fc72d6a91bbe372d22dae36135fde2e19f29"
},
"downloads": -1,
"filename": "metadata_please-0.2.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "b1578456f3e35921febf7da1bc530150",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.7",
"size": 18660,
"upload_time": "2024-11-15T00:13:36",
"upload_time_iso_8601": "2024-11-15T00:13:36.081768Z",
"url": "https://files.pythonhosted.org/packages/75/56/a083dd42ecf11ebc88d687863f4464d258d640001690406a5617cacb18c1/metadata_please-0.2.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "fd6c006d4410de8f181c089ef445b19ea12f2bc0b2e50acaec7a26b529c1f71a",
"md5": "a63596e565cc4c569f9fef81aaa9219e",
"sha256": "886678147eb4606501a14dbf399f1325987870a05dc01a249be68dc2ada9be80"
},
"downloads": -1,
"filename": "metadata_please-0.2.1.tar.gz",
"has_sig": false,
"md5_digest": "a63596e565cc4c569f9fef81aaa9219e",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.7",
"size": 18498,
"upload_time": "2024-11-15T00:13:38",
"upload_time_iso_8601": "2024-11-15T00:13:38.131892Z",
"url": "https://files.pythonhosted.org/packages/fd/6c/006d4410de8f181c089ef445b19ea12f2bc0b2e50acaec7a26b529c1f71a/metadata_please-0.2.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-11-15 00:13:38",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "python-packaging",
"github_project": "metadata-please",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "metadata-please"
}