RBTools 5.3__tar.gz → 6.0__tar.gz

{rbtools-5.3 → rbtools-6.0}/AUTHORS

@@ -29,12 +29,12 @@ Contributors:
 	* Anthony Cruz
 	* Anthony Hache
 	* Azad Salahli
-	* Barret Rennie
 	* Bartosz Gołek
 	* Ben (full name unknown)
 	* Ben Asher
 	* Ben Hollis
 	* Ben Jackson
+	* Beth Rennie
 	* Bogdana Popa
 	* Bradley Baetz
 	* Brandon Martin

{rbtools-5.3 → rbtools-6.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: RBTools
-Version: 5.3
+Version: 6.0
 Summary: Command line tools and API for working with code and document reviews on Review Board
 Author-email: "Beanbag, Inc." <questions@beanbaginc.com>
 License: MIT
@@ -16,17 +16,18 @@ Classifier: Natural Language :: English
 Classifier: Operating System :: OS Independent
 Classifier: Programming Language :: Python
 Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.8
-Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
 Classifier: Topic :: Software Development
 Classifier: Topic :: Software Development :: Quality Assurance
-Requires-Python: >=3.8
+Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 License-File: COPYING
 License-File: AUTHORS
+Requires-Dist: appdirs~=1.4.4
 Requires-Dist: certifi>=2023.5.7
 Requires-Dist: colorama
 Requires-Dist: housekeeping~=1.1
@@ -34,6 +35,7 @@ Requires-Dist: packaging>=21.3
 Requires-Dist: puremagic
 Requires-Dist: pydiffx~=1.1.0
 Requires-Dist: texttable
+Requires-Dist: typelets~=1.1.0
 Requires-Dist: typing_extensions>=4.3.0
 Requires-Dist: tqdm
 Requires-Dist: importlib-metadata>=5.0

{rbtools-5.3 → rbtools-6.0}/RBTools.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: RBTools
-Version: 5.3
+Version: 6.0
 Summary: Command line tools and API for working with code and document reviews on Review Board
 Author-email: "Beanbag, Inc." <questions@beanbaginc.com>
 License: MIT
@@ -16,17 +16,18 @@ Classifier: Natural Language :: English
 Classifier: Operating System :: OS Independent
 Classifier: Programming Language :: Python
 Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.8
-Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
 Classifier: Topic :: Software Development
 Classifier: Topic :: Software Development :: Quality Assurance
-Requires-Python: >=3.8
+Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 License-File: COPYING
 License-File: AUTHORS
+Requires-Dist: appdirs~=1.4.4
 Requires-Dist: certifi>=2023.5.7
 Requires-Dist: colorama
 Requires-Dist: housekeeping~=1.1
@@ -34,6 +35,7 @@ Requires-Dist: packaging>=21.3
 Requires-Dist: puremagic
 Requires-Dist: pydiffx~=1.1.0
 Requires-Dist: texttable
+Requires-Dist: typelets~=1.1.0
 Requires-Dist: typing_extensions>=4.3.0
 Requires-Dist: tqdm
 Requires-Dist: importlib-metadata>=5.0

{rbtools-5.3 → rbtools-6.0}/RBTools.egg-info/SOURCES.txt

@@ -39,6 +39,7 @@ contrib/tools/git-hook-check-approval
 contrib/tools/git-hook-set-submitted
 contrib/tools/p4-trigger-script
 docs/rbtools/Makefile
+docs/rbtools/authentication.rst
 docs/rbtools/conf.py
 docs/rbtools/glossary.rst
 docs/rbtools/index.rst
@@ -48,7 +49,6 @@ docs/rbtools/_ext/__init__.py
 docs/rbtools/_ext/rbt_commands.py
 docs/rbtools/api/index.rst
 docs/rbtools/api/overview.rst
-docs/rbtools/api/resource-specific.rst
 docs/rbtools/api/tutorial.rst
 docs/rbtools/api/coderef/index.rst
 docs/rbtools/rbt/index.rst
@@ -59,6 +59,7 @@ docs/rbtools/rbt/commands/clear-cache.rst
 docs/rbtools/rbt/commands/close.rst
 docs/rbtools/rbt/commands/diff.rst
 docs/rbtools/rbt/commands/index.rst
+docs/rbtools/rbt/commands/info.rst
 docs/rbtools/rbt/commands/install.rst
 docs/rbtools/rbt/commands/land.rst
 docs/rbtools/rbt/commands/list-repo-types.rst
@@ -73,7 +74,7 @@ docs/rbtools/rbt/commands/setup-repo.rst
 docs/rbtools/rbt/commands/stamp.rst
 docs/rbtools/rbt/commands/status-update.rst
 docs/rbtools/rbt/commands/status.rst
-docs/rbtools/rbt/configuration/authentication.rst
+docs/rbtools/rbt/configuration/aliases.rst
 docs/rbtools/rbt/configuration/index.rst
 docs/rbtools/rbt/configuration/repositories.rst
 docs/rbtools/rbt/configuration/tfs.rst
@@ -81,6 +82,7 @@ docs/rbtools/rbt/configuration/users.rst
 docs/rbtools/workflows/clearcase.rst
 docs/rbtools/workflows/git.rst
 docs/rbtools/workflows/index.rst
+docs/rbtools/workflows/jujutsu.rst
 docs/rbtools/workflows/perforce.rst
 docs/rbtools/workflows/sos.rst
 docs/releasenotes/0.2-beta-1.rst
@@ -138,6 +140,7 @@ docs/releasenotes/5.1.rst
 docs/releasenotes/5.2.1.rst
 docs/releasenotes/5.2.rst
 docs/releasenotes/5.3.rst
+docs/releasenotes/6.0.rst
 docs/releasenotes/Makefile
 docs/releasenotes/conf.py
 docs/releasenotes/index.rst
@@ -153,10 +156,73 @@ rbtools/api/decorators.py
 rbtools/api/errors.py
 rbtools/api/factory.py
 rbtools/api/request.py
-rbtools/api/resource.py
 rbtools/api/utils.py
+rbtools/api/resource/__init__.py
+rbtools/api/resource/api_token.py
+rbtools/api/resource/archived_review_request.py
+rbtools/api/resource/base.py
+rbtools/api/resource/base_archived_object.py
+rbtools/api/resource/base_comment.py
+rbtools/api/resource/base_diff_commit.py
+rbtools/api/resource/base_review.py
+rbtools/api/resource/base_review_group.py
+rbtools/api/resource/base_review_request.py
+rbtools/api/resource/base_user.py
+rbtools/api/resource/change.py
+rbtools/api/resource/default_reviewer.py
+rbtools/api/resource/diff.py
+rbtools/api/resource/diff_comment.py
+rbtools/api/resource/diff_commit.py
+rbtools/api/resource/diff_context.py
+rbtools/api/resource/diff_file_attachment.py
+rbtools/api/resource/draft_diff_commit.py
+rbtools/api/resource/draft_file_attachment.py
+rbtools/api/resource/draft_screenshot.py
+rbtools/api/resource/extension.py
+rbtools/api/resource/file_attachment.py
+rbtools/api/resource/file_attachment_comment.py
+rbtools/api/resource/file_diff.py
+rbtools/api/resource/general_comment.py
+rbtools/api/resource/hosting_service.py
+rbtools/api/resource/hosting_service_account.py
+rbtools/api/resource/last_update.py
+rbtools/api/resource/mixins.py
+rbtools/api/resource/muted_review_request.py
+rbtools/api/resource/oauth_application.py
+rbtools/api/resource/oauth_token.py
+rbtools/api/resource/plain_text.py
+rbtools/api/resource/remote_repository.py
+rbtools/api/resource/repository.py
+rbtools/api/resource/repository_branch.py
+rbtools/api/resource/repository_commit.py
+rbtools/api/resource/repository_group.py
+rbtools/api/resource/repository_info.py
+rbtools/api/resource/repository_user.py
+rbtools/api/resource/review.py
+rbtools/api/resource/review_group.py
+rbtools/api/resource/review_group_user.py
+rbtools/api/resource/review_reply.py
+rbtools/api/resource/review_request.py
+rbtools/api/resource/review_request_draft.py
+rbtools/api/resource/root.py
+rbtools/api/resource/screenshot.py
+rbtools/api/resource/screenshot_comment.py
+rbtools/api/resource/search.py
+rbtools/api/resource/server_info.py
+rbtools/api/resource/session.py
+rbtools/api/resource/status_update.py
+rbtools/api/resource/user.py
+rbtools/api/resource/user_file_attachment.py
+rbtools/api/resource/validate_diff.py
+rbtools/api/resource/validate_diff_commit.py
+rbtools/api/resource/validation.py
+rbtools/api/resource/watched.py
+rbtools/api/resource/watched_review_group.py
+rbtools/api/resource/watched_review_request.py
+rbtools/api/resource/webhook.py
 rbtools/api/tests/__init__.py
 rbtools/api/tests/base.py
+rbtools/api/tests/test_auth_handlers.py
 rbtools/api/tests/test_capabilities.py
 rbtools/api/tests/test_errors.py
 rbtools/api/tests/test_factory.py
@@ -170,6 +236,7 @@ rbtools/clients/clearcase.py
 rbtools/clients/cvs.py
 rbtools/clients/errors.py
 rbtools/clients/git.py
+rbtools/clients/jujutsu.py
 rbtools/clients/mercurial.py
 rbtools/clients/perforce.py
 rbtools/clients/plastic.py
@@ -187,6 +254,7 @@ rbtools/clients/tests/test_bzr.py
 rbtools/clients/tests/test_clearcase.py
 rbtools/clients/tests/test_cvs.py
 rbtools/clients/tests/test_git.py
+rbtools/clients/tests/test_jujutsu.py
 rbtools/clients/tests/test_legacy_patcher.py
 rbtools/clients/tests/test_mercurial.py
 rbtools/clients/tests/test_p4.py
@@ -264,6 +332,7 @@ rbtools/clients/tests/testdata/homedir/.bazaar/bazaar.conf
 rbtools/clients/tests/testdata/svn-repo/README.txt
 rbtools/clients/tests/testdata/svn-repo/format
 rbtools/clients/tests/testdata/svn-repo/conf/authz
+rbtools/clients/tests/testdata/svn-repo/conf/hooks-env.tmpl
 rbtools/clients/tests/testdata/svn-repo/conf/passwd
 rbtools/clients/tests/testdata/svn-repo/conf/svnserve.conf
 rbtools/clients/tests/testdata/svn-repo/db/current
@@ -283,6 +352,7 @@ rbtools/clients/tests/testdata/svn-repo/db/revprops/0/3
 rbtools/clients/tests/testdata/svn-repo/db/revprops/0/4
 rbtools/clients/tests/testdata/svn-repo/db/revprops/0/5
 rbtools/clients/tests/testdata/svn-repo/db/revprops/0/6
+rbtools/clients/tests/testdata/svn-repo/db/revprops/0/7
 rbtools/clients/tests/testdata/svn-repo/db/revs/0/0
 rbtools/clients/tests/testdata/svn-repo/db/revs/0/1
 rbtools/clients/tests/testdata/svn-repo/db/revs/0/2
@@ -290,6 +360,7 @@ rbtools/clients/tests/testdata/svn-repo/db/revs/0/3
 rbtools/clients/tests/testdata/svn-repo/db/revs/0/4
 rbtools/clients/tests/testdata/svn-repo/db/revs/0/5
 rbtools/clients/tests/testdata/svn-repo/db/revs/0/6
+rbtools/clients/tests/testdata/svn-repo/db/revs/0/7
 rbtools/clients/tests/testdata/svn-repo/db/transactions/.gitignore
 rbtools/clients/tests/testdata/svn-repo/db/txn-protorevs/.gitignore
 rbtools/clients/tests/testdata/svn-repo/hooks/post-commit.tmpl
@@ -336,7 +407,10 @@ rbtools/commands/conf/completions/zsh
 rbtools/commands/tests/__init__.py
 rbtools/commands/tests/test_alias.py
 rbtools/commands/tests/test_base_output.py
+rbtools/commands/tests/test_command_auth_session.py
 rbtools/commands/tests/test_command_initialization.py
+rbtools/commands/tests/test_login.py
+rbtools/commands/tests/test_logout.py
 rbtools/commands/tests/test_main.py
 rbtools/commands/tests/test_post.py
 rbtools/commands/tests/test_setup_completion.py
@@ -384,11 +458,8 @@ rbtools/testing/api/__init__.py
 rbtools/testing/api/payloads.py
 rbtools/testing/api/transport.py
 rbtools/testing/scripts/editor.py
-rbtools/utils/COPYING.appdirs
-rbtools/utils/README.appdirs
 rbtools/utils/__init__.py
 rbtools/utils/aliases.py
-rbtools/utils/appdirs.py
 rbtools/utils/browser.py
 rbtools/utils/checks.py
 rbtools/utils/commands.py

{rbtools-5.3 → rbtools-6.0}/RBTools.egg-info/requires.txt

@@ -1,3 +1,4 @@
+appdirs~=1.4.4
 certifi>=2023.5.7
 colorama
 housekeeping~=1.1
@@ -5,6 +6,7 @@ packaging>=21.3
 puremagic
 pydiffx~=1.1.0
 texttable
+typelets~=1.1.0
 typing_extensions>=4.3.0
 tqdm
 importlib-metadata>=5.0

{rbtools-5.3 → rbtools-6.0}/contrib/installers/windows/build-installer.bat

@@ -249,7 +249,7 @@ set _rbtools_version=%_return1%
 
 set _wix_path=%CD%\wix
 set _sln_file=%_wix_path%\rbtools.sln
-set _timestamp_url=http://timestamp.comodoca.com/authenticode
+set _timestamp_url=http://timestamp.sectigo.com
 
 echo.
 echo == Building the RBTools installer [x64] ==

{rbtools-5.3 → rbtools-6.0}/docs/rbtools/_ext/rbt_commands.py

@@ -1,3 +1,7 @@
+"""Documentation utils for RBTools commands."""
+
+from __future__ import annotations
+
 import re
 import sys
 
@@ -79,10 +83,8 @@ class CommandDirective(Directive):
 
         name = make_command_section_ref_id(cmd_class.name)
 
-        env.temp_data.update({
-            'rbt-command:class': cmd_class,
-            'rbt-command:doc-prefix': name,
-        })
+        env.temp_data['rbt-command:class'] = cmd_class
+        env.temp_data['rbt-command:doc-prefix'] = name
 
         target_node = nodes.target('', '', ids=[name], names=[name])
         doc.note_explicit_target(target_node)
@@ -131,16 +133,21 @@ class CommandUsageDirective(Directive):
         command_cls = get_current_command_class(env)
         command = command_cls()
 
+        parser_kwargs = {
+            'color': False,
+            'config': {},
+        }
+
         if for_subcommand:
             subcommand_cls = get_current_command_class(env,
                                                        for_subcommand=True)
 
             command.create_parser(
-                config={},
-                argv=['rbt', command_cls.name, subcommand_cls.name])
+                argv=['rbt', command_cls.name, subcommand_cls.name],
+                **parser_kwargs)
             parser = command.subcommand_parsers[subcommand_cls.name]
         else:
-            parser = command.create_parser({})
+            parser = command.create_parser(**parser_kwargs)
 
         usage = '$ %s' % parser.format_help().splitlines()[0][7:]
 
@@ -282,13 +289,26 @@ class CommandOptionsDirective(Directive):
 
         return [section]
 
-    def output_option(self, option):
+    def output_option(
+        self,
+        option: Option,
+    ) -> list[nodes.paragraph]:
+        """Output the documentation for an option of a command.
+
+        Args:
+            option (rbtools.commands.base.options.Option):
+                The option.
+
+        Returns:
+            list of docutils.nodes.paragraph:
+            The documentation for the option.
+        """
         default_text = ''
 
         content = [self.format_content(option.attrs['help'])]
 
-        if 'extended_help' in option.attrs:
-            content.append(self.format_content(option.attrs['extended_help']))
+        if extended_help := option.extended_help:
+            content.append(self.format_content(extended_help))
 
         if 'default' in option.attrs:
             action = option.attrs.get('action', 'store')
@@ -302,18 +322,16 @@ class CommandOptionsDirective(Directive):
                 default_text = ('If not specified, ``%s`` is used by default.'
                                 % default)
 
-        if 'config_key' in option.attrs:
+        if config_key := option.config_key:
             if default_text:
                 default_text += (
-                    ' The default can be changed by setting :rbtconfig:`%s` '
-                    'in :ref:`rbtools-reviewboardrc`.'
-                    % option.attrs['config_key']
+                    f' The default can be changed by setting :rbtconfig:'
+                    f'`{config_key}` in :ref:`rbtools-reviewboardrc`.'
                 )
             else:
                 default_text = (
-                    'The default can be set in :rbtconfig:`%s` in '
-                    ':ref:`rbtools-reviewboardrc`.'
-                    % option.attrs['config_key']
+                    f'The default can be set in :rbtconfig:`{config_key}` in '
+                    f':ref:`rbtools-reviewboardrc`.'
                 )
 
         if default_text:
@@ -341,23 +359,39 @@ class CommandOptionsDirective(Directive):
         else:
             option_args = ', '.join(option.opts)
 
-        if 'deprecated_in' in option.attrs:
-            content.append('.. deprecated:: %s'
-                           % option.attrs['deprecated_in'])
+        if deprecated_in := option.deprecated_in:
+            depr_dir = f'.. deprecated:: {deprecated_in}'
+            depr_desc_parts: list[str] = []
+
+            if removed_in := option.removed_in:
+                depr_desc_parts.append(f'Will be removed in {removed_in}.')
+
+            if replacement := option.replacement:
+                depr_desc_parts.append(f'Use :option:`{replacement}` instead.')
+
+            depr_desc = ' '.join(depr_desc_parts)
+
+            if depr_desc:
+                depr_final_str = '\n'.join([
+                    depr_dir,
+                    self.indent_content(depr_desc,
+                                        indent_level=2),
+                ])
+            else:
+                depr_final_str = depr_dir
 
-        if 'added_in' in option.attrs:
-            content.append('.. versionadded:: %s' % option.attrs['added_in'])
+            content.append(depr_final_str)
 
-        if 'versions_changed' in option.attrs:
-            versions_changed = option.attrs['versions_changed']
+        if added_in := option.added_in:
+            content.append(f'.. versionadded:: {added_in}')
 
+        if versions_changed := option.versions_changed:
             for version in sorted(versions_changed, reverse=True):
+                version_content = self.indent_content(
+                    self.format_content(versions_changed[version]),
+                    indent_level=2)
                 content.append(
-                    '.. versionchanged:: %s\n%s' % (
-                        version,
-                        self.indent_content(
-                            self.format_content(versions_changed[version]),
-                            indent_level=2)))
+                    f'.. versionchanged:: {version}\n{version_content}')
 
         node = parse_text(
             self,
@@ -424,10 +458,8 @@ class SubCommandDirective(Directive):
         name = make_command_section_ref_id(command_cls.name,
                                            subcommand_name)
 
-        env.temp_data.update({
-            'rbt-subcommand:class': subcommand_cls,
-            'rbt-subcommand:doc-prefix': name,
-        })
+        env.temp_data['rbt-subcommand:class'] = subcommand_cls
+        env.temp_data['rbt-subcommand:doc-prefix'] = name
 
         # Set up the initial target for this subcommand.
         target_node = nodes.target('', '',

{rbtools-5.3 → rbtools-6.0}/docs/rbtools/api/coderef/index.rst

@@ -18,6 +18,9 @@ Top-Level Modules
 Review Board API
 ================
 
+Base Support
+------------
+
 .. autosummary::
    :toctree: python
 
@@ -30,12 +33,91 @@ Review Board API
    rbtools.api.errors
    rbtools.api.factory
    rbtools.api.request
-   rbtools.api.resource
    rbtools.api.transport
    rbtools.api.transport.sync
    rbtools.api.utils
 
 
+Resource Base Classes
+---------------------
+
+.. autosummary::
+   :toctree: python
+
+   rbtools.api.resource
+   rbtools.api.resource.base
+   rbtools.api.resource.base_archived_object
+   rbtools.api.resource.base_comment
+   rbtools.api.resource.base_diff_commit
+   rbtools.api.resource.base_review_group
+   rbtools.api.resource.base_review_request
+   rbtools.api.resource.base_review
+   rbtools.api.resource.base_user
+   rbtools.api.resource.mixins
+
+
+Resources
+---------
+
+.. autosummary::
+   :toctree: python
+
+   rbtools.api.resource.api_token
+   rbtools.api.resource.archived_review_request
+   rbtools.api.resource.change
+   rbtools.api.resource.default_reviewer
+   rbtools.api.resource.diff_comment
+   rbtools.api.resource.diff_commit
+   rbtools.api.resource.diff_context
+   rbtools.api.resource.diff_file_attachment
+   rbtools.api.resource.diff
+   rbtools.api.resource.draft_diff_commit
+   rbtools.api.resource.draft_file_attachment
+   rbtools.api.resource.draft_screenshot
+   rbtools.api.resource.extension
+   rbtools.api.resource.file_attachment_comment
+   rbtools.api.resource.file_attachment
+   rbtools.api.resource.file_diff
+   rbtools.api.resource.general_comment
+   rbtools.api.resource.hosting_service_account
+   rbtools.api.resource.hosting_service
+   rbtools.api.resource.last_update
+   rbtools.api.resource.muted_review_request
+   rbtools.api.resource.oauth_application
+   rbtools.api.resource.oauth_token
+   rbtools.api.resource.plain_text
+   rbtools.api.resource.remote_repository
+   rbtools.api.resource.repository_branch
+   rbtools.api.resource.repository_commit
+   rbtools.api.resource.repository_group
+   rbtools.api.resource.repository_info
+   rbtools.api.resource.repository_user
+   rbtools.api.resource.repository
+   rbtools.api.resource.review_group_user
+   rbtools.api.resource.review_group
+   rbtools.api.resource.review_reply
+   rbtools.api.resource.review_request_draft
+   rbtools.api.resource.review_request
+   rbtools.api.resource.review
+   rbtools.api.resource.root
+   rbtools.api.resource.screenshot_comment
+   rbtools.api.resource.screenshot
+   rbtools.api.resource.search
+   rbtools.api.resource.server_info
+   rbtools.api.resource.session
+   rbtools.api.resource.status_update
+   rbtools.api.resource.user_file_attachment
+   rbtools.api.resource.user
+   rbtools.api.resource.validate_diff_commit
+   rbtools.api.resource.validate_diff
+   rbtools.api.resource.validation
+   rbtools.api.resource.watched_review_group
+   rbtools.api.resource.watched_review_request
+   rbtools.api.resource.watched
+   rbtools.api.resource.webhook
+
+
+
 Source Code Management Clients
 ==============================
 
@@ -123,7 +205,6 @@ Base Command Support
 .. autosummary::
    :toctree: python
 
-   rbtools.commands
    rbtools.commands.base
    rbtools.commands.base.commands
    rbtools.commands.base.errors

{rbtools-5.3 → rbtools-6.0}/docs/rbtools/api/index.rst

@@ -18,5 +18,4 @@ documentation, which can be found in the :ref:`rb:webapiguide`.
 
    overview
    tutorial
-   resource-specific
    coderef/index