{"id":15636437,"url":"https://github.com/jackdbd/pod-jackdbd-jsoup","last_synced_at":"2026-01-24T01:35:45.379Z","repository":{"id":257806020,"uuid":"863211196","full_name":"jackdbd/pod-jackdbd-jsoup","owner":"jackdbd","description":"pod for parsing HTML with jsoup","archived":false,"fork":false,"pushed_at":"2024-10-08T13:56:34.000Z","size":124,"stargazers_count":0,"open_issues_count":1,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-30T05:45:06.389Z","etag":null,"topics":["babashka","babashka-pods","clojure","jsoup"],"latest_commit_sha":null,"homepage":"","language":"Clojure","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/jackdbd.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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}},"created_at":"2024-09-25T23:02:45.000Z","updated_at":"2024-10-08T13:25:50.000Z","dependencies_parsed_at":null,"dependency_job_id":"045f4559-6460-4cbf-89a1-5e63e27bc904","html_url":"https://github.com/jackdbd/pod-jackdbd-jsoup","commit_stats":{"total_commits":80,"total_committers":1,"mean_commits":80.0,"dds":0.0,"last_synced_commit":"b925cd68a3c101e721fd82c6c63995a263951bfe"},"previous_names":["jackdbd/pod-jackdbd-jsoup"],"tags_count":27,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jackdbd%2Fpod-jackdbd-jsoup","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jackdbd%2Fpod-jackdbd-jsoup/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jackdbd%2Fpod-jackdbd-jsoup/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jackdbd%2Fpod-jackdbd-jsoup/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jackdbd","download_url":"https://codeload.github.com/jackdbd/pod-jackdbd-jsoup/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":251651221,"owners_count":21621702,"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","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":["babashka","babashka-pods","clojure","jsoup"],"created_at":"2024-10-03T11:03:56.459Z","updated_at":"2026-01-24T01:35:40.361Z","avatar_url":"https://github.com/jackdbd.png","language":"Clojure","funding_links":[],"categories":[],"sub_categories":[],"readme":"# pod-jackdbd-jsoup\n\n![CI/CD](https://github.com/jackdbd/pod-jackdbd-jsoup/actions/workflows/ci-cd.yaml/badge.svg)\n[![Clojars Project](https://img.shields.io/clojars/v/com.github.jackdbd/pod.jackdbd.jsoup.svg)](https://clojars.org/com.github.jackdbd/pod.jackdbd.jsoup)\n\nBabashka pod for parsing HTML with [jsoup](https://jsoup.org/).\n\n## How to use it?\n\n### Use the binary file for your OS/architecture\n\nIf you want to load a version of this pod that was *registered* on the [Pod registry](https://github.com/babashka/pod-registry) (see below to know what *registered* means in this context), you can do it using the **qualified keyword** of this pod.\n\n```clj\n(require '[babashka.pods :as pods])\n(pods/load-pod 'com.github.jackdbd/pod.jackdbd.jsoup \"0.3.0\")\n```\n\nWhether the pod is *registered* or not, you can always load it with this method:\n\n1. Download the archive (e.g. `.zip`) containing the pod binary for your OS/architecture from a [GitHub release](https://github.com/jackdbd/pod-jackdbd-jsoup/releases).\n1. Extract the binary from the archive (e.g. `unzip` it).\n\nAnd either (option A):\n\n1. Move the binary to your [`BABASHKA_PODS_DIR`](https://github.com/babashka/pods?tab=readme-ov-file#where-does-the-pod-come-from).\n1. Load the pod using its **file name**.\n\n```clj\n(require '[babashka.pods :as pods])\n(pods/load-pod \"pod-jackdbd-jsoup\")\n```\n\nOr (option B):\n\n1. Move the binary whenever you want on your filesystem.\n1. Load the pod using its **file path**.\n\n```clj\n(require '[babashka.pods :as pods])\n(pods/load-pod \"/path/to/pod-jackdbd-jsoup\")\n```\n\n### Use the uberjar\n\nIn case the pod wasn't compiled for your combination of OS/architecture, you can still use it with this method:\n\n1. Download the uberjar from a [GitHub release](https://github.com/jackdbd/pod-jackdbd-jsoup/releases).\n1. Load the pod using its **file path**.\n\n```clj\n(require '[babashka.pods :as pods])\n(def uber-file \"path/to/pod-jackdbd-jsoup.jar\")\n(pods/load-pod [\"java\" \"-jar\" uber-file])\n```\n\nSee also [examples/jsoup.bb](./examples/jsoup.bb).\n\n## Development\n\nThe file [`devenv.nix`](./devenv.nix) declares a developer environment for this project. This file is used by [devenv](https://github.com/cachix/devenv) to create such environment. If you don't use devenv you can ignore this file, or use it to understand which dependencies are required by this project.\n\nThis project uses a [`bb.edn`](./bb.edn) file to define a few [Babashka tasks](https://book.babashka.org/#tasks). You can type `bb tasks` to view them.\n\n### Linux binary\n\nIf you are on Linux, you can compile a statically-linked binary using this Babashka task.\n\n```sh\nbb build:binary\n```\n\nYou can double check that the binary is statically linked using one of the following commands.\n\n```sh\nldd target/pod-jackdbd-jsoup\nobjdump --dynamic-syms target/pod-jackdbd\n```\n\n### Namespace dependency graph\n\n![Dependency graph of the namespaces, generated with clj-hiera](./resources/img/namespaces.png)\n\n### Release management\n\nEach push to `main` triggers a deploy to Clojars. These versions will have a semver range (e.g. `1.2.3`).\n\nWhen you are on `main` and you are ready to make a **release**, run this command:\n\n```sh\nbb release\n```\n\nAfter each successful deploy to Clojars from `main`, a **release** on GitHub Releases will be created.\n\nEach push to `canary` triggers a deploy to Clojars. These versions will have a semver range, a suffix and a counter incremented automatically (e.g. `1.2.3-RC.1`, `1.2.3-RC.2`). I don't do [snapshot versions](https://stackoverflow.com/a/5901460/3036129) because I think they are a bad idea. I consider each version published to Clojars an immutable artifact and I never overwrite it.\n\nWhen you are on `canary` and you are ready to make a **pre-release**, run this command:\n\n```sh\nbb prerelease\n```\n\nAfter each successful deploy to Clojars from `canary`, a **pre-release** on GitHub Releases will be created.\n\n\u003e[!IMPORTANT]\n\u003e A deploy on Clojars and GitHub Releases do not imply that the pod is registered on the Pod registry. At the moment, this last step must be done manually.\n\n### Registering the pod on the Pod registry\n\nThe [CI/CD pipeline](./.github/workflows/ci-cd.yaml) takes care of creating a GitHub release that includes the following assets:\n\n- Binary executables for Linux, macOS and Windows.\n- An uberjar (the same one which is published to Clojars).\n- A `manifest.edn` that can be used *register* the pod on the [Pod registry](https://github.com/babashka/pod-registry).\n\nDownload the `manifest.edn` and make a PR on the Pod registry following [these instructions](https://github.com/babashka/pod-registry?tab=readme-ov-file#registering-a-pod).\n\n\u003e [!NOTE]\n\u003e Every pod version has its own `manifest.edn`.\n\nOnce the PR on [Pod registry](https://github.com/babashka/pod-registry) gets merged, the pod version will be considered *registered* and users will be able to load it using the **qualified keyword** for the pod and the desired **version**, instead of having to download the binary from a GitHub release.\n\n## Credits\n\nThis project was inspired by [jaydeesimon/pod-jaydeesimon-jsoup](https://github.com/jaydeesimon/pod-jaydeesimon-jsoup).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjackdbd%2Fpod-jackdbd-jsoup","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjackdbd%2Fpod-jackdbd-jsoup","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjackdbd%2Fpod-jackdbd-jsoup/lists"}