<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.
[](https://pypi.org/project/awesome-list-generator/)
[](https://pypi.org/project/awesome-list-generator/)
[](https://pypi.org/project/awesome-list-generator/) <br />
[](https://github.com/liblaf/awesome-list-generator/graphs/contributors)
[](https://github.com/liblaf/awesome-list-generator/forks)
[](https://github.com/liblaf/awesome-list-generator/stargazers)
[](https://github.com/liblaf/awesome-list-generator/issues)
[](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)
</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">
[](#readme-top)
</div>
## 📦 Installation
To install `awesome-list-generator`, run the following command:
```bash
uv tool install awesome-list-generator
```
<div align="right">
[](#readme-top)
</div>
## ⌨️ Local Development
You can use Github Codespaces for online development:
[](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">
[](#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.
[](https://github.com/liblaf/awesome-list-generator/pulls)
[](https://github.com/liblaf/awesome-list-generator/graphs/contributors)
<div align="right">
[](#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[](https://pypi.org/project/awesome-list-generator/)\n[](https://pypi.org/project/awesome-list-generator/)\n[](https://pypi.org/project/awesome-list-generator/) <br />\n[](https://github.com/liblaf/awesome-list-generator/graphs/contributors)\n[](https://github.com/liblaf/awesome-list-generator/forks)\n[](https://github.com/liblaf/awesome-list-generator/stargazers)\n[](https://github.com/liblaf/awesome-list-generator/issues)\n[](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\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[](#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[](#readme-top)\n\n</div>\n\n## \u2328\ufe0f Local Development\n\nYou can use Github Codespaces for online development:\n\n[](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[](#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[](https://github.com/liblaf/awesome-list-generator/pulls)\n\n[](https://github.com/liblaf/awesome-list-generator/graphs/contributors)\n\n<div align=\"right\">\n\n[](#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"
}
JSON
