API reference

class api4jenkins.Jenkins(url, **kwargs)

Constructs Jenkins.

Parameters:

• url – URL of Jenkins server, str

• auth – (optional) Auth tuple to enable Basic/Digest/Custom HTTP Auth.

• token – (optional) Boolean, Create user token when initialize instance and revoke token once instance is destroied. useful when LDAP server refuse username and password used too much often. Defaults to False.

• **kwargs – other kwargs are same as requests.Session.request

Usage:

>>> from api4jenkins import Jenkins
>>> j = Jenkins('http://127.0.0.1:8080/', auth=('admin', 'admin'))
>>> print(j)
<Jenkins: http://127.0.0.1:8080/>
>>> j.version
'2.176.2'

api_json(tree='', depth=0)

build_job(full_name, **params)

Build job with/without params

Parameters:

• full_name – str, full name of job

• params – parameters for building, support delay and remote token

Returns:

QueueItem

Usage:

>>> from api4jenkins import Jenkins
>>> j = Jenkins('http://127.0.0.1:8080/', auth=('admin', 'admin'))
>>> item = j.build_job('freestylejob')
>>> import time
>>> while not item.get_build():
...      time.sleep(1)
>>> build = item.get_build()
>>> print(build)
<FreeStyleBuild: http://127.0.0.1:8080/job/freestylejob/1/>
>>> for line in build.progressive_output():
...     print(line)
...

check_job_name(name)

copy_job(full_name, dest)

Create job by copying other job, the source job and dest job are in same folder.

Parameters:

• full_name – full name of source job

• dest – name of new job

Usage:

>>> from api4jenkins import Jenkins
>>> j = Jenkins('http://127.0.0.1:8080/', auth=('admin', 'admin'))
>>> j.copy_job('folder/freestylejob', 'newjob')
>>> j.get_job('folder/newjob')
>>> print(job)
<FreeStyleProject: http://127.0.0.1:8080/job/folder/job/newjob/>

create_job(full_name, xml, recursive=False)

Create new jenkins job with given xml configuration

Parameters:

• full_name – str, full name of job

• xml – xml configuration string

• recursive – (optional) Boolean, recursively create folder if not existed

Usage:

>>> from api4jenkins import Jenkins
>>> j = Jenkins('http://127.0.0.1:8080/', auth=('admin', 'admin'))
>>> xml = """<?xml version='1.1' encoding='UTF-8'?>
... <project>
...   <builders>
...     <hudson.tasks.Shell>
...       <command>echo $JENKINS_VERSION</command>
...     </hudson.tasks.Shell>
...   </builders>
... </project>"""
>>> j.create_job('freestylejob', xml)
>>> job = j.get_job('freestylejob')
>>> print(job)
<FreeStyleProject: http://127.0.0.1:8080/job/freestylejob/>

property credentials

An object for managing credentials. see Credentials

property crumb

Crumb of Jenkins

delete_job(full_name)

Delete job

Parameters:

full_name – str, full name of job

Usage:

>>> from api4jenkins import Jenkins
>>> j = Jenkins('http://127.0.0.1:8080/', auth=('admin', 'admin'))
>>> job = j.get_job('freestylejob')
>>> print(job)
<FreeStyleProject: http://127.0.0.1:8080/job/freestylejob/>
>>> j.delete_job('freestylejob')
>>> job = j.get_job('freestylejob')
>>> print(job)
None

property dynamic_attrs

exists()

Check if Jenkins server is up

Returns:

True or False

get_job(full_name)

Get job by full name

Parameters:

full_name – str, full name of job

Returns:

Corresponding Job object or None

Usage:

>>> from api4jenkins import Jenkins
>>> j = Jenkins('http://127.0.0.1:8080/', auth=('admin', 'admin'))
>>> job = j.get_job('freestylejob')
>>> print(job)
<FreeStyleProject: http://127.0.0.1:8080/job/freestylejob/>

handle_req(method, entry, **kwargs)

headers = {'Content-Type': 'text/xml; charset=utf-8'}

iter_jobs(depth=0)

Iterate jobs with depth

Parameters:

depth – int, depth to iterate, default is 0

Returns:

iterator of jobs

Usage:

>>> from api4jenkins import Jenkins
>>> j = Jenkins('http://127.0.0.1:8080/', auth=('admin', 'admin'))
>>> for job in j.iter_jobs():
...     print(job)
<FreeStyleProject: http://127.0.0.1:8080/job/freestylejob/>
...

property me

property nodes

An object for managing nodes. see Nodes

property plugins

An object for managing plugins. see PluginsManager

property queue

An object for managing build queue. see Queue

property system

An object for managing system operation. see System

property users

validate_jenkinsfile(content)

validate Jenkinsfile, see https://www.jenkins.io/doc/book/pipeline/development/#linter

Args:

content (str): content of Jenkinsfile

Returns:

str: ‘Jenkinsfile successfully validated.’ if validate successful or error message

property version

Version of Jenkins

property views

An object for managing views of main window. see Views

class api4jenkins.job.BitbucketSCMNavigator(jenkins, url)

api_json(tree='', depth=0)

build(**params)

property building

configure(xml=None)

delete()

disable()

duplicate(path, recursive=False)

property dynamic_attrs

enable()

exists()

filter_builds_by_result(*, result)

filter build by build results, avaliable results are: ‘SUCCESS’, ‘UNSTABLE’, ‘FAILURE’, ‘NOT_BUILT’, ‘ABORTED’ see: https://javadoc.jenkins-ci.org/hudson/model/Result.html

property full_display_name

property full_name

get_build(number)

get_parameters()

handle_req(method, entry, **kwargs)

headers = {'Content-Type': 'text/xml; charset=utf-8'}

iter_all_builds()

iter_builds()

move(path)

property name

property parent

rename(name)

set_description(text)

set_next_build_number(number)

class api4jenkins.job.ExternalJob(jenkins, url)

api_json(tree='', depth=0)

build(**params)

property building

configure(xml=None)

delete()

disable()

duplicate(path, recursive=False)

property dynamic_attrs

enable()

exists()

filter_builds_by_result(*, result)

filter build by build results, avaliable results are: ‘SUCCESS’, ‘UNSTABLE’, ‘FAILURE’, ‘NOT_BUILT’, ‘ABORTED’ see: https://javadoc.jenkins-ci.org/hudson/model/Result.html

property full_display_name

property full_name

get_build(number)

get_parameters()

handle_req(method, entry, **kwargs)

headers = {'Content-Type': 'text/xml; charset=utf-8'}

iter_all_builds()

iter_builds()

move(path)

property name

property parent

rename(name)

set_description(text)

set_next_build_number(number)

class api4jenkins.job.Folder(jenkins, url)

api_json(tree='', depth=0)

configure(xml=None)

copy(src, dest)

create(name, xml)

property credentials

delete()

duplicate(path, recursive=False)

property dynamic_attrs

exists()

property full_display_name

property full_name

get(name)

handle_req(method, entry, **kwargs)

headers = {'Content-Type': 'text/xml; charset=utf-8'}

iter(depth=0)

move(path)

property name

property parent

reload()

rename(name)

set_description(text)

property views

class api4jenkins.job.FreeStyleProject(jenkins, url)

api_json(tree='', depth=0)

build(**params)

property building

configure(xml=None)

delete()

disable()

duplicate(path, recursive=False)

property dynamic_attrs

enable()

exists()

filter_builds_by_result(*, result)

filter build by build results, avaliable results are: ‘SUCCESS’, ‘UNSTABLE’, ‘FAILURE’, ‘NOT_BUILT’, ‘ABORTED’ see: https://javadoc.jenkins-ci.org/hudson/model/Result.html

property full_display_name

property full_name

get_build(number)

get_parameters()

handle_req(method, entry, **kwargs)

headers = {'Content-Type': 'text/xml; charset=utf-8'}

iter_all_builds()

iter_builds()

move(path)

property name

property parent

rename(name)

set_description(text)

set_next_build_number(number)

class api4jenkins.job.GitHubSCMNavigator(jenkins, url)

api_json(tree='', depth=0)

build(**params)

property building

configure(xml=None)

delete()

disable()

duplicate(path, recursive=False)

property dynamic_attrs

enable()

exists()

filter_builds_by_result(*, result)

filter build by build results, avaliable results are: ‘SUCCESS’, ‘UNSTABLE’, ‘FAILURE’, ‘NOT_BUILT’, ‘ABORTED’ see: https://javadoc.jenkins-ci.org/hudson/model/Result.html

property full_display_name

property full_name

get_build(number)

get_parameters()

handle_req(method, entry, **kwargs)

headers = {'Content-Type': 'text/xml; charset=utf-8'}

iter_all_builds()

iter_builds()

move(path)

property name

property parent

rename(name)

set_description(text)

set_next_build_number(number)

class api4jenkins.job.IvyModuleSet(jenkins, url)

api_json(tree='', depth=0)

build(**params)

property building

configure(xml=None)

delete()

disable()

duplicate(path, recursive=False)

property dynamic_attrs

enable()

exists()

filter_builds_by_result(*, result)

filter build by build results, avaliable results are: ‘SUCCESS’, ‘UNSTABLE’, ‘FAILURE’, ‘NOT_BUILT’, ‘ABORTED’ see: https://javadoc.jenkins-ci.org/hudson/model/Result.html

property full_display_name

property full_name

get_build(number)

get_parameters()

handle_req(method, entry, **kwargs)

headers = {'Content-Type': 'text/xml; charset=utf-8'}

iter_all_builds()

iter_builds()

move(path)

property name

property parent

rename(name)

set_description(text)

set_next_build_number(number)

class api4jenkins.job.Job(jenkins, url)

api_json(tree='', depth=0)

configure(xml=None)

delete()

duplicate(path, recursive=False)

property dynamic_attrs

exists()

property full_display_name

property full_name

handle_req(method, entry, **kwargs)

headers = {'Content-Type': 'text/xml; charset=utf-8'}

move(path)

property name

property parent

rename(name)

set_description(text)

class api4jenkins.job.MatrixProject(jenkins, url)

api_json(tree='', depth=0)

build(**params)

property building

configure(xml=None)

delete()

disable()

duplicate(path, recursive=False)

property dynamic_attrs

enable()

exists()

filter_builds_by_result(*, result)

filter build by build results, avaliable results are: ‘SUCCESS’, ‘UNSTABLE’, ‘FAILURE’, ‘NOT_BUILT’, ‘ABORTED’ see: https://javadoc.jenkins-ci.org/hudson/model/Result.html

property full_display_name

property full_name

get_build(number)

get_parameters()

handle_req(method, entry, **kwargs)

headers = {'Content-Type': 'text/xml; charset=utf-8'}

iter_all_builds()

iter_builds()

move(path)

property name

property parent

rename(name)

set_description(text)

set_next_build_number(number)

class api4jenkins.job.MavenModuleSet(jenkins, url)

api_json(tree='', depth=0)

build(**params)

property building

configure(xml=None)

delete()

disable()

duplicate(path, recursive=False)

property dynamic_attrs

enable()

exists()

filter_builds_by_result(*, result)

filter build by build results, avaliable results are: ‘SUCCESS’, ‘UNSTABLE’, ‘FAILURE’, ‘NOT_BUILT’, ‘ABORTED’ see: https://javadoc.jenkins-ci.org/hudson/model/Result.html

property full_display_name

property full_name

get_build(number)

get_parameters()

handle_req(method, entry, **kwargs)

headers = {'Content-Type': 'text/xml; charset=utf-8'}

iter_all_builds()

iter_builds()

move(path)

property name

property parent

rename(name)

set_description(text)

set_next_build_number(number)

class api4jenkins.job.MultiJobProject(jenkins, url)

api_json(tree='', depth=0)

build(**params)

property building

configure(xml=None)

delete()

disable()

duplicate(path, recursive=False)

property dynamic_attrs

enable()

exists()

filter_builds_by_result(*, result)

filter build by build results, avaliable results are: ‘SUCCESS’, ‘UNSTABLE’, ‘FAILURE’, ‘NOT_BUILT’, ‘ABORTED’ see: https://javadoc.jenkins-ci.org/hudson/model/Result.html

property full_display_name

property full_name

get_build(number)

get_parameters()

handle_req(method, entry, **kwargs)

headers = {'Content-Type': 'text/xml; charset=utf-8'}

iter_all_builds()

iter_builds()

move(path)

property name

property parent

rename(name)

set_description(text)

set_next_build_number(number)

class api4jenkins.job.OrganizationFolder(jenkins, url)

api_json(tree='', depth=0)

property buildable

configure(xml=None)

copy(src, dest)

create(name, xml)

property credentials

delete()

disable()

duplicate(path, recursive=False)

property dynamic_attrs

enable()

exists()

property full_display_name

property full_name

get(name)

get_scan_log(stream=False)

handle_req(method, entry, **kwargs)

headers = {'Content-Type': 'text/xml; charset=utf-8'}

iter(depth=0)

move(path)

property name

property parent

reload()

rename(name)

scan(delay=0)

set_description(text)

property views

class api4jenkins.job.PipelineMultiBranchDefaultsProject(jenkins, url)

api_json(tree='', depth=0)

build(**params)

property building

configure(xml=None)

delete()

disable()

duplicate(path, recursive=False)

property dynamic_attrs

enable()

exists()

filter_builds_by_result(*, result)

filter build by build results, avaliable results are: ‘SUCCESS’, ‘UNSTABLE’, ‘FAILURE’, ‘NOT_BUILT’, ‘ABORTED’ see: https://javadoc.jenkins-ci.org/hudson/model/Result.html

property full_display_name

property full_name

get_build(number)

get_parameters()

handle_req(method, entry, **kwargs)

headers = {'Content-Type': 'text/xml; charset=utf-8'}

iter_all_builds()

iter_builds()

move(path)

property name

property parent

rename(name)

set_description(text)

set_next_build_number(number)

class api4jenkins.job.Project(jenkins, url)

api_json(tree='', depth=0)

build(**params)

property building

configure(xml=None)

delete()

disable()

duplicate(path, recursive=False)

property dynamic_attrs

enable()

exists()

filter_builds_by_result(*, result)

filter build by build results, avaliable results are: ‘SUCCESS’, ‘UNSTABLE’, ‘FAILURE’, ‘NOT_BUILT’, ‘ABORTED’ see: https://javadoc.jenkins-ci.org/hudson/model/Result.html

property full_display_name

property full_name

get_build(number)

get_parameters()

handle_req(method, entry, **kwargs)

headers = {'Content-Type': 'text/xml; charset=utf-8'}

iter_all_builds()

iter_builds()

move(path)

property name

property parent

rename(name)

set_description(text)

set_next_build_number(number)

class api4jenkins.job.WorkflowJob(jenkins, url)

api_json(tree='', depth=0)

build(**params)

property building

configure(xml=None)

delete()

disable()

duplicate(path, recursive=False)

property dynamic_attrs

enable()

exists()

filter_builds_by_result(*, result)

filter build by build results, avaliable results are: ‘SUCCESS’, ‘UNSTABLE’, ‘FAILURE’, ‘NOT_BUILT’, ‘ABORTED’ see: https://javadoc.jenkins-ci.org/hudson/model/Result.html

property full_display_name

property full_name

get_build(number)

get_parameters()

handle_req(method, entry, **kwargs)

headers = {'Content-Type': 'text/xml; charset=utf-8'}

iter_all_builds()

iter_builds()

move(path)

property name

property parent

rename(name)

set_description(text)

set_next_build_number(number)

class api4jenkins.job.WorkflowMultiBranchProject(jenkins, url)

api_json(tree='', depth=0)

property buildable

configure(xml=None)

copy(src, dest)

create(name, xml)

property credentials

delete()

disable()

duplicate(path, recursive=False)

property dynamic_attrs

enable()

exists()

property full_display_name

property full_name

get(name)

get_scan_log(stream=False)

handle_req(method, entry, **kwargs)

headers = {'Content-Type': 'text/xml; charset=utf-8'}

iter(depth=0)

move(path)

property name

property parent

reload()

rename(name)

scan(delay=0)

set_description(text)

property views

class api4jenkins.build.Build(jenkins, url)

api_json(tree='', depth=0)

console_text(stream=False)

delete()

property dynamic_attrs

exists()

get_causes()

get_coverage_report()

Access coverage report generated by JaCoCo

get_coverage_result()

Access coverage result generated by Code Coverage API

get_coverage_trends()

get_job()

get job of this build

get_next_build()

get_parameters()

get_previous_build()

get_test_report()

handle_req(method, entry, **kwargs)

headers = {'Content-Type': 'text/xml; charset=utf-8'}

kill()

progressive_output(html=False)

set_description(text)

stop()

term()

class api4jenkins.build.FreeStyleBuild(jenkins, url)

api_json(tree='', depth=0)

console_text(stream=False)

delete()

property dynamic_attrs

exists()

get_causes()

get_coverage_report()

Access coverage report generated by JaCoCo

get_coverage_result()

Access coverage result generated by Code Coverage API

get_coverage_trends()

get_job()

get job of this build

get_next_build()

get_parameters()

get_previous_build()

get_test_report()

handle_req(method, entry, **kwargs)

headers = {'Content-Type': 'text/xml; charset=utf-8'}

kill()

progressive_output(html=False)

set_description(text)

stop()

term()

class api4jenkins.build.MatrixBuild(jenkins, url)

api_json(tree='', depth=0)

console_text(stream=False)

delete()

property dynamic_attrs

exists()

get_causes()

get_coverage_report()

Access coverage report generated by JaCoCo

get_coverage_result()

Access coverage result generated by Code Coverage API

get_coverage_trends()

get_job()

get job of this build

get_next_build()

get_parameters()

get_previous_build()

get_test_report()

handle_req(method, entry, **kwargs)

headers = {'Content-Type': 'text/xml; charset=utf-8'}

kill()

progressive_output(html=False)

set_description(text)

stop()

term()

class api4jenkins.build.WorkflowRun(jenkins, url)

api_json(tree='', depth=0)

console_text(stream=False)

delete()

property dynamic_attrs

exists()

get_artifacts()

get_causes()

get_coverage_report()

Access coverage report generated by JaCoCo

get_coverage_result()

Access coverage result generated by Code Coverage API

get_coverage_trends()

get_job()

get job of this build

get_next_build()

get_parameters()

get_pending_input()

get current pending input step

get_previous_build()

get_test_report()

handle_req(method, entry, **kwargs)

headers = {'Content-Type': 'text/xml; charset=utf-8'}

kill()

progressive_output(html=False)

save_artifacts(filename='archive.zip')

set_description(text)

stop()

term()

class api4jenkins.input.PendingInputAction(jenkins, raw)

this class implement functionality to process input step

abort()

submit input step

api_json(tree='', depth=0)

property dynamic_attrs

exists()

handle_req(method, entry, **kwargs)

headers = {'Content-Type': 'text/xml; charset=utf-8'}

submit(**params)

submit input step

• for input requires parametes:

  • if submit without parameters, it will use default value of parameters

  • if submit with wrong parameters, exception raised

• for input does not requires parameters, but submit with paramters, exception raised

class api4jenkins.queue.BlockedItem(jenkins, url)

api_json(tree='', depth=0)

cancel()

property dynamic_attrs

exists()

get_build()

get_causes()

get_job()

get_parameters()

handle_req(method, entry, **kwargs)

headers = {'Content-Type': 'text/xml; charset=utf-8'}

class api4jenkins.queue.BuildableItem(jenkins, url)

api_json(tree='', depth=0)

cancel()

property dynamic_attrs

exists()

get_build()

get_causes()

get_job()

get_parameters()

handle_req(method, entry, **kwargs)

headers = {'Content-Type': 'text/xml; charset=utf-8'}

class api4jenkins.queue.LeftItem(jenkins, url)

api_json(tree='', depth=0)

cancel()

property dynamic_attrs

exists()

get_build()

get_causes()

get_job()

get_parameters()

handle_req(method, entry, **kwargs)

headers = {'Content-Type': 'text/xml; charset=utf-8'}

class api4jenkins.queue.Queue(jenkins, url)

api_json(tree='', depth=0)

cancel(id)

property dynamic_attrs

exists()

get(id)

handle_req(method, entry, **kwargs)

headers = {'Content-Type': 'text/xml; charset=utf-8'}

class api4jenkins.queue.QueueItem(jenkins, url)

api_json(tree='', depth=0)

cancel()

property dynamic_attrs

exists()

get_build()

get_causes()

get_job()

get_parameters()

handle_req(method, entry, **kwargs)

headers = {'Content-Type': 'text/xml; charset=utf-8'}

class api4jenkins.queue.WaitingItem(jenkins, url)

api_json(tree='', depth=0)

cancel()

property dynamic_attrs

exists()

get_build()

get_causes()

get_job()

get_parameters()

handle_req(method, entry, **kwargs)

headers = {'Content-Type': 'text/xml; charset=utf-8'}

class api4jenkins.credential.Credential(jenkins, url)

api_json(tree='', depth=0)

configure(xml=None)

delete()

property dynamic_attrs

exists()

handle_req(method, entry, **kwargs)

headers = {'Content-Type': 'text/xml; charset=utf-8'}

property name

class api4jenkins.credential.Credentials(jenkins, url)

api_json(tree='', depth=0)

create(xml)

property dynamic_attrs

exists()

get(name)

property global_domain

handle_req(method, entry, **kwargs)

headers = {'Content-Type': 'text/xml; charset=utf-8'}

class api4jenkins.credential.Domain(jenkins, url)

api_json(tree='', depth=0)

configure(xml=None)

create(xml)

delete()

property dynamic_attrs

exists()

get(id)

handle_req(method, entry, **kwargs)

headers = {'Content-Type': 'text/xml; charset=utf-8'}

property name

class api4jenkins.node.AnkaCloudComputer(jenkins, url)

api_json(tree='', depth=0)

configure(xml=None)

delete()

disable(msg='')

property dynamic_attrs

enable()

exists()

handle_req(method, entry, **kwargs)

headers = {'Content-Type': 'text/xml; charset=utf-8'}

iter_building_builds()

iter_builds()

property name

run_script(script)

class api4jenkins.node.DockerComputer(jenkins, url)

api_json(tree='', depth=0)

configure(xml=None)

delete()

disable(msg='')

property dynamic_attrs

enable()

exists()

handle_req(method, entry, **kwargs)

headers = {'Content-Type': 'text/xml; charset=utf-8'}

iter_building_builds()

iter_builds()

property name

run_script(script)

class api4jenkins.node.EC2Computer(jenkins, url)

api_json(tree='', depth=0)

configure(xml=None)

delete()

disable(msg='')

property dynamic_attrs

enable()

exists()

handle_req(method, entry, **kwargs)

headers = {'Content-Type': 'text/xml; charset=utf-8'}

iter_building_builds()

iter_builds()

property name

run_script(script)

class api4jenkins.node.KubernetesComputer(jenkins, url)

api_json(tree='', depth=0)

configure(xml=None)

delete()

disable(msg='')

property dynamic_attrs

enable()

exists()

handle_req(method, entry, **kwargs)

headers = {'Content-Type': 'text/xml; charset=utf-8'}

iter_building_builds()

iter_builds()

property name

run_script(script)

class api4jenkins.node.MasterComputer(jenkins, url)

api_json(tree='', depth=0)

configure(xml=None)

delete()

disable(msg='')

property dynamic_attrs

enable()

exists()

handle_req(method, entry, **kwargs)

headers = {'Content-Type': 'text/xml; charset=utf-8'}

iter_building_builds()

iter_builds()

property name

run_script(script)

class api4jenkins.node.Node(jenkins, url)

api_json(tree='', depth=0)

configure(xml=None)

delete()

disable(msg='')

property dynamic_attrs

enable()

exists()

handle_req(method, entry, **kwargs)

headers = {'Content-Type': 'text/xml; charset=utf-8'}

iter_building_builds()

iter_builds()

property name

run_script(script)

class api4jenkins.node.Nodes(jenkins, url)

classdocs

api_json(tree='', depth=0)

create(name, **kwargs)

property dynamic_attrs

exists()

filter_node_by_label(*labels)

filter_node_by_status(*, online)

get(name)

handle_req(method, entry, **kwargs)

headers = {'Content-Type': 'text/xml; charset=utf-8'}

iter_building_builds()

iter_builds()

class api4jenkins.node.SlaveComputer(jenkins, url)

api_json(tree='', depth=0)

configure(xml=None)

delete()

disable(msg='')

property dynamic_attrs

enable()

exists()

handle_req(method, entry, **kwargs)

headers = {'Content-Type': 'text/xml; charset=utf-8'}

iter_building_builds()

iter_builds()

property name

run_script(script)

class api4jenkins.plugin.Plugin(jenkins, url)

api_json(tree='', depth=0)

property dynamic_attrs

exists()

handle_req(method, entry, **kwargs)

headers = {'Content-Type': 'text/xml; charset=utf-8'}

uninstall()

class api4jenkins.plugin.PluginsManager(jenkins, url)

api_json(tree='', depth=0)

check_updates_server()

property dynamic_attrs

exists()

get(name)

handle_req(method, entry, **kwargs)

headers = {'Content-Type': 'text/xml; charset=utf-8'}

install(*names, block=False)

property installation_done

property restart_required

set_proxy(name, port, *, username='', password='', no_proxy='', test_url='')

set_site(url)

property site

uninstall(*names)

property update_center

class api4jenkins.plugin.UpdateCenter(jenkins, url)

api_json(tree='', depth=0)

property dynamic_attrs

exists()

handle_req(method, entry, **kwargs)

headers = {'Content-Type': 'text/xml; charset=utf-8'}

property installation_done

property restart_required

property site

class api4jenkins.view.AllView(jenkins, url)

api_json(tree='', depth=0)

configure(xml=None)

delete()

property dynamic_attrs

exclude(name)

exists()

get_job(name)

handle_req(method, entry, **kwargs)

headers = {'Content-Type': 'text/xml; charset=utf-8'}

include(name)

property name

set_description(text)

class api4jenkins.view.Dashboard(jenkins, url)

api_json(tree='', depth=0)

configure(xml=None)

delete()

property dynamic_attrs

exclude(name)

exists()

get_job(name)

handle_req(method, entry, **kwargs)

headers = {'Content-Type': 'text/xml; charset=utf-8'}

include(name)

property name

set_description(text)

class api4jenkins.view.ListView(jenkins, url)

api_json(tree='', depth=0)

configure(xml=None)

delete()

property dynamic_attrs

exclude(name)

exists()

get_job(name)

handle_req(method, entry, **kwargs)

headers = {'Content-Type': 'text/xml; charset=utf-8'}

include(name)

property name

set_description(text)

class api4jenkins.view.MyView(jenkins, url)

api_json(tree='', depth=0)

configure(xml=None)

delete()

property dynamic_attrs

exclude(name)

exists()

get_job(name)

handle_req(method, entry, **kwargs)

headers = {'Content-Type': 'text/xml; charset=utf-8'}

include(name)

property name

set_description(text)

class api4jenkins.view.NestedView(jenkins, url)

api_json(tree='', depth=0)

configure(xml=None)

delete()

property dynamic_attrs

exclude(name)

exists()

get_job(name)

handle_req(method, entry, **kwargs)

headers = {'Content-Type': 'text/xml; charset=utf-8'}

include(name)

property name

set_description(text)

property views

class api4jenkins.view.SectionedView(jenkins, url)

api_json(tree='', depth=0)

configure(xml=None)

delete()

property dynamic_attrs

exclude(name)

exists()

get_job(name)

handle_req(method, entry, **kwargs)

headers = {'Content-Type': 'text/xml; charset=utf-8'}

include(name)

property name

set_description(text)

class api4jenkins.view.View(jenkins, url)

api_json(tree='', depth=0)

configure(xml=None)

delete()

property dynamic_attrs

exclude(name)

exists()

get_job(name)

handle_req(method, entry, **kwargs)

headers = {'Content-Type': 'text/xml; charset=utf-8'}

include(name)

property name

set_description(text)

class api4jenkins.view.Views(owner)

classdocs

api_json(tree='', depth=0)

create(name, xml)

property dynamic_attrs

exists()

get(name)

handle_req(method, entry, **kwargs)

headers = {'Content-Type': 'text/xml; charset=utf-8'}

class api4jenkins.system.System(jenkins, url)

api_json(tree='', depth=0)

apply_jcasc(new)

decrypt_secret(text)

property dynamic_attrs

exists()

export_jcasc(filename='jenkins.yaml')

handle_req(method, entry, **kwargs)

headers = {'Content-Type': 'text/xml; charset=utf-8'}

reload_jcasc()

run_script(script)

class api4jenkins.user.ApiToken(name, uuid, value)

count(value, /)

Return number of occurrences of value.

index(value, start=0, stop=9223372036854775807, /)

Return first index of value.

Raises ValueError if the value is not present.

name

Alias for field number 0

uuid

Alias for field number 1

value

Alias for field number 2

class api4jenkins.user.User(jenkins, url)

api_json(tree='', depth=0)

delete()

property dynamic_attrs

exists()

generate_token(name='')

handle_req(method, entry, **kwargs)

headers = {'Content-Type': 'text/xml; charset=utf-8'}

revoke_token(uuid)

set_description(text)

class api4jenkins.user.Users(jenkins, url)

api_json(tree='', depth=0)

property dynamic_attrs

exists()

get(id=None, full_name=None)

handle_req(method, entry, **kwargs)

headers = {'Content-Type': 'text/xml; charset=utf-8'}

tree = 'users[user[id,absoluteUrl,fullName]]'

class api4jenkins.report.Coverage(raw)

class api4jenkins.report.CoverageElement(raw)

class api4jenkins.report.CoverageReport(jenkins, url)

Access coverage report generated by JaCoCo

api_json(tree='', depth=0)

property dynamic_attrs

exists()

get(name)

handle_req(method, entry, **kwargs)

headers = {'Content-Type': 'text/xml; charset=utf-8'}

report_types = ['branchCoverage', 'classCoverage', 'complexityScore', 'instructionCoverage', 'lineCoverage', 'methodCoverage']

trends(count=2)

class api4jenkins.report.CoverageResult(jenkins, url)

Access coverage result generated by Code Coverage API

api_json(tree='', depth=0)

property dynamic_attrs

exists()

get(name)

handle_req(method, entry, **kwargs)

headers = {'Content-Type': 'text/xml; charset=utf-8'}

class api4jenkins.report.CoverageTrend(raw)

class api4jenkins.report.CoverageTrends(jenkins, url)

api_json(tree='', depth=0)

property dynamic_attrs

exists()

get(name)

handle_req(method, entry, **kwargs)

headers = {'Content-Type': 'text/xml; charset=utf-8'}

class api4jenkins.report.GetMixIn

get(name)

class api4jenkins.report.ResultBase(raw)

class api4jenkins.report.TestCase(raw)

class api4jenkins.report.TestReport(jenkins, url)

api_json(tree='', depth=0)

property dynamic_attrs

exists()

get(name)

handle_req(method, entry, **kwargs)

headers = {'Content-Type': 'text/xml; charset=utf-8'}

property suites

class api4jenkins.report.TestSuite(raw)

property cases

get(name)

class api4jenkins.item.Item(jenkins, url)

classdocs

api_json(tree='', depth=0)

property dynamic_attrs

exists()

handle_req(method, entry, **kwargs)

headers = {'Content-Type': 'text/xml; charset=utf-8'}

api4jenkins.item.append_slash(url)

api4jenkins.item.camel(s)

api4jenkins.item.new_item(jenkins, module, item)

api4jenkins.item.snake(name)

class api4jenkins.mix.ActionsMixIn

get_causes()

get_parameters()

class api4jenkins.mix.ConfigurationMixIn

configure(xml=None)

property name

class api4jenkins.mix.DeletionMixIn

delete()

class api4jenkins.mix.DescriptionMixIn

set_description(text)

class api4jenkins.mix.EnableMixIn

disable()

enable()

class api4jenkins.mix.Parameter(class_name, name, value)

class_name

Alias for field number 0

count(value, /)

Return number of occurrences of value.

index(value, start=0, stop=9223372036854775807, /)

Return first index of value.

Raises ValueError if the value is not present.

name

Alias for field number 1

value

Alias for field number 2

class api4jenkins.mix.RawJsonMixIn

api_json(tree='', depth=0)

class api4jenkins.mix.RunScriptMixIn

run_script(script)

api4jenkins.requester.Requester(**kwargs)

exception api4jenkins.exceptions.AuthenticationError

add_note()

Exception.add_note(note) – add a note to the exception

args

with_traceback()

Exception.with_traceback(tb) – set self.__traceback__ to tb and return self.

exception api4jenkins.exceptions.BadRequestError

add_note()

Exception.add_note(note) – add a note to the exception

args

with_traceback()

Exception.with_traceback(tb) – set self.__traceback__ to tb and return self.

exception api4jenkins.exceptions.ItemExistsError

add_note()

Exception.add_note(note) – add a note to the exception

args

with_traceback()

Exception.with_traceback(tb) – set self.__traceback__ to tb and return self.

exception api4jenkins.exceptions.ItemNotFoundError

add_note()

Exception.add_note(note) – add a note to the exception

args

with_traceback()

Exception.with_traceback(tb) – set self.__traceback__ to tb and return self.

exception api4jenkins.exceptions.JenkinsAPIException

add_note()

Exception.add_note(note) – add a note to the exception

args

with_traceback()

Exception.with_traceback(tb) – set self.__traceback__ to tb and return self.

exception api4jenkins.exceptions.ServerError

add_note()

Exception.add_note(note) – add a note to the exception

args

with_traceback()

Exception.with_traceback(tb) – set self.__traceback__ to tb and return self.

exception api4jenkins.exceptions.UnsafeCharacterError

add_note()

Exception.add_note(note) – add a note to the exception

args

with_traceback()

Exception.with_traceback(tb) – set self.__traceback__ to tb and return self.