feat: add Tailwind CSS pipeline, tag-aware cloning & CI/CD #352

filipchristiansen · 2025-07-01T21:07:53Z

Theme	Highlights
Front-end	• Introduces TailwindCSS • `site.css` compiled in CI • New icon set + favicon pack • Splits huge inline JS into `/static/js/*.js` modules
Docker	• 3-stage build (`node:20-alpine ➜ python:3.12-slim ➜ runtime`) • Copies compiled CSS into final layer
Core library	• Ingest pipeline now recognises git tags in addition to branches & commits • Compat helpers for Py 3.8 (`readlink`, `removesuffix`)
CI / CD	• `ci.yml` caches by pyproject.toml, installs with `pip -e .[dev]` • New frontend job builds & uploads CSS artefact • `publish.yml` builds Tailwind ➜ wheel/sdist ➜ PyPI upload
Packaging	• `[dev]` replaces `requirements-dev.txt`
Docs	• CONTRIBUTING.md (Node ≥18 instructions, CSS build)

package-lock.json

CONTRIBUTING.md

src/gitingest/entrypoint.py

src/server/templates/components/footer.jinja

src/server/templates/index.jinja

Copilot

Pull Request Overview

Introduces a Tailwind CSS build pipeline, adds tag-aware clone and parsing logic, and enhances CI/CD workflows.

Integrates Tailwind CSS into the frontend, extracts inline scripts into static JS modules, and sets up a Docker multi-stage build.
Extends URL parsing and clone utilities to recognize Git tags alongside branches and commits.
Revamps GitHub Actions and Docker workflows to build CSS, cache dependencies, publish artifacts, and deploy the Python package.

Reviewed Changes

Copilot reviewed 37 out of 51 changed files in this pull request and generated 1 comment.

Show a summary per file

File(s)	Description
tests/query_parser/*.py	Updated tests for tag field; removed outdated branch-fallback tests
tests/conftest.py	Updated mocks to use new `fetch_remote_branches_or_tags`
src/static/js/	Extracted inline scripts into dedicated modules; added PostHog, navbar, git form, and git logic
src/static/css/tailwind.css	Added custom utility classes and components
src/server/templates/*/.jinja	Moved inline JS to static files; updated layout for badges, favicons, and scripts
src/server/query_processor.py	Changed error handling to return raw exception text
src/gitingest/utils/git_utils.py	Renamed and enhanced branch/tag fetch with `ref_type`
src/gitingest/utils/compat_func.py	Added Python 3.8 compatibility helpers (`readlink`, `removesuffix`)
src/gitingest/query_parser.py	Tag-aware URL parsing and new `_configure_branch_or_tag`
src/gitingest/clone.py & entrypoint.py	Context-managed cloning with tag support
src/gitingest/schemas/*.py	Extended models to include `tag` field
src/gitingest/output_formatter.py	Updated symlink handling to use compatibility helper
Dockerfile	Multi-stage build: CSS, Python build, and runtime image
pyproject.toml & package.json	Updated dev dependencies, package-data, and build scripts
.github/workflows/{ci,publish,scorecard}.yml	Enhanced caching, CSS build, artifact publishing, and security checks
CONTRIBUTING.md & README.md	Documentation updates for CSS pipeline and contribution guide
.pre-commit-config.yaml & dependabot.yml	Streamlined pre-commit config; added Dependabot grouping

Comments suppressed due to low confidence (2)

tests/query_parser/test_query_parser.py:379

The test for handling failed git fetch (test_parse_repo_source_with_failed_git_command) was removed, leaving fallback logic untested. Consider adding tests for branch and tag fallback when remote fetch fails.

@pytest.mark.asyncio

src/server/query_processor.py:105

[nitpick] Returning raw exception messages may expose internal details and can be confusing. Consider sanitizing the message or mapping known errors to user-friendly messages.

        return IngestErrorResponse(error=str(exc), repo_url=short_repo_url)

src/gitingest/query_parser.py

Frontend * introduce Tailwind CSS (package.json, tailwind.config.js, input CSS) * build site.css on-the-fly (removed tracked artefact; added .gitignore) * new favicon/icon assets & template cleanup * split JS into modular files Docker * replace single-stage image with 3-stage build • css-builder (Node 20 alpine) → compiles Tailwind • python-builder installs project with PEP 621 metadata • runtime image copies site-packages + compiled CSS, runs as uid 1000 CI/CD * ci.yml: cache by pyproject.toml, install with `pip -e .[dev]` * new frontend job builds/archives CSS after tests * publish.yml: build CSS first, then wheel/sdist; trusted OIDC upload * tidy scorecard workflow Core library * clone.py, parser & utils now resolve tags in addition to branches/commits * fallback branch/tag discovery when `git ls-remote` fails * compat\_func.py back-ports Path.readlink / str.removesuffix for Py 3.8 Tooling & docs * add `[dev]` extra, drop requirements-dev.txt & its pre-commit fixer * refreshed CONTRIBUTING.md with Node/Tailwind instructions * updated tests for new tag logic Large squash commit that wires a proper frontend asset pipeline, modernises the container & release workflows, and expands repository-ingest features to understand Git tags.

…oderamp-labs#352) Frontend * introduce Tailwind CSS (package.json, tailwind.config.js, input CSS) * build site.css on-the-fly (removed tracked artefact; added .gitignore) * new favicon/icon assets & template cleanup * split JS into modular files Docker * replace single-stage image with 3-stage build • css-builder (Node 20 alpine) → compiles Tailwind • python-builder installs project with PEP 621 metadata • runtime image copies site-packages + compiled CSS, runs as uid 1000 CI/CD * ci.yml: cache by pyproject.toml, install with `pip -e .[dev]` * new frontend job builds/archives CSS after tests * publish.yml: build CSS first, then wheel/sdist; trusted OIDC upload * tidy scorecard workflow Core library * clone.py, parser & utils now resolve tags in addition to branches/commits * fallback branch/tag discovery when `git ls-remote` fails * compat\_func.py back-ports Path.readlink / str.removesuffix for Py 3.8 Tooling & docs * add `[dev]` extra, drop requirements-dev.txt & its pre-commit fixer * refreshed CONTRIBUTING.md with Node/Tailwind instructions * updated tests for new tag logic

…352) Frontend * introduce Tailwind CSS (package.json, tailwind.config.js, input CSS) * build site.css on-the-fly (removed tracked artefact; added .gitignore) * new favicon/icon assets & template cleanup * split JS into modular files Docker * replace single-stage image with 3-stage build • css-builder (Node 20 alpine) → compiles Tailwind • python-builder installs project with PEP 621 metadata • runtime image copies site-packages + compiled CSS, runs as uid 1000 CI/CD * ci.yml: cache by pyproject.toml, install with `pip -e .[dev]` * new frontend job builds/archives CSS after tests * publish.yml: build CSS first, then wheel/sdist; trusted OIDC upload * tidy scorecard workflow Core library * clone.py, parser & utils now resolve tags in addition to branches/commits * fallback branch/tag discovery when `git ls-remote` fails * compat\_func.py back-ports Path.readlink / str.removesuffix for Py 3.8 Tooling & docs * add `[dev]` extra, drop requirements-dev.txt & its pre-commit fixer * refreshed CONTRIBUTING.md with Node/Tailwind instructions * updated tests for new tag logic

filipchristiansen marked this pull request as draft July 1, 2025 21:09

filipchristiansen requested review from NicolasIRAGNE, Copilot, cyclotruc and ix-56h and removed request for cyclotruc July 1, 2025 21:12

This comment was marked as resolved.

Sign in to view

filipchristiansen marked this pull request as ready for review July 1, 2025 21:32

filipchristiansen requested a review from Copilot July 1, 2025 21:40

This comment was marked as off-topic.

Sign in to view

This comment was marked as resolved.

Sign in to view

This comment was marked as off-topic.

Sign in to view

This comment was marked as resolved.

Sign in to view

filipchristiansen requested a review from cyclotruc July 2, 2025 10:39

filipchristiansen force-pushed the frontend-and-tags branch from 71f99ec to f5c2d42 Compare July 2, 2025 10:41