{"id":15619479,"url":"https://github.com/pawamoy/insiders-project","last_synced_at":"2025-10-29T05:01:53.573Z","repository":{"id":204352203,"uuid":"701791247","full_name":"pawamoy/insiders-project","owner":"pawamoy","description":"Manage your Insiders projects.","archived":false,"fork":false,"pushed_at":"2025-03-03T21:55:37.000Z","size":1064,"stargazers_count":0,"open_issues_count":3,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-03-26T14:23:02.222Z","etag":null,"topics":["github","insiders","projects","pypi"],"latest_commit_sha":null,"homepage":"https://pawamoy.github.io/insiders-project/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"isc","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/pawamoy.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","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},"funding":{"github":"pawamoy","ko_fi":"pawamoy","polar":"pawamoy","custom":["https://www.paypal.me/pawamoy"]}},"created_at":"2023-10-07T15:10:27.000Z","updated_at":"2025-03-03T21:55:41.000Z","dependencies_parsed_at":null,"dependency_job_id":"56eec8dd-bc0a-4e57-a95d-532c1e90448e","html_url":"https://github.com/pawamoy/insiders-project","commit_stats":{"total_commits":4,"total_committers":2,"mean_commits":2.0,"dds":0.25,"last_synced_commit":"b2be4ef11b17d427bec3e466cf79ad33d1e5f472"},"previous_names":["pawamoy/insiders-project","pawamoy/insiders"],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pawamoy%2Finsiders-project","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pawamoy%2Finsiders-project/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pawamoy%2Finsiders-project/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pawamoy%2Finsiders-project/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/pawamoy","download_url":"https://codeload.github.com/pawamoy/insiders-project/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248625505,"owners_count":21135513,"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":["github","insiders","projects","pypi"],"created_at":"2024-10-03T08:20:48.672Z","updated_at":"2025-10-29T05:01:53.490Z","avatar_url":"https://github.com/pawamoy.png","language":"Python","funding_links":["https://github.com/sponsors/pawamoy","https://ko-fi.com/pawamoy","https://polar.sh/pawamoy","https://www.paypal.me/pawamoy"],"categories":[],"sub_categories":[],"readme":"# insiders\n\n[![ci](https://github.com/pawamoy/insiders-project/workflows/ci/badge.svg)](https://github.com/pawamoy/insiders-project/actions?query=workflow%3Aci)\n[![documentation](https://img.shields.io/badge/docs-mkdocs-708FCC.svg?style=flat)](https://pawamoy.github.io/insiders-project/)\n[![pypi version](https://img.shields.io/pypi/v/insiders.svg)](https://pypi.org/project/insiders/)\n[![gitter](https://badges.gitter.im/join%20chat.svg)](https://app.gitter.im/#/room/#insiders-project:gitter.im)\n\nManage your Insiders projects.\n\n## Installation\n\n```bash\npip install insiders\n```\n\nWith [`uv`](https://docs.astral.sh/uv/):\n\n```bash\nuv tool install insiders\n```\n\n## Usage\n\nThe `insiders` tool provides several commands that will help you manage projects based on a sponsorware strategy.\n\n- `insiders backlog`: Print a backlog of issues, ordered using your own defined criteria\n- `insiders index`: Serve a PyPI-like index locally, and upload private Insiders packages to it.\n- `insiders project`: Bootstrap public/insiders project pairs on GitHub.\n- `insiders sponsors`: Manage your sponsors (grant/revoke access to private team, etc.).\n\nRun `insiders -h` to see where the configuration file is found. Example configuration:\n\n```toml\n# --------------------------------------------------------------------------- #\n# Backlog configuration.                                                      #\n# --------------------------------------------------------------------------- #\n# The `backlog` command prints a list of issues from GitHub repositories.\n# It is used to keep track of what needs to be done, and to prioritize tasks.\n[backlog]\n\n# GitHub namespaces (user accounts / organizations) from which to fetch issues.\nnamespaces = [\"pawamoy\", \"mkdocstrings\"]\n\n# How many issues to display when showing the backlog.\nlimit = 30\n\n# Sorting criteria, in order of importance.\n# TODO: Document syntax and available options.\nsort = [\n    \"label('bug')\",\n    \"label('unconfirmed')\",\n    \"label('docs')\",\n    \"label('refactor')\",\n    \"min_sponsorships(50)\",\n    \"min_upvotes(2)\",\n    \"label('insiders')\",\n    \"repository('mkdocstrings/*')\",\n    \"created\",\n]\n\n# A shell command to get your GitHub token.\ngithub-token-command = \"command to echo token\"\n\n# A map of labels to emojis, for shorter display in the backlog.\n[backlog.issue-labels]\nbug = \"🐞\"\ndocs = \"📘\"\nfeature = \"✨\"\ninsiders = \"🔒\"\nunconfirmed = \"❔\"\n\n# --------------------------------------------------------------------------- #\n# Index configuration.                                                        #\n# --------------------------------------------------------------------------- #\n# The `index` command lets you serve a PyPI-like index locally,\n# and upload Insiders versions of projects to it,\n# so that you can install them transparently as dependencies.\n# You can configure a remote index too, instead of a locally-served one.\n[index]\n\n# The URL of the index, local or remote.\nurl = \"http://localhost:31411\"\n\n# Whether to start the index server in the background (when serving locally).\nstart-in-background = true\n\n# The path to the log file of the index server (when serving locally).\nlog-path = \"/tmp/insiders-index.log\"\n\n# --------------------------------------------------------------------------- #\n# Projects configuration.                                                     #\n# --------------------------------------------------------------------------- #\n# The `project` command lets you create public and private projects on GitHub.\n# It supports Copier templates to generate the initial project structure.\n# It can also register projects on PyPI, and run post-creation commands.\n# Created projects will be cloned in the specified directories.\n[project]\n\n# If your Insiders organization is named \"your-username-insiders\",\n# you can specify your GitHub username instead of both the public\n# and insiders namespaces in which projects will be created.\ngithub-username = \"pawamoy\"\n\n# Explicitly specify the public and insiders namespaces.\nnamespace = \"pawamoy\"\ninsiders-namespace = \"pawamoy-insiders\"\n\n# Where to clone the created projects (Git repositories).\ndirectory = \"~/data/dev\"\ninsiders-directory = \"~/data/dev/insiders\"\n\n# Whether to register projects on PyPI.\nregister-on-pypi = false\npypi-username = \"pawamoy\"\n\n# Post-creation commands to run after creating a project.\n# The command only runs in the public project, not the private one.\npost-creation-command = [\n    \"python\",\n    \"scripts/make\",\n    \"setup\",\n    \"changelog\",\n    \"release\",\n    \"version=0.1.0\",\n]\n\n# A Copier template to generate new projects from.\ncopier-template = \"gh:pawamoy/copier-uv\"\n\n# A mapping of template questions to answers.\n# TODO: Document syntax and available options.\n[project.copier-template-answers]\nproject_name = \"{public_name}\"\nproject_description = \"{description}\"\nauthor_username = \"pawamoy\"\nrepository_namespace = \"{public_namespace}\"\nrepository_name = \"{public_name}\"\ninsiders = true\ninsiders_repository_name = \"{insiders_name}\"\n\n# --------------------------------------------------------------------------- #\n# Sponsors configuration.                                                     #\n# --------------------------------------------------------------------------- #\n# The `sponsors` command lets you list sponsors from different platforms,\n# show detailed information about a user,\n# and synchronize your sponsors' access to a GitHub team,\n# where your private projects are made available.\n[sponsors]\n\n# Your GitHub account receiving sponsorships.\ngithub-sponsored-account = \"pawamoy\"\n\n# A shell command to get your GitHub token.\ngithub-token-command = \"command to echo token\"\n\n# Your Polar account receiving sponsorships.\npolar-sponsored-account = \"pawamoy\"\n\n# A shell command to get your Polar token.\npolar-token-command = \"command to echo token\"\n\n# The minimum amount a sponsor must pledge to be considered an insider,\n# granting them access to your private projects.\nminimum-amount = 10\n\n# The GitHub team to which insiders are invited.\ninsiders-team = \"pawamoy-insiders/insiders\"\n\n# A list of users to always include into the insiders team.\ninclude-users = [\n    \"pawamoy\",  # Myself.\n]\n\n# A list of users to always exclude from the insiders team.\nexclude-users = []\n\n# A map of GitHub sponsors to their beneficiaries.\n# Beneficiaries are users/organizations who get voting power\n# and are optionally granted access to your Insiders team.\n# TODO: Document supported values.\n[sponsors.github-beneficiaries]\nsome-github-account = [\n    \"some-github-user\",\n    \"\u0026some-github-org\",\n]\n\n# A map of Polar sponsors to their beneficiaries.\n# Beneficiaries are users/organizations who get voting power\n# and are optionally granted access to your Insiders team.\n# TODO: Document supported values.\n[sponsors.polar-beneficiaries]\n```\n\nMore documentation will be added later, for now ask @pawamoy for details (see where I can be reached on my profile) 🙂\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpawamoy%2Finsiders-project","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpawamoy%2Finsiders-project","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpawamoy%2Finsiders-project/lists"}