.. image:: http://www.repostatus.org/badges/latest/active.svg
:target: http://www.repostatus.org/#active
:alt: Project Status: Active — The project has reached a stable, usable
state and is being actively developed.
.. image:: https://github.com/jwodder/reponews/workflows/Test/badge.svg?branch=master
:target: https://github.com/jwodder/reponews/actions?workflow=Test
:alt: CI Status
.. image:: https://codecov.io/gh/jwodder/reponews/branch/master/graph/badge.svg
:target: https://codecov.io/gh/jwodder/reponews
.. image:: https://img.shields.io/pypi/pyversions/reponews.svg
:target: https://pypi.org/project/reponews/
.. image:: https://img.shields.io/github/license/jwodder/reponews.svg
:target: https://opensource.org/licenses/MIT
:alt: MIT License
`GitHub <https://github.com/jwodder/reponews>`_
| `PyPI <https://pypi.org/project/reponews/>`_
| `Issues <https://github.com/jwodder/reponews/issues>`_
| `Changelog <https://github.com/jwodder/reponews/blob/master/CHANGELOG.md>`_
Do you want to receive e-mail notifications about new issues, pull requests,
discussions, releases, tags, stargazers, & forks on your GitHub repositories?
Of course you do — but turning on e-mail notifications in GitHub for
repositories you're watching will mean you get an e-mail for every comment on
every issue, which is a bit too much. ``reponews`` aims for a happy medium:
only e-mailing you about new issues and similar activity — not about comments —
and only on repositories of your choice. Simply set it up to run under cron or
another job scheduler (sold separately), point it at a compatible e-mail
sending service (also sold separately), and you'll get periodic e-mails listing
new events.
Installation & Setup
====================
``reponews`` requires Python 3.8 or higher. Just use `pip
<https://pip.pypa.io>`_ for Python 3 (You have pip, right?) to install
``reponews`` and its dependencies::
python3 -m pip install reponews
Before running ``reponews`` for the first time, you need to `acquire a GitHub
personal access token`__ for fetching details about your repositories via the
GitHub GraphQL API, and you need to create a configuration file containing, at
a minimum:
__ https://docs.github.com/en/authentication/keeping-your-account-and-data
-secure/creating-a-personal-access-token
- The access token or the path to a file containing it
- The e-mail address that ``reponews`` should send its reports to
- Details on how to send those e-mails
An example configuration file, for sending e-mails to luser@example.com with
the ``sendmail`` command:
.. code:: toml
[reponews]
recipient = "luser@example.com"
auth-token = "..."
[outgoing]
method = "command"
command = ["sendmail", "-i", "-t"]
See "`Configuration`_" below for details.
Example
=======
An example of the sort of e-mail that ``reponews`` might send you::
[luser/my-repo] ISSUE #42: I found a bug (@bug-finder)
<https://github.com/luser/my-repo/issues/42>
@bug-fixer forked luser/my-repo
<https://github.com/bug.fixer/my-repo>
[luser/my-repo] PR #43: I fixed that bug (@bug-fixer)
<https://github.com/luser/my-repo/pull/43>
★ @repo-fan starred orgcorp/bigrepo
[orgcorp/bigrepo] DISCUSSION #123: How do I use this? (@confused-user)
<https://github.com/orgcorp/bigrepo/discussions/123>
[theteam/theproject] RELEASE v1.0a1 [prerelease]: v1 Preview (@github-actions[bot])
<https://github.com/theteam/theproject/releases/tag/v1.0a1>
> We're gearing up for the first full release! Here are some changes you'll find:
>
> * Added a feature
> * Fixed a bug
Now tracking repository luser/brand-new-repo
<https://github.com/luser/brand-new-repo>
> This is the repository description.
No longer tracking repository tmprepos/deleted-repo
Repository renamed: team-member/new-project → theteam/new-project
Usage
=====
::
reponews [<options>]
The ``reponews`` command queries GitHub's GraphQL API for new issues, pull
requests, discussions, releases, tags, stargazers, and/or forks on the
repositories specified in its configuration file (by default, all repositories
affiliated with the authenticated user) and composes & sends an e-mail listing
the events in chronological order. Also included in the report are
notifications about newly-tracked and -untracked repositories and renamed
repositories. If there is no new activity, no e-mail is sent.
"New" activity is, in the general case, anything that has happened since the
last time ``reponews`` was successfully run (specifically, since the last time
the state file was updated). The first time ``reponews`` is run, it merely
reports all the repositories that it is now tracking. If ``reponews`` stops
tracking a repository (usually because the repository listing in the config
file was edited) and then starts tracking it again, it will *not* pick up where
it left off; instead, when it first starts tracking the repository again, it
will mark down that point in time and afterwards only report events occurring
after it. Similar behavior occurs if ``reponews`` stops tracking a certain
type of activity and then starts tracking it again.
Options
-------
-c PATH, --config PATH Specify the configuration file to use. See
"`Configuration`_" below for the default config
file location.
--dump-repos Instead of fetching repository activity, dump
the set of tracked repositories and their
configured activity preferences as a JSON
document
-E FILE, --env FILE Load environment variables from the given
``.env`` file. By default, environment
variables are loaded from the first file named
"``.env``" found by searching from the current
directory upwards.
-l LEVEL, --log-level LEVEL Set the log level to the given value. Possible
values are "``CRITICAL``", "``ERROR``",
"``WARNING``", "``INFO``", "``DEBUG``" (all
case-insensitive) and their Python integer
equivalents. [default: ``WARNING``]
--print Cause ``reponews`` to output the e-mail (as a
MIME document) instead of sending it
--print-body Cause ``reponews`` to output the body of the
e-mail instead of sending it
--save, --no-save Update/do not update the state file on
successful completion [default: ``--save``]
Configuration
=============
``reponews`` is configured via a `TOML <https://toml.io>`_ file whose default
location depends on your OS:
======= ==================================================================
Linux ``~/.config/reponews/config.toml``
or ``$XDG_CONFIG_HOME/reponews/config.toml``
macOS ``~/Library/Application Support/reponews/config.toml``
Windows ``%USERPROFILE%\AppData\Local\jwodder\reponews\config.toml``
======= ==================================================================
This TOML file must contain a ``[reponews]`` table with the following keys &
subtables (all of which are optional unless stated otherwise). Unknown keys
result in an error.
``recipient`` : e-mail address
[Required when ``--print-body`` is not given] The e-mail address to which
``reponews`` should send its reports. This can be either a plain e-mail
address (e.g., ``"me@example.com"``) or a display name with an address in
angle brackets (e.g., ``"Madam E <me@example.com>"``). Note that, if the
display name contains any punctuation, it needs to be enclosed in double
quotes, which then need to be escaped for use in the TOML string, e.g.,
``"\"Joe Q. Recipient\" <jqr@example.net>"``.
``sender`` : e-mail address
The ``From:`` address to put on ``reponews``'s e-mails; specified the same
way as ``recipient``. If ``sender`` is not specified, it is assumed that
the e-mail sending mechanism will automatically fill in the ``From:``
address appropriately.
``subject`` : string
The subject to apply to ``reponews``'s e-mails; defaults to "[reponews] New
activity on your GitHub repositories".
``auth-token`` : string
The GitHub access token to use for interacting with the GitHub API. If
``auth-token`` is not set, the token will be read from the file specified
by ``auth-token-file``. If neither key is set, the GitHub token is looked
up via the following sources, in order:
- The ``GH_TOKEN`` and ``GITHUB_TOKEN`` environment variables (possibly set
via the ``.env`` file; see the ``--env`` option under "Options_" above)
- The gh_ command, if installed
- The hub_ command's configuration file
- The ``hub.oauthtoken`` Git config option
.. _gh: https://github.com/cli/cli
.. _hub: https://github.com/mislav/hub
``auth-token-file`` : path
The path to a file containing the GitHub access token to use for
interacting with the GitHub API. The file must contain only the token and
possibly leading and/or trailing whitespace.
The path may start with a tilde (``~``) to indicate a file in the user's
home directory. A relative path will be resolved relative to the directory
containing the config file.
``state-file`` : path
The path to the file where ``reponews`` will store repository activity
state, used to determine the cutoff point for new activity. The path may
start with a tilde (``~``) to indicate a file in the user's home directory.
A relative path will be resolved relative to the directory containing the
config file.
The default location for the state file depends on your OS:
======= =================================================================
Linux ``~/.local/state/reponews/state.json``
or ``$XDG_STATE_HOME/reponews/state.json``
macOS ``~/Library/Application Support/reponews/state.json``
Windows ``%USERPROFILE%\AppData\Local\jwodder\reponews\state.json``
======= =================================================================
``api-url`` : URL
The GraphQL endpoint to query; defaults to "https://api.github.com/graphql"
``activity`` : table
A subtable describing what types of repository activity to fetch & track.
This table may contain the following keys:
``issues`` : boolean
Whether to report new issues in tracked repositories; defaults to true
``pull-requests`` : boolean
Whether to report new pull requests in tracked repositories; defaults
to true
``discussions`` : boolean
Whether to report new `discussions`_ in tracked repositories; defaults
to true
``releases`` : boolean
Whether to report new releases in tracked repositories; defaults to
true
``tags`` : boolean
Whether to report new tags in tracked repositories; defaults to true
``released-tags`` : boolean
This setting controls how to handle tags that are also made into
releases when both tags and releases are being tracked. If true, such
tags are reported separately from the releases. If false (the
default), such tags are not reported.
``stars`` : boolean
Whether to report new stargazers for tracked repositories; defaults to
true
``forks`` : boolean
Whether to report new forks of tracked repositories; defaults to true
``my-activity`` : boolean
When false (the default), activity performed by the authenticated user
is not reported.
``affiliated`` : table
A subtable describing what types of repository activity to fetch &
track for repositories affiliated with the authenticated user. The
table's keys are the same as the boolean keys of
``[reponews.activity]``.
``repo`` : table
A subtable describing what types of repository activity to fetch &
track for specific repositories or repositories belonging to a given
user/organization. The keys of the subtable must be of the form
``"owner/name"`` (for a specific repository) or ``"owner/*"`` (for all
repositories belonging to a given user/organization), and the values
must be subtables with the same boolean keys as
``[reponews.activity]``.
By default, all repositories and repository owners listed as keys in
``[reponews.activity.repo]`` will be tracked by ``reponews`` just as if
they were listed under ``reponews.repos.include`` (see below). This
can be disabled for a single key by setting ``include = false`` in the
key's subtable.
When determining the activity to fetch & track for a repository
``owner/name``, each setting is looked up in the relevant tables in the
following order, from highest precedence to lowest precedence:
1. ``[reponews.activity.repo."owner/name"]``
2. ``[reponews.activity.repo."owner/*"]``
3. ``[reponews.activity.affiliated]`` (if the repository is affiliated with
the authenticated user)
4. ``[reponews.activity]``
``repos`` : table
A subtable describing what repositories to track. This table may contain
the following keys:
``affiliations`` : list of strings
A list of repository affiliations describing which repositories
associated with the authenticated user should be automatically tracked.
The affiliations are ``"OWNER"`` (for tracking repositories that the
user owns), ``"ORGANIZATION_MEMBER"`` (for tracking repositories
belonging to an organization of which the user is a member), and
``"COLLABORATOR"`` (for tracking repositories to which the user has
been added as a collaborator). Unknown affiliations result in an
error. When ``affiliations`` is not specified, it defaults to all
affiliation types.
``include`` : list of strings
A list of repositories to track in addition to affiliated repositories.
Repositories can be specified as either ``"owner/name"`` (for a
specific repository) or ``"owner/*"`` (for all repositories belonging
to a given user/organization).
``exclude`` : list of strings
A list of repositories to exclude from tracking, specified the same way
as for ``include``. This option takes precedence over the
``affiliations`` and ``include`` settings.
.. _discussions: https://docs.github.com/en/discussions
Example Configuration
---------------------
.. code:: toml
[reponews]
recipient = "luser@example.com"
sender = "RepoNews Bot <reponews@example.net>"
# Fetch the GitHub access token from the "token.txt" file next to the
# config file:
auth-token-file = "token.txt"
state-file = "~/.cache/reponews.json"
[reponews.activity]
# Don't report new issues or tags:
issues = false
tags = false
[reponews.activity.affiliated]
# Do report new issues for affiliated repositories:
issues = true
[reponews.activity.repo."pypa/*"]
# Don't report forks of pypa/* repositories:
forks = false
# Don't track all pypa/* repositories; only track those we're affiliated
# with and those listed under `reponews.repos.include`.
#
# Without this setting, the presence of `[reponews.activity.repo."pypa/*"]`
# would cause reponews to track all repositories belonging to the pypa
# organization.
include = false
[reponews.repos]
affiliations = ["OWNER", "ORGANIZATION_MEMBER"]
include = [
"pypa/packaging",
"pypa/pip",
"pypa/setuptools",
"some-user/*",
]
exclude = [
"some-user/boring-repo",
]
Sending E-Mail
==============
``reponews`` uses outgoing_ for sending e-mail, allowing it to handle multiple
sending methods like sendmail, SMTP, and more. The `outgoing configuration`_
can be located in the ``reponews`` configuration file (as an ``[outgoing]``
table) or in ``outgoing``'s default configuration file. See `outgoing's
documentation <https://outgoing.rtfd.io>`_ for more information.
.. _outgoing: https://github.com/jwodder/outgoing
.. _outgoing configuration:
https://outgoing.readthedocs.io/en/latest/configuration.html
Raw data
{
"_id": null,
"home_page": "https://github.com/jwodder/reponews",
"name": "reponews",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": "",
"keywords": "GitHub,GitHub activity,GitHub issues,e-mail,notifications,pull requests",
"author": "John Thorvald Wodder II",
"author_email": "reponews@varonathe.org",
"download_url": "https://files.pythonhosted.org/packages/89/4e/3b99e4eb81c268c28b4cc5a63df327094537e5911d10776d70924a01fd1b/reponews-0.4.0.tar.gz",
"platform": null,
"description": ".. image:: http://www.repostatus.org/badges/latest/active.svg\n :target: http://www.repostatus.org/#active\n :alt: Project Status: Active \u2014 The project has reached a stable, usable\n state and is being actively developed.\n\n.. image:: https://github.com/jwodder/reponews/workflows/Test/badge.svg?branch=master\n :target: https://github.com/jwodder/reponews/actions?workflow=Test\n :alt: CI Status\n\n.. image:: https://codecov.io/gh/jwodder/reponews/branch/master/graph/badge.svg\n :target: https://codecov.io/gh/jwodder/reponews\n\n.. image:: https://img.shields.io/pypi/pyversions/reponews.svg\n :target: https://pypi.org/project/reponews/\n\n.. image:: https://img.shields.io/github/license/jwodder/reponews.svg\n :target: https://opensource.org/licenses/MIT\n :alt: MIT License\n\n`GitHub <https://github.com/jwodder/reponews>`_\n| `PyPI <https://pypi.org/project/reponews/>`_\n| `Issues <https://github.com/jwodder/reponews/issues>`_\n| `Changelog <https://github.com/jwodder/reponews/blob/master/CHANGELOG.md>`_\n\nDo you want to receive e-mail notifications about new issues, pull requests,\ndiscussions, releases, tags, stargazers, & forks on your GitHub repositories?\nOf course you do \u2014 but turning on e-mail notifications in GitHub for\nrepositories you're watching will mean you get an e-mail for every comment on\nevery issue, which is a bit too much. ``reponews`` aims for a happy medium:\nonly e-mailing you about new issues and similar activity \u2014 not about comments \u2014\nand only on repositories of your choice. Simply set it up to run under cron or\nanother job scheduler (sold separately), point it at a compatible e-mail\nsending service (also sold separately), and you'll get periodic e-mails listing\nnew events.\n\nInstallation & Setup\n====================\n``reponews`` requires Python 3.8 or higher. Just use `pip\n<https://pip.pypa.io>`_ for Python 3 (You have pip, right?) to install\n``reponews`` and its dependencies::\n\n python3 -m pip install reponews\n\nBefore running ``reponews`` for the first time, you need to `acquire a GitHub\npersonal access token`__ for fetching details about your repositories via the\nGitHub GraphQL API, and you need to create a configuration file containing, at\na minimum:\n\n__ https://docs.github.com/en/authentication/keeping-your-account-and-data\n -secure/creating-a-personal-access-token\n\n- The access token or the path to a file containing it\n- The e-mail address that ``reponews`` should send its reports to\n- Details on how to send those e-mails\n\nAn example configuration file, for sending e-mails to luser@example.com with\nthe ``sendmail`` command:\n\n.. code:: toml\n\n [reponews]\n recipient = \"luser@example.com\"\n auth-token = \"...\"\n\n [outgoing]\n method = \"command\"\n command = [\"sendmail\", \"-i\", \"-t\"]\n\nSee \"`Configuration`_\" below for details.\n\nExample\n=======\n\nAn example of the sort of e-mail that ``reponews`` might send you::\n\n [luser/my-repo] ISSUE #42: I found a bug (@bug-finder)\n <https://github.com/luser/my-repo/issues/42>\n\n @bug-fixer forked luser/my-repo\n <https://github.com/bug.fixer/my-repo>\n\n [luser/my-repo] PR #43: I fixed that bug (@bug-fixer)\n <https://github.com/luser/my-repo/pull/43>\n\n \u2605 @repo-fan starred orgcorp/bigrepo\n\n [orgcorp/bigrepo] DISCUSSION #123: How do I use this? (@confused-user)\n <https://github.com/orgcorp/bigrepo/discussions/123>\n\n [theteam/theproject] RELEASE v1.0a1 [prerelease]: v1 Preview (@github-actions[bot])\n <https://github.com/theteam/theproject/releases/tag/v1.0a1>\n > We're gearing up for the first full release! Here are some changes you'll find:\n >\n > * Added a feature\n > * Fixed a bug\n\n Now tracking repository luser/brand-new-repo\n <https://github.com/luser/brand-new-repo>\n > This is the repository description.\n\n No longer tracking repository tmprepos/deleted-repo\n\n Repository renamed: team-member/new-project \u2192 theteam/new-project\n\n\nUsage\n=====\n\n::\n\n reponews [<options>]\n\nThe ``reponews`` command queries GitHub's GraphQL API for new issues, pull\nrequests, discussions, releases, tags, stargazers, and/or forks on the\nrepositories specified in its configuration file (by default, all repositories\naffiliated with the authenticated user) and composes & sends an e-mail listing\nthe events in chronological order. Also included in the report are\nnotifications about newly-tracked and -untracked repositories and renamed\nrepositories. If there is no new activity, no e-mail is sent.\n\n\"New\" activity is, in the general case, anything that has happened since the\nlast time ``reponews`` was successfully run (specifically, since the last time\nthe state file was updated). The first time ``reponews`` is run, it merely\nreports all the repositories that it is now tracking. If ``reponews`` stops\ntracking a repository (usually because the repository listing in the config\nfile was edited) and then starts tracking it again, it will *not* pick up where\nit left off; instead, when it first starts tracking the repository again, it\nwill mark down that point in time and afterwards only report events occurring\nafter it. Similar behavior occurs if ``reponews`` stops tracking a certain\ntype of activity and then starts tracking it again.\n\nOptions\n-------\n\n-c PATH, --config PATH Specify the configuration file to use. See\n \"`Configuration`_\" below for the default config\n file location.\n\n--dump-repos Instead of fetching repository activity, dump\n the set of tracked repositories and their\n configured activity preferences as a JSON\n document\n\n-E FILE, --env FILE Load environment variables from the given\n ``.env`` file. By default, environment\n variables are loaded from the first file named\n \"``.env``\" found by searching from the current\n directory upwards.\n\n-l LEVEL, --log-level LEVEL Set the log level to the given value. Possible\n values are \"``CRITICAL``\", \"``ERROR``\",\n \"``WARNING``\", \"``INFO``\", \"``DEBUG``\" (all\n case-insensitive) and their Python integer\n equivalents. [default: ``WARNING``]\n\n--print Cause ``reponews`` to output the e-mail (as a\n MIME document) instead of sending it\n\n--print-body Cause ``reponews`` to output the body of the\n e-mail instead of sending it\n\n--save, --no-save Update/do not update the state file on\n successful completion [default: ``--save``]\n\n\nConfiguration\n=============\n\n``reponews`` is configured via a `TOML <https://toml.io>`_ file whose default\nlocation depends on your OS:\n\n======= ==================================================================\nLinux ``~/.config/reponews/config.toml``\n or ``$XDG_CONFIG_HOME/reponews/config.toml``\nmacOS ``~/Library/Application Support/reponews/config.toml``\nWindows ``%USERPROFILE%\\AppData\\Local\\jwodder\\reponews\\config.toml``\n======= ==================================================================\n\nThis TOML file must contain a ``[reponews]`` table with the following keys &\nsubtables (all of which are optional unless stated otherwise). Unknown keys\nresult in an error.\n\n``recipient`` : e-mail address\n [Required when ``--print-body`` is not given] The e-mail address to which\n ``reponews`` should send its reports. This can be either a plain e-mail\n address (e.g., ``\"me@example.com\"``) or a display name with an address in\n angle brackets (e.g., ``\"Madam E <me@example.com>\"``). Note that, if the\n display name contains any punctuation, it needs to be enclosed in double\n quotes, which then need to be escaped for use in the TOML string, e.g.,\n ``\"\\\"Joe Q. Recipient\\\" <jqr@example.net>\"``.\n\n``sender`` : e-mail address\n The ``From:`` address to put on ``reponews``'s e-mails; specified the same\n way as ``recipient``. If ``sender`` is not specified, it is assumed that\n the e-mail sending mechanism will automatically fill in the ``From:``\n address appropriately.\n\n``subject`` : string\n The subject to apply to ``reponews``'s e-mails; defaults to \"[reponews] New\n activity on your GitHub repositories\".\n\n``auth-token`` : string\n The GitHub access token to use for interacting with the GitHub API. If\n ``auth-token`` is not set, the token will be read from the file specified\n by ``auth-token-file``. If neither key is set, the GitHub token is looked\n up via the following sources, in order:\n\n - The ``GH_TOKEN`` and ``GITHUB_TOKEN`` environment variables (possibly set\n via the ``.env`` file; see the ``--env`` option under \"Options_\" above)\n\n - The gh_ command, if installed\n\n - The hub_ command's configuration file\n\n - The ``hub.oauthtoken`` Git config option\n\n .. _gh: https://github.com/cli/cli\n .. _hub: https://github.com/mislav/hub\n\n``auth-token-file`` : path\n The path to a file containing the GitHub access token to use for\n interacting with the GitHub API. The file must contain only the token and\n possibly leading and/or trailing whitespace.\n\n The path may start with a tilde (``~``) to indicate a file in the user's\n home directory. A relative path will be resolved relative to the directory\n containing the config file.\n\n``state-file`` : path\n The path to the file where ``reponews`` will store repository activity\n state, used to determine the cutoff point for new activity. The path may\n start with a tilde (``~``) to indicate a file in the user's home directory.\n A relative path will be resolved relative to the directory containing the\n config file.\n\n The default location for the state file depends on your OS:\n\n ======= =================================================================\n Linux ``~/.local/state/reponews/state.json``\n or ``$XDG_STATE_HOME/reponews/state.json``\n macOS ``~/Library/Application Support/reponews/state.json``\n Windows ``%USERPROFILE%\\AppData\\Local\\jwodder\\reponews\\state.json``\n ======= =================================================================\n\n``api-url`` : URL\n The GraphQL endpoint to query; defaults to \"https://api.github.com/graphql\"\n\n``activity`` : table\n A subtable describing what types of repository activity to fetch & track.\n This table may contain the following keys:\n\n ``issues`` : boolean\n Whether to report new issues in tracked repositories; defaults to true\n\n ``pull-requests`` : boolean\n Whether to report new pull requests in tracked repositories; defaults\n to true\n\n ``discussions`` : boolean\n Whether to report new `discussions`_ in tracked repositories; defaults\n to true\n\n ``releases`` : boolean\n Whether to report new releases in tracked repositories; defaults to\n true\n\n ``tags`` : boolean\n Whether to report new tags in tracked repositories; defaults to true\n\n ``released-tags`` : boolean\n This setting controls how to handle tags that are also made into\n releases when both tags and releases are being tracked. If true, such\n tags are reported separately from the releases. If false (the\n default), such tags are not reported.\n\n ``stars`` : boolean\n Whether to report new stargazers for tracked repositories; defaults to\n true\n\n ``forks`` : boolean\n Whether to report new forks of tracked repositories; defaults to true\n\n ``my-activity`` : boolean\n When false (the default), activity performed by the authenticated user\n is not reported.\n\n ``affiliated`` : table\n A subtable describing what types of repository activity to fetch &\n track for repositories affiliated with the authenticated user. The\n table's keys are the same as the boolean keys of\n ``[reponews.activity]``.\n\n ``repo`` : table\n A subtable describing what types of repository activity to fetch &\n track for specific repositories or repositories belonging to a given\n user/organization. The keys of the subtable must be of the form\n ``\"owner/name\"`` (for a specific repository) or ``\"owner/*\"`` (for all\n repositories belonging to a given user/organization), and the values\n must be subtables with the same boolean keys as\n ``[reponews.activity]``.\n\n By default, all repositories and repository owners listed as keys in\n ``[reponews.activity.repo]`` will be tracked by ``reponews`` just as if\n they were listed under ``reponews.repos.include`` (see below). This\n can be disabled for a single key by setting ``include = false`` in the\n key's subtable.\n\n When determining the activity to fetch & track for a repository\n ``owner/name``, each setting is looked up in the relevant tables in the\n following order, from highest precedence to lowest precedence:\n\n 1. ``[reponews.activity.repo.\"owner/name\"]``\n 2. ``[reponews.activity.repo.\"owner/*\"]``\n 3. ``[reponews.activity.affiliated]`` (if the repository is affiliated with\n the authenticated user)\n 4. ``[reponews.activity]``\n\n``repos`` : table\n A subtable describing what repositories to track. This table may contain\n the following keys:\n\n ``affiliations`` : list of strings\n A list of repository affiliations describing which repositories\n associated with the authenticated user should be automatically tracked.\n The affiliations are ``\"OWNER\"`` (for tracking repositories that the\n user owns), ``\"ORGANIZATION_MEMBER\"`` (for tracking repositories\n belonging to an organization of which the user is a member), and\n ``\"COLLABORATOR\"`` (for tracking repositories to which the user has\n been added as a collaborator). Unknown affiliations result in an\n error. When ``affiliations`` is not specified, it defaults to all\n affiliation types.\n\n ``include`` : list of strings\n A list of repositories to track in addition to affiliated repositories.\n Repositories can be specified as either ``\"owner/name\"`` (for a\n specific repository) or ``\"owner/*\"`` (for all repositories belonging\n to a given user/organization).\n\n ``exclude`` : list of strings\n A list of repositories to exclude from tracking, specified the same way\n as for ``include``. This option takes precedence over the\n ``affiliations`` and ``include`` settings.\n\n.. _discussions: https://docs.github.com/en/discussions\n\n\nExample Configuration\n---------------------\n\n.. code:: toml\n\n [reponews]\n recipient = \"luser@example.com\"\n\n sender = \"RepoNews Bot <reponews@example.net>\"\n\n # Fetch the GitHub access token from the \"token.txt\" file next to the\n # config file:\n auth-token-file = \"token.txt\"\n\n state-file = \"~/.cache/reponews.json\"\n\n [reponews.activity]\n # Don't report new issues or tags:\n issues = false\n tags = false\n\n [reponews.activity.affiliated]\n # Do report new issues for affiliated repositories:\n issues = true\n\n [reponews.activity.repo.\"pypa/*\"]\n # Don't report forks of pypa/* repositories:\n forks = false\n # Don't track all pypa/* repositories; only track those we're affiliated\n # with and those listed under `reponews.repos.include`.\n #\n # Without this setting, the presence of `[reponews.activity.repo.\"pypa/*\"]`\n # would cause reponews to track all repositories belonging to the pypa\n # organization.\n include = false\n\n [reponews.repos]\n affiliations = [\"OWNER\", \"ORGANIZATION_MEMBER\"]\n include = [\n \"pypa/packaging\",\n \"pypa/pip\",\n \"pypa/setuptools\",\n \"some-user/*\",\n ]\n exclude = [\n \"some-user/boring-repo\",\n ]\n\n\nSending E-Mail\n==============\n\n``reponews`` uses outgoing_ for sending e-mail, allowing it to handle multiple\nsending methods like sendmail, SMTP, and more. The `outgoing configuration`_\ncan be located in the ``reponews`` configuration file (as an ``[outgoing]``\ntable) or in ``outgoing``'s default configuration file. See `outgoing's\ndocumentation <https://outgoing.rtfd.io>`_ for more information.\n\n.. _outgoing: https://github.com/jwodder/outgoing\n\n.. _outgoing configuration:\n https://outgoing.readthedocs.io/en/latest/configuration.html\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Send e-mails about new events on your GitHub repositories",
"version": "0.4.0",
"project_urls": {
"Bug Tracker": "https://github.com/jwodder/reponews/issues",
"Homepage": "https://github.com/jwodder/reponews",
"Source Code": "https://github.com/jwodder/reponews"
},
"split_keywords": [
"github",
"github activity",
"github issues",
"e-mail",
"notifications",
"pull requests"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "0fc02407c556955cdc6b952600e17207f14e3f8ede6308614a60f1b57002b1a1",
"md5": "6b6680fed816de36af91ae8f68b897ba",
"sha256": "9ee4ed7b89e1c287d9013c935b1a3a9faebe59f483fc3e162cd6147bb8e61d0c"
},
"downloads": -1,
"filename": "reponews-0.4.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "6b6680fed816de36af91ae8f68b897ba",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 24001,
"upload_time": "2023-10-31T16:49:47",
"upload_time_iso_8601": "2023-10-31T16:49:47.673838Z",
"url": "https://files.pythonhosted.org/packages/0f/c0/2407c556955cdc6b952600e17207f14e3f8ede6308614a60f1b57002b1a1/reponews-0.4.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "894e3b99e4eb81c268c28b4cc5a63df327094537e5911d10776d70924a01fd1b",
"md5": "7f0493a0c678bf0c954d2aefb906d9d7",
"sha256": "84a9dce78876155f184f4dfd59e7dcb5bfa75ab2f925b4227807de73684a5b3a"
},
"downloads": -1,
"filename": "reponews-0.4.0.tar.gz",
"has_sig": false,
"md5_digest": "7f0493a0c678bf0c954d2aefb906d9d7",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 45534,
"upload_time": "2023-10-31T16:49:48",
"upload_time_iso_8601": "2023-10-31T16:49:48.975301Z",
"url": "https://files.pythonhosted.org/packages/89/4e/3b99e4eb81c268c28b4cc5a63df327094537e5911d10776d70924a01fd1b/reponews-0.4.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-10-31 16:49:48",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "jwodder",
"github_project": "reponews",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"tox": true,
"lcname": "reponews"
}
JSON
