# metametameta
Generate dunder metadata file with `__title__`, `__author__`, etc. Also tools to discover these in other packages.
## Installation
```bash
pipx install metametameta
```
## Usage
Defaults to putting an `__about__.py` file in the module directory, assuming your package name is your main module name.
```bash
metametameta poetry
```
Or set everything explicitly:
```bash
metametameta poetry --name "something" --source some.toml --output OUTPUT "mod/meta/__meta__.py"
```
Subcommand per source.
```text
usage: metametameta [-h] {setup_cfg,pep621,poetry,importlib} ...
metametameta: Generate __about__.py from various sources.
positional arguments:
{setup_cfg,pep621,poetry,importlib}
sub-command help
setup_cfg Generate from setup.cfg
pep621 Generate from PEP 621 pyproject.toml
poetry Generate from poetry pyproject.toml
importlib Generate from installed package metadata
options:
-h, --help show this help message and exit
```
Subcommand help (they all have the same switches)
```text
usage: metametameta poetry [-h] [--name NAME] [--source SOURCE] [--output OUTPUT]
options:
-h, --help show this help message and exit
--name NAME Name of the project (from file if omitted)
--source SOURCE Path to pyproject.toml
--output OUTPUT Output file
```
TODO: Programmatic interface.
```python
import metametameta as mmm
# not implemented yet
mmm.find_metadata("path/to/module")
```
## Motivation
There are many modern ways to get metadata about packages, as of
2024, [importlib.metadata](https://docs.python.org/3/library/importlib.metadata.html) and it's backports will get you
lots of metadata for yours and other packages.
The newest way is [PEP-621](https://peps.python.org/pep-0621/), see also [packaging.python.org](https://packaging.python.org/en/latest/specifications/pyproject-toml/#pyproject-toml-spec)
The oldest way to provide metadata was to use dunder variables in your package, e.g. `__author__`, `__version__`, etc.
The method was never strongly standardized, neither officially nor informally. [Here is one early proponent of this
sort of metadata](https://web.archive.org/web/20111010053227/http://jaynes.colorado.edu/PythonGuidelines.html#module_formatting).
- Metadata fields can appear in any or no python file in a project.
- Sometimes they are at the top of a single file python module, common locations for metadata:
- `__init__.py`
- `__meta__.py`
- `__about__.py`
- Some metadata elements could reasonably be in every single file.
- There are no particular standards for the type of `__author__`. It could be a string, space delimited string, list
or tuple. That is true for the other metadata elements as well.
- Sometimes the metadata values are code, e.g. `__version__` could be a string or some tuple or data class
representing a version.
## Workflow
On each build, regenerate the `__about__.py`. Pick one source of your canonical metadata, e.g. `pyproject.toml`,
`setup.py`, `setup.cfg`.
## Using metadata
If you have a lot of packages and you are doing analytics or something with them, you could compile all the metadata
as declared in the source code. It could be different from the metadata that shows on the PyPI page. If you are
searching for contact info for a package maintainer, this might be useful.
Another marginal use case is in error logging. Error loggers gather up info from just about anywhere, anything can
be a clue including metadata of dependencies. So this is one more source of that. See `bug_trail` for a proof of
concept for this usage.
Another marginal use case is that is a folksonomy, a taxonomy created by the people. The official metadata is
governed by the Python Packaging Authority and the Python Software Foundation. If, say, you wanted to add a metadata
item for `__mailing_address__` you could easily do it with source code metadata.
Raw data
{
"_id": null,
"home_page": "https://github.com/matthewdeanmartin/metametameta",
"name": "metametameta",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": null,
"keywords": "packagin, metadata",
"author": "Matthew Martin",
"author_email": "matthewdeanmartin@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/28/4e/d5cea961b0c18c268cb843cd0f6a6be96433c3c703197d884bfa70f3748d/metametameta-0.1.1.tar.gz",
"platform": null,
"description": "# metametameta\n\nGenerate dunder metadata file with `__title__`, `__author__`, etc. Also tools to discover these in other packages.\n\n## Installation\n\n```bash\npipx install metametameta\n```\n\n## Usage\n\nDefaults to putting an `__about__.py` file in the module directory, assuming your package name is your main module name.\n\n```bash\nmetametameta poetry\n```\n\nOr set everything explicitly:\n```bash\nmetametameta poetry --name \"something\" --source some.toml --output OUTPUT \"mod/meta/__meta__.py\"\n```\n\nSubcommand per source.\n```text\nusage: metametameta [-h] {setup_cfg,pep621,poetry,importlib} ...\n\nmetametameta: Generate __about__.py from various sources.\n\npositional arguments:\n {setup_cfg,pep621,poetry,importlib}\n sub-command help\n setup_cfg Generate from setup.cfg\n pep621 Generate from PEP 621 pyproject.toml\n poetry Generate from poetry pyproject.toml\n importlib Generate from installed package metadata\n\noptions:\n -h, --help show this help message and exit\n```\n\nSubcommand help (they all have the same switches)\n```text\nusage: metametameta poetry [-h] [--name NAME] [--source SOURCE] [--output OUTPUT]\n\noptions:\n -h, --help show this help message and exit\n --name NAME Name of the project (from file if omitted)\n --source SOURCE Path to pyproject.toml\n --output OUTPUT Output file\n```\n\nTODO: Programmatic interface.\n```python\nimport metametameta as mmm\n\n# not implemented yet\nmmm.find_metadata(\"path/to/module\")\n```\n\n## Motivation\n\nThere are many modern ways to get metadata about packages, as of\n2024, [importlib.metadata](https://docs.python.org/3/library/importlib.metadata.html) and it's backports will get you\nlots of metadata for yours and other packages.\n\nThe newest way is [PEP-621](https://peps.python.org/pep-0621/), see also [packaging.python.org](https://packaging.python.org/en/latest/specifications/pyproject-toml/#pyproject-toml-spec)\n\nThe oldest way to provide metadata was to use dunder variables in your package, e.g. `__author__`, `__version__`, etc.\n\nThe method was never strongly standardized, neither officially nor informally. [Here is one early proponent of this\nsort of metadata](https://web.archive.org/web/20111010053227/http://jaynes.colorado.edu/PythonGuidelines.html#module_formatting).\n\n- Metadata fields can appear in any or no python file in a project.\n- Sometimes they are at the top of a single file python module, common locations for metadata:\n - `__init__.py`\n - `__meta__.py`\n - `__about__.py`\n- Some metadata elements could reasonably be in every single file.\n- There are no particular standards for the type of `__author__`. It could be a string, space delimited string, list\n or tuple. That is true for the other metadata elements as well.\n- Sometimes the metadata values are code, e.g. `__version__` could be a string or some tuple or data class\n representing a version.\n\n## Workflow\n\nOn each build, regenerate the `__about__.py`. Pick one source of your canonical metadata, e.g. `pyproject.toml`,\n`setup.py`, `setup.cfg`.\n\n## Using metadata\n\nIf you have a lot of packages and you are doing analytics or something with them, you could compile all the metadata\nas declared in the source code. It could be different from the metadata that shows on the PyPI page. If you are\nsearching for contact info for a package maintainer, this might be useful.\n\nAnother marginal use case is in error logging. Error loggers gather up info from just about anywhere, anything can\nbe a clue including metadata of dependencies. So this is one more source of that. See `bug_trail` for a proof of\nconcept for this usage.\n\nAnother marginal use case is that is a folksonomy, a taxonomy created by the people. The official metadata is\ngoverned by the Python Packaging Authority and the Python Software Foundation. If, say, you wanted to add a metadata\nitem for `__mailing_address__` you could easily do it with source code metadata.\n\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Generate __about__.py with dunder meta.",
"version": "0.1.1",
"project_urls": {
"Bug Tracker": "https://github.com/matthewdeanmartin/metametameta/issues",
"Change Log": "https://github.com/matthewdeanmartin/metametameta/blob/main/CHANGELOG.md",
"Documentation": "https://matthewdeanmartin.github.io/metametameta/metametameta/index.html",
"Homepage": "https://github.com/matthewdeanmartin/metametameta",
"Repository": "https://github.com/matthewdeanmartin/metametameta"
},
"split_keywords": [
"packagin",
" metadata"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "f0deef0bcafdef2c83b69794836fb73ce6e833096d9119456838865e333a94fe",
"md5": "173c0a78d495e5d4902308c9a3d8e975",
"sha256": "ed965042c2aef558e9e6499327b38a1165ea469171005070165f8aa719f064b4"
},
"downloads": -1,
"filename": "metametameta-0.1.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "173c0a78d495e5d4902308c9a3d8e975",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 15043,
"upload_time": "2024-08-03T16:17:25",
"upload_time_iso_8601": "2024-08-03T16:17:25.329244Z",
"url": "https://files.pythonhosted.org/packages/f0/de/ef0bcafdef2c83b69794836fb73ce6e833096d9119456838865e333a94fe/metametameta-0.1.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "284ed5cea961b0c18c268cb843cd0f6a6be96433c3c703197d884bfa70f3748d",
"md5": "b2908b8671df4b51cd9a93c9a36245f6",
"sha256": "86bfb063f93a895065823dd6cbc21a49083a979b87083c3f6b6d2899d1dcdca0"
},
"downloads": -1,
"filename": "metametameta-0.1.1.tar.gz",
"has_sig": false,
"md5_digest": "b2908b8671df4b51cd9a93c9a36245f6",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 13696,
"upload_time": "2024-08-03T16:17:26",
"upload_time_iso_8601": "2024-08-03T16:17:26.648078Z",
"url": "https://files.pythonhosted.org/packages/28/4e/d5cea961b0c18c268cb843cd0f6a6be96433c3c703197d884bfa70f3748d/metametameta-0.1.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-08-03 16:17:26",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "matthewdeanmartin",
"github_project": "metametameta",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"tox": true,
"lcname": "metametameta"
}
JSON
