awesome-list-generator


Nameawesome-list-generator JSON
Version 0.1.6 PyPI version JSON
download
home_pageNone
Summary๐Ÿ“šโœจ Automate awesome lists with GitHub metadata & markdown magic!
upload_time2025-02-23 01:41:43
maintainerNone
docs_urlNone
authorNone
requires_python<4,>=3.12
licenseNone
keywords automation awesome cli data-visualization dependency-management documentation github-api markdown project-management python
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            <div align="center"><a name="readme-top"></a>

<img height="160" src="https://raw.githubusercontent.com/sindresorhus/awesome/refs/heads/main/media/logo.svg" />

<h1>Awesome List Generator</h1>

Awesome List Generator is a powerful Python tool for creating and maintaining curated lists of awesome projects. It supports multiple formats, integrates with GitHub for project metadata, and provides customizable templates for generating professional-looking lists with rich project details.

[![PyPI - Version](https://img.shields.io/pypi/v/awesome-list-generator?logo=PyPI&logoColor=3775A9&label=PyPI)](https://pypi.org/project/awesome-list-generator/)
[![PyPI - Downloads](https://img.shields.io/pypi/dm/awesome-list-generator?logo=PyPI&logoColor=3775A9)](https://pypi.org/project/awesome-list-generator/)
[![PyPI - Python Version](https://img.shields.io/pypi/pyversions/awesome-list-generator?logo=Python&logoColor=3776AB&label=Python)](https://pypi.org/project/awesome-list-generator/) <br />
[![GitHub contributors](https://img.shields.io/github/contributors/liblaf/awesome-list-generator)](https://github.com/liblaf/awesome-list-generator/graphs/contributors)
[![GitHub forks](https://img.shields.io/github/forks/liblaf/awesome-list-generator)](https://github.com/liblaf/awesome-list-generator/forks)
[![GitHub Repo stars](https://img.shields.io/github/stars/liblaf/awesome-list-generator)](https://github.com/liblaf/awesome-list-generator/stargazers)
[![GitHub Issues](https://img.shields.io/github/issues/liblaf/awesome-list-generator)](https://github.com/liblaf/awesome-list-generator/issues)
[![GitHub License](https://img.shields.io/github/license/liblaf/awesome-list-generator)](https://github.com/liblaf/awesome-list-generator/blob/main/LICENSE)

[Changelog](https://github.com/liblaf/awesome-list-generator/blob/main/CHANGELOG.md) ยท [Report Bug](https://github.com/liblaf/awesome-list-generator/issues) ยท [Request Feature](https://github.com/liblaf/awesome-list-generator/issues)

![banner](https://raw.githubusercontent.com/andreasbm/readme/master/assets/lines/rainbow.png)

</div>

## โœจ Features

- ๐Ÿ“œ **Markdown Generation:** Automatically generates beautiful and structured Markdown files for awesome lists, complete with badges, descriptions, and project statistics;
- ๐Ÿš€ **GitHub Integration:** Seamlessly fetches project information from GitHub, including stars, forks, issues, pull requests, and license details;
- ๐Ÿงฉ **Plugin Architecture:** Extensible plugin system allows for easy integration of additional data sources and formats beyond GitHub;
- ๐ŸŽจ **Customizable Formatting:** Supports multiple output formats (currently Markdown) with customizable templates for different presentation styles;
- โšก **Async Performance:** Built with asyncio for efficient concurrent fetching of project data from multiple sources;
- ๐Ÿ” **Project Categorization:** Automatically organizes projects into categories with customizable titles and subtitles;
- ๐Ÿ› ๏ธ **CLI Interface:** Easy-to-use command-line interface for generating lists with a single command;
- ๐Ÿงช **Type Safety:** Fully type-annotated codebase with Pydantic models for robust data validation and IDE support;
- ๐Ÿงฐ **Dependency Management:** Uses modern Python packaging tools (Hatch) for clean dependency management and reproducible builds;
- ๐Ÿค– **Automation Ready:** Includes GitHub Actions workflows for automated testing, linting, and releases.

<div align="right">

[![BACK TO TOP](https://img.shields.io/badge/-BACK_TO_TOP-black?style=flat-square)](#readme-top)

</div>

## ๐Ÿ“ฆ Installation

To install `awesome-list-generator`, run the following command:

```bash
uv tool install awesome-list-generator
```

<div align="right">

[![BACK TO TOP](https://img.shields.io/badge/-BACK_TO_TOP-black?style=flat-square)](#readme-top)

</div>

## โŒจ๏ธ Local Development

You can use Github Codespaces for online development:

[![Open in GitHub Codespaces](https://github.com/codespaces/badge.svg)](https://codespaces.new/liblaf/awesome-list-generator)

Or clone it for local development:

```bash
git clone https://github.com/liblaf/awesome-list-generator.git
cd lime
uv sync
```

<div align="right">

[![BACK TO TOP](https://img.shields.io/badge/-BACK_TO_TOP-black?style=flat-square)](#readme-top)

</div>

## ๐Ÿค Contributing

Contributions of all types are more than welcome, if you are interested in contributing code, feel free to check out our GitHub [Issues](https://github.com/liblaf/awesome-list-generator/issues) to get stuck in to show us what you're made of.

[![๐Ÿคฏ PR WELCOME](https://img.shields.io/badge/%F0%9F%A4%AF%20PR%20WELCOME-%E2%86%92-ffcb47?labelColor=black&style=for-the-badge)](https://github.com/liblaf/awesome-list-generator/pulls)

[![Contributors](https://contrib.rocks/image?repo=liblaf%2Flime)](https://github.com/liblaf/awesome-list-generator/graphs/contributors)

<div align="right">

[![BACK TO TOP](https://img.shields.io/badge/-BACK_TO_TOP-black?style=flat-square)](#readme-top)

</div>

---

#### ๐Ÿ“ License

Copyright ยฉ 2025 [liblaf](https://github.com/liblaf). <br />
This project is [MIT](https://github.com/liblaf/awesome-list-generator/blob/main/LICENSE) licensed.

            

Raw data

            {
    "_id": null,
    "home_page": null,
    "name": "awesome-list-generator",
    "maintainer": null,
    "docs_url": null,
    "requires_python": "<4,>=3.12",
    "maintainer_email": null,
    "keywords": "automation, awesome, cli, data-visualization, dependency-management, documentation, github-api, markdown, project-management, python",
    "author": null,
    "author_email": "liblaf <30631553+liblaf@users.noreply.github.com>",
    "download_url": "https://files.pythonhosted.org/packages/25/e9/bfb5d9052a645bf5be77e340b0b05eff59a6772354ff84c8ef852aa36366/awesome_list_generator-0.1.6.tar.gz",
    "platform": null,
    "description": "<div align=\"center\"><a name=\"readme-top\"></a>\n\n<img height=\"160\" src=\"https://raw.githubusercontent.com/sindresorhus/awesome/refs/heads/main/media/logo.svg\" />\n\n<h1>Awesome List Generator</h1>\n\nAwesome List Generator is a powerful Python tool for creating and maintaining curated lists of awesome projects. It supports multiple formats, integrates with GitHub for project metadata, and provides customizable templates for generating professional-looking lists with rich project details.\n\n[![PyPI - Version](https://img.shields.io/pypi/v/awesome-list-generator?logo=PyPI&logoColor=3775A9&label=PyPI)](https://pypi.org/project/awesome-list-generator/)\n[![PyPI - Downloads](https://img.shields.io/pypi/dm/awesome-list-generator?logo=PyPI&logoColor=3775A9)](https://pypi.org/project/awesome-list-generator/)\n[![PyPI - Python Version](https://img.shields.io/pypi/pyversions/awesome-list-generator?logo=Python&logoColor=3776AB&label=Python)](https://pypi.org/project/awesome-list-generator/) <br />\n[![GitHub contributors](https://img.shields.io/github/contributors/liblaf/awesome-list-generator)](https://github.com/liblaf/awesome-list-generator/graphs/contributors)\n[![GitHub forks](https://img.shields.io/github/forks/liblaf/awesome-list-generator)](https://github.com/liblaf/awesome-list-generator/forks)\n[![GitHub Repo stars](https://img.shields.io/github/stars/liblaf/awesome-list-generator)](https://github.com/liblaf/awesome-list-generator/stargazers)\n[![GitHub Issues](https://img.shields.io/github/issues/liblaf/awesome-list-generator)](https://github.com/liblaf/awesome-list-generator/issues)\n[![GitHub License](https://img.shields.io/github/license/liblaf/awesome-list-generator)](https://github.com/liblaf/awesome-list-generator/blob/main/LICENSE)\n\n[Changelog](https://github.com/liblaf/awesome-list-generator/blob/main/CHANGELOG.md) \u00b7 [Report Bug](https://github.com/liblaf/awesome-list-generator/issues) \u00b7 [Request Feature](https://github.com/liblaf/awesome-list-generator/issues)\n\n![banner](https://raw.githubusercontent.com/andreasbm/readme/master/assets/lines/rainbow.png)\n\n</div>\n\n## \u2728 Features\n\n- \ud83d\udcdc **Markdown Generation:** Automatically generates beautiful and structured Markdown files for awesome lists, complete with badges, descriptions, and project statistics;\n- \ud83d\ude80 **GitHub Integration:** Seamlessly fetches project information from GitHub, including stars, forks, issues, pull requests, and license details;\n- \ud83e\udde9 **Plugin Architecture:** Extensible plugin system allows for easy integration of additional data sources and formats beyond GitHub;\n- \ud83c\udfa8 **Customizable Formatting:** Supports multiple output formats (currently Markdown) with customizable templates for different presentation styles;\n- \u26a1 **Async Performance:** Built with asyncio for efficient concurrent fetching of project data from multiple sources;\n- \ud83d\udd0d **Project Categorization:** Automatically organizes projects into categories with customizable titles and subtitles;\n- \ud83d\udee0\ufe0f **CLI Interface:** Easy-to-use command-line interface for generating lists with a single command;\n- \ud83e\uddea **Type Safety:** Fully type-annotated codebase with Pydantic models for robust data validation and IDE support;\n- \ud83e\uddf0 **Dependency Management:** Uses modern Python packaging tools (Hatch) for clean dependency management and reproducible builds;\n- \ud83e\udd16 **Automation Ready:** Includes GitHub Actions workflows for automated testing, linting, and releases.\n\n<div align=\"right\">\n\n[![BACK TO TOP](https://img.shields.io/badge/-BACK_TO_TOP-black?style=flat-square)](#readme-top)\n\n</div>\n\n## \ud83d\udce6 Installation\n\nTo install `awesome-list-generator`, run the following command:\n\n```bash\nuv tool install awesome-list-generator\n```\n\n<div align=\"right\">\n\n[![BACK TO TOP](https://img.shields.io/badge/-BACK_TO_TOP-black?style=flat-square)](#readme-top)\n\n</div>\n\n## \u2328\ufe0f Local Development\n\nYou can use Github Codespaces for online development:\n\n[![Open in GitHub Codespaces](https://github.com/codespaces/badge.svg)](https://codespaces.new/liblaf/awesome-list-generator)\n\nOr clone it for local development:\n\n```bash\ngit clone https://github.com/liblaf/awesome-list-generator.git\ncd lime\nuv sync\n```\n\n<div align=\"right\">\n\n[![BACK TO TOP](https://img.shields.io/badge/-BACK_TO_TOP-black?style=flat-square)](#readme-top)\n\n</div>\n\n## \ud83e\udd1d Contributing\n\nContributions of all types are more than welcome, if you are interested in contributing code, feel free to check out our GitHub [Issues](https://github.com/liblaf/awesome-list-generator/issues) to get stuck in to show us what you're made of.\n\n[![\ud83e\udd2f PR WELCOME](https://img.shields.io/badge/%F0%9F%A4%AF%20PR%20WELCOME-%E2%86%92-ffcb47?labelColor=black&style=for-the-badge)](https://github.com/liblaf/awesome-list-generator/pulls)\n\n[![Contributors](https://contrib.rocks/image?repo=liblaf%2Flime)](https://github.com/liblaf/awesome-list-generator/graphs/contributors)\n\n<div align=\"right\">\n\n[![BACK TO TOP](https://img.shields.io/badge/-BACK_TO_TOP-black?style=flat-square)](#readme-top)\n\n</div>\n\n---\n\n#### \ud83d\udcdd License\n\nCopyright \u00a9 2025 [liblaf](https://github.com/liblaf). <br />\nThis project is [MIT](https://github.com/liblaf/awesome-list-generator/blob/main/LICENSE) licensed.\n",
    "bugtrack_url": null,
    "license": null,
    "summary": "\ud83d\udcda\u2728 Automate awesome lists with GitHub metadata & markdown magic!",
    "version": "0.1.6",
    "project_urls": {
        "Changelog": "https://github.com/liblaf/awesome-list-generator/blob/main/CHANGELOG.md",
        "Homepage": "https://github.com/liblaf/awesome-list-generator",
        "Issue Tracker": "https://github.com/liblaf/awesome-list-generator/issues",
        "Release Notes": "https://github.com/liblaf/awesome-list-generator/releases",
        "Source Code": "https://github.com/liblaf/awesome-list-generator"
    },
    "split_keywords": [
        "automation",
        " awesome",
        " cli",
        " data-visualization",
        " dependency-management",
        " documentation",
        " github-api",
        " markdown",
        " project-management",
        " python"
    ],
    "urls": [
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "9f152a9e3dcb3ceb73ad7a96b433e6f00f0069e9ac9f06f5d2fbd1fad4204c3b",
                "md5": "48870180fcc21be4773b462fe9e19437",
                "sha256": "abceb15495343e30f1b2542fa4d264299f609df84f42641cb94a4efce084080b"
            },
            "downloads": -1,
            "filename": "awesome_list_generator-0.1.6-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "48870180fcc21be4773b462fe9e19437",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": "<4,>=3.12",
            "size": 14575,
            "upload_time": "2025-02-23T01:41:39",
            "upload_time_iso_8601": "2025-02-23T01:41:39.739201Z",
            "url": "https://files.pythonhosted.org/packages/9f/15/2a9e3dcb3ceb73ad7a96b433e6f00f0069e9ac9f06f5d2fbd1fad4204c3b/awesome_list_generator-0.1.6-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "25e9bfb5d9052a645bf5be77e340b0b05eff59a6772354ff84c8ef852aa36366",
                "md5": "a893f5c5785202b220285d8161ee18a4",
                "sha256": "447b8285e4b100dfca898ce9babc3a67a80f676a003ae27573a0dbf69e0159bf"
            },
            "downloads": -1,
            "filename": "awesome_list_generator-0.1.6.tar.gz",
            "has_sig": false,
            "md5_digest": "a893f5c5785202b220285d8161ee18a4",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": "<4,>=3.12",
            "size": 58061,
            "upload_time": "2025-02-23T01:41:43",
            "upload_time_iso_8601": "2025-02-23T01:41:43.126181Z",
            "url": "https://files.pythonhosted.org/packages/25/e9/bfb5d9052a645bf5be77e340b0b05eff59a6772354ff84c8ef852aa36366/awesome_list_generator-0.1.6.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2025-02-23 01:41:43",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "liblaf",
    "github_project": "awesome-list-generator",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": true,
    "lcname": "awesome-list-generator"
}
        
Elapsed time: 1.80812s