rename built in node

Author: joelee2012

.github/workflows/tests.yml

@@ -9,7 +9,7 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        python-version: [3.6, 3.7, 3.8, 3.9]
+        python-version: [3.6, 3.7, 3.8, 3.9, 3.10]
         os: [ubuntu-latest, macOS-latest, windows-latest]
         include:
           - python-version: pypy3

HISTORY.md

@@ -1,5 +1,10 @@
 Release History
 ===============
+1.8 (2021-12-??)
+-----------------
+- Rename built-in node as https://www.jenkins.io/doc/book/managing/built-in-node-migration/
+- Get parameters for job
+
 1.7 (2021-10-09)
 -----------------
 - `Jenkins.get_job` can accept job url now

api4jenkins/__version__.py

@@ -1,10 +1,10 @@
 # -*- coding: utf-8 -*-
-__version__ = '1.7'
+__version__ = '1.8'
 __title__ = 'api4jenkins'
 __description__ = 'Jenkins Python Client'
 __url__ = 'https://github.com/joelee2012/api4jenkins'
 __author__ = 'Joe Lee'
 __author_email__ = 'lj_2005@163.com'
 __license__ = 'Apache 2.0'
-__copyright__ = 'Copyright 2021 Joe Lee'
+__copyright__ = 'Copyright 2022 Joe Lee'
 __documentation__ = 'https://api4jenkins.readthedocs.io'

api4jenkins/job.py

@@ -150,6 +150,13 @@ def set_next_build_number(self, number):
         self.handle_req('POST', 'nextbuildnumber/submit',
                         params={'nextBuildNumber': number})
 
+    def get_parameters(self):
+        params = []
+        for p in self.api_json()['property']:
+            if 'parameterDefinitions' in p:
+                params = p['parameterDefinitions']
+        return params
+
     @property
     def building(self):
         builds = self.api_json(tree='builds[building]')['builds']

api4jenkins/node.py

@@ -106,7 +106,7 @@ def __iter__(self):
 
 class MasterComputer(Node):
     def __init__(self, jenkins, url):
-        super().__init__(jenkins, re.sub(r'/master/$', '/(master)/', url))
+        super().__init__(jenkins, re.sub(r'/Built-In Node/$', '/(built-in)/', url))
 
 
 class SlaveComputer(Node):

api4jenkins/utils.py

@@ -33,3 +33,8 @@ def filter_job_build_by_result(job, *, result):
     if result not in expect:
         raise ValueError(f'Expect one of {expect}')
     yield from filter(lambda build: build.result == result, job)
+
+
+def iter_all_builds(job):
+    for item in job.api_json(tree='allBuilds[number,url]')['allBuilds']:
+        yield job._new_instance_by_item('api4jenkins.build', item)

docs/source/user/example.rst

@@ -299,6 +299,10 @@ build with parameters
 
     >>> item = job.build(arg1='string1', arg2='string2')
 
+get job parameters
+
+    >>> parameters = job.get_parameters()
+
 disable/enable project to
 
     >>> job.disable()
@@ -336,7 +340,7 @@ set next build number (requires `next-build-number` plugin)
 
     >>> job.set_next_build_number(1)
 
-iterate all builds of this project, following are same
+iterate builds(latest 100 builds) of this project, following are same
 
     >>> for build in job:
     ...     print(build)

setup.py

@@ -42,6 +42,7 @@
         'Programming Language :: Python :: 3.7',
         'Programming Language :: Python :: 3.8',
         'Programming Language :: Python :: 3.9',
+        'Programming Language :: Python :: 3.10',
         'Topic :: Software Development',
     ],
     project_urls={