{"id":20257427,"url":"https://github.com/jgadling/pennant","last_synced_at":"2026-02-15T20:02:39.204Z","repository":{"id":78017717,"uuid":"95388622","full_name":"jgadling/pennant","owner":"jgadling","description":"Pennant is a powerful feature flag service designed for maximum flexibility and performance","archived":false,"fork":false,"pushed_at":"2019-11-14T00:10:56.000Z","size":930,"stargazers_count":4,"open_issues_count":0,"forks_count":0,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-10-09T04:08:09.859Z","etag":null,"topics":["cli","dark-launch","feature-flags","feature-toggles","golang","golang-application","grpc-service","rest-server"],"latest_commit_sha":null,"homepage":null,"language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/jgadling.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":"2017-06-25T22:11:36.000Z","updated_at":"2025-08-07T18:00:59.000Z","dependencies_parsed_at":"2023-06-14T21:45:17.593Z","dependency_job_id":null,"html_url":"https://github.com/jgadling/pennant","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/jgadling/pennant","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jgadling%2Fpennant","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jgadling%2Fpennant/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jgadling%2Fpennant/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jgadling%2Fpennant/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jgadling","download_url":"https://codeload.github.com/jgadling/pennant/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jgadling%2Fpennant/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29487784,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-15T19:29:10.908Z","status":"ssl_error","status_checked_at":"2026-02-15T19:29:10.419Z","response_time":118,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":["cli","dark-launch","feature-flags","feature-toggles","golang","golang-application","grpc-service","rest-server"],"created_at":"2024-11-14T10:51:08.311Z","updated_at":"2026-02-15T20:02:39.200Z","avatar_url":"https://github.com/jgadling.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"[![Build Status](https://travis-ci.org/jgadling/pennant.svg?branch=master)](https://travis-ci.org/jgadling/pennant)\n[![GoDoc](https://godoc.org/github.com/jgadling/pennant?status.svg)](https://godoc.org/github.com/jgadling/pennant)\n\n## Pennant Feature Flags\n\nPennant is a powerful dark-launch utility designed for maximum flexibility and\nperformance.\n\n### Getting Started\n\nBuilding and running pennant:\n\n```\n% brew install consul\n% consul agent -dev -advertise 127.0.0.1\n% git clone pennant.git\n% go build \u0026\u0026 ./pennant server\n```\n\n### Example flag\n\n```\n{\n  \"name\": \"red_button\",\n  \"description\": \"Makes the button on the home page red\",\n  \"default\": false,\n  \"policies\": [\n     {\n      \"comment\": \"Everybody whose username starts with 'foo'\",\n      \"rules\": \"user_username =~ '^foo'\"\n     },\n     {\n      \"comment\": \"and some volunteers\",\n      \"rules\": \"user_id in (10, 11, 13)\"\n     },\n     {\n      \"comment\": \"Also 10% of rando users\",\n      \"rules\": \"pct(user_username) \u003c= 10\"\n     }\n  ]\n}\n\n```\n\n#### Test a flag without a server\n\n```\npennant test -f tests/data/flag1.json -d tests/data/data1.json\n```\n\n### CLI\n\n\n#### Create or update a flag\n\n```\n$ pennant update -f tests/data/flag1.json\n- or -\n$ pennant update '{\"name\":\"red_button\",\"description\":....}'\n- or -\n$ cat tests/data/flag1.json | pennant update -\n\nName        Description                            DefaultValue\n----------  -------------------------------------  ------------\nred_button  Makes the button on the home page red  false\n\nRule                      Comment\n------------------------  ------------------------------------------\nuser_username =~ '^foo'   Everybody whose username starts with 'foo'\nuser_id in (10, 11, 13)   and some volunteers\npct(user_username) \u003c= 10  Also 10% of rando users\n```\n\n#### List flags\n\n```\n% pennant list\nName\n----------\nred_button\n```\n\n#### Get flag details\n\n```\n$ pennant show red_button\nName        Description                            DefaultValue\n----------  -------------------------------------  ------------\nred_button  Makes the button on the home page red  false\n\nRule                      Comment\n------------------------  ------------------------------------------\nuser_username =~ '^foo'   Everybody whose username starts with 'foo'\nuser_id in (10, 11, 13)   and some volunteers\npct(user_username) \u003c= 10  Also 10% of rando users\n```\n\n#### Check whether a flag is enabled\n\n```\n$ pennant value red_button '{\"user_id\": 10}'\n- or -\n$ pennant value red_button -f document.json\n- or -\n$ cat document.json | pennant value red_button -\nFlag        Status\n----------  -------\nred_button  enabled\n```\n\n#### Delete a flag\n\n```\n$ pennant delete red_button\nred_button deleted\n```\n\n### API\n\n| Method | Path | Description |\n| --- | --- | --- |\n| GET | /flags | List flags |\n| GET | /flags/{name} | Get a flag's definition |\n| DELETE | /flags/{name} | Delete a flag |\n| POST | /flags | Create or update a flag |\n| GET | /flagValue/{name} | Fetch en/disabled state of a flag, given a document |\n\n\n### Roadmap\nV1 milestones:\n\n - ✓ Pluggable storage backends, ships with consul and in-memory support\n - ✓ GRPC and REST query interfaces\n - ✓ REST flag management interfaces\n - ✓ Watches for consul value changes\n - ✓ Bundled percentage calculator\n - ✓ Supports arbitrary expressions for en/disabling flags\n - ✓ Client and server in single binary\n - Ships metrics to StatsD\n - FlagGroup - evaluate multiple flags in a single query\n\nV2:\n\n - More drivers - redis, etcd, filesystem\n - Authentication\n - Prometheus compatible stats\n - Query results caching, perf improvements\n - GRPC flag management interface\n\n### Further reading on feature flags\n\n- [http://featureflags.io/](http://featureflags.io/)\n- [https://engineering.instagram.com/flexible-feature-control-at-instagram-a7d3417658df](https://engineering.instagram.com/flexible-feature-control-at-instagram-a7d3417658df)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjgadling%2Fpennant","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjgadling%2Fpennant","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjgadling%2Fpennant/lists"}