{"id":31822122,"url":"https://github.com/jet-logic/alterx","last_synced_at":"2026-01-20T16:54:13.624Z","repository":{"id":293525403,"uuid":"984053636","full_name":"jet-logic/alterx","owner":"jet-logic","description":"A powerful file processing toolkit for batch transformations of HTML, JSON, TOML, XML, and YAML files","archived":false,"fork":false,"pushed_at":"2025-06-28T05:49:01.000Z","size":234,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-10-05T19:48:18.954Z","etag":null,"topics":["command-line-tool","file-processing","html-parser","json-parsing","json-serialization","python3","toml-parsing","xml-parsing","yaml-processor"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/jet-logic.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-05-15T10:21:29.000Z","updated_at":"2025-06-28T05:37:10.000Z","dependencies_parsed_at":"2025-05-15T19:42:45.163Z","dependency_job_id":"e1fb2977-f939-44f2-86c1-c4b1dc8dc778","html_url":"https://github.com/jet-logic/alterx","commit_stats":null,"previous_names":["jet-logic/alterx"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/jet-logic/alterx","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jet-logic%2Falterx","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jet-logic%2Falterx/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jet-logic%2Falterx/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jet-logic%2Falterx/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jet-logic","download_url":"https://codeload.github.com/jet-logic/alterx/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jet-logic%2Falterx/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":279007345,"owners_count":26084285,"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-10-11T02:00:06.511Z","response_time":55,"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":["command-line-tool","file-processing","html-parser","json-parsing","json-serialization","python3","toml-parsing","xml-parsing","yaml-processor"],"created_at":"2025-10-11T13:59:57.141Z","updated_at":"2025-10-11T13:59:58.963Z","avatar_url":"https://github.com/jet-logic.png","language":"Python","funding_links":["https://ko-fi.com/B0B01E8SY7"],"categories":[],"sub_categories":[],"readme":"# AlterX - The File Transformation Toolkit\n\n\u003c!-- [![Python Version](https://img.shields.io/badge/python-3.8+-blue.svg)](https://www.python.org/) --\u003e\n\u003c!-- [![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE) --\u003e\n\n[![Python Version](https://img.shields.io/badge/python-3.8%2B-blue)](https://www.python.org/)\n[![Tests Status](https://github.com/jet-logic/alterx/actions/workflows/build.yml/badge.svg)](https://github.com/jet-logic/alterx/actions)\n[![PyPI version fury.io](https://badge.fury.io/py/alterx.svg)](https://pypi.python.org/pypi/alterx/)\n\nAlterX is a powerful command-line tool for batch processing and transforming files in various formats. It provides a consistent framework for modifying HTML, JSON, TOML, XML, and YAML files with custom Python logic.\n\n## Features\n\n- **Multi-format support**: Process HTML, JSON, TOML, XML, and YAML files\n- **Extension system**: Define transformations in Python scripts\n- **Smart modification**: Only changes files that need updates\n- **Batch processing**: Recursively process entire directories\n- **Dry run mode**: Test changes before applying them\n- **Comprehensive logging**: Detailed output about modifications\n\n## ☕ Support\n\nIf you find this project helpful, consider supporting me:\n\n[![ko-fi](https://ko-fi.com/img/githubbutton_sm.svg)](https://ko-fi.com/B0B01E8SY7)\n\n## Installation\n\n```bash\npip install alterx\n```\n\n## Quick Start\n\n1. Create a processing script (e.g., `transform.py`):\n\n```python\ndef init(app):\n    app.defs['VERSION'] = \"2.0.0\"\n\ndef process(doc, file_info, app):\n    if 'version' in doc:\n        doc['version'] = app.defs['VERSION']\n        return True\n```\n\n2. Run AlterX:\n\n```bash\n# Process JSON files\nalterx json -x transform.py path/to/files\n```\n\n### Example Use Cases\n\n- [JSON](Example-json.md) Updating API URLs across multiple JSON config files\n- [TOML](Example-toml.md) Maintaining consistent Python project TOML files\n- [HTML](Example-html.md) Standardizing HTML documents (adding missing tags, accessibility improvements)\n- [XML](Example-xml.md) Processing XML sitemaps (adding/removing URLs, updating dates)\n- [YAML](Example-yaml.md) Managing Kubernetes YAML manifests (adding labels, updating image tags)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjet-logic%2Falterx","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjet-logic%2Falterx","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjet-logic%2Falterx/lists"}