From 21be1a1a854b2f35ddc574d8b8f50ed55a1bc23a Mon Sep 17 00:00:00 2001
From: "tgstation-server-ci[bot]"
<161980869+tgstation-server-ci[bot]@users.noreply.github.com>
Date: Sun, 18 Aug 2024 13:02:50 +0000
Subject: [PATCH] Deploy code docs to GitHub Pages for workflow run 3224
Commit: b0fa8e7c91f3ab39379da19d378ecacabce14a71
---
_byond_installer_base_8cs_source.html | 6 +-
_delegating_engine_installer_8cs_source.html | 6 +-
_dream_maker_8cs_source.html | 4 +-
_engine_controller_8cs_source.html | 343 +--
_engine_installer_base_8cs_source.html | 6 +-
_engine_manager_8cs_source.html | 852 ++++----
_fetch_options_extensions_8cs_source.html | 16 +-
_i_dream_maker_8cs_source.html | 2 +-
_i_engine_installer_8cs_source.html | 6 +-
_i_engine_manager_8cs_source.html | 8 +-
_i_process_base_8cs_source.html | 4 +-
_i_repository_8cs_source.html | 14 +-
_i_repository_manager_8cs_source.html | 8 +-
_job_entrypoint_8cs_source.html | 2 +-
_job_progress_reporter_8cs_source.html | 312 ++-
_job_service_8cs_source.html | 194 +-
_open_dream_installer_8cs_source.html | 471 +++--
_process_8cs_source.html | 442 ++--
_repository_8cs_source.html | 1864 +++++++++--------
_repository_manager_8cs_source.html | 16 +-
_repository_update_service_8cs_source.html | 971 ++++-----
_session_controller_8cs_source.html | 6 +-
...st_2_components_2_instance_8cs_source.html | 6 +-
_watchdog_base_8cs_source.html | 4 +-
_windows_open_dream_installer_8cs_source.html | 2 +-
changelog.yml | 5 +
class_i_disposable.html | 37 +-
class_i_disposable__inherit__graph.map | 37 +-
class_i_disposable__inherit__graph.md5 | 2 +-
class_i_disposable__inherit__graph.png | Bin 298326 -> 306239 bytes
...1_1_api_1_1_models_1_1_engine_version.html | 20 +-
...76a2503f8e4371139e9abe80df44d2_icgraph.map | 6 +-
...76a2503f8e4371139e9abe80df44d2_icgraph.md5 | 2 +-
..._1_1_internal_1_1_repository_settings.html | 4 +-
..._server_1_1_api_1_1_models_1_1_limits.html | 2 +-
..._extensions_1_1_value_task_extensions.html | 2 +-
...onents_1_1_deployment_1_1_dream_maker.html | 4 +-
...gine_1_1_byond_installer_base-members.html | 2 +-
...s_1_1_engine_1_1_byond_installer_base.html | 42 +-
...0f9b30cccd75058679a819522f0b74_icgraph.map | 2 +-
...0f9b30cccd75058679a819522f0b74_icgraph.md5 | 2 +-
...f1546f8ef11d749bc75509ce63bdae5_cgraph.map | 0
...f1546f8ef11d749bc75509ce63bdae5_cgraph.md5 | 0
...f1546f8ef11d749bc75509ce63bdae5_cgraph.png | Bin
...1_delegating_engine_installer-members.html | 2 +-
...ngine_1_1_delegating_engine_installer.html | 26 +-
...ine_1_1_engine_installer_base-members.html | 2 +-
..._1_1_engine_1_1_engine_installer_base.html | 38 +-
...0a63f182a77bc1a099f3c7f8cd6849_icgraph.map | 4 +-
...0a63f182a77bc1a099f3c7f8cd6849_icgraph.md5 | 2 +-
...1_1_engine_1_1_engine_manager-members.html | 6 +-
...ponents_1_1_engine_1_1_engine_manager.html | 1036 ++++-----
...303d46d250191f69bb5251c89ca301d_cgraph.md5 | 1 -
...303d46d250191f69bb5251c89ca301d_cgraph.png | Bin 85220 -> 0 bytes
...03d46d250191f69bb5251c89ca301d_icgraph.md5 | 1 -
...d4c2604e3020f77b073021bf3016b4_icgraph.map | 2 +-
...d4c2604e3020f77b073021bf3016b4_icgraph.md5 | 2 +-
...d2a758adff2c72db49e822c8f6ceccf_cgraph.md5 | 1 -
...d2a758adff2c72db49e822c8f6ceccf_cgraph.png | Bin 126786 -> 0 bytes
...2a758adff2c72db49e822c8f6ceccf_icgraph.md5 | 1 -
...d0593064aa1c11835cfa1ab2823ec34_cgraph.map | 32 +-
...d0593064aa1c11835cfa1ab2823ec34_cgraph.md5 | 1 +
...d0593064aa1c11835cfa1ab2823ec34_cgraph.png | Bin 0 -> 155232 bytes
...0593064aa1c11835cfa1ab2823ec34_icgraph.map | 2 +-
...0593064aa1c11835cfa1ab2823ec34_icgraph.md5 | 1 +
...0593064aa1c11835cfa1ab2823ec34_icgraph.png | Bin
...03c2123e6edceee48d8b4897be532c6_cgraph.map | 36 +-
...03c2123e6edceee48d8b4897be532c6_cgraph.md5 | 2 +-
...03c2123e6edceee48d8b4897be532c6_cgraph.png | Bin 137052 -> 164267 bytes
...9978534a863e31d7d58e51c86b5886c_cgraph.map | 42 +-
...9978534a863e31d7d58e51c86b5886c_cgraph.md5 | 1 +
...9978534a863e31d7d58e51c86b5886c_cgraph.png | Bin 0 -> 184344 bytes
...06e9789785574f8d657a29fdd183795_cgraph.map | 20 +-
...06e9789785574f8d657a29fdd183795_cgraph.md5 | 1 +
...06e9789785574f8d657a29fdd183795_cgraph.png | Bin 0 -> 102272 bytes
...6e9789785574f8d657a29fdd183795_icgraph.map | 4 +-
...6e9789785574f8d657a29fdd183795_icgraph.md5 | 1 +
...6e9789785574f8d657a29fdd183795_icgraph.png | Bin
...40140865facd71ee580f625a8c95bc_icgraph.map | 4 +-
...40140865facd71ee580f625a8c95bc_icgraph.md5 | 2 +-
...2cedaccbf100b9dcf3922a9443f8f19_cgraph.md5 | 1 -
...2cedaccbf100b9dcf3922a9443f8f19_cgraph.png | Bin 169926 -> 0 bytes
...gine_1_1_open_dream_installer-members.html | 2 +-
...s_1_1_engine_1_1_open_dream_installer.html | 507 ++---
...df90470a5fd85e870cf0d959181e7d8_cgraph.map | 8 -
...df90470a5fd85e870cf0d959181e7d8_cgraph.md5 | 1 -
...df90470a5fd85e870cf0d959181e7d8_cgraph.png | Bin 38513 -> 0 bytes
...0f999e3876ac5a4c9c92684df68ec12_cgraph.map | 11 +
...0f999e3876ac5a4c9c92684df68ec12_cgraph.md5 | 1 +
...0f999e3876ac5a4c9c92684df68ec12_cgraph.png | Bin 0 -> 68826 bytes
...ine_1_1_posix_byond_installer-members.html | 2 +-
..._1_1_engine_1_1_posix_byond_installer.html | 26 +-
...e_1_1_windows_byond_installer-members.html | 2 +-
..._1_engine_1_1_windows_byond_installer.html | 26 +-
..._windows_open_dream_installer-members.html | 2 +-
...gine_1_1_windows_open_dream_installer.html | 30 +-
..._1_1_host_1_1_components_1_1_instance.html | 283 +--
...1cc04923d2557eefd57ad2ded9eb7f2_cgraph.md5 | 2 +-
...2340b0e0ecd2c2ccc812d88f86f7a3c_cgraph.map | 89 +-
...2340b0e0ecd2c2ccc812d88f86f7a3c_cgraph.md5 | 2 +-
...2340b0e0ecd2c2ccc812d88f86f7a3c_cgraph.png | Bin 468619 -> 460703 bytes
...6b97c61b214295da99e737ab2570b5a_cgraph.map | 91 +-
...6b97c61b214295da99e737ab2570b5a_cgraph.md5 | 2 +-
...6b97c61b214295da99e737ab2570b5a_cgraph.png | Bin 480223 -> 469720 bytes
...437eb5855fbd7575d4a5b0c71217745_cgraph.map | 2 +-
...437eb5855fbd7575d4a5b0c71217745_cgraph.md5 | 2 +-
...437eb5855fbd7575d4a5b0c71217745_cgraph.png | Bin 69632 -> 72568 bytes
...c1fd9e8dc3bd57b78dbcbc4e7f449b4_cgraph.map | 95 +-
...c1fd9e8dc3bd57b78dbcbc4e7f449b4_cgraph.md5 | 2 +-
...c1fd9e8dc3bd57b78dbcbc4e7f449b4_cgraph.png | Bin 498542 -> 485142 bytes
...1_1_repository_1_1_repository-members.html | 37 +-
...ponents_1_1_repository_1_1_repository.html | 1591 +++++++-------
...repository_1_1_repository__coll__graph.map | 3 +-
...repository_1_1_repository__coll__graph.md5 | 2 +-
...repository_1_1_repository__coll__graph.png | Bin 183140 -> 192586 bytes
...44a180597fe2bde35fd85e43d0dd59d_cgraph.map | 10 +-
...44a180597fe2bde35fd85e43d0dd59d_cgraph.md5 | 1 +
...44a180597fe2bde35fd85e43d0dd59d_cgraph.png | Bin 0 -> 51487 bytes
...28bfe68ce247974125194b074003c1b_cgraph.md5 | 1 -
...28bfe68ce247974125194b074003c1b_cgraph.png | Bin 17882 -> 0 bytes
...8bfe68ce247974125194b074003c1b_icgraph.md5 | 1 -
...a8561c6ba67a42fec9a9830a043fbdc_cgraph.map | 7 +-
...a8561c6ba67a42fec9a9830a043fbdc_cgraph.md5 | 2 +-
...a8561c6ba67a42fec9a9830a043fbdc_cgraph.png | Bin 69166 -> 69729 bytes
...dc9ca8cfb27f89f6d595412d819021a_cgraph.map | 6 +-
...dc9ca8cfb27f89f6d595412d819021a_cgraph.md5 | 2 +-
...dc9ca8cfb27f89f6d595412d819021a_cgraph.png | Bin 15081 -> 17096 bytes
...32cb5984c52022a23716cbabb1e4a40_cgraph.map | 9 +
...32cb5984c52022a23716cbabb1e4a40_cgraph.md5 | 1 +
...32cb5984c52022a23716cbabb1e4a40_cgraph.png | Bin 0 -> 46644 bytes
...fefc02e22b5c22787b498a045107740_cgraph.map | 7 +-
...fefc02e22b5c22787b498a045107740_cgraph.md5 | 1 +
...fefc02e22b5c22787b498a045107740_cgraph.png | Bin 0 -> 23487 bytes
...efc02e22b5c22787b498a045107740_icgraph.map | 2 +-
...efc02e22b5c22787b498a045107740_icgraph.md5 | 1 +
...efc02e22b5c22787b498a045107740_icgraph.png | Bin
...5068b3afe9edb4dc3a0474422f650aa_cgraph.map | 8 -
...5068b3afe9edb4dc3a0474422f650aa_cgraph.md5 | 1 -
...5068b3afe9edb4dc3a0474422f650aa_cgraph.png | Bin 40344 -> 0 bytes
...52e74ecb862a3cb6c26b89970ccc402_cgraph.md5 | 1 -
...52e74ecb862a3cb6c26b89970ccc402_cgraph.png | Bin 17853 -> 0 bytes
...a21ca98ea484845f3a7094fcc782814_cgraph.md5 | 1 -
...a21ca98ea484845f3a7094fcc782814_cgraph.png | Bin 38211 -> 0 bytes
...23395c46c6ba3e61646128d392d586b_cgraph.md5 | 1 -
...23395c46c6ba3e61646128d392d586b_cgraph.png | Bin 17556 -> 0 bytes
...3395c46c6ba3e61646128d392d586b_icgraph.md5 | 1 -
...63b639a5a6a59e780677f9849122b1f_cgraph.map | 4 +
...63b639a5a6a59e780677f9849122b1f_cgraph.md5 | 1 +
...63b639a5a6a59e780677f9849122b1f_cgraph.png | Bin 0 -> 11617 bytes
...97958179867ac2592eebd95711cf822_cgraph.map | 7 +-
...97958179867ac2592eebd95711cf822_cgraph.md5 | 1 +
...97958179867ac2592eebd95711cf822_cgraph.png | Bin 0 -> 23319 bytes
...7958179867ac2592eebd95711cf822_icgraph.map | 2 +-
...7958179867ac2592eebd95711cf822_icgraph.md5 | 1 +
...7958179867ac2592eebd95711cf822_icgraph.png | Bin
...e952092abaede9670adeaf6114d7d73_cgraph.map | 13 +-
...e952092abaede9670adeaf6114d7d73_cgraph.md5 | 2 +-
...e952092abaede9670adeaf6114d7d73_cgraph.png | Bin 45686 -> 46294 bytes
...ee48c4e5681a5003e8b626bfbbc2ef8_cgraph.map | 6 +-
...ee48c4e5681a5003e8b626bfbbc2ef8_cgraph.md5 | 1 +
...ee48c4e5681a5003e8b626bfbbc2ef8_cgraph.png | Bin 0 -> 17564 bytes
...sitory_1_1_repository_manager-members.html | 2 +-
...1_1_repository_1_1_repository_manager.html | 61 +-
...7aa1886c83c4ddb306ad33074f3a365_cgraph.md5 | 1 -
...7aa1886c83c4ddb306ad33074f3a365_cgraph.png | Bin 93800 -> 0 bytes
...40bff5e7feecd1e71018b1d6fab7bc_icgraph.map | 2 +-
...40bff5e7feecd1e71018b1d6fab7bc_icgraph.md5 | 2 +-
...d9235dfb77b745164af1553b922573d_cgraph.map | 19 +-
...d9235dfb77b745164af1553b922573d_cgraph.md5 | 1 +
...d9235dfb77b745164af1553b922573d_cgraph.png | Bin 0 -> 96717 bytes
...ository_1_1_repository_update_service.html | 982 ++++-----
...52e0821327fb59aa750db441622df34_cgraph.map | 8 +-
...52e0821327fb59aa750db441622df34_cgraph.md5 | 2 +-
...52e0821327fb59aa750db441622df34_cgraph.png | Bin 36135 -> 32935 bytes
...11d4f50183fc2f990b464da1fd0b240_cgraph.map | 15 +-
...11d4f50183fc2f990b464da1fd0b240_cgraph.md5 | 2 +-
...11d4f50183fc2f990b464da1fd0b240_cgraph.png | Bin 47869 -> 51941 bytes
..._1_1_repository_1_1_test_merge_result.html | 2 +-
...ession_1_1_session_controller-members.html | 2 +-
...ts_1_1_session_1_1_session_controller.html | 20 +-
...nfiguration_1_1_general_configuration.html | 2 +-
...nfiguration_1_1_session_configuration.html | 2 +-
...1_1_controllers_1_1_engine_controller.html | 325 +--
..._1_1_fetch_options_extensions-members.html | 4 +-
...tensions_1_1_fetch_options_extensions.html | 49 +-
...e986ebc3ee757beadd72f98f99076c_icgraph.md5 | 1 -
...19e6ba4a3ccca999a74240886628b41_cgraph.md5 | 1 -
...b564fc1ab3f6caf84958bc85d5236a_icgraph.map | 2 +-
...b564fc1ab3f6caf84958bc85d5236a_icgraph.md5 | 1 +
...b564fc1ab3f6caf84958bc85d5236a_icgraph.png | Bin
...e0e1a7712aa907faf658940322b8478_cgraph.map | 2 +-
...e0e1a7712aa907faf658940322b8478_cgraph.md5 | 1 +
...e0e1a7712aa907faf658940322b8478_cgraph.png | Bin
..._host_1_1_i_o_1_1_default_i_o_manager.html | 4 +-
...obs_1_1_job_progress_reporter-members.html | 12 +-
...st_1_1_jobs_1_1_job_progress_reporter.html | 594 ++++--
...1_1_job_progress_reporter__coll__graph.map | 13 +-
...1_1_job_progress_reporter__coll__graph.md5 | 2 +-
...1_1_job_progress_reporter__coll__graph.png | Bin 29853 -> 38056 bytes
..._job_progress_reporter__inherit__graph.map | 4 +
..._job_progress_reporter__inherit__graph.md5 | 1 +
..._job_progress_reporter__inherit__graph.png | Bin 0 -> 6698 bytes
...2254a185da6e76e7fcd2d72a8032970_cgraph.map | 4 +-
...2254a185da6e76e7fcd2d72a8032970_cgraph.md5 | 2 +-
...2254a185da6e76e7fcd2d72a8032970_cgraph.png | Bin 10028 -> 11568 bytes
...254a185da6e76e7fcd2d72a8032970_icgraph.map | 39 +-
...254a185da6e76e7fcd2d72a8032970_icgraph.md5 | 2 +-
...254a185da6e76e7fcd2d72a8032970_icgraph.png | Bin 141843 -> 187474 bytes
...e9230c68a7eff4ddf044bb8c07836cc_cgraph.map | 4 +
...e9230c68a7eff4ddf044bb8c07836cc_cgraph.md5 | 1 +
...e9230c68a7eff4ddf044bb8c07836cc_cgraph.png | Bin 0 -> 9209 bytes
...5af832a3c5781b796441234fc0e5fe_icgraph.map | 25 +
...5af832a3c5781b796441234fc0e5fe_icgraph.md5 | 1 +
...5af832a3c5781b796441234fc0e5fe_icgraph.png | Bin 0 -> 196024 bytes
...36a80d9d56a20711468d9b8e27e3c1_icgraph.map | 48 +-
...36a80d9d56a20711468d9b8e27e3c1_icgraph.md5 | 2 +-
...36a80d9d56a20711468d9b8e27e3c1_icgraph.png | Bin 239861 -> 151935 bytes
...ver_1_1_host_1_1_jobs_1_1_job_service.html | 188 +-
...1_security_1_1_authentication_context.html | 2 +-
...1_1_host_1_1_system_1_1_dotnet_helper.html | 2 +-
...1_host_1_1_system_1_1_process-members.html | 2 +-
...erver_1_1_host_1_1_system_1_1_process.html | 434 ++--
..._host_1_1_system_1_1_process_executor.html | 2 +-
..._host_1_1_utils_1_1_reference_counter.html | 6 +-
...603269a01198b149ea66eaba0dd014_icgraph.map | 4 +-
...603269a01198b149ea66eaba0dd014_icgraph.md5 | 2 +-
...tils_1_1_reference_counting_container.html | 10 +-
...512890f504f0e2fa9593bbd5ab851f_icgraph.map | 4 +-
...512890f504f0e2fa9593bbd5ab851f_icgraph.md5 | 2 +-
..._1_1_utils_1_1_semaphore_slim_context.html | 6 +-
...773d588476671bbe480f096d839c91_icgraph.map | 4 +-
...773d588476671bbe480f096d839c91_icgraph.md5 | 2 +-
functions.html | 8 +-
functions_c.html | 13 +-
functions_d.html | 4 +-
functions_f.html | 2 +-
functions_func.html | 2 +-
functions_func_c.html | 6 +-
functions_func_d.html | 6 +-
functions_func_f.html | 2 +-
functions_func_g.html | 2 +-
functions_func_h.html | 2 +-
functions_func_i.html | 2 +-
functions_func_j.html | 2 +-
functions_func_r.html | 2 +-
functions_func_t.html | 2 +-
functions_func_u.html | 2 +-
functions_g.html | 6 +-
functions_h.html | 9 +-
functions_i.html | 6 +-
functions_j.html | 4 +-
functions_m.html | 2 +-
functions_o.html | 2 +-
functions_p.html | 5 +-
functions_prop_m.html | 2 +-
functions_r.html | 2 +-
functions_s.html | 10 +-
functions_t.html | 5 +-
functions_u.html | 6 +-
functions_vars_p.html | 1 +
functions_vars_s.html | 1 +
hierarchy.html | 550 ++---
index.html | 2 +-
inherit_graph_156.map | 4 +-
inherit_graph_156.md5 | 2 +-
inherit_graph_156.png | Bin 4344 -> 17647 bytes
inherit_graph_157.map | 7 +-
inherit_graph_157.md5 | 2 +-
inherit_graph_157.png | Bin 17647 -> 18886 bytes
inherit_graph_158.map | 11 +-
inherit_graph_158.md5 | 2 +-
inherit_graph_158.png | Bin 18886 -> 36946 bytes
inherit_graph_159.map | 12 +-
inherit_graph_159.md5 | 2 +-
inherit_graph_159.png | Bin 36946 -> 29445 bytes
inherit_graph_160.map | 6 +-
inherit_graph_160.md5 | 2 +-
inherit_graph_160.png | Bin 29445 -> 5198 bytes
inherit_graph_161.map | 2 +-
inherit_graph_161.md5 | 2 +-
inherit_graph_161.png | Bin 5198 -> 4159 bytes
inherit_graph_162.map | 2 +-
inherit_graph_162.md5 | 2 +-
inherit_graph_162.png | Bin 4159 -> 4525 bytes
inherit_graph_163.map | 2 +-
inherit_graph_163.md5 | 2 +-
inherit_graph_163.png | Bin 4525 -> 2720 bytes
inherit_graph_164.map | 3 +-
inherit_graph_164.md5 | 2 +-
inherit_graph_164.png | Bin 2720 -> 9645 bytes
inherit_graph_165.map | 5 +-
inherit_graph_165.md5 | 2 +-
inherit_graph_165.png | Bin 9645 -> 16662 bytes
inherit_graph_166.map | 5 +-
inherit_graph_166.md5 | 2 +-
inherit_graph_166.png | Bin 16662 -> 8408 bytes
inherit_graph_167.map | 4 +-
inherit_graph_167.md5 | 2 +-
inherit_graph_167.png | Bin 8408 -> 9215 bytes
inherit_graph_168.map | 9 +-
inherit_graph_168.md5 | 2 +-
inherit_graph_168.png | Bin 9215 -> 40800 bytes
inherit_graph_169.map | 8 +-
inherit_graph_169.md5 | 2 +-
inherit_graph_169.png | Bin 40800 -> 4088 bytes
inherit_graph_170.map | 2 +-
inherit_graph_170.md5 | 2 +-
inherit_graph_170.png | Bin 4088 -> 3479 bytes
inherit_graph_171.map | 2 +-
inherit_graph_171.md5 | 2 +-
inherit_graph_171.png | Bin 3479 -> 4179 bytes
inherit_graph_172.map | 3 +-
inherit_graph_172.md5 | 2 +-
inherit_graph_172.png | Bin 4179 -> 5076 bytes
inherit_graph_173.map | 4 +-
inherit_graph_173.md5 | 2 +-
inherit_graph_173.png | Bin 5076 -> 6278 bytes
inherit_graph_174.map | 3 +-
inherit_graph_174.md5 | 2 +-
inherit_graph_174.png | Bin 6278 -> 4420 bytes
inherit_graph_175.map | 2 +-
inherit_graph_175.md5 | 2 +-
inherit_graph_175.png | Bin 4420 -> 5149 bytes
inherit_graph_176.map | 2 +-
inherit_graph_176.md5 | 2 +-
inherit_graph_176.png | Bin 5149 -> 4878 bytes
inherit_graph_177.map | 2 +-
inherit_graph_177.md5 | 2 +-
inherit_graph_177.png | Bin 4878 -> 4909 bytes
inherit_graph_178.map | 2 +-
inherit_graph_178.md5 | 2 +-
inherit_graph_178.png | Bin 4909 -> 3793 bytes
inherit_graph_179.map | 3 +-
inherit_graph_179.md5 | 2 +-
inherit_graph_179.png | Bin 3793 -> 9803 bytes
inherit_graph_180.map | 4 +-
inherit_graph_180.md5 | 2 +-
inherit_graph_180.png | Bin 9803 -> 9013 bytes
inherit_graph_181.map | 4 +-
inherit_graph_181.md5 | 2 +-
inherit_graph_181.png | Bin 9013 -> 8304 bytes
inherit_graph_182.map | 4 +-
inherit_graph_182.md5 | 2 +-
inherit_graph_182.png | Bin 8304 -> 8145 bytes
inherit_graph_183.map | 3 +-
inherit_graph_183.md5 | 2 +-
inherit_graph_183.png | Bin 8145 -> 4294 bytes
inherit_graph_184.map | 2 +-
inherit_graph_184.md5 | 2 +-
inherit_graph_184.png | Bin 4294 -> 4658 bytes
inherit_graph_185.map | 2 +-
inherit_graph_185.md5 | 2 +-
inherit_graph_185.png | Bin 4658 -> 4246 bytes
inherit_graph_186.map | 2 +-
inherit_graph_186.md5 | 2 +-
inherit_graph_186.png | Bin 4246 -> 4589 bytes
inherit_graph_187.map | 4 +-
inherit_graph_187.md5 | 2 +-
inherit_graph_187.png | Bin 4589 -> 8539 bytes
inherit_graph_188.map | 5 +-
inherit_graph_188.md5 | 2 +-
inherit_graph_188.png | Bin 8539 -> 9218 bytes
inherit_graph_189.map | 4 +-
inherit_graph_189.md5 | 2 +-
inherit_graph_189.png | Bin 9218 -> 8540 bytes
inherit_graph_190.map | 4 +-
inherit_graph_190.md5 | 2 +-
inherit_graph_190.png | Bin 8540 -> 8046 bytes
inherit_graph_191.map | 3 +-
inherit_graph_191.md5 | 2 +-
inherit_graph_191.png | Bin 8046 -> 6478 bytes
inherit_graph_192.map | 2 +-
inherit_graph_192.md5 | 2 +-
inherit_graph_192.png | Bin 6478 -> 4408 bytes
inherit_graph_193.map | 3 +-
inherit_graph_193.md5 | 2 +-
inherit_graph_193.png | Bin 4408 -> 10192 bytes
inherit_graph_194.map | 3 +-
inherit_graph_194.md5 | 2 +-
inherit_graph_194.png | Bin 10192 -> 9112 bytes
inherit_graph_195.map | 2 +-
inherit_graph_195.md5 | 2 +-
inherit_graph_195.png | Bin 9112 -> 7322 bytes
inherit_graph_196.map | 5 +-
inherit_graph_196.md5 | 2 +-
inherit_graph_196.png | Bin 7322 -> 26197 bytes
inherit_graph_197.map | 6 +-
inherit_graph_197.md5 | 2 +-
inherit_graph_197.png | Bin 26197 -> 5272 bytes
inherit_graph_198.map | 4 +-
inherit_graph_198.md5 | 2 +-
inherit_graph_198.png | Bin 5272 -> 5688 bytes
inherit_graph_199.map | 4 -
inherit_graph_199.md5 | 1 -
inherit_graph_199.png | Bin 5688 -> 0 bytes
inherit_graph_2.map | 323 +--
inherit_graph_2.md5 | 2 +-
inherit_graph_2.png | Bin 1328458 -> 1362871 bytes
inherits.html | 396 ++--
..._1_1_engine_1_1_i_engine_installation.html | 2 +-
...engine_1_1_i_engine_installation_data.html | 8 +-
...12d13d543fde6cbb64c9085f9370b7_icgraph.map | 6 +-
...12d13d543fde6cbb64c9085f9370b7_icgraph.md5 | 2 +-
...engine_1_1_i_engine_installer-members.html | 2 +-
...nts_1_1_engine_1_1_i_engine_installer.html | 44 +-
...ac565523ae59fd18a8ad6eb1dfb616_icgraph.map | 4 +-
...ac565523ae59fd18a8ad6eb1dfb616_icgraph.md5 | 2 +-
...41dfb27438fbd4d70462cd137bcb42_icgraph.map | 6 +-
...41dfb27438fbd4d70462cd137bcb42_icgraph.md5 | 1 +
...41dfb27438fbd4d70462cd137bcb42_icgraph.png | Bin
...100637a7abd23c97157b7a4deb4736_icgraph.md5 | 1 -
...982c374c0d5d56779125fce7c933be_icgraph.map | 6 +-
...982c374c0d5d56779125fce7c933be_icgraph.md5 | 2 +-
...1_engine_1_1_i_engine_manager-members.html | 2 +-
...nents_1_1_engine_1_1_i_engine_manager.html | 16 +-
...nents_1_1_events_1_1_i_event_consumer.html | 10 +-
...4f82eb43566dabd77e37191b4e3d37_icgraph.map | 8 +-
...4f82eb43566dabd77e37191b4e3d37_icgraph.md5 | 2 +-
...st_1_1_components_1_1_i_instance_core.html | 2 +-
...repository_1_1_i_credentials_provider.html | 10 +-
...b24a1c8a29d90d03abdb627eb24635_icgraph.map | 4 +-
...b24a1c8a29d90d03abdb627eb24635_icgraph.md5 | 2 +-
...dfc1a59c4a3f30bc795c43b3c6fa42_icgraph.map | 2 +-
...dfc1a59c4a3f30bc795c43b3c6fa42_icgraph.md5 | 2 +-
..._1_repository_1_1_i_lib_git2_commands.html | 4 +-
...60f1ded05e762c347ffc43c6d71700_icgraph.map | 2 +-
...60f1ded05e762c347ffc43c6d71700_icgraph.md5 | 2 +-
...ory_1_1_i_lib_git2_repository_factory.html | 4 +-
...6ed81450e50013e2ec1bae65e5f8cb_icgraph.map | 2 +-
...6ed81450e50013e2ec1bae65e5f8cb_icgraph.md5 | 2 +-
...a092f96f2408453c2a1b5d5b0a4f30_icgraph.map | 2 +-
...a092f96f2408453c2a1b5d5b0a4f30_icgraph.md5 | 2 +-
...1_repository_1_1_i_repository-members.html | 4 +-
...nents_1_1_repository_1_1_i_repository.html | 65 +-
...e15b3dd9fe05cabc167ad5e6b3cdcd_icgraph.map | 7 +-
...e15b3dd9fe05cabc167ad5e6b3cdcd_icgraph.md5 | 2 +-
...e15b3dd9fe05cabc167ad5e6b3cdcd_icgraph.png | Bin 22663 -> 30211 bytes
...47fd2dbfe8a1f51ea38ca78259eabd_icgraph.md5 | 1 -
...47fd2dbfe8a1f51ea38ca78259eabd_icgraph.png | Bin 13564 -> 0 bytes
...a99bf9d0bc659cc3989ba4318cdfcc_icgraph.map | 5 +-
...a99bf9d0bc659cc3989ba4318cdfcc_icgraph.md5 | 1 +
...a99bf9d0bc659cc3989ba4318cdfcc_icgraph.png | Bin 0 -> 20730 bytes
...a5d05808bd1a5314dc619c6c2a6428_icgraph.map | 4 +
...a5d05808bd1a5314dc619c6c2a6428_icgraph.md5 | 1 +
...a5d05808bd1a5314dc619c6c2a6428_icgraph.png | Bin 0 -> 11212 bytes
...tory_1_1_i_repository_manager-members.html | 2 +-
...1_repository_1_1_i_repository_manager.html | 24 +-
...642bc09ffdcb87116758727bcbd813_icgraph.md5 | 1 -
...06fb30c8098ae3520612c13fcbac0c_icgraph.map | 2 +-
...06fb30c8098ae3520612c13fcbac0c_icgraph.md5 | 1 +
...06fb30c8098ae3520612c13fcbac0c_icgraph.png | Bin
...58009c7d92a55634a7ddd80ca60b1b_icgraph.map | 2 +-
...58009c7d92a55634a7ddd80ca60b1b_icgraph.md5 | 2 +-
...sion_1_1_i_session_controller-members.html | 2 +-
..._1_1_session_1_1_i_session_controller.html | 6 +-
...tabase_1_1_i_database_context_factory.html | 2 +-
..._1_host_1_1_i_o_1_1_i_file_downloader.html | 2 +-
...327aceb0182d4678f593c3385131de_icgraph.map | 2 +-
...327aceb0182d4678f593c3385131de_icgraph.md5 | 2 +-
...er_1_1_host_1_1_i_o_1_1_i_i_o_manager.html | 66 +-
...a442b5dff16f5e7a730ec354e81d78_icgraph.map | 8 +-
...a442b5dff16f5e7a730ec354e81d78_icgraph.md5 | 2 +-
...6f4eb5c679683b7e519847a6c3574e_icgraph.map | 6 +-
...6f4eb5c679683b7e519847a6c3574e_icgraph.md5 | 2 +-
...aa1b9dbeb6af3744e568095c4376e7_icgraph.map | 6 +-
...aa1b9dbeb6af3744e568095c4376e7_icgraph.md5 | 2 +-
...eb8b83ea3f4b13a183b6ac55b35a70_icgraph.map | 6 +-
...eb8b83ea3f4b13a183b6ac55b35a70_icgraph.md5 | 2 +-
...e0dda4b7fbad4c77f48ba3b2681dc7_icgraph.map | 8 +-
...e0dda4b7fbad4c77f48ba3b2681dc7_icgraph.md5 | 2 +-
...e08438da658a3c0afddbb7960e4faa_icgraph.map | 2 +-
...e08438da658a3c0afddbb7960e4faa_icgraph.md5 | 2 +-
...host_1_1_i_o_1_1_i_post_write_handler.html | 4 +-
...host_1_1_system_1_1_i_process-members.html | 2 +-
...ver_1_1_host_1_1_system_1_1_i_process.html | 6 +-
...1_1_system_1_1_i_process_base-members.html | 2 +-
..._1_host_1_1_system_1_1_i_process_base.html | 14 +-
...ost_1_1_system_1_1_i_process_features.html | 8 +-
search/all_1.js | 242 +--
search/all_10.js | 345 ++-
search/all_12.js | 113 +-
search/all_13.js | 265 +--
search/all_14.js | 114 +-
search/all_15.js | 109 +-
search/all_2.js | 59 +-
search/all_3.js | 341 +--
search/all_4.js | 461 ++--
search/all_6.js | 81 +-
search/all_7.js | 10 +-
search/all_8.js | 43 +-
search/all_9.js | 749 +++----
search/all_a.js | 24 +-
search/all_c.js | 8 +-
search/all_d.js | 2 +-
search/all_e.js | 4 +-
search/all_f.js | 127 +-
search/functions_0.js | 2 +-
search/functions_11.js | 2 +-
search/functions_13.js | 2 +-
search/functions_14.js | 2 +-
search/functions_2.js | 6 +-
search/functions_3.js | 18 +-
search/functions_5.js | 2 +-
search/functions_6.js | 2 +-
search/functions_7.js | 2 +-
search/functions_8.js | 2 +-
search/functions_9.js | 2 +-
search/properties_c.js | 2 +-
search/variables_12.js | 111 +-
search/variables_14.js | 4 +-
search/variables_2.js | 4 +-
search/variables_8.js | 27 +-
search/variables_f.js | 5 +-
513 files changed, 9526 insertions(+), 8745 deletions(-)
rename class_tgstation_1_1_server_1_1_host_1_1_components_1_1_engine_1_1_byond_installer_base_a6bd81dbdb1f24aaf80bba10224b4773f_cgraph.map => class_tgstation_1_1_server_1_1_host_1_1_components_1_1_engine_1_1_byond_installer_base_adf1546f8ef11d749bc75509ce63bdae5_cgraph.map (100%)
rename class_tgstation_1_1_server_1_1_host_1_1_components_1_1_engine_1_1_byond_installer_base_a6bd81dbdb1f24aaf80bba10224b4773f_cgraph.md5 => class_tgstation_1_1_server_1_1_host_1_1_components_1_1_engine_1_1_byond_installer_base_adf1546f8ef11d749bc75509ce63bdae5_cgraph.md5 (100%)
rename class_tgstation_1_1_server_1_1_host_1_1_components_1_1_engine_1_1_byond_installer_base_a6bd81dbdb1f24aaf80bba10224b4773f_cgraph.png => class_tgstation_1_1_server_1_1_host_1_1_components_1_1_engine_1_1_byond_installer_base_adf1546f8ef11d749bc75509ce63bdae5_cgraph.png (100%)
delete mode 100644 class_tgstation_1_1_server_1_1_host_1_1_components_1_1_engine_1_1_engine_manager_a0303d46d250191f69bb5251c89ca301d_cgraph.md5
delete mode 100644 class_tgstation_1_1_server_1_1_host_1_1_components_1_1_engine_1_1_engine_manager_a0303d46d250191f69bb5251c89ca301d_cgraph.png
delete mode 100644 class_tgstation_1_1_server_1_1_host_1_1_components_1_1_engine_1_1_engine_manager_a0303d46d250191f69bb5251c89ca301d_icgraph.md5
delete mode 100644 class_tgstation_1_1_server_1_1_host_1_1_components_1_1_engine_1_1_engine_manager_a3d2a758adff2c72db49e822c8f6ceccf_cgraph.md5
delete mode 100644 class_tgstation_1_1_server_1_1_host_1_1_components_1_1_engine_1_1_engine_manager_a3d2a758adff2c72db49e822c8f6ceccf_cgraph.png
delete mode 100644 class_tgstation_1_1_server_1_1_host_1_1_components_1_1_engine_1_1_engine_manager_a3d2a758adff2c72db49e822c8f6ceccf_icgraph.md5
rename class_tgstation_1_1_server_1_1_host_1_1_components_1_1_engine_1_1_engine_manager_a3d2a758adff2c72db49e822c8f6ceccf_cgraph.map => class_tgstation_1_1_server_1_1_host_1_1_components_1_1_engine_1_1_engine_manager_a4d0593064aa1c11835cfa1ab2823ec34_cgraph.map (69%)
create mode 100644 class_tgstation_1_1_server_1_1_host_1_1_components_1_1_engine_1_1_engine_manager_a4d0593064aa1c11835cfa1ab2823ec34_cgraph.md5
create mode 100644 class_tgstation_1_1_server_1_1_host_1_1_components_1_1_engine_1_1_engine_manager_a4d0593064aa1c11835cfa1ab2823ec34_cgraph.png
rename class_tgstation_1_1_server_1_1_host_1_1_components_1_1_engine_1_1_engine_manager_a3d2a758adff2c72db49e822c8f6ceccf_icgraph.map => class_tgstation_1_1_server_1_1_host_1_1_components_1_1_engine_1_1_engine_manager_a4d0593064aa1c11835cfa1ab2823ec34_icgraph.map (85%)
create mode 100644 class_tgstation_1_1_server_1_1_host_1_1_components_1_1_engine_1_1_engine_manager_a4d0593064aa1c11835cfa1ab2823ec34_icgraph.md5
rename class_tgstation_1_1_server_1_1_host_1_1_components_1_1_engine_1_1_engine_manager_a3d2a758adff2c72db49e822c8f6ceccf_icgraph.png => class_tgstation_1_1_server_1_1_host_1_1_components_1_1_engine_1_1_engine_manager_a4d0593064aa1c11835cfa1ab2823ec34_icgraph.png (100%)
rename class_tgstation_1_1_server_1_1_host_1_1_components_1_1_engine_1_1_engine_manager_ad2cedaccbf100b9dcf3922a9443f8f19_cgraph.map => class_tgstation_1_1_server_1_1_host_1_1_components_1_1_engine_1_1_engine_manager_aa9978534a863e31d7d58e51c86b5886c_cgraph.map (64%)
create mode 100644 class_tgstation_1_1_server_1_1_host_1_1_components_1_1_engine_1_1_engine_manager_aa9978534a863e31d7d58e51c86b5886c_cgraph.md5
create mode 100644 class_tgstation_1_1_server_1_1_host_1_1_components_1_1_engine_1_1_engine_manager_aa9978534a863e31d7d58e51c86b5886c_cgraph.png
rename class_tgstation_1_1_server_1_1_host_1_1_components_1_1_engine_1_1_engine_manager_a0303d46d250191f69bb5251c89ca301d_cgraph.map => class_tgstation_1_1_server_1_1_host_1_1_components_1_1_engine_1_1_engine_manager_ac06e9789785574f8d657a29fdd183795_cgraph.map (53%)
create mode 100644 class_tgstation_1_1_server_1_1_host_1_1_components_1_1_engine_1_1_engine_manager_ac06e9789785574f8d657a29fdd183795_cgraph.md5
create mode 100644 class_tgstation_1_1_server_1_1_host_1_1_components_1_1_engine_1_1_engine_manager_ac06e9789785574f8d657a29fdd183795_cgraph.png
rename class_tgstation_1_1_server_1_1_host_1_1_components_1_1_engine_1_1_engine_manager_a0303d46d250191f69bb5251c89ca301d_icgraph.map => class_tgstation_1_1_server_1_1_host_1_1_components_1_1_engine_1_1_engine_manager_ac06e9789785574f8d657a29fdd183795_icgraph.map (77%)
create mode 100644 class_tgstation_1_1_server_1_1_host_1_1_components_1_1_engine_1_1_engine_manager_ac06e9789785574f8d657a29fdd183795_icgraph.md5
rename class_tgstation_1_1_server_1_1_host_1_1_components_1_1_engine_1_1_engine_manager_a0303d46d250191f69bb5251c89ca301d_icgraph.png => class_tgstation_1_1_server_1_1_host_1_1_components_1_1_engine_1_1_engine_manager_ac06e9789785574f8d657a29fdd183795_icgraph.png (100%)
delete mode 100644 class_tgstation_1_1_server_1_1_host_1_1_components_1_1_engine_1_1_engine_manager_ad2cedaccbf100b9dcf3922a9443f8f19_cgraph.md5
delete mode 100644 class_tgstation_1_1_server_1_1_host_1_1_components_1_1_engine_1_1_engine_manager_ad2cedaccbf100b9dcf3922a9443f8f19_cgraph.png
delete mode 100644 class_tgstation_1_1_server_1_1_host_1_1_components_1_1_engine_1_1_open_dream_installer_a6df90470a5fd85e870cf0d959181e7d8_cgraph.map
delete mode 100644 class_tgstation_1_1_server_1_1_host_1_1_components_1_1_engine_1_1_open_dream_installer_a6df90470a5fd85e870cf0d959181e7d8_cgraph.md5
delete mode 100644 class_tgstation_1_1_server_1_1_host_1_1_components_1_1_engine_1_1_open_dream_installer_a6df90470a5fd85e870cf0d959181e7d8_cgraph.png
create mode 100644 class_tgstation_1_1_server_1_1_host_1_1_components_1_1_engine_1_1_open_dream_installer_a80f999e3876ac5a4c9c92684df68ec12_cgraph.map
create mode 100644 class_tgstation_1_1_server_1_1_host_1_1_components_1_1_engine_1_1_open_dream_installer_a80f999e3876ac5a4c9c92684df68ec12_cgraph.md5
create mode 100644 class_tgstation_1_1_server_1_1_host_1_1_components_1_1_engine_1_1_open_dream_installer_a80f999e3876ac5a4c9c92684df68ec12_cgraph.png
rename class_tgstation_1_1_server_1_1_host_1_1_components_1_1_repository_1_1_repository_aaa21ca98ea484845f3a7094fcc782814_cgraph.map => class_tgstation_1_1_server_1_1_host_1_1_components_1_1_repository_1_1_repository_a244a180597fe2bde35fd85e43d0dd59d_cgraph.map (56%)
create mode 100644 class_tgstation_1_1_server_1_1_host_1_1_components_1_1_repository_1_1_repository_a244a180597fe2bde35fd85e43d0dd59d_cgraph.md5
create mode 100644 class_tgstation_1_1_server_1_1_host_1_1_components_1_1_repository_1_1_repository_a244a180597fe2bde35fd85e43d0dd59d_cgraph.png
delete mode 100644 class_tgstation_1_1_server_1_1_host_1_1_components_1_1_repository_1_1_repository_a328bfe68ce247974125194b074003c1b_cgraph.md5
delete mode 100644 class_tgstation_1_1_server_1_1_host_1_1_components_1_1_repository_1_1_repository_a328bfe68ce247974125194b074003c1b_cgraph.png
delete mode 100644 class_tgstation_1_1_server_1_1_host_1_1_components_1_1_repository_1_1_repository_a328bfe68ce247974125194b074003c1b_icgraph.md5
create mode 100644 class_tgstation_1_1_server_1_1_host_1_1_components_1_1_repository_1_1_repository_a632cb5984c52022a23716cbabb1e4a40_cgraph.map
create mode 100644 class_tgstation_1_1_server_1_1_host_1_1_components_1_1_repository_1_1_repository_a632cb5984c52022a23716cbabb1e4a40_cgraph.md5
create mode 100644 class_tgstation_1_1_server_1_1_host_1_1_components_1_1_repository_1_1_repository_a632cb5984c52022a23716cbabb1e4a40_cgraph.png
rename class_tgstation_1_1_server_1_1_host_1_1_components_1_1_repository_1_1_repository_a328bfe68ce247974125194b074003c1b_cgraph.map => class_tgstation_1_1_server_1_1_host_1_1_components_1_1_repository_1_1_repository_a7fefc02e22b5c22787b498a045107740_cgraph.map (54%)
create mode 100644 class_tgstation_1_1_server_1_1_host_1_1_components_1_1_repository_1_1_repository_a7fefc02e22b5c22787b498a045107740_cgraph.md5
create mode 100644 class_tgstation_1_1_server_1_1_host_1_1_components_1_1_repository_1_1_repository_a7fefc02e22b5c22787b498a045107740_cgraph.png
rename class_tgstation_1_1_server_1_1_host_1_1_components_1_1_repository_1_1_repository_a328bfe68ce247974125194b074003c1b_icgraph.map => class_tgstation_1_1_server_1_1_host_1_1_components_1_1_repository_1_1_repository_a7fefc02e22b5c22787b498a045107740_icgraph.map (89%)
create mode 100644 class_tgstation_1_1_server_1_1_host_1_1_components_1_1_repository_1_1_repository_a7fefc02e22b5c22787b498a045107740_icgraph.md5
rename class_tgstation_1_1_server_1_1_host_1_1_components_1_1_repository_1_1_repository_a328bfe68ce247974125194b074003c1b_icgraph.png => class_tgstation_1_1_server_1_1_host_1_1_components_1_1_repository_1_1_repository_a7fefc02e22b5c22787b498a045107740_icgraph.png (100%)
delete mode 100644 class_tgstation_1_1_server_1_1_host_1_1_components_1_1_repository_1_1_repository_a95068b3afe9edb4dc3a0474422f650aa_cgraph.map
delete mode 100644 class_tgstation_1_1_server_1_1_host_1_1_components_1_1_repository_1_1_repository_a95068b3afe9edb4dc3a0474422f650aa_cgraph.md5
delete mode 100644 class_tgstation_1_1_server_1_1_host_1_1_components_1_1_repository_1_1_repository_a95068b3afe9edb4dc3a0474422f650aa_cgraph.png
delete mode 100644 class_tgstation_1_1_server_1_1_host_1_1_components_1_1_repository_1_1_repository_aa52e74ecb862a3cb6c26b89970ccc402_cgraph.md5
delete mode 100644 class_tgstation_1_1_server_1_1_host_1_1_components_1_1_repository_1_1_repository_aa52e74ecb862a3cb6c26b89970ccc402_cgraph.png
delete mode 100644 class_tgstation_1_1_server_1_1_host_1_1_components_1_1_repository_1_1_repository_aaa21ca98ea484845f3a7094fcc782814_cgraph.md5
delete mode 100644 class_tgstation_1_1_server_1_1_host_1_1_components_1_1_repository_1_1_repository_aaa21ca98ea484845f3a7094fcc782814_cgraph.png
delete mode 100644 class_tgstation_1_1_server_1_1_host_1_1_components_1_1_repository_1_1_repository_ad23395c46c6ba3e61646128d392d586b_cgraph.md5
delete mode 100644 class_tgstation_1_1_server_1_1_host_1_1_components_1_1_repository_1_1_repository_ad23395c46c6ba3e61646128d392d586b_cgraph.png
delete mode 100644 class_tgstation_1_1_server_1_1_host_1_1_components_1_1_repository_1_1_repository_ad23395c46c6ba3e61646128d392d586b_icgraph.md5
create mode 100644 class_tgstation_1_1_server_1_1_host_1_1_components_1_1_repository_1_1_repository_af63b639a5a6a59e780677f9849122b1f_cgraph.map
create mode 100644 class_tgstation_1_1_server_1_1_host_1_1_components_1_1_repository_1_1_repository_af63b639a5a6a59e780677f9849122b1f_cgraph.md5
create mode 100644 class_tgstation_1_1_server_1_1_host_1_1_components_1_1_repository_1_1_repository_af63b639a5a6a59e780677f9849122b1f_cgraph.png
rename class_tgstation_1_1_server_1_1_host_1_1_components_1_1_repository_1_1_repository_ad23395c46c6ba3e61646128d392d586b_cgraph.map => class_tgstation_1_1_server_1_1_host_1_1_components_1_1_repository_1_1_repository_af97958179867ac2592eebd95711cf822_cgraph.map (54%)
create mode 100644 class_tgstation_1_1_server_1_1_host_1_1_components_1_1_repository_1_1_repository_af97958179867ac2592eebd95711cf822_cgraph.md5
create mode 100644 class_tgstation_1_1_server_1_1_host_1_1_components_1_1_repository_1_1_repository_af97958179867ac2592eebd95711cf822_cgraph.png
rename class_tgstation_1_1_server_1_1_host_1_1_components_1_1_repository_1_1_repository_ad23395c46c6ba3e61646128d392d586b_icgraph.map => class_tgstation_1_1_server_1_1_host_1_1_components_1_1_repository_1_1_repository_af97958179867ac2592eebd95711cf822_icgraph.map (76%)
create mode 100644 class_tgstation_1_1_server_1_1_host_1_1_components_1_1_repository_1_1_repository_af97958179867ac2592eebd95711cf822_icgraph.md5
rename class_tgstation_1_1_server_1_1_host_1_1_components_1_1_repository_1_1_repository_ad23395c46c6ba3e61646128d392d586b_icgraph.png => class_tgstation_1_1_server_1_1_host_1_1_components_1_1_repository_1_1_repository_af97958179867ac2592eebd95711cf822_icgraph.png (100%)
rename class_tgstation_1_1_server_1_1_host_1_1_components_1_1_repository_1_1_repository_aa52e74ecb862a3cb6c26b89970ccc402_cgraph.map => class_tgstation_1_1_server_1_1_host_1_1_components_1_1_repository_1_1_repository_afee48c4e5681a5003e8b626bfbbc2ef8_cgraph.map (64%)
create mode 100644 class_tgstation_1_1_server_1_1_host_1_1_components_1_1_repository_1_1_repository_afee48c4e5681a5003e8b626bfbbc2ef8_cgraph.md5
create mode 100644 class_tgstation_1_1_server_1_1_host_1_1_components_1_1_repository_1_1_repository_afee48c4e5681a5003e8b626bfbbc2ef8_cgraph.png
delete mode 100644 class_tgstation_1_1_server_1_1_host_1_1_components_1_1_repository_1_1_repository_manager_a07aa1886c83c4ddb306ad33074f3a365_cgraph.md5
delete mode 100644 class_tgstation_1_1_server_1_1_host_1_1_components_1_1_repository_1_1_repository_manager_a07aa1886c83c4ddb306ad33074f3a365_cgraph.png
rename class_tgstation_1_1_server_1_1_host_1_1_components_1_1_repository_1_1_repository_manager_a07aa1886c83c4ddb306ad33074f3a365_cgraph.map => class_tgstation_1_1_server_1_1_host_1_1_components_1_1_repository_1_1_repository_manager_aad9235dfb77b745164af1553b922573d_cgraph.map (76%)
create mode 100644 class_tgstation_1_1_server_1_1_host_1_1_components_1_1_repository_1_1_repository_manager_aad9235dfb77b745164af1553b922573d_cgraph.md5
create mode 100644 class_tgstation_1_1_server_1_1_host_1_1_components_1_1_repository_1_1_repository_manager_aad9235dfb77b745164af1553b922573d_cgraph.png
delete mode 100644 class_tgstation_1_1_server_1_1_host_1_1_extensions_1_1_fetch_options_extensions_a15e986ebc3ee757beadd72f98f99076c_icgraph.md5
delete mode 100644 class_tgstation_1_1_server_1_1_host_1_1_extensions_1_1_fetch_options_extensions_a819e6ba4a3ccca999a74240886628b41_cgraph.md5
rename class_tgstation_1_1_server_1_1_host_1_1_extensions_1_1_fetch_options_extensions_a15e986ebc3ee757beadd72f98f99076c_icgraph.map => class_tgstation_1_1_server_1_1_host_1_1_extensions_1_1_fetch_options_extensions_ad2b564fc1ab3f6caf84958bc85d5236a_icgraph.map (78%)
create mode 100644 class_tgstation_1_1_server_1_1_host_1_1_extensions_1_1_fetch_options_extensions_ad2b564fc1ab3f6caf84958bc85d5236a_icgraph.md5
rename class_tgstation_1_1_server_1_1_host_1_1_extensions_1_1_fetch_options_extensions_a15e986ebc3ee757beadd72f98f99076c_icgraph.png => class_tgstation_1_1_server_1_1_host_1_1_extensions_1_1_fetch_options_extensions_ad2b564fc1ab3f6caf84958bc85d5236a_icgraph.png (100%)
rename class_tgstation_1_1_server_1_1_host_1_1_extensions_1_1_fetch_options_extensions_a819e6ba4a3ccca999a74240886628b41_cgraph.map => class_tgstation_1_1_server_1_1_host_1_1_extensions_1_1_fetch_options_extensions_aee0e1a7712aa907faf658940322b8478_cgraph.map (83%)
create mode 100644 class_tgstation_1_1_server_1_1_host_1_1_extensions_1_1_fetch_options_extensions_aee0e1a7712aa907faf658940322b8478_cgraph.md5
rename class_tgstation_1_1_server_1_1_host_1_1_extensions_1_1_fetch_options_extensions_a819e6ba4a3ccca999a74240886628b41_cgraph.png => class_tgstation_1_1_server_1_1_host_1_1_extensions_1_1_fetch_options_extensions_aee0e1a7712aa907faf658940322b8478_cgraph.png (100%)
create mode 100644 class_tgstation_1_1_server_1_1_host_1_1_jobs_1_1_job_progress_reporter__inherit__graph.map
create mode 100644 class_tgstation_1_1_server_1_1_host_1_1_jobs_1_1_job_progress_reporter__inherit__graph.md5
create mode 100644 class_tgstation_1_1_server_1_1_host_1_1_jobs_1_1_job_progress_reporter__inherit__graph.png
create mode 100644 class_tgstation_1_1_server_1_1_host_1_1_jobs_1_1_job_progress_reporter_a3e9230c68a7eff4ddf044bb8c07836cc_cgraph.map
create mode 100644 class_tgstation_1_1_server_1_1_host_1_1_jobs_1_1_job_progress_reporter_a3e9230c68a7eff4ddf044bb8c07836cc_cgraph.md5
create mode 100644 class_tgstation_1_1_server_1_1_host_1_1_jobs_1_1_job_progress_reporter_a3e9230c68a7eff4ddf044bb8c07836cc_cgraph.png
create mode 100644 class_tgstation_1_1_server_1_1_host_1_1_jobs_1_1_job_progress_reporter_aa95af832a3c5781b796441234fc0e5fe_icgraph.map
create mode 100644 class_tgstation_1_1_server_1_1_host_1_1_jobs_1_1_job_progress_reporter_aa95af832a3c5781b796441234fc0e5fe_icgraph.md5
create mode 100644 class_tgstation_1_1_server_1_1_host_1_1_jobs_1_1_job_progress_reporter_aa95af832a3c5781b796441234fc0e5fe_icgraph.png
delete mode 100644 inherit_graph_199.map
delete mode 100644 inherit_graph_199.md5
delete mode 100644 inherit_graph_199.png
rename interface_tgstation_1_1_server_1_1_host_1_1_components_1_1_engine_1_1_i_engine_installer_a76100637a7abd23c97157b7a4deb4736_icgraph.map => interface_tgstation_1_1_server_1_1_host_1_1_components_1_1_engine_1_1_i_engine_installer_a1841dfb27438fbd4d70462cd137bcb42_icgraph.map (72%)
create mode 100644 interface_tgstation_1_1_server_1_1_host_1_1_components_1_1_engine_1_1_i_engine_installer_a1841dfb27438fbd4d70462cd137bcb42_icgraph.md5
rename interface_tgstation_1_1_server_1_1_host_1_1_components_1_1_engine_1_1_i_engine_installer_a76100637a7abd23c97157b7a4deb4736_icgraph.png => interface_tgstation_1_1_server_1_1_host_1_1_components_1_1_engine_1_1_i_engine_installer_a1841dfb27438fbd4d70462cd137bcb42_icgraph.png (100%)
delete mode 100644 interface_tgstation_1_1_server_1_1_host_1_1_components_1_1_engine_1_1_i_engine_installer_a76100637a7abd23c97157b7a4deb4736_icgraph.md5
delete mode 100644 interface_tgstation_1_1_server_1_1_host_1_1_components_1_1_repository_1_1_i_repository_abd47fd2dbfe8a1f51ea38ca78259eabd_icgraph.md5
delete mode 100644 interface_tgstation_1_1_server_1_1_host_1_1_components_1_1_repository_1_1_i_repository_abd47fd2dbfe8a1f51ea38ca78259eabd_icgraph.png
rename interface_tgstation_1_1_server_1_1_host_1_1_components_1_1_repository_1_1_i_repository_abd47fd2dbfe8a1f51ea38ca78259eabd_icgraph.map => interface_tgstation_1_1_server_1_1_host_1_1_components_1_1_repository_1_1_i_repository_ac1a99bf9d0bc659cc3989ba4318cdfcc_icgraph.map (55%)
create mode 100644 interface_tgstation_1_1_server_1_1_host_1_1_components_1_1_repository_1_1_i_repository_ac1a99bf9d0bc659cc3989ba4318cdfcc_icgraph.md5
create mode 100644 interface_tgstation_1_1_server_1_1_host_1_1_components_1_1_repository_1_1_i_repository_ac1a99bf9d0bc659cc3989ba4318cdfcc_icgraph.png
create mode 100644 interface_tgstation_1_1_server_1_1_host_1_1_components_1_1_repository_1_1_i_repository_adea5d05808bd1a5314dc619c6c2a6428_icgraph.map
create mode 100644 interface_tgstation_1_1_server_1_1_host_1_1_components_1_1_repository_1_1_i_repository_adea5d05808bd1a5314dc619c6c2a6428_icgraph.md5
create mode 100644 interface_tgstation_1_1_server_1_1_host_1_1_components_1_1_repository_1_1_i_repository_adea5d05808bd1a5314dc619c6c2a6428_icgraph.png
delete mode 100644 interface_tgstation_1_1_server_1_1_host_1_1_components_1_1_repository_1_1_i_repository_manager_a01642bc09ffdcb87116758727bcbd813_icgraph.md5
rename interface_tgstation_1_1_server_1_1_host_1_1_components_1_1_repository_1_1_i_repository_manager_a01642bc09ffdcb87116758727bcbd813_icgraph.map => interface_tgstation_1_1_server_1_1_host_1_1_components_1_1_repository_1_1_i_repository_manager_a0506fb30c8098ae3520612c13fcbac0c_icgraph.map (89%)
create mode 100644 interface_tgstation_1_1_server_1_1_host_1_1_components_1_1_repository_1_1_i_repository_manager_a0506fb30c8098ae3520612c13fcbac0c_icgraph.md5
rename interface_tgstation_1_1_server_1_1_host_1_1_components_1_1_repository_1_1_i_repository_manager_a01642bc09ffdcb87116758727bcbd813_icgraph.png => interface_tgstation_1_1_server_1_1_host_1_1_components_1_1_repository_1_1_i_repository_manager_a0506fb30c8098ae3520612c13fcbac0c_icgraph.png (100%)
diff --git a/_byond_installer_base_8cs_source.html b/_byond_installer_base_8cs_source.html
index 6a8237f825..3535685bb3 100644
--- a/_byond_installer_base_8cs_source.html
+++ b/_byond_installer_base_8cs_source.html
@@ -188,7 +188,7 @@ $(function() {
-
+
@@ -239,11 +239,11 @@ $(function() {
const string ByondBinPath
The path to the BYOND bin folder.
virtual IEnumerable< string > AdditionalCacheCleanFilePaths(string configDirectory)
List off additional file paths in the configDirectory to delete.
abstract string DreamMakerName
Path to the DreamMaker executable.
override async ValueTask< IEngineInstallationData > DownloadVersion(EngineVersion version, JobProgressReporter? progressReporter, CancellationToken cancellationToken)
Download a given engine version . A ValueTask<TResult> resulting in the IEngineInstallationData for t...
ByondInstallerBase(IIOManager ioManager, ILogger< ByondInstallerBase > logger, IFileDownloader fileDownloader)
Initializes a new instance of the ByondInstallerBase class.
override async Task CleanCache(CancellationToken cancellationToken)
Attempts to cleans the engine's cache folder for the system. A Task representing the running operatio...
Uri GetDownloadZipUrl(EngineVersion version)
Create a Uri pointing to the location of the download for a given version .
override EngineType TargetEngineType
override async ValueTask< IEngineInstallationData > DownloadVersion(EngineVersion version, JobProgressReporter progressReporter, CancellationToken cancellationToken)
Download a given engine version . A ValueTask<TResult> resulting in the IEngineInstallationData for t...
abstract string GetDreamDaemonName(Version byondVersion, out bool supportsCli)
Get the file name of the DreamDaemon executable.
override IEngineInstallation CreateInstallation(EngineVersion version, string path, Task installationTask)
Creates an IEngineInstallation for a given version . The IEngineInstallation.
Implementation of IEngineInstallationData for a zip file in a Stream.
IFileStreamProvider that provides a ISeekableFileStreamProvider from an input Stream.
An IIOManager that resolve relative paths from another IIOManager to a subdirectory of that.
Progress reporter for a Job.
Progress reporter for a Job.
Represents a BYOND installation.
IFileStreamProvider DownloadFile(Uri url, string? bearerToken)
Downloads a file from a given url .
37 => DelegateCall(version, installer => installer.CreateInstallation(version, path, installationTask));
-
+
41 => DelegateCall(version, installer => installer.DownloadVersion(version, jobProgressReporter, cancellationToken));
44 public ValueTask
Install(
EngineVersion version,
string path,
bool deploymentPipelineProcesses, CancellationToken cancellationToken)
@@ -127,14 +127,14 @@ $(function() {
Implementation of IEngineInstaller that forwards calls to different IEngineInstaller based on their a...
IEngineInstallation CreateInstallation(EngineVersion version, string path, Task installationTask)
Creates an IEngineInstallation for a given version . The IEngineInstallation.
DelegatingEngineInstaller(FrozenDictionary< EngineType, IEngineInstaller > delegatedInstallers)
Initializes a new instance of the DelegatingEngineInstaller class.
ValueTask< IEngineInstallationData > DownloadVersion(EngineVersion version, JobProgressReporter? jobProgressReporter, CancellationToken cancellationToken)
Download a given engine version . A ValueTask<TResult> resulting in the IEngineInstallationData for t...
TReturn DelegateCall< TReturn >(EngineVersion version, Func< IEngineInstaller, TReturn > call)
Delegate a given call to its appropriate IEngineInstaller.
ValueTask Install(EngineVersion version, string path, bool deploymentPipelineProcesses, CancellationToken cancellationToken)
Does actions necessary to get an extracted installation working. A ValueTask representing the running...
ValueTask< IEngineInstallationData > DownloadVersion(EngineVersion version, JobProgressReporter jobProgressReporter, CancellationToken cancellationToken)
Download a given engine version . A ValueTask<TResult> resulting in the IEngineInstallationData for t...
ValueTask UpgradeInstallation(EngineVersion version, string path, CancellationToken cancellationToken)
Does actions necessary to get upgrade a version installed by a previous version of TGS....
Task CleanCache(CancellationToken cancellationToken)
Attempts to cleans the engine's cache folder for the system. A Task representing the running operatio...
readonly FrozenDictionary< EngineType, IEngineInstaller > delegatedInstallers
The FrozenDictionary<TKey, TValue> mapping EngineTypes to their appropriate IEngineInstaller.
ValueTask TrustDmbPath(EngineVersion version, string fullDmbPath, CancellationToken cancellationToken)
Add a given fullDmbPath to the trusted DMBs list in BYOND's config. A ValueTask representing the run...
Progress reporter for a Job.
Progress reporter for a Job.
Represents a BYOND installation.
For downloading and installing game engines for a given system.
Repository(LibGit2Sharp.IRepository libGitRepo, ILibGit2Commands commands, IIOManager ioManager, IEventConsumer eventConsumer, ICredentialsProvider credentialsProvider, IPostWriteHandler postWriteHandler, IGitRemoteFeaturesFactory gitRemoteFeaturesFactory, ILibGit2RepositoryFactory submoduleFactory, ILogger< Repository > logger, GeneralConfiguration generalConfiguration, Action disposeAction)
Initializes a new instance of the Repository class.
Configuration options for the game sessions.
Operation exceptions thrown from the context of a Models.Job.
Progress reporter for a Job.
void ReportProgress(double? progress)
Report progress.
Progress reporter for a Job.
void ReportProgress(double? progress)
Report progress.
Represents an Api.Models.Instance in the database.
187 await byondManager.ChangeVersion(null, model.EngineVersion, null, false, cancellationToken);
-
- 189 catch (InvalidOperationException ex)
-
-
-
- 193 "Race condition: Engine {version} uninstalled before we could switch to it. Creating install job instead...",
-
- 195 versionAlreadyInstalled =
false;
-
-
-
- 199 if (!versionAlreadyInstalled)
-
- 201 if (model.EngineVersion.CustomIteration.HasValue)
-
-
-
- 205 "User ID {userId} installing engine version {newByondVersion} on instance ID {instanceId}",
-
-
-
-
-
- 211 var job = Models.Job.Create(
-
-
- 214 :
JobCode.EngineOfficialInstall,
-
-
-
- 218 job.Description += $
" {model.EngineVersion}";
-
-
-
-
-
-
-
- 226 await jobManager.RegisterOperation(
-
- 228 async (core, databaseContextFactory, paramJob, progressHandler, jobCancellationToken) =>
-
- 230 MemoryStream? zipFileStream = null;
- 231 if (fileUploadTicket != null)
- 232 await using (fileUploadTicket)
-
- 234 var uploadStream = await fileUploadTicket.GetResult(jobCancellationToken) ?? throw new JobException(ErrorCode.FileUploadExpired);
- 235 zipFileStream = new MemoryStream();
-
-
- 238 await uploadStream.CopyToAsync(zipFileStream, jobCancellationToken);
-
-
-
- 242 await zipFileStream.DisposeAsync();
-
-
-
-
- 247 await using (zipFileStream)
- 248 await core!.EngineManager.ChangeVersion(
-
-
-
-
- 253 jobCancellationToken);
-
-
-
- 257 result.InstallJob = job.ToApi();
- 258 result.FileTicket = fileUploadTicket?.Ticket.FileTicket;
-
-
-
- 262 if (fileUploadTicket !=
null)
- 263 await fileUploadTicket.DisposeAsync();
-
-
-
-
-
- 269 return result.InstallJob !=
null ? Accepted(result) : Json(result);
-
-
-
-
-
-
-
-
-
-
- 289 ArgumentNullException.ThrowIfNull(model);
- 290 var earlyOut = ValidateEngineVersion(model.EngineVersion);
- 291 if (earlyOut !=
null)
-
-
- 294 var engineVersion = model.EngineVersion!;
- 295 var notInstalledResponse = await WithComponentInstanceNullable(
-
-
- 298 var byondManager = instance.EngineManager;
- 299 var activeVersion = byondManager.ActiveVersion;
- 300 if (activeVersion !=
null && engineVersion.Equals(activeVersion))
- 301 return ValueTask.FromResult<IActionResult?>(
-
-
- 304 var versionNotInstalled = !byondManager.InstalledVersions.Any(x => x.Equals(engineVersion));
-
- 306 return ValueTask.FromResult<IActionResult?>(
-
-
-
-
-
- 312 if (notInstalledResponse !=
null)
- 313 return notInstalledResponse;
-
- 315 var isByondVersion = engineVersion.Engine!.Value ==
EngineType.Byond;
-
-
- 318 var cancelRight = isByondVersion
- 319 ? engineVersion.CustomIteration.HasValue
- 320 ? EngineRights.InstallCustomByondVersion
- 321 : EngineRights.InstallOfficialOrChangeActiveByondVersion
- 322 : engineVersion.CustomIteration.HasValue
- 323 ? EngineRights.InstallOfficialOrChangeActiveOpenDreamVersion
-
-
-
- 327 job.Description += $
" {engineVersion}";
-
- 329 await jobManager.RegisterOperation(
-
- 331 (instanceCore, databaseContextFactory, job, progressReporter, jobCancellationToken)
- 332 => instanceCore!.EngineManager.DeleteVersion(progressReporter, engineVersion, jobCancellationToken),
-
-
- 335 var apiResponse = job.ToApi();
- 336 return Accepted(apiResponse);
-
-
-
-
- 346 if (version ==
null || !version.
Engine.HasValue)
-
-
- 349 var isByond = version.Engine.Value ==
EngineType.Byond;
-
-
-
-
-
-
- 356 || (version.
Version !=
null && (version.
Version.Revision != -1 || validSha)))))
-
-
-
-
- 361 version.Version = NormalizeByondVersion(version.
Version!);
- 362 if (version.
Version.Build != -1)
-
-
-
-
-
-
-
+ 187 using var progressReporter = new JobProgressReporter();
+ 188 await byondManager.ChangeVersion(progressReporter, model.EngineVersion, null, false, cancellationToken);
+
+ 190 catch (InvalidOperationException ex)
+
+
+
+ 194 "Race condition: Engine {version} uninstalled before we could switch to it. Creating install job instead...",
+
+ 196 versionAlreadyInstalled =
false;
+
+
+
+ 200 if (!versionAlreadyInstalled)
+
+ 202 if (model.EngineVersion.CustomIteration.HasValue)
+
+
+
+ 206 "User ID {userId} installing engine version {newByondVersion} on instance ID {instanceId}",
+
+
+
+
+
+ 212 var job = Models.Job.Create(
+
+
+ 215 :
JobCode.EngineOfficialInstall,
+
+
+
+ 219 job.Description += $
" {model.EngineVersion}";
+
+
+
+
+
+
+
+ 227 await jobManager.RegisterOperation(
+
+ 229 async (core, databaseContextFactory, paramJob, progressHandler, jobCancellationToken) =>
+
+ 231 MemoryStream? zipFileStream = null;
+ 232 if (fileUploadTicket != null)
+ 233 await using (fileUploadTicket)
+
+ 235 var uploadStream = await fileUploadTicket.GetResult(jobCancellationToken) ?? throw new JobException(ErrorCode.FileUploadExpired);
+ 236 zipFileStream = new MemoryStream();
+
+
+ 239 await uploadStream.CopyToAsync(zipFileStream, jobCancellationToken);
+
+
+
+ 243 await zipFileStream.DisposeAsync();
+
+
+
+
+ 248 await using (zipFileStream)
+ 249 await core!.EngineManager.ChangeVersion(
+
+
+
+
+ 254 jobCancellationToken);
+
+
+
+ 258 result.InstallJob = job.ToApi();
+ 259 result.FileTicket = fileUploadTicket?.Ticket.FileTicket;
+
+
+
+ 263 if (fileUploadTicket !=
null)
+ 264 await fileUploadTicket.DisposeAsync();
+
+
+
+
+
+ 270 return result.InstallJob !=
null ? Accepted(result) : Json(result);
+
+
+
+
+
+
+
+
+
+
+ 290 ArgumentNullException.ThrowIfNull(model);
+ 291 var earlyOut = ValidateEngineVersion(model.EngineVersion);
+ 292 if (earlyOut !=
null)
+
+
+ 295 var engineVersion = model.EngineVersion!;
+ 296 var notInstalledResponse = await WithComponentInstanceNullable(
+
+
+ 299 var byondManager = instance.EngineManager;
+ 300 var activeVersion = byondManager.ActiveVersion;
+ 301 if (activeVersion !=
null && engineVersion.Equals(activeVersion))
+ 302 return ValueTask.FromResult<IActionResult?>(
+
+
+ 305 var versionNotInstalled = !byondManager.InstalledVersions.Any(x => x.Equals(engineVersion));
+
+ 307 return ValueTask.FromResult<IActionResult?>(
+
+
+
+
+
+ 313 if (notInstalledResponse !=
null)
+ 314 return notInstalledResponse;
+
+ 316 var isByondVersion = engineVersion.Engine!.Value ==
EngineType.Byond;
+
+
+ 319 var cancelRight = isByondVersion
+ 320 ? engineVersion.CustomIteration.HasValue
+ 321 ? EngineRights.InstallCustomByondVersion
+ 322 : EngineRights.InstallOfficialOrChangeActiveByondVersion
+ 323 : engineVersion.CustomIteration.HasValue
+ 324 ? EngineRights.InstallOfficialOrChangeActiveOpenDreamVersion
+
+
+
+ 328 job.Description += $
" {engineVersion}";
+
+ 330 await jobManager.RegisterOperation(
+
+ 332 (instanceCore, databaseContextFactory, job, progressReporter, jobCancellationToken)
+ 333 => instanceCore!.EngineManager.DeleteVersion(progressReporter, engineVersion, jobCancellationToken),
+
+
+ 336 var apiResponse = job.ToApi();
+ 337 return Accepted(apiResponse);
+
+
+
+
+ 347 if (version ==
null || !version.
Engine.HasValue)
+
+
+ 350 var isByond = version.Engine.Value ==
EngineType.Byond;
+
+
+
+
+
+
+ 357 || (version.
Version !=
null && (version.
Version.Revision != -1 || validSha)))))
+
+
+
+
+ 362 version.Version = NormalizeByondVersion(version.
Version!);
+ 363 if (version.
Version.Build != -1)
+
+
+
+
+
+
+
Information about an engine installation.
Version? Version
The System.Version of the engine. Currently only valid when Engine is EngineType.Byond.
string? SourceSHA
The git commit SHA of the engine. Currently only valid when Engine is EngineType.OpenDream.
ValueTask< IActionResult > List([FromQuery] int? page, [FromQuery] int? pageSize, CancellationToken cancellationToken)
Lists installed EngineVersions.
EngineController(IDatabaseContext databaseContext, IAuthenticationContext authenticationContext, ILogger< EngineController > logger, IInstanceManager instanceManager, IJobManager jobManager, IFileTransferTicketProvider fileTransferService, IApiHeadersProvider apiHeadersProvider)
Initializes a new instance of the EngineController class.
static Version NormalizeByondVersion(Version version)
Remove the Version.Build from a given version if present.
async ValueTask< IActionResult > Delete([FromBody] EngineVersionDeleteRequest model, CancellationToken cancellationToken)
Attempts to delete the BYOND version specified in a given model from the instance.
BadRequestObjectResult? ValidateEngineVersion(EngineVersion? version)
Validate and normalize a given version .
async ValueTask< IActionResult > Delete([FromBody] EngineVersionDeleteRequest model, CancellationToken cancellationToken)
Attempts to delete the BYOND version specified in a given model from the instance.
BadRequestObjectResult? ValidateEngineVersion(EngineVersion? version)
Validate and normalize a given version .
async ValueTask< IActionResult > Update([FromBody] EngineVersionRequest model, CancellationToken cancellationToken)
Changes the active engine version to the one specified in a given model .
readonly IJobManager jobManager
The IJobManager for the EngineController.
ComponentInterfacingController for operations that require an instance.
EngineType? Engine
The EngineType.
abstract ValueTask TrustDmbPath(EngineVersion version, string fullDmbPath, CancellationToken cancellationToken)
Add a given fullDmbPath to the trusted DMBs list in BYOND's config. A ValueTask representing the run...
abstract ValueTask< IEngineInstallationData > DownloadVersion(EngineVersion version, JobProgressReporter? jobProgressReporter, CancellationToken cancellationToken)
Download a given engine version . A ValueTask<TResult> resulting in the IEngineInstallationData for t...
abstract Task CleanCache(CancellationToken cancellationToken)
Attempts to cleans the engine's cache folder for the system. A Task representing the running operatio...
void CheckVersionValidity(EngineVersion version)
Check that a given version is of type EngineType.Byond.
abstract IEngineInstallation CreateInstallation(EngineVersion version, string path, Task installationTask)
Creates an IEngineInstallation for a given version . The IEngineInstallation.
abstract ValueTask< IEngineInstallationData > DownloadVersion(EngineVersion version, JobProgressReporter jobProgressReporter, CancellationToken cancellationToken)
Download a given engine version . A ValueTask<TResult> resulting in the IEngineInstallationData for t...
IIOManager IOManager
Gets the IIOManager for the EngineInstallerBase.
EngineInstallerBase(IIOManager ioManager, ILogger< EngineInstallerBase > logger)
Initializes a new instance of the EngineInstallerBase class.
abstract ValueTask Install(EngineVersion version, string path, bool deploymentPipelineProcesses, CancellationToken cancellationToken)
Does actions necessary to get an extracted installation working. A ValueTask representing the running...
ILogger< EngineInstallerBase > Logger
Gets the ILogger for the EngineInstallerBase.
abstract EngineType TargetEngineType
The EngineType the installer supports.
abstract ValueTask UpgradeInstallation(EngineVersion version, string path, CancellationToken cancellationToken)
Does actions necessary to get upgrade a version installed by a previous version of TGS....
Progress reporter for a Job.
Progress reporter for a Job.
Represents a BYOND installation.
For downloading and installing game engines for a given system.
Interface for using filesystems.
123 Stream? customVersionStream,
124 bool allowInstallation,
@@ -164,7 +164,7 @@ $(function() {
-
+
@@ -201,419 +201,430 @@ $(function() {
166 "Acquiring lock on BYOND version {version}...",
167 requiredVersion?.ToString() ?? $
"{ActiveVersion} (active)");
-
-
-
-
- 173 requiredVersion !=
null,
-
-
-
-
- 178 if (trustDmbFullPath !=
null)
-
-
-
-
-
-
- 185 installLock.Dispose();
-
-
-
-
-
-
- 193 ArgumentNullException.ThrowIfNull(progressReporter);
-
-
-
- 197 logger.LogTrace(
"DeleteVersion {version}", version);
-
-
- 200 if (activeVersion !=
null && version.
Equals(activeVersion))
-
-
-
- 204 logger.LogTrace(
"Waiting to acquire installedVersions lock...");
-
-
-
-
- 209 logger.LogTrace(
"Version {version} already deleted.", version);
-
-
-
- 213 container = containerNullable;
- 214 logger.LogTrace(
"Installation container acquired for deletion");
-
-
- 217 progressReporter.StageName =
"Waiting for version to not be in use...";
-
-
-
-
-
- 223 Task activeVersionUpdate;
-
-
-
- 227 logger.LogTrace(
"Waiting for container.OnZeroReferences or switch of active version...");
-
-
-
- 231 .WaitAsync(cancellationToken);
-
- 233 if (containerTask.IsCompleted)
- 234 logger.LogTrace(
"All locks for version {version} are gone", version);
-
- 236 logger.LogTrace(
"activeVersion changed, we may have to wait again. Acquiring semaphore...");
-
-
-
-
-
- 242 if (activeVersion !=
null && version.
Equals(activeVersion))
-
-
-
- 246 logger.LogTrace(
"Locking installedVersions...");
-
-
-
-
-
- 252 logger.LogWarning(
"Unable to remove engine installation {version} from list! Is there a duplicate job running?", version);
-
-
- 255 if (container != newerContainer)
-
-
-
-
- 260 logger.LogDebug(
"Extreme race condition encountered, applying concentrated copium...");
- 261 container = newerContainer;
-
-
-
-
-
- 267 logger.LogTrace(
"Proceeding with installation deletion...");
-
-
-
-
-
-
-
- 275 logger.LogInformation(
"Deleting version {version}...", version);
- 276 progressReporter.StageName =
"Deleting installation...";
-
-
- 279 var installPath = version.
ToString();
-
-
-
-
-
-
-
- 287 if (containerTask.IsCompleted)
-
- 289 "Another lock was acquired before we could remove version {version} from the list. We will have to wait again.",
-
-
- 292 logger.LogTrace(
"Not proceeding for some reason or another");
-
-
-
-
- 298 public async Task
StartAsync(CancellationToken cancellationToken)
-
- 300 async ValueTask<byte[]?> GetActiveVersion()
-
-
-
-
-
- 306 var activeVersionBytesTask = GetActiveVersion();
-
-
-
+
+
+
+
+
+
+
+ 176 requiredVersion !=
null,
+
+
+
+
+ 181 if (trustDmbFullPath !=
null)
+
+
+
+
+
+
+ 188 installLock.Dispose();
+
+
+
+
+
+
+ 196 ArgumentNullException.ThrowIfNull(progressReporter);
+
+
+
+ 200 logger.LogTrace(
"DeleteVersion {version}", version);
+
+
+ 203 if (activeVersion !=
null && version.
Equals(activeVersion))
+
+
+
+ 207 logger.LogTrace(
"Waiting to acquire installedVersions lock...");
+
+
+
+
+ 212 logger.LogTrace(
"Version {version} already deleted.", version);
+
+
+
+ 216 container = containerNullable;
+ 217 logger.LogTrace(
"Installation container acquired for deletion");
+
+
+ 220 progressReporter.StageName =
"Waiting for version to not be in use...";
+
+
+
+
+
+ 226 Task activeVersionUpdate;
+
+
+
+ 230 logger.LogTrace(
"Waiting for container.OnZeroReferences or switch of active version...");
+
+
+
+ 234 .WaitAsync(cancellationToken);
+
+ 236 if (containerTask.IsCompleted)
+ 237 logger.LogTrace(
"All locks for version {version} are gone", version);
+
+ 239 logger.LogTrace(
"activeVersion changed, we may have to wait again. Acquiring semaphore...");
+
+
+
+
+
+ 245 if (activeVersion !=
null && version.
Equals(activeVersion))
+
+
+
+ 249 logger.LogTrace(
"Locking installedVersions...");
+
+
+
+
+
+ 255 logger.LogWarning(
"Unable to remove engine installation {version} from list! Is there a duplicate job running?", version);
+
+
+ 258 if (container != newerContainer)
+
+
+
+
+ 263 logger.LogDebug(
"Extreme race condition encountered, applying concentrated copium...");
+ 264 container = newerContainer;
+
+
+
+
+
+ 270 logger.LogTrace(
"Proceeding with installation deletion...");
+
+
+
+
+
+
+
+ 278 logger.LogInformation(
"Deleting version {version}...", version);
+ 279 progressReporter.StageName =
"Deleting installation...";
+
+
+ 282 var installPath = version.
ToString();
+
+
+
+
+
+
+
+ 290 if (containerTask.IsCompleted)
+
+ 292 "Another lock was acquired before we could remove version {version} from the list. We will have to wait again.",
+
+
+ 295 logger.LogTrace(
"Not proceeding for some reason or another");
+
+
+
+
+ 301 public async Task
StartAsync(CancellationToken cancellationToken)
+
+ 303 async ValueTask<byte[]?> GetActiveVersion()
+
+
+
+
+
+ 309 var activeVersionBytesTask = GetActiveVersion();
- 311 var installedVersionPaths =
new Dictionary<string, EngineVersion>();
-
- 313 async ValueTask ReadVersion(
string path)
-
-
-
-
-
-
-
-
-
-
- 324 var text = Encoding.UTF8.GetString(bytes);
-
-
-
-
-
-
-
-
- 333 version = versionNullable!;
-
-
-
-
- 338 logger.LogDebug(
"Added detected BYOND version {versionKey}...", version);
-
-
-
-
-
- 344 "It seems that there are multiple directories that say they contain BYOND version {version}. We're ignoring and cleaning the duplicate: {duplicatePath}",
-
-
-
-
-
-
- 351 lock (installedVersionPaths)
-
-
-
-
-
- 357 .Select(ReadVersion));
-
- 359 logger.LogTrace(
"Upgrading BYOND installations...");
-
- 361 installedVersionPaths
-
-
- 364 var activeVersionBytes = await activeVersionBytesTask;
- 365 if (activeVersionBytes !=
null)
-
- 367 var activeVersionString = Encoding.UTF8.GetString(activeVersionBytes);
-
-
- 370 bool hasRequestedActiveVersion;
-
-
-
-
- 375 if (hasRequestedActiveVersion)
-
-
-
- 379 logger.LogWarning(
"Failed to load saved active version {activeVersion}!", activeVersionString);
-
-
-
-
-
- 386 public Task
StopAsync(CancellationToken cancellationToken) => Task.CompletedTask;
+
+
+
+ 314 var installedVersionPaths =
new Dictionary<string, EngineVersion>();
+
+ 316 async ValueTask ReadVersion(
string path)
+
+
+
+
+
+
+
+
+
+
+ 327 var text = Encoding.UTF8.GetString(bytes);
+
+
+
+
+
+
+
+
+ 336 version = versionNullable!;
+
+
+
+
+ 341 logger.LogDebug(
"Added detected BYOND version {versionKey}...", version);
+
+
+
+
+
+ 347 "It seems that there are multiple directories that say they contain BYOND version {version}. We're ignoring and cleaning the duplicate: {duplicatePath}",
+
+
+
+
+
+
+ 354 lock (installedVersionPaths)
+
+
+
+
+
+ 360 .Select(ReadVersion));
+
+ 362 logger.LogTrace(
"Upgrading BYOND installations...");
+
+ 364 installedVersionPaths
+
+
+ 367 var activeVersionBytes = await activeVersionBytesTask;
+ 368 if (activeVersionBytes !=
null)
+
+ 370 var activeVersionString = Encoding.UTF8.GetString(activeVersionBytes);
+
+
+ 373 bool hasRequestedActiveVersion;
+
+
+
+
+ 378 if (hasRequestedActiveVersion)
+
+
+
+ 382 logger.LogWarning(
"Failed to load saved active version {activeVersion}!", activeVersionString);
+
+
+
+
-
-
-
- 401 Stream? customVersionStream,
-
- 403 bool allowInstallation,
- 404 CancellationToken cancellationToken)
-
- 406 var ourTcs =
new TaskCompletionSource();
-
-
- 409 bool installedOrInstalling;
-
-
- 412 if (customVersionStream !=
null)
-
- 414 var customInstallationNumber = 1;
-
-
- 417 version.CustomIteration = customInstallationNumber++;
-
-
-
-
- 422 installedOrInstalling =
installedVersions.TryGetValue(version, out var installationContainerNullable);
-
- 424 if (!installedOrInstalling)
-
- 426 if (!allowInstallation)
- 427 throw new InvalidOperationException($
"Engine version {version} not installed!");
-
-
-
-
-
-
-
- 435 installationContainer = installationContainerNullable!;
-
- 437 installation = installationContainer.
Instance;
-
-
-
- 441 var deploymentPipelineProcesses = !neededForLock;
-
-
- 444 if (installedOrInstalling)
-
- 446 if (progressReporter !=
null)
- 447 progressReporter.StageName =
"Waiting for existing installation job...";
-
-
- 450 logger.LogWarning(
"The required engine version ({version}) is not readily available! We will have to wait for it to install.", version);
-
-
-
-
-
-
-
-
- 459 if (customVersionStream !=
null)
- 460 logger.LogInformation(
"Installing custom engine version as {version}...", version);
- 461 else if (neededForLock)
-
-
-
-
- 466 logger.LogWarning(
"The required engine version ({version}) is not readily available! We will have to install it.", version);
-
-
- 469 logger.LogInformation(
"Requested engine version {version} not currently installed. Doing so now...", version);
-
- 471 if (progressReporter !=
null)
- 472 progressReporter.StageName =
"Running event";
-
- 474 var versionString = version.
ToString();
-
-
- 477 await
InstallVersionFiles(progressReporter, version, customVersionStream, deploymentPipelineProcesses, cancellationToken);
-
-
-
-
-
-
-
- 485 if (ex is not OperationCanceledException)
-
-
-
-
-
- 491 ourTcs.SetException(ex);
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- 516 Stream? customVersionStream,
- 517 bool deploymentPipelineProcesses,
- 518 CancellationToken cancellationToken)
-
-
- 521 async ValueTask DirectoryCleanup()
-
-
-
-
-
- 527 var directoryCleanupTask = DirectoryCleanup();
-
-
-
- 531 if (customVersionStream ==
null)
-
- 533 if (progressReporter !=
null)
- 534 progressReporter.StageName =
"Downloading version";
-
-
-
-
-
-
- 541#pragma warning disable CA2000
-
-
- 544 customVersionStream);
- 545#pragma warning restore CA2000
-
- 547 await
using (engineInstallationData)
+ 389 public Task
StopAsync(CancellationToken cancellationToken) => Task.CompletedTask;
+
+
+
+
+ 404 Stream? customVersionStream,
+
+ 406 bool allowInstallation,
+ 407 CancellationToken cancellationToken)
+
+ 409 var ourTcs =
new TaskCompletionSource();
+
+
+ 412 bool installedOrInstalling;
+
+
+ 415 if (customVersionStream !=
null)
+
+ 417 var customInstallationNumber = 1;
+
+
+ 420 version.CustomIteration = customInstallationNumber++;
+
+
+
+
+ 425 installedOrInstalling =
installedVersions.TryGetValue(version, out var installationContainerNullable);
+
+ 427 if (!installedOrInstalling)
+
+ 429 if (!allowInstallation)
+ 430 throw new InvalidOperationException($
"Engine version {version} not installed!");
+
+
+
+
+
+
+
+ 438 installationContainer = installationContainerNullable!;
+
+ 440 installation = installationContainer.
Instance;
+
+
+
+ 444 var deploymentPipelineProcesses = !neededForLock;
+
+
+ 447 if (installedOrInstalling)
+
+ 449 progressReporter.StageName =
"Waiting for existing installation job...";
+
+
+ 452 logger.LogWarning(
"The required engine version ({version}) is not readily available! We will have to wait for it to install.", version);
+
+
+
+
+
+
+
+
+ 461 if (customVersionStream !=
null)
+ 462 logger.LogInformation(
"Installing custom engine version as {version}...", version);
+ 463 else if (neededForLock)
+
+
+
+
+ 468 logger.LogWarning(
"The required engine version ({version}) is not readily available! We will have to install it.", version);
+
+
+ 471 logger.LogInformation(
"Requested engine version {version} not currently installed. Doing so now...", version);
+
+ 473 progressReporter.StageName =
"Running event";
+
+ 475 var versionString = version.
ToString();
+
+
+ 478 await
InstallVersionFiles(progressReporter, version, customVersionStream, deploymentPipelineProcesses, cancellationToken);
+
+
+
+
+
+
+
+ 486 if (ex is not OperationCanceledException)
+
+
+
+
+
+ 492 ourTcs.SetException(ex);
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ 517 Stream? customVersionStream,
+ 518 bool deploymentPipelineProcesses,
+ 519 CancellationToken cancellationToken)
+
+
+ 522 async ValueTask DirectoryCleanup()
+
+
+
+
+
+ 528 var directoryCleanupTask = DirectoryCleanup();
+
+
+
+ 532 var remainingProgress = 1.0;
+ 533 if (customVersionStream ==
null)
+
+ 535 using var subReporter = progressReporter.
CreateSection(
"Downloading Version", 0.5);
+ 536 remainingProgress -= 0.5;
+
+
+
+ 540#pragma warning disable CA2000
+
+
+ 543 customVersionStream);
+ 544#pragma warning restore CA2000
+
+
+
- 549 if (progressReporter !=
null)
- 550 progressReporter.StageName =
"Cleaning target directory";
-
- 552 await directoryCleanupTask;
-
- 554 if (progressReporter !=
null)
- 555 progressReporter.StageName =
"Extracting data";
+ 549 remainingReporter = progressReporter.
CreateSection(
null, remainingProgress);
+
+
+
+ 553 await engineInstallationData.DisposeAsync();
+
+
- 557 logger.LogTrace(
"Extracting engine to {extractPath}...", installFullPath);
- 558 await engineInstallationData.
ExtractToPath(installFullPath, cancellationToken);
-
-
- 561 if (progressReporter !=
null)
- 562 progressReporter.StageName =
"Running installation actions";
-
-
-
- 566 if (progressReporter !=
null)
- 567 progressReporter.StageName =
"Writing version file";
-
-
-
-
- 572 Encoding.UTF8.GetBytes(version.
ToString()),
-
-
- 575 catch (HttpRequestException ex)
-
-
-
-
- 580 catch (OperationCanceledException)
-
-
-
-
-
-
-
-
-
-
-
-
-
+ 557 using (remainingReporter)
+
+ 559 await
using (engineInstallationData)
+
+ 561 remainingReporter.StageName =
"Cleaning target directory";
+
+ 563 await directoryCleanupTask;
+
+ 565 remainingReporter.StageName =
"Extracting data";
+
+ 567 logger.LogTrace(
"Extracting engine to {extractPath}...", installFullPath);
+ 568 await engineInstallationData.
ExtractToPath(installFullPath, cancellationToken);
+
+
+
+ 572 remainingReporter.StageName =
"Running installation actions";
+
+
+
+
+ 577 remainingReporter.StageName =
"Writing version file";
+
+
+
+
+ 582 Encoding.UTF8.GetBytes(version.
ToString()),
+
+
+
+ 586 catch (HttpRequestException ex)
+
+
+
+
+ 591 catch (OperationCanceledException)
+
+
+
+
+
+
+
+
+
-
-
-
-
-
- 607 return installationContainer;
-
-
-
+
+
+
+
+
+
+
+
+
+ 618 return installationContainer;
+
+
+
Information about an engine installation.
static async ValueTask WhenAll(IEnumerable< ValueTask > tasks)
Fully await a given list of tasks .
async ValueTask InstallVersionFiles(JobProgressReporter? progressReporter, EngineVersion version, Stream? customVersionStream, bool deploymentPipelineProcesses, CancellationToken cancellationToken)
Installs the files for a given BYOND version .
static void CheckVersionParameter(EngineVersion version)
Validates a given version parameter.
readonly Dictionary< EngineVersion, ReferenceCountingContainer< IEngineInstallation, EngineExecutableLock > > installedVersions
Map of byond EngineVersions to Tasks that complete when they are installed.
Task StopAsync(CancellationToken cancellationToken)
async ValueTask< EngineExecutableLock > AssertAndLockVersion(JobProgressReporter? progressReporter, EngineVersion version, Stream? customVersionStream, bool neededForLock, bool allowInstallation, CancellationToken cancellationToken)
Ensures a BYOND version is installed if it isn't already.
const string VersionFileName
The file in which we store the Version for installations.
async Task StartAsync(CancellationToken cancellationToken)
async Task StartAsync(CancellationToken cancellationToken)
IReadOnlyList< EngineVersion > InstalledVersions
The installed EngineVersions.
async ValueTask< EngineExecutableLock > AssertAndLockVersion(JobProgressReporter progressReporter, EngineVersion version, Stream? customVersionStream, bool neededForLock, bool allowInstallation, CancellationToken cancellationToken)
Ensures a BYOND version is installed if it isn't already.
volatile TaskCompletionSource activeVersionChanged
TaskCompletionSource that notifes when the ActiveVersion changes.
const string ActiveVersionFileName
The file in which we store the ActiveVersion.
async ValueTask< IEngineExecutableLock > UseExecutables(EngineVersion? requiredVersion, string? trustDmbFullPath, CancellationToken cancellationToken)
Lock the current installation's location and return a IEngineExecutableLock. A ValueTask<TResult> res...
async ValueTask DeleteVersion(JobProgressReporter progressReporter, EngineVersion version, CancellationToken cancellationToken)
Deletes a given version from the disk. A Task representing the running operation.
async ValueTask DeleteVersion(JobProgressReporter progressReporter, EngineVersion version, CancellationToken cancellationToken)
Deletes a given version from the disk. A Task representing the running operation.
EngineVersion? ActiveVersion
The currently active EngineVersion.
EngineManager(IIOManager ioManager, IEngineInstaller engineInstaller, IEventConsumer eventConsumer, ILogger< EngineManager > logger)
Initializes a new instance of the EngineManager class.
readonly SemaphoreSlim changeDeleteSemaphore
The SemaphoreSlim for changing or deleting the active BYOND version.
async ValueTask ChangeVersion(JobProgressReporter progressReporter, EngineVersion version, Stream? customVersionStream, bool allowInstallation, CancellationToken cancellationToken)
Change the active EngineVersion. A ValueTask representing the running operation.
readonly IEventConsumer eventConsumer
The IEventConsumer for the EngineManager.
readonly IIOManager ioManager
The IIOManager for the EngineManager.
readonly IEngineInstaller engineInstaller
The IEngineInstaller for the EngineManager.
async ValueTask InstallVersionFiles(JobProgressReporter progressReporter, EngineVersion version, Stream? customVersionStream, bool deploymentPipelineProcesses, CancellationToken cancellationToken)
Installs the files for a given BYOND version .
readonly ILogger< EngineManager > logger
The ILogger for the EngineManager.
ReferenceCountingContainer< IEngineInstallation, EngineExecutableLock > AddInstallationContainer(EngineVersion version, string installPath, Task installationTask)
Create and add a new IEngineInstallation to installedVersions.
async ValueTask ChangeVersion(JobProgressReporter? progressReporter, EngineVersion version, Stream? customVersionStream, bool allowInstallation, CancellationToken cancellationToken)
Change the active EngineVersion. A ValueTask representing the running operation.
ReferenceCountingContainer< IEngineInstallation, EngineExecutableLock > AddInstallationContainer(EngineVersion version, string installPath, Task installationTask)
Create and add a new IEngineInstallation to installedVersions.
Implementation of IEngineInstallationData for a zip file in a Stream.
IIOManager that resolves paths to Environment.CurrentDirectory.
const string CurrentDirectory
Path to the current working directory for the IIOManager.
Operation exceptions thrown from the context of a Models.Job.
Progress reporter for a Job.
void ReportProgress(double? progress)
Report progress.
Progress reporter for a Job.
JobProgressReporter CreateSection(string? newStageName, double percentage)
Create a subsection of the JobProgressReporter with its optional own stage name.
void ReportProgress(double? progress)
Report progress.
Wrapper for managing some TWrapped .
TReference AddReference()
Create a new TReference to the Instance.
Task InstallationTask
The Task that completes when the BYOND version finished installing.
For downloading and installing game engines for a given system.
IEngineInstallation CreateInstallation(EngineVersion version, string path, Task installationTask)
Creates an IEngineInstallation for a given version .
ValueTask< IEngineInstallationData > DownloadVersion(EngineVersion version, JobProgressReporter jobProgressReporter, CancellationToken cancellationToken)
Download a given engine version .
ValueTask UpgradeInstallation(EngineVersion version, string path, CancellationToken cancellationToken)
Does actions necessary to get upgrade a version installed by a previous version of TGS.
ValueTask< IEngineInstallationData > DownloadVersion(EngineVersion version, JobProgressReporter? jobProgressReporter, CancellationToken cancellationToken)
Download a given engine version .
ValueTask Install(EngineVersion version, string path, bool deploymentPipelineProcesses, CancellationToken cancellationToken)
Does actions necessary to get an extracted installation working.
ValueTask TrustDmbPath(EngineVersion version, string fullDmbPath, CancellationToken cancellationToken)
Add a given fullDmbPath to the trusted DMBs list in BYOND's config.
For managing the engine installations.
28 this FetchOptions fetchOptions,
-
+
31 CredentialsHandler credentialsHandler,
32 CancellationToken cancellationToken)
@@ -115,7 +115,7 @@ $(function() {
48 fetchOptions.OnUpdateTips = (_, _, _) => !cancellationToken.IsCancellationRequested;
49 fetchOptions.CredentialsProvider = credentialsHandler;
50 fetchOptions.RepositoryOperationStarting = _ => !cancellationToken.IsCancellationRequested;
-
+
@@ -123,7 +123,7 @@ $(function() {
-
+
69 var totalObjectsToProcess = transferProgress.TotalObjects * 2;
@@ -150,10 +150,10 @@ $(function() {
Extension methods for FetchOptions.
static TransferProgressHandler TransferProgressHandler(ILogger logger, JobProgressReporter? progressReporter, CancellationToken cancellationToken)
Generate a LibGit2Sharp.Handlers.TransferProgressHandler from a given progressReporter and cancellat...
static FetchOptions Hydrate(this FetchOptions fetchOptions, ILogger logger, JobProgressReporter? progressReporter, CredentialsHandler credentialsHandler, CancellationToken cancellationToken)
Hydrate a given set of fetchOptions .
Progress reporter for a Job.
void ReportProgress(double? progress)
Report progress.
static TransferProgressHandler TransferProgressHandler(ILogger logger, JobProgressReporter progressReporter, CancellationToken cancellationToken)
Generate a LibGit2Sharp.Handlers.TransferProgressHandler from a given progressReporter and cancellat...
static FetchOptions Hydrate(this FetchOptions fetchOptions, ILogger logger, JobProgressReporter progressReporter, CredentialsHandler credentialsHandler, CancellationToken cancellationToken)
Hydrate a given set of fetchOptions .
Progress reporter for a Job.
void ReportProgress(double? progress)
Report progress.
27 CancellationToken cancellationToken);
-Progress reporter for a Job.
Progress reporter for a Job.
For managing the compiler.
ValueTask DeploymentProcess(Job job, IDatabaseContextFactory databaseContextFactory, JobProgressReporter progressReporter, CancellationToken cancellationToken)
Create and a compile job and insert it into the database. Meant to be called by a IJobManager.
40 ValueTask
Install(
EngineVersion version,
string path,
bool deploymentPipelineProcesses, CancellationToken cancellationToken);
@@ -101,12 +101,12 @@ $(function() {
Information about an engine installation.
Progress reporter for a Job.
Progress reporter for a Job.
Represents a BYOND installation.
For downloading and installing game engines for a given system.
IEngineInstallation CreateInstallation(EngineVersion version, string path, Task installationTask)
Creates an IEngineInstallation for a given version .
ValueTask< IEngineInstallationData > DownloadVersion(EngineVersion version, JobProgressReporter jobProgressReporter, CancellationToken cancellationToken)
Download a given engine version .
ValueTask UpgradeInstallation(EngineVersion version, string path, CancellationToken cancellationToken)
Does actions necessary to get upgrade a version installed by a previous version of TGS.
ValueTask< IEngineInstallationData > DownloadVersion(EngineVersion version, JobProgressReporter? jobProgressReporter, CancellationToken cancellationToken)
Download a given engine version .
ValueTask Install(EngineVersion version, string path, bool deploymentPipelineProcesses, CancellationToken cancellationToken)
Does actions necessary to get an extracted installation working.
ValueTask TrustDmbPath(EngineVersion version, string fullDmbPath, CancellationToken cancellationToken)
Add a given fullDmbPath to the trusted DMBs list in BYOND's config.
Task CleanCache(CancellationToken cancellationToken)
Attempts to cleans the engine's cache folder for the system.
40 Stream? customVersionStream,
41 bool allowInstallation,
@@ -112,13 +112,13 @@ $(function() {
Information about an engine installation.
Progress reporter for a Job.
Progress reporter for a Job.
For managing the engine installations.
ValueTask DeleteVersion(JobProgressReporter progressReporter, EngineVersion version, CancellationToken cancellationToken)
Deletes a given version from the disk.
IReadOnlyList< EngineVersion > InstalledVersions
The installed EngineVersions.
EngineVersion? ActiveVersion
The currently active EngineVersion.
ValueTask ChangeVersion(JobProgressReporter progressReporter, EngineVersion version, Stream? customVersionStream, bool allowInstallation, CancellationToken cancellationToken)
Change the active EngineVersion.
ValueTask< IEngineExecutableLock > UseExecutables(EngineVersion? requiredVersion, string? trustDmbFullPath, CancellationToken cancellationToken)
Lock the current installation's location and return a IEngineExecutableLock.
ValueTask ChangeVersion(JobProgressReporter? progressReporter, EngineVersion version, Stream? customVersionStream, bool allowInstallation, CancellationToken cancellationToken)
Change the active EngineVersion.
Represents a component meant to be started and stopped by its parent component.
void SuspendProcess()
Suspends the process.
void ResumeProcess()
Resumes the process.
void AdjustPriority(bool higher)
Set's the owned global::System.Diagnostics.Process.PriorityClass to a non-normal value.
long MemoryUsage
Gets the process' memory usage in bytes.
long? MemoryUsage
Gets the process' memory usage in bytes.
ValueTask CreateDump(string outputFile, bool minidump, CancellationToken cancellationToken)
Create a dump file of the process.
Task< int?> Lifetime
The Task<TResult> resulting in the exit code of the process or null if the process was detached.
41 Task<bool>
IsSha(
string committish, CancellationToken cancellationToken);
-
+
58 bool updateSubmodules,
59 bool moveCurrentReference,
-
+
61 CancellationToken cancellationToken);
@@ -117,8 +117,8 @@ $(function() {
83 CancellationToken cancellationToken);
-
-
+
+
98 bool deploymentPipeline,
@@ -162,7 +162,7 @@ $(function() {
Parameters for creating a TestMerge.
Progress reporter for a Job.
Progress reporter for a Job.
Represents an on-disk git repository.
Task< DateTimeOffset > TimestampCommit(string sha, CancellationToken cancellationToken)
Gets the DateTimeOffset a given sha was created on.
string Head
The SHA of the IRepository HEAD.
Task ResetToSha(string sha, JobProgressReporter progressReporter, CancellationToken cancellationToken)
Requires the current HEAD to be a reference. Hard resets the reference to the given sha.
Task< bool > CommittishIsParent(string committish, CancellationToken cancellationToken)
Check if a given committish is a parent of the current Head.
ValueTask CheckoutObject(string committish, string? username, string? password, bool updateSubmodules, bool moveCurrentReference, JobProgressReporter? progressReporter, CancellationToken cancellationToken)
Checks out a given committish .
ValueTask CheckoutObject(string committish, string? username, string? password, bool updateSubmodules, bool moveCurrentReference, JobProgressReporter progressReporter, CancellationToken cancellationToken)
Checks out a given committish .
Task< bool > IsSha(string committish, CancellationToken cancellationToken)
Checks if a given committish is a sha.
ValueTask FetchOrigin(JobProgressReporter? progressReporter, string? username, string? password, bool deploymentPipeline, CancellationToken cancellationToken)
Fetch commits from the origin repository.
ValueTask FetchOrigin(JobProgressReporter progressReporter, string? username, string? password, bool deploymentPipeline, CancellationToken cancellationToken)
Fetch commits from the origin repository.
Uri Origin
The current origin remote the IRepository is using.
ValueTask< TestMergeResult > AddTestMerge(TestMergeParameters testMergeParameters, string committerName, string committerEmail, string? username, string? password, bool updateSubmodules, JobProgressReporter progressReporter, CancellationToken cancellationToken)
Attempt to merge the revision specified by a given set of testMergeParameters into HEAD.
44 string? initialBranch,
-
+
48 bool recurseSubmodules,
49 CancellationToken cancellationToken);
@@ -106,9 +106,9 @@ $(function() {
-Progress reporter for a Job.
Progress reporter for a Job.
Factory for creating and loading IRepositorys.
ValueTask< IRepository?> CloneRepository(Uri url, string? initialBranch, string? username, string? password, JobProgressReporter? progressReporter, bool recurseSubmodules, CancellationToken cancellationToken)
Clone the repository at url .
ValueTask< IRepository?> CloneRepository(Uri url, string? initialBranch, string? username, string? password, JobProgressReporter progressReporter, bool recurseSubmodules, CancellationToken cancellationToken)
Clone the repository at url .
bool CloneInProgress
If a CloneRepository(Uri, string, string, string, JobProgressReporter, bool, CancellationToken) opera...
ValueTask< IRepository?> LoadRepository(CancellationToken cancellationToken)
Attempt to load the IRepository from the default location.
ValueTask DeleteRepository(CancellationToken cancellationToken)
Delete the current repository.
24 CancellationToken cancellationToken);
-Progress reporter for a Job.
Progress reporter for a Job.
For interacting with the instance services.
Factory for scoping usage of IDatabaseContexts. Meant for use by Components.
3using Microsoft.Extensions.Logging;
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
33 readonly ILogger<JobProgressReporter>
logger;
-
-
-
-
-
-
-
-
-
-
-
-
63 this.logger =
logger ??
throw new ArgumentNullException(nameof(
logger));
-
64 this.callback =
callback ??
throw new ArgumentNullException(nameof(
callback));
-
-
-
67 logger.LogDebug(
"Job progress reporter created. Stage: {stageName}",
stageName ??
"(null)");
-
-
-
-
-
76 var clampedProgress = progress;
-
77 if (progress.HasValue)
-
78 if (progress > 1 || progress < 0)
-
-
-
81 new ArgumentOutOfRangeException(nameof(progress), progress,
"Progress must be a value from 0-1!"),
-
82 "Invalid progress value for stage {stageName}",
-
-
84 clampedProgress =
null;
-
-
-
+
4using Microsoft.Extensions.Logging.Abstractions;
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
34 readonly ILogger<JobProgressReporter>
logger;
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
-
-
-
-
-
-
-
102 if (percentage > 1 || percentage < 0)
-
-
-
105 new ArgumentOutOfRangeException(nameof(percentage), percentage,
"Percentage must be a value from 0-1!"),
-
106 "Invalid percentage value for stage {newStageName}! Clamping...",
-
107 newStageName ??
"(null)");
+
+
+
98 this.logger =
logger ??
throw new ArgumentNullException(nameof(
logger));
+
99 this.callback =
callback ??
throw new ArgumentNullException(nameof(
callback));
+
+
+
+
+
+
+
+
-
109 percentage = Math.Min(Math.Max(percentage, 0.0), 1.0);
-
+
109 logger.LogDebug(
"Job progress reporter created. Stage: {stageName}",
stageName ??
"(null)");
+
-
-
113 if (percentage + childBaseProgress > 1.0)
-
-
115 var remainingPercentage = 1.0 - childBaseProgress;
-
-
117 "Stage {newStageName} is overbudgeted ({budget}/{remainingPercentage})! Clamping...",
-
-
-
120 remainingPercentage);
-
121 percentage = remainingPercentage;
-
-
-
-
-
-
127 (currentStage, progress) =>
-
-
-
130 if (!progress.HasValue)
-
-
132 callback(currentStage, null);
-
-
-
-
136 var childLocalProgress = progress.Value * percentage;
-
-
-
-
-
-
-
-
-
-
-
Progress reporter for a Job.
-
double? lastProgress
The last progress value pushed into the callback.
-
double sectionProgression
The total progress reported so far in this section.
-
string? StageName
The name of the current stage.
-
readonly Action< string?, double?> callback
Progress reporter callback taking a description of what the job is currently doing and the (optional)...
-
JobProgressReporter CreateSection(string? newStageName, double percentage)
Create a subsection of the JobProgressReporter with its optional own stage name.
-
JobProgressReporter(ILogger< JobProgressReporter > logger, string? stageName, Action< string?, double?> callback)
Initializes a new instance of the JobProgressReporter class.
-
readonly ILogger< JobProgressReporter > logger
The ILogger<TCategoryName> for the JobProgressReporter.
-
void ReportProgress(double? progress)
Report progress.
-
string? stageName
Backing field for StageName.
+
+
+
+
+
+
+
+
+
+
+
+
124 new InvalidOperationException($
"Parent progress reporter has child sections that didn't complete! Current: {sectionProgression}"),
+
125 "TGS BUG: Progress reporter children didn't complete!");
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
148 new InvalidOperationException(
"Progress reporter is reporting progress with existing nested sections!"),
+
149 "TGS BUG: A progress reporter is using mixed local and nested progress, this is not supported");
+
+
+
152 var clampedProgress = progress;
+
153 if (progress.HasValue)
+
154 if (progress > 1 || progress < 0)
+
+
+
157 new ArgumentOutOfRangeException(nameof(progress), progress,
"Progress must be a value from 0-1!"),
+
158 "TGS BUG: Invalid progress value for stage {stageName}",
+
+
160 clampedProgress =
null;
+
+
+
+
+
+
+
+
+
+
+
178 if (percentage > 1 || percentage < 0)
+
+
+
181 new ArgumentOutOfRangeException(nameof(percentage), percentage,
"Percentage must be a value from 0-1!"),
+
182 "TGS BUG: Invalid percentage value for stage {newStageName}! Clamping...",
+
183 newStageName ??
"(null)");
+
+
185 percentage = Math.Min(Math.Max(percentage, 0.0), 1.0);
+
+
+
+
+
+
+
+
193 new InvalidOperationException(
"Progress reporter is creating a section with local progress!"),
+
194 "TGS BUG: A progress reporter is using mixed local and nested progress, this is not supported");
+
+
+
+
+
+
+
+
+
+
+
205 "Stage {newStageName} is overbudgeted ({budget}/{remainingPercentage})! Clamping...",
+
+
+
208 remainingPercentage);
+
209 percentage = remainingPercentage;
+
+
+
+
+
214 var childLocalProgress = 0.0;
+
+
+
+
218 (currentStage, progress) =>
+
+
+
221 if (!progress.HasValue)
+
+
223 callback(currentStage, null);
+
+
+
+
+
228 childLocalProgress = progress.Value * percentage;
+
+
+
+
+
+
+
+
+
+
+
239 newReporter.ReportProgress(0);
+
+
+
+
+
+
Progress reporter for a Job.
+
double? lastProgress
The last progress value pushed into the callback.
+
double sectionProgression
The total progress reported so far in this section.
+
string? StageName
The name of the current stage.
+
readonly Action< string?, double?> callback
Progress reporter callback taking a description of what the job is currently doing and the (optional)...
+
JobProgressReporter CreateSection(string? newStageName, double percentage)
Create a subsection of the JobProgressReporter with its optional own stage name.
+
JobProgressReporter(ILogger< JobProgressReporter > logger, string? stageName, Action< string?, double?> callback)
Initializes a new instance of the JobProgressReporter class.
+
readonly ILogger< JobProgressReporter > logger
The ILogger<TCategoryName> for the JobProgressReporter.
+
+
JobProgressReporter(ILogger< JobProgressReporter > logger, string? stageName, Action< string?, double?> callback, bool setStageName)
Initializes a new instance of the JobProgressReporter class.
+
JobProgressReporter()
Initializes a new instance of the JobProgressReporter class.
+
double? sectionReservations
The total progress reserved for use in this section.
+
void ReportProgress(double? progress)
Report progress.
+
string? stageName
Backing field for StageName.
+
Represents an Api.Models.Instance in the database.
diff --git a/_job_service_8cs_source.html b/_job_service_8cs_source.html
index 6100983377..7de5bbc3bb 100644
--- a/_job_service_8cs_source.html
+++ b/_job_service_8cs_source.html
@@ -482,101 +482,103 @@ $(function() {
460 QueueHubUpdate(job.
ToApi(),
false);
462 logger.LogTrace(
"Starting job...");
-
- 464 instanceCoreProvider.GetInstance(job.
Instance!),
- 465 databaseContextFactory,
-
-
-
-
-
-
-
- 473 logger.LogDebug(
"Job {jobId} completed!", job.
Id);
-
-
- 476 catch (OperationCanceledException ex)
-
- 478 logger.LogDebug(ex,
"Job {jobId} cancelled!", job.
Id);
- 479 job.Cancelled =
true;
-
-
-
-
- 484 job.ExceptionDetails = String.IsNullOrWhiteSpace(e.Message) ? e.InnerException?.Message : e.Message + $
" (Inner exception: {e.InnerException?.Message})";
-
-
-
-
- 489 job.ExceptionDetails = e.ToString();
-
-
-
-
-
- 495 await databaseContextFactory.UseContext(async databaseContext =>
-
- 497 var attachedJob =
new Job(jid);
-
- 499 databaseContext.Jobs.Attach(attachedJob);
- 500 attachedJob.StoppedAt = DateTimeOffset.UtcNow;
-
-
-
-
-
- 506 await databaseContext.Save(CancellationToken.None);
-
-
-
- 510 await databaseContextFactory.UseContext(async databaseContext =>
-
-
-
-
-
- 516 var finalJob = await databaseContext
-
-
- 519 .Include(x => x.Instance)
- 520 .Include(x => x.StartedBy)
- 521 .Include(x => x.CancelledBy)
- 522 .Where(dbJob => dbJob.Id == jid)
- 523 .FirstAsync(CancellationToken.None);
- 524 QueueHubUpdate(finalJob.ToApi(),
true);
-
-
-
-
- 529 lock (hubUpdateActions)
- 530 hubUpdateActions.Remove(jid);
-
-
-
-
-
-
- 537 await hubUpdatesTask;
-
-
-
- 541 logger.LogError(ex,
"Error in hub updates chain task!");
-
-
-
-
-
-
- 548 lock (synchronizationLock)
-
- 550 var handler = jobs[jid];
-
-
-
-
-
-
-
+
+
+
+
+ 467 using var innerReporter = progressReporter.CreateSection(
null, 1.0);
+
+ 469 instanceCoreProvider.GetInstance(job.
Instance!),
+ 470 databaseContextFactory,
+
+
+
+
+ 475 logger.LogDebug(
"Job {jobId} completed!", job.
Id);
+
+
+ 478 catch (OperationCanceledException ex)
+
+ 480 logger.LogDebug(ex,
"Job {jobId} cancelled!", job.
Id);
+ 481 job.Cancelled =
true;
+
+
+
+
+ 486 job.ExceptionDetails = String.IsNullOrWhiteSpace(e.Message) ? e.InnerException?.Message : e.Message + $
" (Inner exception: {e.InnerException?.Message})";
+
+
+
+
+ 491 job.ExceptionDetails = e.ToString();
+
+
+
+
+
+ 497 await databaseContextFactory.UseContext(async databaseContext =>
+
+ 499 var attachedJob =
new Job(jid);
+
+ 501 databaseContext.Jobs.Attach(attachedJob);
+ 502 attachedJob.StoppedAt = DateTimeOffset.UtcNow;
+
+
+
+
+
+ 508 await databaseContext.Save(CancellationToken.None);
+
+
+
+ 512 await databaseContextFactory.UseContext(async databaseContext =>
+
+
+
+
+
+ 518 var finalJob = await databaseContext
+
+
+ 521 .Include(x => x.Instance)
+ 522 .Include(x => x.StartedBy)
+ 523 .Include(x => x.CancelledBy)
+ 524 .Where(dbJob => dbJob.Id == jid)
+ 525 .FirstAsync(CancellationToken.None);
+ 526 QueueHubUpdate(finalJob.ToApi(),
true);
+
+
+
+
+ 531 lock (hubUpdateActions)
+ 532 hubUpdateActions.Remove(jid);
+
+
+
+
+
+
+ 539 await hubUpdatesTask;
+
+
+
+ 543 logger.LogError(ex,
"Error in hub updates chain task!");
+
+
+
+
+
+
+ 550 lock (synchronizationLock)
+
+ 552 var handler = jobs[jid];
+
+
+
+
+
+
+
virtual ? long Id
The ID of the entity.
void Cancel()
Cancels task.
Task< bool > Wait(CancellationToken cancellationToken)
Wait for task to complete.
bool Started
If the job has started.
Progress reporter for a Job.
Progress reporter for a Job.
readonly IConnectionMappedHubContext< JobsHub, IJobsHub > hub
The IHubContext for the JobsHub.
async Task< bool > RunJob(Job job, JobEntrypoint operation, CancellationToken cancellationToken)
Runner for JobHandlers.
141 Logger.LogTrace(
"Cloning OD repo...");
-
- 143 var progressSection1 = jobProgressReporter?.
CreateSection(
"Updating OpenDream git repository", 0.5f);
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- 158 Logger.LogTrace(
"OD repo seems to already exist, attempting load and fetch...");
-
-
- 161 throw new JobException(
"Can't load OpenDream repository! Please delete cache from disk!");
+ 139 ArgumentNullException.ThrowIfNull(jobProgressReporter);
+
+
+ 142 Logger.LogTrace(
"Cloning OD repo...");
+
+ 144 var progressSection1 = jobProgressReporter.
CreateSection(
"Updating OpenDream git repository", 0.5f);
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ 159 progressSection1.Dispose();
+
+
- 163 await repo!.FetchOrigin(
-
-
-
-
-
-
-
- 171 var progressSection2 = jobProgressReporter?.
CreateSection(
"Checking out OpenDream version", 0.5f);
-
- 173 var committish = version.SourceSHA
- 174 ?? $
"{GeneralConfiguration.OpenDreamGitTagPrefix}{version.Version!.Semver()}";
-
- 176 await repo.CheckoutObject(
-
-
-
-
-
-
-
-
- 185 if (!await repo.CommittishIsParent(
"tgs-min-compat", cancellationToken))
-
+
+
+
+
+ 167 Logger.LogTrace(
"OD repo seems to already exist, attempting load and fetch...");
+
+
+ 170 throw new JobException(
"Can't load OpenDream repository! Please delete cache from disk!");
+
+
+
+
+
+
+
+
+
+ 180 progressSection1.Dispose();
+ 181 progressSection1 =
null;
+
+ 183 using (var progressSection2 = jobProgressReporter.
CreateSection(
"Checking out OpenDream version", 0.5f))
+
+ 185 var committish = version.SourceSHA
+ 186 ?? $
"{GeneralConfiguration.OpenDreamGitTagPrefix}{version.Version!.Semver()}";
-
-
-
-
-
-
-
-
-
- 198 public override async ValueTask
Install(
EngineVersion version,
string installPath,
bool deploymentPipelineProcesses, CancellationToken cancellationToken)
-
-
- 201 ArgumentNullException.ThrowIfNull(installPath);
-
-
-
-
-
-
- 208 Logger.LogDebug(
"Correcting extraction location...");
-
-
-
-
- 213 await Task.WhenAll(dirsTask, filesTask, dirCreateTask);
-
- 215 var dirsMoveTasks = dirsTask
-
-
-
-
-
-
-
-
- 224 var filesMoveTask = filesTask
-
-
-
-
-
-
-
-
-
- 234 await Task.WhenAll(dirsMoveTasks.Concat(filesMoveTask));
-
-
-
- 238 if (dotnetPath ==
null)
-
-
- 241 const string DeployDir =
"tgs_deploy";
- 242 int? buildExitCode =
null;
-
- 244 async shortenedPath =>
-
-
-
-
-
- 250 $
"run -c Release --project OpenDreamPackageTool -- --tgs -o {shortenedDeployPath}",
-
-
-
-
-
-
-
- 258 buildProcess.AdjustPriority(
false);
-
- 260 using (cancellationToken.Register(() => buildProcess.Terminate()))
- 261 buildExitCode = await buildProcess.Lifetime;
-
-
-
-
- 266 var buildOutputTask = buildProcess.GetCombinedOutput(cancellationToken);
- 267 if (!buildOutputTask.IsCompleted)
- 268 Logger.LogTrace(
"OD build complete, waiting for output...");
- 269 output = await buildOutputTask;
-
-
- 272 output =
"<Build output suppressed by configuration due to not being immediately available>";
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ 210 progressSection1?.Dispose();
+
+
+
+ 215 public override async ValueTask
Install(
EngineVersion version,
string installPath,
bool deploymentPipelineProcesses, CancellationToken cancellationToken)
+
+
+ 218 ArgumentNullException.ThrowIfNull(installPath);
+
+
+
+
+
+
+ 225 Logger.LogDebug(
"Correcting extraction location...");
+
+
+
+
+ 230 await Task.WhenAll(dirsTask, filesTask, dirCreateTask);
+
+ 232 var dirsMoveTasks = dirsTask
+
+
+
+
+
+
+
+
+ 241 var filesMoveTask = filesTask
+
+
+
+
+
+
+
+
+
+ 251 await Task.WhenAll(dirsMoveTasks.Concat(filesMoveTask));
+
+
+
+ 255 if (dotnetPath ==
null)
+
+
+ 258 const string DeployDir =
"tgs_deploy";
+ 259 int? buildExitCode =
null;
+
+ 261 async shortenedPath =>
+
+
+
+
+
+ 267 $
"run -c Release --project OpenDreamPackageTool -- --tgs -o {shortenedDeployPath}",
+
+
+
+
+
-
- 275 "OpenDream build exited with code {exitCode}:{newLine}{output}",
-
-
-
-
-
-
-
- 283 if (buildExitCode != 0)
-
-
-
- 287 async ValueTask MoveDirs()
-
-
-
-
-
-
-
-
-
- 297 cancellationToken)));
-
+
+ 275 buildProcess.AdjustPriority(
false);
+
+ 277 using (cancellationToken.Register(() => buildProcess.Terminate()))
+ 278 buildExitCode = await buildProcess.Lifetime;
+
+
+
+
+ 283 var buildOutputTask = buildProcess.GetCombinedOutput(cancellationToken);
+ 284 if (!buildOutputTask.IsCompleted)
+ 285 Logger.LogTrace(
"OD build complete, waiting for output...");
+ 286 output = await buildOutputTask;
+
+
+ 289 output =
"<Build output suppressed by configuration due to not being immediately available>";
+
+
+ 292 "OpenDream build exited with code {exitCode}:{newLine}{output}",
+
+
+
+
+
+
- 300 async ValueTask MoveFiles()
-
-
-
-
-
-
-
-
-
- 310 cancellationToken)));
-
-
- 313 var dirsMoveTask = MoveDirs();
- 314 var outputFilesMoveTask = MoveFiles();
-
-
-
-
-
-
-
- 323 ArgumentNullException.ThrowIfNull(path);
- 324 return ValueTask.CompletedTask;
-
-
-
-
- 330 ArgumentNullException.ThrowIfNull(engineVersion);
- 331 ArgumentNullException.ThrowIfNull(fullDmbPath);
-
- 333 Logger.LogTrace(
"TrustDmbPath is a no-op: {path}", fullDmbPath);
- 334 return ValueTask.CompletedTask;
-
-
-
- 345 Func<string, ValueTask> shortenedPathOperation,
-
- 347 CancellationToken cancellationToken)
- 348 => shortenedPathOperation(originalPath);
+ 300 if (buildExitCode != 0)
+
+
+
+ 304 async ValueTask MoveDirs()
+
+
+
+
+
+
+
+
+
+ 314 cancellationToken)));
+
+
+ 317 async ValueTask MoveFiles()
+
+
+
+
+
+
+
+
+
+ 327 cancellationToken)));
+
+
+ 330 var dirsMoveTask = MoveDirs();
+ 331 var outputFilesMoveTask = MoveFiles();
+
+
+
+
+
+
+
+ 340 ArgumentNullException.ThrowIfNull(path);
+ 341 return ValueTask.CompletedTask;
+
+
+
+
+ 347 ArgumentNullException.ThrowIfNull(engineVersion);
+ 348 ArgumentNullException.ThrowIfNull(fullDmbPath);
- 356 protected void GetExecutablePaths(
string installationPath, out
string serverExePath, out
string compilerExePath)
-
- 358 var exeExtension = platformIdentifier.IsWindows
-
-
-
-
-
-
-
- 366 $
"Robust.Server{exeExtension}");
-
-
-
-
-
- 372 $
"DMCompiler{exeExtension}");
-
-
-
+ 350 Logger.LogTrace(
"TrustDmbPath is a no-op: {path}", fullDmbPath);
+ 351 return ValueTask.CompletedTask;
+
+
+
+ 362 Func<string, ValueTask> shortenedPathOperation,
+
+ 364 CancellationToken cancellationToken)
+ 365 => shortenedPathOperation(originalPath);
+
+ 373 protected void GetExecutablePaths(
string installationPath, out
string serverExePath, out
string compilerExePath)
+
+ 375 var exeExtension = platformIdentifier.IsWindows
+
+
+
+
+
+
+
+ 383 $
"Robust.Server{exeExtension}");
+
+
+
+
+
+ 389 $
"DMCompiler{exeExtension}");
+
+
+
Information about an engine installation.
Extension methods for the ValueTask and ValueTask<TResult> classes.
static async ValueTask WhenAll(IEnumerable< ValueTask > tasks)
Fully await a given list of tasks .
ILogger< EngineInstallerBase > Logger
Gets the ILogger for the EngineInstallerBase.
Implementation of IEngineInstallation for EngineType.OpenDream.
Implementation of IEngineInstaller for EngineType.OpenDream.
void GetExecutablePaths(string installationPath, out string serverExePath, out string compilerExePath)
Gets the paths to the server and client executables.
void GetExecutablePaths(string installationPath, out string serverExePath, out string compilerExePath)
Gets the paths to the server and client executables.
readonly IAbstractHttpClientFactory httpClientFactory
The IAbstractHttpClientFactory for the OpenDreamInstaller.
override EngineType TargetEngineType
readonly IPlatformIdentifier platformIdentifier
The IPlatformIdentifier for the OpenDreamInstaller.
readonly IRepositoryManager repositoryManager
The IRepositoryManager for the OpenDream repository.
override async ValueTask Install(EngineVersion version, string installPath, bool deploymentPipelineProcesses, CancellationToken cancellationToken)
Does actions necessary to get an extracted installation working. A ValueTask representing the running...
override async ValueTask< IEngineInstallationData > DownloadVersion(EngineVersion version, JobProgressReporter? jobProgressReporter, CancellationToken cancellationToken)
Download a given engine version . A ValueTask<TResult> resulting in the IEngineInstallationData for t...
override ValueTask TrustDmbPath(EngineVersion engineVersion, string fullDmbPath, CancellationToken cancellationToken)
Add a given fullDmbPath to the trusted DMBs list in BYOND's config. A ValueTask representing the run...
override async ValueTask Install(EngineVersion version, string installPath, bool deploymentPipelineProcesses, CancellationToken cancellationToken)
Does actions necessary to get an extracted installation working. A ValueTask representing the running...
override ValueTask TrustDmbPath(EngineVersion engineVersion, string fullDmbPath, CancellationToken cancellationToken)
Add a given fullDmbPath to the trusted DMBs list in BYOND's config. A ValueTask representing the run...
const string ServerDir
The OD server directory name.
override async ValueTask< IEngineInstallationData > DownloadVersion(EngineVersion version, JobProgressReporter jobProgressReporter, CancellationToken cancellationToken)
Download a given engine version . A ValueTask<TResult> resulting in the IEngineInstallationData for t...
override IEngineInstallation CreateInstallation(EngineVersion version, string path, Task installationTask)
Creates an IEngineInstallation for a given version . The IEngineInstallation.
override Task CleanCache(CancellationToken cancellationToken)
Attempts to cleans the engine's cache folder for the system. A Task representing the running operatio...
OpenDreamInstaller(IIOManager ioManager, ILogger< OpenDreamInstaller > logger, IPlatformIdentifier platformIdentifier, IProcessExecutor processExecutor, IRepositoryManager repositoryManager, IAsyncDelayer asyncDelayer, IAbstractHttpClientFactory httpClientFactory, IOptions< GeneralConfiguration > generalConfigurationOptions, IOptions< SessionConfiguration > sessionConfigurationOptions)
Initializes a new instance of the OpenDreamInstaller class.
const string InstallationCompilerDirectory
The name of the subdirectory in an installation's BinDir used to store the compiler binaries.
const string InstallationSourceSubDirectory
The name of the subdirectory used for the RepositoryEngineInstallationData's copy.
override ValueTask UpgradeInstallation(EngineVersion version, string path, CancellationToken cancellationToken)
Does actions necessary to get upgrade a version installed by a previous version of TGS....
override ValueTask UpgradeInstallation(EngineVersion version, string path, CancellationToken cancellationToken)
Does actions necessary to get upgrade a version installed by a previous version of TGS....
readonly IAsyncDelayer asyncDelayer
The IAsyncDelayer for the OpenDreamInstaller.
virtual ValueTask HandleExtremelyLongPathOperation(Func< string, ValueTask > shortenedPathOperation, string originalPath, CancellationToken cancellationToken)
Perform an operation on a very long path.
const string BinDir
The bin directory name.
bool LowPriorityDeploymentProcesses
If the deployment DreamMaker and DreamDaemon instances are set to be below normal priority processes.
An IIOManager that resolve relative paths from another IIOManager to a subdirectory of that.
Operation exceptions thrown from the context of a Models.Job.
Progress reporter for a Job.
JobProgressReporter CreateSection(string? newStageName, double percentage)
Create a subsection of the JobProgressReporter with its optional own stage name.
Progress reporter for a Job.
JobProgressReporter CreateSection(string? newStageName, double percentage)
Create a subsection of the JobProgressReporter with its optional own stage name.
Helper methods for working with the dotnet executable.
static async ValueTask< string?> GetDotnetPath(IPlatformIdentifier platformIdentifier, IIOManager ioManager, CancellationToken cancellationToken)
Locate a dotnet executable to use.
async ValueTask< IProcess > LaunchProcess(string fileName, string workingDirectory, string arguments, CancellationToken cancellationToken, IReadOnlyDictionary< string, string >? environment, string? fileRedirect, bool readStandardHandles, bool noShellExecute)
Launch a IProcess. A ValueTask<TResult> resulting in the new IProcess.
Represents a BYOND installation.
Represents an on-disk git repository.
Task< bool > CommittishIsParent(string committish, CancellationToken cancellationToken)
Check if a given committish is a parent of the current Head.
ValueTask CheckoutObject(string committish, string? username, string? password, bool updateSubmodules, bool moveCurrentReference, JobProgressReporter progressReporter, CancellationToken cancellationToken)
Checks out a given committish .
ValueTask FetchOrigin(JobProgressReporter progressReporter, string? username, string? password, bool deploymentPipeline, CancellationToken cancellationToken)
Fetch commits from the origin repository.
Factory for creating and loading IRepositorys.
ValueTask< IRepository?> CloneRepository(Uri url, string? initialBranch, string? username, string? password, JobProgressReporter? progressReporter, bool recurseSubmodules, CancellationToken cancellationToken)
Clone the repository at url .
ValueTask< IRepository?> CloneRepository(Uri url, string? initialBranch, string? username, string? password, JobProgressReporter progressReporter, bool recurseSubmodules, CancellationToken cancellationToken)
Clone the repository at url .
ValueTask< IRepository?> LoadRepository(CancellationToken cancellationToken)
Attempt to load the IRepository from the default location.
Interface for using filesystems.
Task< IReadOnlyList< string > > GetFiles(string path, CancellationToken cancellationToken)
Returns full file names in a given path .
41 readonly global::System.Diagnostics.Process
handle;
-
-
-
-
-
-
-
-
-
-
-
- 75 global::System.Diagnostics.Process
handle,
- 76 CancellationTokenSource? readerCts,
-
-
-
-
- 81 this.handle =
handle ??
throw new ArgumentNullException(nameof(
handle));
-
-
-
-
-
-
-
-
-
-
-
- 93 this.logger =
logger ??
throw new ArgumentNullException(nameof(
logger));
-
-
+
+
+
+
+
+
+ 32 return handle.VirtualMemorySize64;
+
+
+
+ 36 logger.LogWarning(ex,
"Failed to get PID {pid}'s memory usage!",
Id);
+
+
+
+
+
+
+
+
+
+ 55 readonly global::System.Diagnostics.Process
handle;
+
+
+
+
+
+
+
+
+
+
+
+ 89 global::System.Diagnostics.Process
handle,
+ 90 CancellationTokenSource? readerCts,
+
+
+
+
+ 95 this.handle =
handle ??
throw new ArgumentNullException(nameof(
handle));
-
-
-
-
-
+
+
+
+
+
- 103 Startup = Task.Factory.StartNew(
-
-
-
-
- 108 handle.WaitForInputIdle();
-
-
-
- 112 logger.LogTrace(ex,
"WaitForInputIdle() failed, this is normal.");
-
-
- 115 CancellationToken.None,
-
- 117 TaskScheduler.Current);
-
- 119 logger.LogTrace(
"Created process ID: {pid}",
Id);
-
-
-
-
- 125 if (Interlocked.Exchange(ref
disposed, 1) != 0)
-
-
- 128 logger.LogTrace(
"Disposing PID {pid}...",
Id);
-
-
-
-
-
-
+
+
+
+
+ 107 this.logger =
logger ??
throw new ArgumentNullException(nameof(
logger));
+
+
+
+
+
+
+
+
+
+ 117 Startup = Task.Factory.StartNew(
+
+
+
+
+ 122 handle.WaitForInputIdle();
+
+
+
+ 126 logger.LogTrace(ex,
"WaitForInputIdle() failed, this is normal.");
+
+
+ 129 CancellationToken.None,
+
+ 131 TaskScheduler.Current);
+
+ 133 logger.LogTrace(
"Created process ID: {pid}",
Id);
+
-
-
-
-
-
-
-
- 144 throw new InvalidOperationException(
"Output/Error stream reading was not enabled!");
-
- 146 return readTask.WaitAsync(cancellationToken);
-
-
-
-
-
-
-
- 155 logger.LogTrace(
"PID {pid} already exited",
Id);
-
-
-
-
-
- 161 logger.LogTrace(
"Terminating PID {pid}...",
Id);
-
- 163 if (!
handle.WaitForExit(5000))
- 164 logger.LogWarning(
"WaitForExit() on PID {pid} timed out!",
Id);
-
-
-
- 168 logger.LogDebug(e,
"PID {pid} termination exception!",
Id);
-
-
-
-
-
-
- 176 var targetPriority = higher ? ProcessPriorityClass.AboveNormal : ProcessPriorityClass.BelowNormal;
-
-
- 179 handle.PriorityClass = targetPriority;
- 180 logger.LogTrace(
"Set PID {pid} to {targetPriority} priority",
Id, targetPriority);
-
-
-
- 184 logger.LogWarning(ex,
"Unable to set priority for PID {id} to {targetPriority}!",
Id, targetPriority);
-
-
-
-
-
-
-
-
-
- 195 logger.LogTrace(
"Suspended PID {pid}",
Id);
-
-
-
- 199 logger.LogError(e,
"Failed to suspend PID {pid}!",
Id);
-
-
-
-
-
-
-
-
-
-
- 211 logger.LogTrace(
"Resumed PID {pid}",
Id);
-
-
-
- 215 logger.LogError(e,
"Failed to resume PID {pid}!",
Id);
-
-
-
-
-
-
-
-
- 225 logger.LogTrace(
"PID {pid} Username: {username}",
Id, result);
-
-
-
- 230 public ValueTask
CreateDump(
string outputFile,
bool minidump, CancellationToken cancellationToken)
-
- 232 ArgumentNullException.ThrowIfNull(outputFile);
-
-
- 235 logger.LogTrace(
"Dumping PID {pid} to {dumpFilePath}...",
Id, outputFile);
-
-
-
-
-
-
-
-
-
-
-
- 251 catch (OperationCanceledException ex)
-
- 253 logger.LogTrace(ex,
"Process lifetime task cancelled!");
- 254 hasExited =
handle.HasExited;
-
-
-
-
-
- 260 var exitCode =
handle.ExitCode;
- 261 logger.LogTrace(
"PID {pid} exited with code {exitCode}",
Id, exitCode);
-
-
-
-
-
-
+
+
+ 139 if (Interlocked.Exchange(ref
disposed, 1) != 0)
+
+
+ 142 logger.LogTrace(
"Disposing PID {pid}...",
Id);
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ 158 throw new InvalidOperationException(
"Output/Error stream reading was not enabled!");
+
+ 160 return readTask.WaitAsync(cancellationToken);
+
+
+
+
+
+
+
+ 169 logger.LogTrace(
"PID {pid} already exited",
Id);
+
+
+
+
+
+ 175 logger.LogTrace(
"Terminating PID {pid}...",
Id);
+
+ 177 if (!
handle.WaitForExit(5000))
+ 178 logger.LogWarning(
"WaitForExit() on PID {pid} timed out!",
Id);
+
+
+
+ 182 logger.LogDebug(e,
"PID {pid} termination exception!",
Id);
+
+
+
+
+
+
+ 190 var targetPriority = higher ? ProcessPriorityClass.AboveNormal : ProcessPriorityClass.BelowNormal;
+
+
+ 193 handle.PriorityClass = targetPriority;
+ 194 logger.LogTrace(
"Set PID {pid} to {targetPriority} priority",
Id, targetPriority);
+
+
+
+ 198 logger.LogWarning(ex,
"Unable to set priority for PID {id} to {targetPriority}!",
Id, targetPriority);
+
+
+
+
+
+
+
+
+
+ 209 logger.LogTrace(
"Suspended PID {pid}",
Id);
+
+
+
+ 213 logger.LogError(e,
"Failed to suspend PID {pid}!",
Id);
+
+
+
+
+
+
+
+
+
+
+ 225 logger.LogTrace(
"Resumed PID {pid}",
Id);
+
+
+
+ 229 logger.LogError(e,
"Failed to resume PID {pid}!",
Id);
+
+
+
+
+
+
+
+
+ 239 logger.LogTrace(
"PID {pid} Username: {username}",
Id, result);
+
+
+
+ 244 public ValueTask
CreateDump(
string outputFile,
bool minidump, CancellationToken cancellationToken)
+
+ 246 ArgumentNullException.ThrowIfNull(outputFile);
+
+
+ 249 logger.LogTrace(
"Dumping PID {pid} to {dumpFilePath}...",
Id, outputFile);
+
+
+
+
+
+
+
+
+
+
+
+ 265 catch (OperationCanceledException ex)
+
+ 267 logger.LogTrace(ex,
"Process lifetime task cancelled!");
+ 268 hasExited =
handle.HasExited;
+
+
+
+
+
+ 274 var exitCode =
handle.ExitCode;
+ 275 logger.LogTrace(
"PID {pid} exited with code {exitCode}",
Id, exitCode);
+
+
+
+
+
+
IIOManager that resolves paths to Environment.CurrentDirectory.
const TaskCreationOptions BlockingTaskCreationOptions
The TaskCreationOptions used to spawn Tasks for potentially long running, blocking operations.
Process(IProcessFeatures processFeatures, global::System.Diagnostics.Process handle, CancellationTokenSource? readerCts, Task< string?>? readTask, ILogger< Process > logger, bool preExisting)
Initializes a new instance of the Process class.
Process(IProcessFeatures processFeatures, global::System.Diagnostics.Process handle, CancellationTokenSource? readerCts, Task< string?>? readTask, ILogger< Process > logger, bool preExisting)
Initializes a new instance of the Process class.
void CheckDisposed()
Throws an ObjectDisposedException if a method of the Process was called after DisposeAsync.
async ValueTask DisposeAsync()
async ValueTask DisposeAsync()
readonly global::System.Diagnostics.Process handle
The global::System.Diagnostics.Process object.
readonly global::System.Diagnostics.Process handle
The global::System.Diagnostics.Process object.
Task< int?> Lifetime
The Task<TResult> resulting in the exit code of the process or null if the process was detached.
Task< string?> GetCombinedOutput(CancellationToken cancellationToken)
Get the stderr and stdout output of the IProcess. A Task<TResult> resulting in the stderr and stdout ...
void AdjustPriority(bool higher)
Set's the owned global::System.Diagnostics.Process.PriorityClass to a non-normal value.
ValueTask CreateDump(string outputFile, bool minidump, CancellationToken cancellationToken)
Create a dump file of the process. A ValueTask representing the running operation.
volatile int disposed
If the Process was disposed.
void Terminate()
Asycnhronously terminates the process. To ensure the IProcess has ended, use the IProcessBase....
readonly ILogger< Process > logger
The ILogger for the Process.
void SuspendProcess()
Suspends the process.
readonly CancellationTokenSource cancellationTokenSource
The CancellationTokenSource used to shutdown the readTask and Lifetime.
string GetExecutingUsername()
Get the name of the account executing the IProcess. The name of the account executing the IProcess.
void ResumeProcess()
Resumes the process.
long MemoryUsage
Gets the process' memory usage in bytes.
readonly SafeProcessHandle safeHandle
The global::System.Diagnostics.Process.SafeHandle.
readonly IProcessFeatures processFeatures
The IProcessFeatures for the Process.
Task< string?> GetCombinedOutput(CancellationToken cancellationToken)
Get the stderr and stdout output of the IProcess. A Task<TResult> resulting in the stderr and stdout ...
void AdjustPriority(bool higher)
Set's the owned global::System.Diagnostics.Process.PriorityClass to a non-normal value.
ValueTask CreateDump(string outputFile, bool minidump, CancellationToken cancellationToken)
Create a dump file of the process. A ValueTask representing the running operation.
volatile int disposed
If the Process was disposed.
void Terminate()
Asycnhronously terminates the process. To ensure the IProcess has ended, use the IProcessBase....
readonly ILogger< Process > logger
The ILogger for the Process.
void SuspendProcess()
Suspends the process.
readonly CancellationTokenSource cancellationTokenSource
The CancellationTokenSource used to shutdown the readTask and Lifetime.
string GetExecutingUsername()
Get the name of the account executing the IProcess. The name of the account executing the IProcess.
void ResumeProcess()
Resumes the process.
readonly SafeProcessHandle safeHandle
The global::System.Diagnostics.Process.SafeHandle.
readonly IProcessFeatures processFeatures
The IProcessFeatures for the Process.
Task Startup
The Task representing the time until the IProcess becomes "idle".
readonly? Task< string?> readTask
The Task<TResult> resulting in the process' standard output/error text.
async Task< int?> WrapLifetimeTask()
Attaches a log message to the process' exit event.
long? MemoryUsage
Gets the process' memory usage in bytes.
readonly? Task< string?> readTask
The Task<TResult> resulting in the process' standard output/error text.
async Task< int?> WrapLifetimeTask()
Attaches a log message to the process' exit event.
Abstraction for suspending and resuming processes.
string GetExecutingUsername(global::System.Diagnostics.Process process)
Get the name of the user executing a given process .
ValueTask CreateDump(global::System.Diagnostics.Process process, string outputFile, bool minidump, CancellationToken cancellationToken)
Create a dump file for a given process .
232 logger.LogTrace(
"Fetching refspec {refSpec}...", refSpec);
234 var remote =
libGitRepo.Network.Remotes.First();
-
-
-
-
- 239 new FetchOptions().Hydrate(
-
- 241 progressReporter.
CreateSection($
"Fetch {refSpec}", progressFactor),
-
-
-
-
- 246 catch (UserCancelledException ex)
-
- 248 logger.LogTrace(ex,
"Suppressing fetch cancel exception");
-
- 250 catch (LibGit2SharpException ex)
-
-
-
-
- 255 cancellationToken.ThrowIfCancellationRequested();
-
-
-
- 259 cancellationToken.ThrowIfCancellationRequested();
-
- 261 var objectName = testMergeParameters.TargetCommitSha ?? localBranchName;
- 262 var gitObject =
libGitRepo.Lookup(objectName) ??
throw new JobException($
"Could not find object to merge: {objectName}");
-
- 264 testMergeParameters.TargetCommitSha = gitObject.Sha;
-
- 266 cancellationToken.ThrowIfCancellationRequested();
-
-
-
-
-
- 272 CommitOnSuccess = commitMessage == null,
- 273 FailOnConflict = false,
- 274 FastForwardStrategy = FastForwardStrategy.NoFastForward,
-
- 276 OnCheckoutProgress = CheckoutProgressHandler(
- 277 progressReporter.CreateSection($
"Merge {testMergeParameters.TargetCommitSha[..7]}", progressFactor)),
-
-
-
-
-
-
-
- 285 cancellationToken.ThrowIfCancellationRequested();
-
- 287 if (result.Status == MergeStatus.Conflicts)
-
- 289 var repoStatus = libGitRepo.RetrieveStatus();
- 290 conflictedPaths = new List<string>();
- 291 foreach (var file in repoStatus)
- 292 if (file.State == FileStatus.Conflicted)
- 293 conflictedPaths.Add(file.FilePath);
-
- 295 var revertTo = originalCommit.CanonicalName ?? originalCommit.Tip.Sha;
- 296 logger.LogDebug(
"Merge conflict, aborting and reverting to {revertTarget}", revertTo);
- 297 progressReporter.ReportProgress(0);
- 298 RawCheckout(revertTo, false, progressReporter.CreateSection(
"Hard Reset to {revertTo}", 1.0), cancellationToken);
- 299 cancellationToken.ThrowIfCancellationRequested();
-
-
-
-
-
-
- 306 TaskScheduler.Current);
-
- 308 if (result!.Status == MergeStatus.Conflicts)
-
- 310 var arguments =
new List<string>
-
- 312 originalCommit.Tip.Sha,
-
-
-
-
-
- 318 arguments.AddRange(conflictedPaths!);
+ 235 using var fetchReporter = progressReporter.
CreateSection($
"Fetch {refSpec}", progressFactor);
+
+
+
+
+ 240 new FetchOptions().Hydrate(
+
+
+
+
+
+
+ 247 catch (UserCancelledException ex)
+
+ 249 logger.LogTrace(ex,
"Suppressing fetch cancel exception");
+
+ 251 catch (LibGit2SharpException ex)
+
+
+
+
+ 256 cancellationToken.ThrowIfCancellationRequested();
+
+
+
+ 260 cancellationToken.ThrowIfCancellationRequested();
+
+ 262 var objectName = testMergeParameters.TargetCommitSha ?? localBranchName;
+ 263 var gitObject =
libGitRepo.Lookup(objectName) ??
throw new JobException($
"Could not find object to merge: {objectName}");
+
+ 265 testMergeParameters.TargetCommitSha = gitObject.Sha;
+
+ 267 cancellationToken.ThrowIfCancellationRequested();
+
+
+
+ 271 using var mergeReporter = progressReporter.
CreateSection($
"Merge {testMergeParameters.TargetCommitSha[..7]}", progressFactor);
+
+
+ 274 CommitOnSuccess = commitMessage == null,
+ 275 FailOnConflict = false,
+ 276 FastForwardStrategy = FastForwardStrategy.NoFastForward,
+
+ 278 OnCheckoutProgress = CheckoutProgressHandler(mergeReporter),
+
+
+
+
+
+
+
+ 286 cancellationToken.ThrowIfCancellationRequested();
+
+ 288 if (result.Status == MergeStatus.Conflicts)
+
+ 290 var repoStatus = libGitRepo.RetrieveStatus();
+ 291 conflictedPaths = new List<string>();
+ 292 foreach (var file in repoStatus)
+ 293 if (file.State == FileStatus.Conflicted)
+ 294 conflictedPaths.Add(file.FilePath);
+
+ 296 var revertTo = originalCommit.CanonicalName ?? originalCommit.Tip.Sha;
+ 297 logger.LogDebug(
"Merge conflict, aborting and reverting to {revertTarget}", revertTo);
+ 298 progressReporter.ReportProgress(0);
+ 299 using var revertReporter = progressReporter.CreateSection(
"Hard Reset to {revertTo}", 1.0);
+ 300 RawCheckout(revertTo, false, revertReporter, cancellationToken);
+ 301 cancellationToken.ThrowIfCancellationRequested();
+
+
+
+
+
+
+ 308 TaskScheduler.Current);
+
+ 310 if (result!.Status == MergeStatus.Conflicts)
+
+ 312 var arguments =
new List<string>
+
+ 314 originalCommit.Tip.Sha,
+
+
+
+
-
-
-
-
-
-
-
-
- 328 ConflictingFiles = conflictedPaths,
-
-
-
- 332 if (result.Status != MergeStatus.UpToDate)
-
- 334 logger.LogTrace(
"Committing merge: \"{commitMessage}\"...", commitMessage);
- 335 await Task.Factory.StartNew(
- 336 () =>
libGitRepo.Commit(commitMessage, sig, sig,
new CommitOptions
-
- 338 PrettifyMessage = true,
-
-
-
- 342 TaskScheduler.Current);
-
- 344 if (updateSubmodules)
-
-
- 347 progressReporter.
CreateSection(
"Update Submodules", progressFactor),
-
-
-
-
-
-
-
-
-
-
-
- 359 testMergeParameters.Number.ToString(CultureInfo.InvariantCulture),
- 360 testMergeParameters.TargetCommitSha!,
- 361 testMergeParameters.Comment,
-
-
-
-
-
-
-
-
-
- 371#pragma warning restore CA1506
-
-
-
-
-
- 378 bool updateSubmodules,
- 379 bool moveCurrentReference,
-
- 381 CancellationToken cancellationToken)
-
- 383 ArgumentNullException.ThrowIfNull(committish);
-
- 385 logger.LogDebug(
"Checkout object: {committish}...", committish);
-
- 387 await Task.Factory.StartNew(
-
-
-
-
-
- 393 moveCurrentReference,
- 394 progressReporter?.CreateSection(
null, updateSubmodules ? 2.0 / 3 : 1.0),
-
-
-
-
- 399 TaskScheduler.Current);
-
- 401 if (updateSubmodules)
-
- 403 progressReporter?.CreateSection(
null, 1.0 / 3),
-
-
-
-
-
-
-
-
-
-
- 415 bool deploymentPipeline,
- 416 CancellationToken cancellationToken)
-
- 418 logger.LogDebug(
"Fetch origin...");
-
- 420 await Task.Factory.StartNew(
-
-
- 423 var remote =
libGitRepo.Network.Remotes.First();
-
-
- 426 var fetchOptions =
new FetchOptions
-
-
- 429 TagFetchMode = TagFetchMode.All,
-
-
- 432 progressReporter?.CreateSection(
"Fetch Origin", 1.0),
-
-
-
-
-
-
-
- 440 .Select(x => x.Specification),
-
-
- 443 "Fetch origin commits");
-
- 445 catch (UserCancelledException)
-
- 447 cancellationToken.ThrowIfCancellationRequested();
-
- 449 catch (LibGit2SharpException ex)
-
-
+ 320 arguments.AddRange(conflictedPaths!);
+
+
+
+
+
+
+
+
+
+ 330 ConflictingFiles = conflictedPaths,
+
+
+
+ 334 if (result.Status != MergeStatus.UpToDate)
+
+ 336 logger.LogTrace(
"Committing merge: \"{commitMessage}\"...", commitMessage);
+ 337 await Task.Factory.StartNew(
+ 338 () =>
libGitRepo.Commit(commitMessage, sig, sig,
new CommitOptions
+
+ 340 PrettifyMessage = true,
+
+
+
+ 344 TaskScheduler.Current);
+
+ 346 if (updateSubmodules)
+
+ 348 using var progressReporter2 = progressReporter.
CreateSection(
"Update Submodules", progressFactor);
+
+
+
+
+
+
+
+
+
+
+
+
+
+ 362 testMergeParameters.Number.ToString(CultureInfo.InvariantCulture),
+ 363 testMergeParameters.TargetCommitSha!,
+ 364 testMergeParameters.Comment,
+
+
+
+
+
+
+
+
+
+ 374#pragma warning restore CA1506
+
+
+
+
+
+ 381 bool updateSubmodules,
+ 382 bool moveCurrentReference,
+
+ 384 CancellationToken cancellationToken)
+
+ 386 ArgumentNullException.ThrowIfNull(committish);
+
+ 388 logger.LogDebug(
"Checkout object: {committish}...", committish);
+
+ 390 await Task.Factory.StartNew(
+
+
+
+ 394 using var progressReporter3 = progressReporter.
CreateSection(
null, updateSubmodules ? 2.0 / 3 : 1.0);
+
+
+ 397 moveCurrentReference,
+
+
+
+
+
+ 403 TaskScheduler.Current);
+
+ 405 if (updateSubmodules)
+
+ 407 using var progressReporter2 = progressReporter.
CreateSection(
null, 1.0 / 3);
+
+
+
+
+
+
+
+
+
+
+
+
+
+ 422 bool deploymentPipeline,
+ 423 CancellationToken cancellationToken)
+
+ 425 logger.LogDebug(
"Fetch origin...");
+
+ 427 await Task.Factory.StartNew(
+
+
+ 430 var remote =
libGitRepo.Network.Remotes.First();
+
+
+ 433 using var subReporter = progressReporter.
CreateSection(
"Fetch Origin", 1.0);
+ 434 var fetchOptions =
new FetchOptions
+
+
+ 437 TagFetchMode = TagFetchMode.All,
+
+
+
+
+
+
+
+
+
+
+ 448 .Select(x => x.Specification),
+
+
+ 451 "Fetch origin commits");
-
-
-
- 456 TaskScheduler.Current);
-
-
-
-
-
-
- 464 bool updateSubmodules,
- 465 bool deploymentPipeline,
- 466 CancellationToken cancellationToken)
-
- 468 ArgumentNullException.ThrowIfNull(progressReporter);
-
-
- 471 logger.LogTrace(
"Reset to origin...");
-
- 473 await
eventConsumer.
HandleEvent(
EventType.RepoResetOrigin,
new List<string> { trackedBranch.FriendlyName, trackedBranch.Tip.Sha }, deploymentPipeline, cancellationToken);
-
- 475 trackedBranch.Tip.Sha,
- 476 progressReporter.
CreateSection(
null, updateSubmodules ? 2.0 / 3 : 1.0),
-
-
- 479 if (updateSubmodules)
-
-
-
-
-
-
-
-
-
-
-
- 492 ArgumentNullException.ThrowIfNull(sha);
- 493 ArgumentNullException.ThrowIfNull(progressReporter);
-
- 495 logger.LogDebug(
"Reset to sha: {sha}", sha[..7]);
-
-
- 498 cancellationToken.ThrowIfCancellationRequested();
-
- 500 var gitObject =
libGitRepo.Lookup(sha, ObjectType.Commit);
- 501 cancellationToken.ThrowIfCancellationRequested();
-
- 503 if (gitObject ==
null)
- 504 throw new InvalidOperationException(String.Format(CultureInfo.InvariantCulture,
"Cannot reset to non-existent SHA: {0}", sha));
-
- 506 libGitRepo.Reset(ResetMode.Hard, gitObject.Peel<Commit>(),
new CheckoutOptions
-
- 508 OnCheckoutProgress = CheckoutProgressHandler(progressReporter.CreateSection($
"Reset to {gitObject.Sha}", 1.0)),
-
-
-
-
- 513 TaskScheduler.Current);
-
- 516 public async ValueTask
CopyTo(
string path, CancellationToken cancellationToken)
-
- 518 ArgumentNullException.ThrowIfNull(path);
- 519 logger.LogTrace(
"Copying to {path}...", path);
-
- 521 new List<string> {
".git" },
-
-
-
-
-
- 527 return ValueTask.CompletedTask;
-
-
-
-
-
-
-
- 536 public Task<string>
GetOriginSha(CancellationToken cancellationToken) => Task.Factory.StartNew(
-
-
-
-
-
- 542 cancellationToken.ThrowIfCancellationRequested();
-
-
-
-
-
- 548 TaskScheduler.Current);
-
-
-
- 553 string committerName,
- 554 string committerEmail,
- 555 bool deploymentPipeline,
- 556 CancellationToken cancellationToken)
-
- 558 ArgumentNullException.ThrowIfNull(progressReporter);
-
- 560 MergeResult? result =
null;
- 561 Branch? trackedBranch =
null;
+ 453 catch (UserCancelledException)
+
+ 455 cancellationToken.ThrowIfCancellationRequested();
+
+ 457 catch (LibGit2SharpException ex)
+
+
+
+
+
+
+ 464 TaskScheduler.Current);
+
+
+
+
+
+
+ 472 bool updateSubmodules,
+ 473 bool deploymentPipeline,
+ 474 CancellationToken cancellationToken)
+
+ 476 ArgumentNullException.ThrowIfNull(progressReporter);
+
+
+ 479 logger.LogTrace(
"Reset to origin...");
+
+ 481 await
eventConsumer.
HandleEvent(
EventType.RepoResetOrigin,
new List<string> { trackedBranch.FriendlyName, trackedBranch.Tip.Sha }, deploymentPipeline, cancellationToken);
+
+ 483 using (var progressReporter2 = progressReporter.
CreateSection(
null, updateSubmodules ? 2.0 / 3 : 1.0))
+
+ 485 trackedBranch.Tip.Sha,
+
+
+
+ 489 if (updateSubmodules)
+
+ 491 using var progressReporter3 = progressReporter.
CreateSection(
null, 1.0 / 3);
+
+
+
+
+
+
+
+
+
+
+
+
+ 505 ArgumentNullException.ThrowIfNull(sha);
+ 506 ArgumentNullException.ThrowIfNull(progressReporter);
+
+ 508 logger.LogDebug(
"Reset to sha: {sha}", sha[..7]);
+
+
+ 511 cancellationToken.ThrowIfCancellationRequested();
+
+ 513 var gitObject =
libGitRepo.Lookup(sha, ObjectType.Commit);
+ 514 cancellationToken.ThrowIfCancellationRequested();
+
+ 516 if (gitObject ==
null)
+ 517 throw new InvalidOperationException(String.Format(CultureInfo.InvariantCulture,
"Cannot reset to non-existent SHA: {0}", sha));
+
+ 519 libGitRepo.Reset(ResetMode.Hard, gitObject.Peel<Commit>(),
new CheckoutOptions
+
+ 521 OnCheckoutProgress = CheckoutProgressHandler(progressReporter.CreateSection($
"Reset to {gitObject.Sha}", 1.0)),
+
+
+
+
+ 526 TaskScheduler.Current);
+
+ 529 public async ValueTask
CopyTo(
string path, CancellationToken cancellationToken)
+
+ 531 ArgumentNullException.ThrowIfNull(path);
+ 532 logger.LogTrace(
"Copying to {path}...", path);
+
+ 534 new List<string> {
".git" },
+
+
+
+
+
+ 540 return ValueTask.CompletedTask;
+
+
+
+
+
+
+
+ 549 public Task<string>
GetOriginSha(CancellationToken cancellationToken) => Task.Factory.StartNew(
+
+
+
+
+
+ 555 cancellationToken.ThrowIfCancellationRequested();
+
+
+
+
+
+ 561 TaskScheduler.Current);
-
- 564 var oldTip = oldHead.Tip;
-
- 566 await Task.Factory.StartNew(
-
-
-
-
-
-
-
- 574 cancellationToken.ThrowIfCancellationRequested();
+
+
+ 566 string committerName,
+ 567 string committerEmail,
+ 568 bool deploymentPipeline,
+ 569 CancellationToken cancellationToken)
+
+ 571 ArgumentNullException.ThrowIfNull(progressReporter);
+
+ 573 MergeResult? result =
null;
+ 574 Branch? trackedBranch =
null;
-
-
- 578 "Merge origin/{trackedBranch}: <{committerName} ({committerEmail})>",
- 579 trackedBranch.FriendlyName,
-
-
- 582 result =
libGitRepo.Merge(trackedBranch,
new Signature(committerName, committerEmail, DateTimeOffset.UtcNow),
new MergeOptions
-
- 584 CommitOnSuccess = true,
- 585 FailOnConflict = true,
- 586 FastForwardStrategy = FastForwardStrategy.Default,
-
- 588 OnCheckoutProgress = CheckoutProgressHandler(progressReporter.CreateSection(
"Merge Origin", 1.0)),
-
-
- 591 cancellationToken.ThrowIfCancellationRequested();
-
- 593 if (result.Status == MergeStatus.Conflicts)
-
- 595 logger.LogDebug(
"Merge conflict, aborting and reverting to {oldHeadFriendlyName}", oldHead.FriendlyName);
- 596 progressReporter.ReportProgress(0);
- 597 libGitRepo.Reset(ResetMode.Hard, oldTip, new CheckoutOptions
-
- 599 OnCheckoutProgress = CheckoutProgressHandler(progressReporter.CreateSection($
"Hard Reset to {oldHead.FriendlyName}", 1.0)),
-
- 601 cancellationToken.ThrowIfCancellationRequested();
-
+
+ 577 var oldTip = oldHead.Tip;
+
+ 579 await Task.Factory.StartNew(
+
+
+
+
+
+
+
+ 587 cancellationToken.ThrowIfCancellationRequested();
+
+
+
+ 591 "Merge origin/{trackedBranch}: <{committerName} ({committerEmail})>",
+ 592 trackedBranch.FriendlyName,
+
+
+ 595 result =
libGitRepo.Merge(trackedBranch,
new Signature(committerName, committerEmail, DateTimeOffset.UtcNow),
new MergeOptions
+
+ 597 CommitOnSuccess = true,
+ 598 FailOnConflict = true,
+ 599 FastForwardStrategy = FastForwardStrategy.Default,
+
+ 601 OnCheckoutProgress = CheckoutProgressHandler(progressReporter.CreateSection(
"Merge Origin", 1.0)),
+
-
-
-
-
- 608 TaskScheduler.Current);
-
- 610 if (result!.Status == MergeStatus.Conflicts)
-
-
-
-
-
-
- 617 trackedBranch!.Tip.Sha,
-
- 619 trackedBranch.FriendlyName,
-
-
-
-
-
-
- 626 return result.Status == MergeStatus.FastForward;
-
-
-
-
-
-
- 634 string committerName,
- 635 string committerEmail,
- 636 bool synchronizeTrackedBranch,
- 637 bool deploymentPipeline,
- 638 CancellationToken cancellationToken)
-
- 640 ArgumentNullException.ThrowIfNull(committerName);
- 641 ArgumentNullException.ThrowIfNull(committerEmail);
- 642 ArgumentNullException.ThrowIfNull(progressReporter);
-
- 644 if (username ==
null && password ==
null)
-
- 646 logger.LogTrace(
"Not synchronizing due to lack of credentials!");
-
-
-
- 650 logger.LogTrace(
"Begin Synchronize...");
-
- 652 ArgumentNullException.ThrowIfNull(username);
- 653 ArgumentNullException.ThrowIfNull(password);
-
- 655 var startHead = Head;
+ 604 cancellationToken.ThrowIfCancellationRequested();
+
+ 606 if (result.Status == MergeStatus.Conflicts)
+
+ 608 logger.LogDebug(
"Merge conflict, aborting and reverting to {oldHeadFriendlyName}", oldHead.FriendlyName);
+ 609 progressReporter.ReportProgress(0);
+ 610 libGitRepo.Reset(ResetMode.Hard, oldTip, new CheckoutOptions
+
+ 612 OnCheckoutProgress = CheckoutProgressHandler(progressReporter.CreateSection($
"Hard Reset to {oldHead.FriendlyName}", 1.0)),
+
+ 614 cancellationToken.ThrowIfCancellationRequested();
+
+
+
+
+
+
+ 621 TaskScheduler.Current);
+
+ 623 if (result!.Status == MergeStatus.Conflicts)
+
+
+
+
+
+
+ 630 trackedBranch!.Tip.Sha,
+
+ 632 trackedBranch.FriendlyName,
+
+
+
+
+
+
+ 639 return result.Status == MergeStatus.FastForward;
+
+
+
+
+
+
+ 647 string committerName,
+ 648 string committerEmail,
+ 649 bool synchronizeTrackedBranch,
+ 650 bool deploymentPipeline,
+ 651 CancellationToken cancellationToken)
+
+ 653 ArgumentNullException.ThrowIfNull(committerName);
+ 654 ArgumentNullException.ThrowIfNull(committerEmail);
+ 655 ArgumentNullException.ThrowIfNull(progressReporter);
- 657 logger.LogTrace(
"Configuring <{committerName} ({committerEmail})> as author/committer", committerName, committerEmail);
- 658 await Task.Factory.StartNew(
-
-
- 661 libGitRepo.Config.Set(
"user.name", committerName);
- 662 cancellationToken.ThrowIfCancellationRequested();
- 663 libGitRepo.Config.Set(
"user.email", committerEmail);
-
-
-
- 667 TaskScheduler.Current);
-
- 669 cancellationToken.ThrowIfCancellationRequested();
-
-
- 672 await eventConsumer.HandleEvent(
-
-
-
- 676 ioManager.ResolvePath(),
-
-
-
-
-
-
- 683 logger.LogTrace(
"Resetting and cleaning untracked files...");
- 684 await Task.Factory.StartNew(
-
-
- 687 libGitRepo.Reset(ResetMode.Hard, libGitRepo.Head.Tip,
new CheckoutOptions
-
- 689 OnCheckoutProgress = CheckoutProgressHandler(progressReporter.CreateSection(
"Hard reset and remove untracked files", 0.1)),
-
- 691 cancellationToken.ThrowIfCancellationRequested();
- 692 libGitRepo.RemoveUntrackedFiles();
-
-
-
- 696 TaskScheduler.Current);
-
-
- 699 var remainingProgressFactor = 0.9;
- 700 if (!synchronizeTrackedBranch)
-
- 702 await PushHeadToTemporaryBranch(
-
-
- 705 progressReporter.
CreateSection(
"Push to temporary branch", remainingProgressFactor),
-
-
-
-
- 710 var sameHead = Head == startHead;
- 711 if (sameHead || !Tracking)
-
- 713 logger.LogTrace(
"Aborted synchronize due to {abortReason}!", sameHead ?
"lack of changes" :
"not being on tracked reference");
-
-
-
- 717 logger.LogInformation(
"Synchronizing with origin...");
-
- 719 return await Task.Factory.StartNew(
-
-
- 722 var remote = libGitRepo.Network.Remotes.First();
-
-
- 725 libGitRepo.Network.Push(
-
-
- 728 progressReporter.
CreateSection(
"Push to origin", remainingProgressFactor),
-
-
-
-
-
- 734 catch (NonFastForwardException)
-
- 736 logger.LogInformation(
"Synchronize aborted, non-fast forward!");
-
-
- 739 catch (UserCancelledException e)
-
- 741 cancellationToken.ThrowIfCancellationRequested();
- 742 throw new InvalidOperationException(
"Caught UserCancelledException without cancellationToken triggering", e);
-
- 744 catch (LibGit2SharpException e)
-
- 746 logger.LogWarning(e,
"Unable to make synchronization push!");
-
-
-
-
-
- 752 TaskScheduler.Current);
-
-
- 756 public Task<bool>
IsSha(
string committish, CancellationToken cancellationToken) => Task.Factory.StartNew(
-
-
-
- 760 var gitObject = libGitRepo.Lookup(committish, ObjectType.Tag);
- 761 if (gitObject !=
null)
-
- 763 cancellationToken.ThrowIfCancellationRequested();
-
-
- 766 if (libGitRepo.Branches[committish] !=
null)
-
- 768 cancellationToken.ThrowIfCancellationRequested();
-
-
- 771 if (libGitRepo.Lookup<Commit>(committish) !=
null)
-
-
-
-
-
- 777 TaskScheduler.Current);
-
- 780 public Task<bool>
CommittishIsParent(
string committish, CancellationToken cancellationToken) => Task.Factory.StartNew(
-
-
- 783 var targetObject = libGitRepo.Lookup(committish);
- 784 if (targetObject ==
null)
-
- 786 logger.LogTrace(
"Committish {committish} not found in repository", committish);
-
-
-
- 790 if (targetObject is not Commit targetCommit)
-
- 792 if (targetObject is not TagAnnotation)
-
- 794 logger.LogTrace(
"Committish {committish} is a {type} and does not point to a commit!", committish, targetObject.GetType().Name);
-
-
-
- 798 targetCommit = targetObject.Peel<Commit>();
- 799 if (targetCommit ==
null)
-
-
- 802 "TagAnnotation {committish} was found but the commit associated with it could not be found in repository!",
-
-
-
-
-
- 808 cancellationToken.ThrowIfCancellationRequested();
-
- 810 logger.LogTrace(
"Testing if {committish} is a parent of {startSha}...", committish, startSha);
- 811 MergeResult mergeResult;
-
-
- 814 mergeResult = libGitRepo.Merge(
-
-
- 817 DefaultCommitterName,
- 818 DefaultCommitterEmail,
- 819 DateTimeOffset.UtcNow),
-
-
- 822 FastForwardStrategy = FastForwardStrategy.FastForwardOnly,
- 823 FailOnConflict = true,
-
-
- 826 catch (NonFastForwardException ex)
-
- 828 logger.LogTrace(ex,
"{committish} is not a parent of {startSha}", committish, startSha);
-
-
-
- 832 if (mergeResult.Status == MergeStatus.UpToDate)
-
-
- 835 logger.LogTrace(
"{committish} is not a parent of {startSha} ({mergeStatus}). Moving back...", committish, startSha, mergeResult.Status);
-
-
-
-
- 840 CheckoutModifiers = CheckoutModifiers.Force,
-
-
-
-
-
-
-
- 848 TaskScheduler.Current);
-
-
-
-
- 854 CancellationToken cancellationToken) => gitRemoteFeatures.GetTestMerge(
-
-
-
-
- 860 public Task<DateTimeOffset>
TimestampCommit(
string sha, CancellationToken cancellationToken) => Task.Factory.StartNew(
-
-
- 863 ArgumentNullException.ThrowIfNull(sha);
-
- 865 var commit = libGitRepo.Lookup<Commit>(sha) ??
throw new JobException($
"Commit {sha} does not exist in the repository!");
- 866 return commit.Committer.When.ToUniversalTime();
-
-
-
- 870 TaskScheduler.Current);
-
-
-
- 875 logger.LogTrace(
"Disposing...");
- 876 libGitRepo.Dispose();
-
-
-
-
-
- 889 logger.LogTrace(
"Checkout: {committish}", committish);
+ 657 if (username ==
null && password ==
null)
+
+ 659 logger.LogTrace(
"Not synchronizing due to lack of credentials!");
+
+
+
+ 663 logger.LogTrace(
"Begin Synchronize...");
+
+ 665 ArgumentNullException.ThrowIfNull(username);
+ 666 ArgumentNullException.ThrowIfNull(password);
+
+ 668 var startHead = Head;
+
+ 670 logger.LogTrace(
"Configuring <{committerName} ({committerEmail})> as author/committer", committerName, committerEmail);
+ 671 await Task.Factory.StartNew(
+
+
+ 674 libGitRepo.Config.Set(
"user.name", committerName);
+ 675 cancellationToken.ThrowIfCancellationRequested();
+ 676 libGitRepo.Config.Set(
"user.email", committerEmail);
+
+
+
+ 680 TaskScheduler.Current);
+
+ 682 cancellationToken.ThrowIfCancellationRequested();
+
+
+ 685 await eventConsumer.HandleEvent(
+
+
+
+ 689 ioManager.ResolvePath(),
+
+
+
+
+
+
+ 696 logger.LogTrace(
"Resetting and cleaning untracked files...");
+ 697 await Task.Factory.StartNew(
+
+
+ 700 using var resetProgress = progressReporter.
CreateSection(
"Hard reset and remove untracked files", 0.1);
+ 701 libGitRepo.Reset(ResetMode.Hard, libGitRepo.Head.Tip,
new CheckoutOptions
+
+ 703 OnCheckoutProgress = CheckoutProgressHandler(resetProgress),
+
+ 705 cancellationToken.ThrowIfCancellationRequested();
+ 706 libGitRepo.RemoveUntrackedFiles();
+
+
+
+ 710 TaskScheduler.Current);
+
+
+ 713 var remainingProgressFactor = 0.9;
+ 714 if (!synchronizeTrackedBranch)
+
+ 716 using var progressReporter2 = progressReporter.
CreateSection(
"Push to temporary branch", remainingProgressFactor);
+ 717 await PushHeadToTemporaryBranch(
+
+
+
+
+
+
+
+ 725 var sameHead = Head == startHead;
+ 726 if (sameHead || !Tracking)
+
+ 728 logger.LogTrace(
"Aborted synchronize due to {abortReason}!", sameHead ?
"lack of changes" :
"not being on tracked reference");
+
+
+
+ 732 logger.LogInformation(
"Synchronizing with origin...");
+
+ 734 return await Task.Factory.StartNew(
+
+
+ 737 var remote = libGitRepo.Network.Remotes.First();
+
+
+ 740 using var pushReporter = progressReporter.
CreateSection(
"Push to origin", remainingProgressFactor);
+ 741 var (pushOptions, progressReporters) = GeneratePushOptions(
+
+
+
+
+
+
+ 748 libGitRepo.Network.Push(
+
+
+
+
+
+ 754 foreach (var progressReporter
in progressReporters)
+ 755 progressReporter.Dispose();
+
+
+
+
+ 760 catch (NonFastForwardException)
+
+ 762 logger.LogInformation(
"Synchronize aborted, non-fast forward!");
+
+
+ 765 catch (UserCancelledException e)
+
+ 767 cancellationToken.ThrowIfCancellationRequested();
+ 768 throw new InvalidOperationException(
"Caught UserCancelledException without cancellationToken triggering", e);
+
+ 770 catch (LibGit2SharpException e)
+
+ 772 logger.LogWarning(e,
"Unable to make synchronization push!");
+
+
+
+
+
+ 778 TaskScheduler.Current);
+
+
+ 782 public Task<bool>
IsSha(
string committish, CancellationToken cancellationToken) => Task.Factory.StartNew(
+
+
+
+ 786 var gitObject = libGitRepo.Lookup(committish, ObjectType.Tag);
+ 787 if (gitObject !=
null)
+
+ 789 cancellationToken.ThrowIfCancellationRequested();
+
+
+ 792 if (libGitRepo.Branches[committish] !=
null)
+
+ 794 cancellationToken.ThrowIfCancellationRequested();
+
+
+ 797 if (libGitRepo.Lookup<Commit>(committish) !=
null)
+
+
+
+
+
+ 803 TaskScheduler.Current);
+
+ 806 public Task<bool>
CommittishIsParent(
string committish, CancellationToken cancellationToken) => Task.Factory.StartNew(
+
+
+ 809 var targetObject = libGitRepo.Lookup(committish);
+ 810 if (targetObject ==
null)
+
+ 812 logger.LogTrace(
"Committish {committish} not found in repository", committish);
+
+
+
+ 816 if (targetObject is not Commit targetCommit)
+
+ 818 if (targetObject is not TagAnnotation)
+
+ 820 logger.LogTrace(
"Committish {committish} is a {type} and does not point to a commit!", committish, targetObject.GetType().Name);
+
+
+
+ 824 targetCommit = targetObject.Peel<Commit>();
+ 825 if (targetCommit ==
null)
+
+
+ 828 "TagAnnotation {committish} was found but the commit associated with it could not be found in repository!",
+
+
+
+
+
+ 834 cancellationToken.ThrowIfCancellationRequested();
+
+ 836 logger.LogTrace(
"Testing if {committish} is a parent of {startSha}...", committish, startSha);
+ 837 MergeResult mergeResult;
+
+
+ 840 mergeResult = libGitRepo.Merge(
+
+
+ 843 DefaultCommitterName,
+ 844 DefaultCommitterEmail,
+ 845 DateTimeOffset.UtcNow),
+
+
+ 848 FastForwardStrategy = FastForwardStrategy.FastForwardOnly,
+ 849 FailOnConflict = true,
+
+
+ 852 catch (NonFastForwardException ex)
+
+ 854 logger.LogTrace(ex,
"{committish} is not a parent of {startSha}", committish, startSha);
+
+
+
+ 858 if (mergeResult.Status == MergeStatus.UpToDate)
+
+
+ 861 logger.LogTrace(
"{committish} is not a parent of {startSha} ({mergeStatus}). Moving back...", committish, startSha, mergeResult.Status);
+
+
+
+
+ 866 CheckoutModifiers = CheckoutModifiers.Force,
+
+
+
+
+
+
+
+ 874 TaskScheduler.Current);
+
+
+
+
+ 880 CancellationToken cancellationToken) => gitRemoteFeatures.GetTestMerge(
+
+
+
+
+ 886 public Task<DateTimeOffset>
TimestampCommit(
string sha, CancellationToken cancellationToken) => Task.Factory.StartNew(
+
+
+ 889 ArgumentNullException.ThrowIfNull(sha);
- 891 var checkoutOptions =
new CheckoutOptions
-
- 893 CheckoutModifiers = CheckoutModifiers.Force,
-
-
- 896 if (progressReporter !=
null)
-
- 898 var stage = $
"Checkout {committish}";
- 899 progressReporter = progressReporter.
CreateSection(stage, 1.0);
-
- 901 checkoutOptions.OnCheckoutProgress = CheckoutProgressHandler(progressReporter);
-
-
- 904 cancellationToken.ThrowIfCancellationRequested();
+ 891 var commit = libGitRepo.Lookup<Commit>(sha) ??
throw new JobException($
"Commit {sha} does not exist in the repository!");
+ 892 return commit.Committer.When.ToUniversalTime();
+
+
+
+ 896 TaskScheduler.Current);
+
+
+
+ 901 logger.LogTrace(
"Disposing...");
+ 902 libGitRepo.Dispose();
+
+
- 906 if (moveCurrentReference)
-
- 908 if (Reference == NoReference)
- 909 throw new InvalidOperationException(
"Cannot move current reference when not on reference!");
-
- 911 var gitObject = libGitRepo.Lookup(committish);
- 912 if (gitObject ==
null)
- 913 throw new JobException($
"Could not find committish: {committish}");
-
- 915 var commit = gitObject.Peel<Commit>();
+
+
+ 915 logger.LogTrace(
"Checkout: {committish}", committish);
- 917 cancellationToken.ThrowIfCancellationRequested();
-
- 919 libGitRepo.Reset(ResetMode.Hard, commit, checkoutOptions);
-
-
-
- 923 void RunCheckout() => commands.Checkout(
-
-
-
-
-
-
-
-
- 932 catch (NotFoundException)
-
-
- 935 var remoteName = $
"origin/{committish}";
- 936 var remoteBranch = libGitRepo.Branches.FirstOrDefault(
- 937 branch => branch.FriendlyName.Equals(remoteName, StringComparison.Ordinal));
- 938 cancellationToken.ThrowIfCancellationRequested();
+ 917 var checkoutOptions =
new CheckoutOptions
+
+ 919 CheckoutModifiers = CheckoutModifiers.Force,
+
+
+ 922 var stage = $
"Checkout {committish}";
+ 923 using var newProgressReporter = progressReporter.
CreateSection(stage, 1.0);
+
+ 925 checkoutOptions.OnCheckoutProgress = CheckoutProgressHandler(newProgressReporter);
+
+ 927 cancellationToken.ThrowIfCancellationRequested();
+
+ 929 if (moveCurrentReference)
+
+ 931 if (Reference == NoReference)
+ 932 throw new InvalidOperationException(
"Cannot move current reference when not on reference!");
+
+ 934 var gitObject = libGitRepo.Lookup(committish);
+ 935 if (gitObject ==
null)
+ 936 throw new JobException($
"Could not find committish: {committish}");
+
+ 938 var commit = gitObject.Peel<Commit>();
- 940 if (remoteBranch ==
default)
-
-
- 943 logger.LogDebug(
"Creating local branch for {remoteBranchFriendlyName}...", remoteBranch.FriendlyName);
- 944 var branch = libGitRepo.CreateBranch(committish, remoteBranch.Tip);
-
- 946 libGitRepo.Branches.Update(branch, branchUpdate => branchUpdate.TrackedBranch = remoteBranch.CanonicalName);
-
- 948 cancellationToken.ThrowIfCancellationRequested();
-
-
-
-
-
- 954 cancellationToken.ThrowIfCancellationRequested();
-
- 956 libGitRepo.RemoveUntrackedFiles();
-
-
-
-
-
- 970 logger.LogInformation(
"Pushing changes to temporary remote branch...");
- 971 var branch = libGitRepo.CreateBranch(RemoteTemporaryBranchName);
-
-
- 974 cancellationToken.ThrowIfCancellationRequested();
- 975 var remote = libGitRepo.Network.Remotes.First();
-
-
- 978 var forcePushString = String.Format(CultureInfo.InvariantCulture,
"+{0}:{0}", branch.CanonicalName);
- 979 libGitRepo.Network.Push(remote, forcePushString, GeneratePushOptions(progressReporter.CreateSection(
null, 0.9), username, password, cancellationToken));
- 980 var removalString = String.Format(CultureInfo.InvariantCulture,
":{0}", branch.CanonicalName);
- 981 libGitRepo.Network.Push(remote, removalString, GeneratePushOptions(progressReporter.CreateSection(
null, 0.1), username, password, cancellationToken));
-
- 983 catch (UserCancelledException)
-
- 985 cancellationToken.ThrowIfCancellationRequested();
-
- 987 catch (LibGit2SharpException e)
-
- 989 logger.LogWarning(e,
"Unable to push to temporary branch!");
-
-
-
-
- 994 libGitRepo.Branches.Remove(branch);
-
-
-
-
- 999 TaskScheduler.Current);
-
-
-
- 1011 var subProgressReporter = progressReporter.
CreateSection(
null, 0.5);
-
- 1013 return new PushOptions
-
- 1015 OnPackBuilderProgress = (stage, current, total) =>
-
- 1017 var baseProgress = stage == PackBuilderStage.Counting ? 0 : 0.5;
- 1018 var addon = total > 0 && current <= total ? (0.5 * ((double)current / total)) : 0;
-
- 1020 return !cancellationToken.IsCancellationRequested;
-
- 1022 OnNegotiationCompletedBeforePush = (a) =>
-
- 1024 subProgressReporter = progressReporter.
CreateSection(
null, 0.5);
- 1025 return !cancellationToken.IsCancellationRequested;
-
- 1027 OnPushTransferProgress = (a, sentBytes, totalBytes) =>
-
-
- 1030 return !cancellationToken.IsCancellationRequested;
-
- 1032 CredentialsProvider = credentialsProvider.GenerateCredentialsHandler(username, password),
-
-
-
-
- 1041 => ioManager.GetDirectoryName(libGitRepo
-
-
- 1044 .TrimEnd(Path.DirectorySeparatorChar)
- 1045 .TrimEnd(Path.AltDirectorySeparatorChar));
-
-
-
-
-
- 1060 bool deploymentPipeline,
- 1061 CancellationToken cancellationToken)
+ 940 cancellationToken.ThrowIfCancellationRequested();
+
+ 942 libGitRepo.Reset(ResetMode.Hard, commit, checkoutOptions);
+
+
+
+ 946 void RunCheckout() => commands.Checkout(
+
+
+
+
+
+
+
+
+ 955 catch (NotFoundException)
+
+
+ 958 var remoteName = $
"origin/{committish}";
+ 959 var remoteBranch = libGitRepo.Branches.FirstOrDefault(
+ 960 branch => branch.FriendlyName.Equals(remoteName, StringComparison.Ordinal));
+ 961 cancellationToken.ThrowIfCancellationRequested();
+
+ 963 if (remoteBranch ==
default)
+
+
+ 966 logger.LogDebug(
"Creating local branch for {remoteBranchFriendlyName}...", remoteBranch.FriendlyName);
+ 967 var branch = libGitRepo.CreateBranch(committish, remoteBranch.Tip);
+
+ 969 libGitRepo.Branches.Update(branch, branchUpdate => branchUpdate.TrackedBranch = remoteBranch.CanonicalName);
+
+ 971 cancellationToken.ThrowIfCancellationRequested();
+
+
+
+
+
+ 977 cancellationToken.ThrowIfCancellationRequested();
+
+ 979 libGitRepo.RemoveUntrackedFiles();
+
+
+
+
+
+ 993 logger.LogInformation(
"Pushing changes to temporary remote branch...");
+ 994 var branch = libGitRepo.CreateBranch(RemoteTemporaryBranchName);
+
+
+ 997 cancellationToken.ThrowIfCancellationRequested();
+ 998 var remote = libGitRepo.Network.Remotes.First();
+
+
+ 1001 var forcePushString = String.Format(CultureInfo.InvariantCulture,
"+{0}:{0}", branch.CanonicalName);
+
+ 1003 using (var mainPushReporter = progressReporter.CreateSection(
null, 0.9))
+
+ 1005 var (pushOptions, progressReporters) = GeneratePushOptions(
+
+
+
+
+
+
+
+ 1013 libGitRepo.Network.Push(remote, forcePushString, pushOptions);
+
+
+
+ 1017 foreach (var progressReporter in progressReporters)
+ 1018 progressReporter.Dispose();
+
+
+
+ 1022 var removalString = String.Format(CultureInfo.InvariantCulture,
":{0}", branch.CanonicalName);
+ 1023 using var forcePushReporter = progressReporter.CreateSection(
null, 0.1);
+ 1024 var (forcePushOptions, forcePushReporters) = GeneratePushOptions(forcePushReporter, username, password, cancellationToken);
+
+
+ 1027 libGitRepo.Network.Push(remote, removalString, forcePushOptions);
+
+
+
+ 1031 foreach (var subForcePushReporter
in forcePushReporters)
+ 1032 forcePushReporter.Dispose();
+
+
+ 1035 catch (UserCancelledException)
+
+ 1037 cancellationToken.ThrowIfCancellationRequested();
+
+ 1039 catch (LibGit2SharpException e)
+
+ 1041 logger.LogWarning(e,
"Unable to push to temporary branch!");
+
+
+
+
+ 1046 libGitRepo.Branches.Remove(branch);
+
+
+
+
+ 1051 TaskScheduler.Current);
+
+ 1061 (PushOptions PushOptions, IEnumerable<JobProgressReporter> SubProgressReporters)
GeneratePushOptions(
JobProgressReporter progressReporter,
string username,
string password, CancellationToken cancellationToken)
- 1063 logger.LogTrace(
"Updating submodules {withOrWithout} credentials...", username ==
null ?
"without" :
"with");
-
- 1065 async ValueTask RecursiveUpdateSubmodules(LibGit2Sharp.IRepository parentRepository,
JobProgressReporter? currentProgressReporter,
string parentGitDirectory)
-
- 1067 var submoduleCount = libGitRepo.Submodules.Count();
- 1068 if (submoduleCount == 0)
+ 1063 var packFileCountingReporter = progressReporter.
CreateSection(
null, 0.25);
+ 1064 var packFileDeltafyingReporter = progressReporter.
CreateSection(
null, 0.25);
+ 1065 var transferProgressReporter = progressReporter.
CreateSection(
null, 0.5);
+
+
+ 1068 PushOptions:
new PushOptions
- 1070 logger.LogTrace(
"No submodules, skipping update");
-
-
-
- 1074 var factor = 1.0 / submoduleCount / 3;
- 1075 foreach (var submodule
in parentRepository.Submodules)
-
- 1077 logger.LogTrace(
"Entering submodule {name} ({path}) for recursive updates...", submodule.Name, submodule.Path);
- 1078 var submoduleUpdateOptions =
new SubmoduleUpdateOptions
-
-
- 1081 OnCheckoutNotify = (_, _) => !cancellationToken.IsCancellationRequested,
-
-
- 1084 submoduleUpdateOptions.FetchOptions.Hydrate(
-
- 1086 currentProgressReporter?.CreateSection($
"Fetch submodule {submodule.Name}", factor),
- 1087 credentialsProvider.GenerateCredentialsHandler(username, password),
-
-
- 1090 if (currentProgressReporter !=
null)
- 1091 submoduleUpdateOptions.OnCheckoutProgress = CheckoutProgressHandler(
- 1092 currentProgressReporter.
CreateSection($
"Checkout submodule {submodule.Name}", factor));
-
- 1094 logger.LogDebug(
"Updating submodule {submoduleName}...", submodule.Name);
- 1095 Task RawSubModuleUpdate() => Task.Factory.StartNew(
- 1096 () => parentRepository.Submodules.Update(submodule.Name, submoduleUpdateOptions),
-
-
- 1099 TaskScheduler.Current);
-
-
-
- 1103 await RawSubModuleUpdate();
-
- 1105 catch (LibGit2SharpException ex) when (parentRepository == libGitRepo)
-
-
-
-
- 1110 credentialsProvider.CheckBadCredentialsException(ex);
- 1111 logger.LogWarning(ex,
"Initial update of submodule {submoduleName} failed. Deleting submodule directories and re-attempting...", submodule.Name);
-
-
- 1114 ioManager.DeleteDirectory($
".git/modules/{submodule.Path}", cancellationToken),
- 1115 ioManager.DeleteDirectory(submodule.Path, cancellationToken));
-
- 1117 logger.LogTrace(
"Second update attempt for submodule {submoduleName}...", submodule.Name);
-
-
- 1120 await RawSubModuleUpdate();
-
- 1122 catch (UserCancelledException)
-
- 1124 cancellationToken.ThrowIfCancellationRequested();
-
- 1126 catch (LibGit2SharpException ex2)
-
- 1128 credentialsProvider.CheckBadCredentialsException(ex2);
- 1129 logger.LogTrace(ex2,
"Retried update of submodule {submoduleName} failed!", submodule.Name);
- 1130 throw new AggregateException(ex, ex2);
-
-
-
- 1134 await eventConsumer.HandleEvent(
-
- 1136 new List<string> { submodule.Name },
-
-
-
- 1140 var submodulePath = ioManager.ResolvePath(
- 1141 ioManager.ConcatPath(
-
-
+ 1070 OnPackBuilderProgress = (stage, current, total) =>
+
+ 1072 if (total < current)
+
+
+ 1075 var percentage = ((double)current) / total;
+ 1076 (stage == PackBuilderStage.Counting ? packFileCountingReporter : packFileDeltafyingReporter).ReportProgress(percentage);
+ 1077 return !cancellationToken.IsCancellationRequested;
+
+ 1079 OnNegotiationCompletedBeforePush = (a) => !cancellationToken.IsCancellationRequested,
+ 1080 OnPushTransferProgress = (a, sentBytes, totalBytes) =>
+
+ 1082 packFileCountingReporter.ReportProgress((
double)sentBytes / totalBytes);
+ 1083 return !cancellationToken.IsCancellationRequested;
+
+ 1085 CredentialsProvider = credentialsProvider.GenerateCredentialsHandler(username, password),
+
+ 1087 SubProgressReporters:
new List<JobProgressReporter>
+
+ 1089 packFileCountingReporter,
+ 1090 packFileDeltafyingReporter,
+ 1091 transferProgressReporter,
+
+
+
+
+ 1100 => ioManager.GetDirectoryName(libGitRepo
+
+
+ 1103 .TrimEnd(Path.DirectorySeparatorChar)
+ 1104 .TrimEnd(Path.AltDirectorySeparatorChar));
+
+
+
+
+
+ 1119 bool deploymentPipeline,
+ 1120 CancellationToken cancellationToken)
+
+ 1122 logger.LogTrace(
"Updating submodules {withOrWithout} credentials...", username ==
null ?
"without" :
"with");
+
+ 1124 async ValueTask RecursiveUpdateSubmodules(LibGit2Sharp.IRepository parentRepository,
JobProgressReporter currentProgressReporter,
string parentGitDirectory)
+
+ 1126 var submoduleCount = libGitRepo.Submodules.Count();
+ 1127 if (submoduleCount == 0)
+
+ 1129 logger.LogTrace(
"No submodules, skipping update");
+
+
+
+ 1133 var factor = 1.0 / submoduleCount / 3;
+ 1134 foreach (var submodule
in parentRepository.Submodules)
+
+ 1136 logger.LogTrace(
"Entering submodule {name} ({path}) for recursive updates...", submodule.Name, submodule.Path);
+ 1137 var submoduleUpdateOptions =
new SubmoduleUpdateOptions
+
+
+ 1140 OnCheckoutNotify = (_, _) => !cancellationToken.IsCancellationRequested,
+
+
+ 1143 using var fetchReporter = currentProgressReporter.
CreateSection($
"Fetch submodule {submodule.Name}", factor);
- 1145 using var submoduleRepo = await submoduleFactory.CreateFromPath(
-
-
- 1148 await RecursiveUpdateSubmodules(
-
- 1150 currentProgressReporter?.CreateSection($
"Entering submodule \"{submodule.Name}\"...", factor),
-
-
-
-
- 1155 return RecursiveUpdateSubmodules(libGitRepo, progressReporter, GetRepositoryPath());
-
-
-
-
-
-
-
- 1168 if (completedSteps == 0)
-
- 1170 else if (totalSteps < completedSteps || totalSteps == 0)
-
-
-
- 1174 percentage = ((double)completedSteps) / totalSteps;
-
-
-
-
- 1179 if (percentage ==
null)
-
- 1181 "Bad checkout progress values (Please tell Dominion)! Completeds: {completed}, Total: {total}",
-
-
-
- 1185 progressReporter.ReportProgress(percentage);
-
-
- 1188#pragma warning restore CA1506
-
+ 1145 submoduleUpdateOptions.FetchOptions.Hydrate(
+
+
+ 1148 credentialsProvider.GenerateCredentialsHandler(username, password),
+
+
+ 1151 using var checkoutReporter = currentProgressReporter.
CreateSection($
"Checkout submodule {submodule.Name}", factor);
+ 1152 submoduleUpdateOptions.OnCheckoutProgress = CheckoutProgressHandler(checkoutReporter);
+
+ 1154 logger.LogDebug(
"Updating submodule {submoduleName}...", submodule.Name);
+ 1155 Task RawSubModuleUpdate() => Task.Factory.StartNew(
+ 1156 () => parentRepository.Submodules.Update(submodule.Name, submoduleUpdateOptions),
+
+
+ 1159 TaskScheduler.Current);
+
+
+
+ 1163 await RawSubModuleUpdate();
+
+ 1165 catch (LibGit2SharpException ex) when (parentRepository == libGitRepo)
+
+
+
+
+ 1170 credentialsProvider.CheckBadCredentialsException(ex);
+ 1171 logger.LogWarning(ex,
"Initial update of submodule {submoduleName} failed. Deleting submodule directories and re-attempting...", submodule.Name);
+
+
+ 1174 ioManager.DeleteDirectory($
".git/modules/{submodule.Path}", cancellationToken),
+ 1175 ioManager.DeleteDirectory(submodule.Path, cancellationToken));
+
+ 1177 logger.LogTrace(
"Second update attempt for submodule {submoduleName}...", submodule.Name);
+
+
+ 1180 await RawSubModuleUpdate();
+
+ 1182 catch (UserCancelledException)
+
+ 1184 cancellationToken.ThrowIfCancellationRequested();
+
+ 1186 catch (LibGit2SharpException ex2)
+
+ 1188 credentialsProvider.CheckBadCredentialsException(ex2);
+ 1189 logger.LogTrace(ex2,
"Retried update of submodule {submoduleName} failed!", submodule.Name);
+ 1190 throw new AggregateException(ex, ex2);
+
+
+
+ 1194 await eventConsumer.HandleEvent(
+
+ 1196 new List<string> { submodule.Name },
+
+
+
+ 1200 var submodulePath = ioManager.ResolvePath(
+ 1201 ioManager.ConcatPath(
+
+
+
+ 1205 using var submoduleRepo = await submoduleFactory.CreateFromPath(
+
+
+
+ 1209 using var submoduleReporter = currentProgressReporter.
CreateSection($
"Entering submodule \"{submodule.Name}\"...", factor);
+ 1210 await RecursiveUpdateSubmodules(
+
+
+
+
+
+
+ 1217 return RecursiveUpdateSubmodules(libGitRepo, progressReporter, GetRepositoryPath());
+
+
+
+
+
+
+
+ 1230 if (completedSteps == 0)
+
+ 1232 else if (totalSteps < completedSteps || totalSteps == 0)
+
+
+
+ 1236 percentage = ((double)completedSteps) / totalSteps;
+
+
+
+
+ 1241 if (percentage ==
null)
+
+ 1243 "Bad checkout progress values (Please tell Dominion)! Completeds: {completed}, Total: {total}",
+
+
+
+
+
+
+ 1250#pragma warning restore CA1506
+
Represents configurable settings for a git repository.
Parameters for creating a TestMerge.
virtual ? string TargetCommitSha
The sha of the test merge revision to merge. If not specified, the latest commit from the source will...
const string OriginTrackingErrorTemplate
Template error message for when tracking of the most recent origin commit fails.
Task ResetToSha(string sha, JobProgressReporter progressReporter, CancellationToken cancellationToken)
Requires the current HEAD to be a reference. Hard resets the reference to the given sha....
const string DefaultCommitterEmail
The default password for committers.
async ValueTask CopyTo(string path, CancellationToken cancellationToken)
Copies the current working directory to a given path . A ValueTask representing the running operation...
ValueTask UpdateSubmodules(JobProgressReporter? progressReporter, string? username, string? password, bool deploymentPipeline, CancellationToken cancellationToken)
Recusively update all Submodules in the libGitRepo.
async ValueTask FetchOrigin(JobProgressReporter progressReporter, string? username, string? password, bool deploymentPipeline, CancellationToken cancellationToken)
Fetch commits from the origin repository. A ValueTask representing the running operation.
async ValueTask CopyTo(string path, CancellationToken cancellationToken)
Copies the current working directory to a given path . A ValueTask representing the running operation...
async ValueTask< TestMergeResult > AddTestMerge(TestMergeParameters testMergeParameters, string committerName, string committerEmail, string? username, string? password, bool updateSubmodules, JobProgressReporter progressReporter, CancellationToken cancellationToken)
Attempt to merge the revision specified by a given set of testMergeParameters into HEAD....
string Head
The SHA of the IRepository HEAD.
string? RemoteRepositoryName
If RemoteGitProvider is not RemoteGitProvider.Unknown this will be set with the name of the repositor...
bool Tracking
If Reference tracks an upstream branch.
const string RemoteTemporaryBranchName
The branch name used for publishing testmerge commits.
async ValueTask< bool > Synchronize(JobProgressReporter progressReporter, string? username, string? password, string committerName, string committerEmail, bool synchronizeTrackedBranch, bool deploymentPipeline, CancellationToken cancellationToken)
Runs the synchronize event script and attempts to push any changes made to the IRepository if on a tr...
async ValueTask< bool > Synchronize(JobProgressReporter progressReporter, string? username, string? password, string committerName, string committerEmail, bool synchronizeTrackedBranch, bool deploymentPipeline, CancellationToken cancellationToken)
Runs the synchronize event script and attempts to push any changes made to the IRepository if on a tr...
Uri Origin
The current origin remote the IRepository is using.
async ValueTask CheckoutObject(string committish, string? username, string? password, bool updateSubmodules, bool moveCurrentReference, JobProgressReporter progressReporter, CancellationToken cancellationToken)
Checks out a given committish . A ValueTask representing the running operation.
readonly LibGit2Sharp.IRepository libGitRepo
The LibGit2Sharp.IRepository for the Repository.
Task PushHeadToTemporaryBranch(string username, string password, JobProgressReporter progressReporter, CancellationToken cancellationToken)
Force push the current repository HEAD to RemoteTemporaryBranchName;.
readonly IGitRemoteFeatures gitRemoteFeatures
The IGitRemoteFeatures for the Repository.
ValueTask UpdateSubmodules(JobProgressReporter progressReporter, string? username, string? password, bool deploymentPipeline, CancellationToken cancellationToken)
Recusively update all Submodules in the libGitRepo.
readonly ILibGit2RepositoryFactory submoduleFactory
The ILibGit2RepositoryFactory used for updating submodules.
async ValueTask CheckoutObject(string committish, string? username, string? password, bool updateSubmodules, bool moveCurrentReference, JobProgressReporter? progressReporter, CancellationToken cancellationToken)
Checks out a given committish . A ValueTask representing the running operation.
PushOptions GeneratePushOptions(JobProgressReporter progressReporter, string username, string password, CancellationToken cancellationToken)
Generate a standard set of PushOptions.
async ValueTask< bool?> MergeOrigin(JobProgressReporter progressReporter, string committerName, string committerEmail, bool deploymentPipeline, CancellationToken cancellationToken)
Requires the current HEAD to be a tracked reference. Merges the reference to what it tracks on the or...
async ValueTask FetchOrigin(JobProgressReporter? progressReporter, string? username, string? password, bool deploymentPipeline, CancellationToken cancellationToken)
Fetch commits from the origin repository. A ValueTask representing the running operation.
async ValueTask< bool?> MergeOrigin(JobProgressReporter progressReporter, string committerName, string committerEmail, bool deploymentPipeline, CancellationToken cancellationToken)
Requires the current HEAD to be a tracked reference. Merges the reference to what it tracks on the or...
readonly ILogger< Repository > logger
The ILogger for the Repository.
override void DisposeImpl()
Implementation of Dispose run after reentrancy check.
override void DisposeImpl()
Implementation of Dispose run after reentrancy check.
string? RemoteRepositoryOwner
If RemoteGitProvider is not RemoteGitProvider.Unknown this will be set with the owner of the reposito...
readonly IIOManager ioManager
The IIOManager for the Repository.
ValueTask< Models.TestMerge > GetTestMerge(TestMergeParameters parameters, RepositorySettings repositorySettings, CancellationToken cancellationToken)
Retrieve the Models.TestMerge representation of given test merge parameters . A ValueTask<TResult> re...
readonly IPostWriteHandler postWriteHandler
The IPostWriteHandler for the Repository.
const string DefaultCommitterName
The default username for committers.
const string UnknownReference
Used when a reference cannot be determined.
void RawCheckout(string committish, bool moveCurrentReference, JobProgressReporter? progressReporter, CancellationToken cancellationToken)
Runs a blocking force checkout to committish .
Task< string > GetOriginSha(CancellationToken cancellationToken)
Get the tracked reference's current SHA. A Task<TResult> resulting in the tracked origin reference's ...
Task< bool > IsSha(string committish, CancellationToken cancellationToken)
Checks if a given committish is a sha. A Task<TResult> resulting in true if committish is a sha,...
Task< bool > CommittishIsParent(string committish, CancellationToken cancellationToken)
Check if a given committish is a parent of the current Head. A Task<TResult> resulting in true if co...
readonly IEventConsumer eventConsumer
The IEventConsumer for the Repository.
const string NoReference
The value of Reference when not on a reference.
CheckoutProgressHandler CheckoutProgressHandler(JobProgressReporter progressReporter)
Converts a given progressReporter to a LibGit2Sharp.Handlers.CheckoutProgressHandler.
void RawCheckout(string committish, bool moveCurrentReference, JobProgressReporter progressReporter, CancellationToken cancellationToken)
Runs a blocking force checkout to committish .
readonly ICredentialsProvider credentialsProvider
The ICredentialsProvider for the Repository.
Task< DateTimeOffset > TimestampCommit(string sha, CancellationToken cancellationToken)
Gets the DateTimeOffset a given sha was created on. A Task<TResult> resulting in the DateTimeOffset ...
async ValueTask ResetToOrigin(JobProgressReporter progressReporter, string? username, string? password, bool updateSubmodules, bool deploymentPipeline, CancellationToken cancellationToken)
Requires the current HEAD to be a tracked reference. Hard resets the reference to what it tracks on t...
async ValueTask ResetToOrigin(JobProgressReporter progressReporter, string? username, string? password, bool updateSubmodules, bool deploymentPipeline, CancellationToken cancellationToken)
Requires the current HEAD to be a tracked reference. Hard resets the reference to what it tracks on t...
PushOptions IEnumerable< JobProgressReporter > SubProgressReporters GeneratePushOptions(JobProgressReporter progressReporter, string username, string password, CancellationToken cancellationToken)
readonly GeneralConfiguration generalConfiguration
The GeneralConfiguration for the Repository.
Represents the result of a repository test merge attempt.
MergeStatus Status
The resulting MergeStatus.
IIOManager that resolves paths to Environment.CurrentDirectory.
const TaskCreationOptions BlockingTaskCreationOptions
The TaskCreationOptions used to spawn Tasks for potentially long running, blocking operations.
Operation exceptions thrown from the context of a Models.Job.
Progress reporter for a Job.
JobProgressReporter CreateSection(string? newStageName, double percentage)
Create a subsection of the JobProgressReporter with its optional own stage name.
void ReportProgress(double? progress)
Report progress.
Progress reporter for a Job.
JobProgressReporter CreateSection(string? newStageName, double percentage)
Create a subsection of the JobProgressReporter with its optional own stage name.
void ReportProgress(double? progress)
Report progress.
Runs a given disposeAction on Dispose.
readonly Action disposeAction
The Action to run on Dispose.
123 string? initialBranch,
-
+
127 bool recurseSubmodules,
128 CancellationToken cancellationToken)
@@ -178,8 +178,8 @@ $(function() {
- 149 var cloneProgressReporter = progressReporter?.
CreateSection(
null, 0.75f);
- 150 var checkoutProgressReporter = progressReporter?.
CreateSection(
null, 0.25f);
+ 149 using var cloneProgressReporter = progressReporter.
CreateSection(
null, 0.75f);
+ 150 using var checkoutProgressReporter = progressReporter.
CreateSection(
null, 0.25f);
151 var cloneOptions =
new CloneOptions
153 RecurseSubmodules = recurseSubmodules,
@@ -307,7 +307,6 @@ $(function() {
RepositoryManager(ILibGit2RepositoryFactory repositoryFactory, ILibGit2Commands commands, IIOManager ioManager, IEventConsumer eventConsumer, IPostWriteHandler postWriteHandler, IGitRemoteFeaturesFactory gitRemoteFeaturesFactory, ILogger< Repository > repositoryLogger, ILogger< RepositoryManager > logger, GeneralConfiguration generalConfiguration)
Initializes a new instance of the RepositoryManager class.
async ValueTask< IRepository?> CloneRepository(Uri url, string? initialBranch, string? username, string? password, JobProgressReporter? progressReporter, bool recurseSubmodules, CancellationToken cancellationToken)
Clone the repository at url . A ValueTask<TResult> resulting i the newly cloned IRepository,...
readonly ILogger< Repository > repositoryLogger
The ILogger created Repositorys.
async ValueTask DeleteRepository(CancellationToken cancellationToken)
Delete the current repository. A ValueTask representing the running operation.
readonly GeneralConfiguration generalConfiguration
The GeneralConfiguration for the RepositoryManager.
bool InUse
If something is holding a lock on the repository.
readonly IPostWriteHandler postWriteHandler
The IPostWriteHandler for the RepositoryManager.
readonly IIOManager ioManager
The IIOManager for the RepositoryManager.
async ValueTask< IRepository?> CloneRepository(Uri url, string? initialBranch, string? username, string? password, JobProgressReporter progressReporter, bool recurseSubmodules, CancellationToken cancellationToken)
Clone the repository at url . A ValueTask<TResult> resulting i the newly cloned IRepository,...
readonly ILogger< RepositoryManager > logger
The ILogger for the RepositoryManager.
readonly IEventConsumer eventConsumer
The IEventConsumer for the RepositoryManager.
bool CloneInProgress
If a CloneRepository(Uri, string, string, string, JobProgressReporter, bool, CancellationToken) opera...
readonly IGitRemoteFeaturesFactory gitRemoteFeaturesFactory
The IGitRemoteFeaturesFactory for the RepositoryManager.
General configuration options.
Operation exceptions thrown from the context of a Models.Job.
Progress reporter for a Job.
JobProgressReporter CreateSection(string? newStageName, double percentage)
Create a subsection of the JobProgressReporter with its optional own stage name.
void ReportProgress(double? progress)
Report progress.
Progress reporter for a Job.
JobProgressReporter CreateSection(string? newStageName, double percentage)
Create a subsection of the JobProgressReporter with its optional own stage name.
void ReportProgress(double? progress)
Report progress.
Async lock context helper.
static async ValueTask< SemaphoreSlimContext > Lock(SemaphoreSlim semaphore, CancellationToken cancellationToken)
Asyncronously locks a semaphore .
Consumes EventTypes and takes the appropriate actions.
173 var numSteps = (model.
NewTestMerges?.Count ?? 0) + (model.
UpdateFromOrigin ==
true ? 1 : 0) + (!modelHasShaOrReference ? 2 : (hardResettingToOriginReference ? 3 : 1));
174 var progressFactor = 1.0 / numSteps;
-
-
- 178 return progressReporter.
CreateSection(stage, progressFactor);
-
-
-
+
+
+
+
+
+ 181 Models.RevisionInformation? lastRevisionInfo =
null;
-
- 184 Models.RevisionInformation? lastRevisionInfo =
null;
-
-
-
-
-
-
- 191 ValueTask CallLoadRevInfo(Models.TestMerge? testMergeToAdd =
null,
string? lastOriginCommitSha =
null) => databaseContextFactory
-
- 193 async databaseContext =>
-
- 195 databaseContext.Instances.Attach(attachedInstance);
- 196 var previousRevInfo = lastRevisionInfo!;
-
-
-
-
-
-
- 203 x => lastRevisionInfo = x,
-
-
- 206 if (testMergeToAdd !=
null)
-
-
- 209 var mergedBy = databaseContext.Users.Local.FirstOrDefault(x => x.Id ==
initiatingUser.
Id);
- 210 if (mergedBy ==
default)
-
-
-
-
-
+
+
+
+
+
+ 188 ValueTask CallLoadRevInfo(Models.TestMerge? testMergeToAdd =
null,
string? lastOriginCommitSha =
null) => databaseContextFactory
+
+ 190 async databaseContext =>
+
+ 192 databaseContext.Instances.Attach(attachedInstance);
+ 193 var previousRevInfo = lastRevisionInfo!;
+
+
+
+
+
+
+ 200 x => lastRevisionInfo = x,
+
+
+ 203 if (testMergeToAdd !=
null)
+
+
+ 206 var mergedBy = databaseContext.Users.Local.FirstOrDefault(x => x.Id ==
initiatingUser.
Id);
+ 207 if (mergedBy ==
default)
+
+
+
+
+
+
+ 214 databaseContext.Users.Attach(mergedBy);
+
- 217 databaseContext.Users.Attach(mergedBy);
-
+ 217 testMergeToAdd.MergedBy = mergedBy;
+ 218 testMergeToAdd.MergedAt = DateTimeOffset.UtcNow;
- 220 testMergeToAdd.MergedBy = mergedBy;
- 221 testMergeToAdd.MergedAt = DateTimeOffset.UtcNow;
-
- 223 var activeTestMerges = lastRevisionInfo!.ActiveTestMerges!;
- 224 foreach (var activeTestMerge
in previousRevInfo.ActiveTestMerges!)
- 225 activeTestMerges.Add(activeTestMerge);
+ 220 var activeTestMerges = lastRevisionInfo!.ActiveTestMerges!;
+ 221 foreach (var activeTestMerge
in previousRevInfo.ActiveTestMerges!)
+ 222 activeTestMerges.Add(activeTestMerge);
+
+ 224 activeTestMerges.Add(
new RevInfoTestMerge(testMergeToAdd, lastRevisionInfo));
+ 225 lastRevisionInfo.PrimaryTestMerge = testMergeToAdd;
- 227 activeTestMerges.Add(
new RevInfoTestMerge(testMergeToAdd, lastRevisionInfo));
- 228 lastRevisionInfo.PrimaryTestMerge = testMergeToAdd;
+
+
-
-
-
-
- 234 await databaseContext.Save(cancellationToken);
-
-
- 237 await CallLoadRevInfo();
+
+ 231 await databaseContext.Save(cancellationToken);
+
+
+ 234 await CallLoadRevInfo();
+
+
+ 237 ValueTask UpdateRevInfo(Models.TestMerge? testMergeToAdd =
null) => CallLoadRevInfo(testMergeToAdd, lastRevisionInfo!.OriginCommitSha);
-
- 240 ValueTask UpdateRevInfo(Models.TestMerge? testMergeToAdd =
null) => CallLoadRevInfo(testMergeToAdd, lastRevisionInfo!.OriginCommitSha);
-
-
-
-
-
-
-
-
- 249 await repo.FetchOrigin(
- 250 NextProgressReporter(
"Fetch Origin"),
-
-
-
-
-
- 256 if (!modelHasShaOrReference)
-
- 258 var fastForward = await repo.MergeOrigin(
- 259 NextProgressReporter(
"Merge Origin"),
-
-
-
-
- 264 if (!fastForward.HasValue)
-
- 266 lastRevisionInfo!.OriginCommitSha = await repo.GetOriginSha(cancellationToken);
- 267 await UpdateRevInfo();
- 268 if (fastForward.Value)
-
- 270 await repo.Synchronize(
- 271 NextProgressReporter(
"Sychronize"),
-
-
-
-
-
-
-
- 279 postUpdateSha = repo.Head;
-
-
- 282 NextProgressReporter(
null).ReportProgress(1.0);
-
-
-
-
-
-
- 289 if (modelHasShaOrReference)
-
- 291 var validCheckoutSha =
- 292 model.CheckoutSha !=
null
- 293 && !repo.Head.StartsWith(model.
CheckoutSha, StringComparison.OrdinalIgnoreCase);
- 294 var validCheckoutReference =
- 295 model.Reference !=
null
- 296 && !repo.Reference.Equals(model.
Reference, StringComparison.OrdinalIgnoreCase);
-
- 298 if (validCheckoutSha || validCheckoutReference)
-
- 300 var committish = model.CheckoutSha ?? model.
Reference!;
- 301 var isSha = await repo.IsSha(committish, cancellationToken);
-
-
-
+
+
+
+
+
+
+
+ 246 using (var fetchReporter = NextProgressReporter(
"Fetch Origin"))
+ 247 await repo.FetchOrigin(
+
+
+
+
+
+
+ 254 if (!modelHasShaOrReference)
+
+
+ 257 using (var mergeReporter = NextProgressReporter(
"Merge Origin"))
+ 258 fastForward = await repo.MergeOrigin(
+
+
+
+
+
+
+ 265 if (!fastForward.HasValue)
+
+
+ 268 lastRevisionInfo!.OriginCommitSha = await repo.GetOriginSha(cancellationToken);
+ 269 await UpdateRevInfo();
+ 270 if (fastForward.Value)
+
+ 272 using var syncReporter = NextProgressReporter(
"Sychronize");
+ 273 await repo.Synchronize(
+
+
+
+
+
+
+
+
+ 282 postUpdateSha = repo.Head;
+
+
+ 285 NextProgressReporter(
null).Dispose();
+
+
+
+
+
+
+ 292 if (modelHasShaOrReference)
+
+ 294 var validCheckoutSha =
+ 295 model.CheckoutSha !=
null
+ 296 && !repo.Head.StartsWith(model.
CheckoutSha, StringComparison.OrdinalIgnoreCase);
+ 297 var validCheckoutReference =
+ 298 model.Reference !=
null
+ 299 && !repo.Reference.Equals(model.
Reference, StringComparison.OrdinalIgnoreCase);
+
+ 301 if (validCheckoutSha || validCheckoutReference)
+
+ 303 var committish = model.CheckoutSha ?? model.
Reference!;
+ 304 var isSha = await repo.IsSha(committish, cancellationToken);
- 306 await repo.CheckoutObject(
-
-
-
-
-
- 312 NextProgressReporter(
"Checkout"),
-
- 314 await CallLoadRevInfo();
-
-
- 317 NextProgressReporter(
null).ReportProgress(1.0);
-
- 319 if (hardResettingToOriginReference)
-
-
-
- 323 await repo.ResetToOrigin(
- 324 NextProgressReporter(
"Reset to Origin"),
-
-
-
-
-
- 330 await repo.Synchronize(
- 331 NextProgressReporter(
"Synchronize"),
-
-
-
-
-
-
-
- 339 await CallLoadRevInfo();
-
-
-
- 343 lastRevisionInfo!.OriginCommitSha = repo.Head;
-
-
+
+
+
+ 309 using (var checkoutReporter = NextProgressReporter(
"Checkout"))
+ 310 await repo.CheckoutObject(
+
+
+
+
+
+
+
+ 318 await CallLoadRevInfo();
+
+
+ 321 NextProgressReporter(
null).Dispose();
+
+ 323 if (hardResettingToOriginReference)
+
+
+
+ 327 using (var resetReporter = NextProgressReporter(
"Reset to Origin"))
+ 328 await repo.ResetToOrigin(
+
+
+
+
+
+
+
+ 336 using (var syncReporter = NextProgressReporter(
"Synchronize"))
+ 337 await repo.Synchronize(
+
+
+
+
+
+
+
+
-
-
-
-
-
-
-
-
- 355 foreach (var newTestMergeWithoutTargetCommitSha
in newTestMergeModels.Where(x => String.IsNullOrWhiteSpace(x.TargetCommitSha)))
- 356 newTestMergeWithoutTargetCommitSha.TargetCommitSha =
null;
-
- 358 var repoOwner = repo.RemoteRepositoryOwner;
- 359 var repoName = repo.RemoteRepositoryName;
+ 347 await CallLoadRevInfo();
+
+
+
+ 351 lastRevisionInfo!.OriginCommitSha = repo.Head;
+
+
+
+
+
+
+
+
-
- 362 Models.RevisionInformation? revInfoWereLookingFor =
null;
- 363 bool needToApplyRemainingPrs =
true;
- 364 if (lastRevisionInfo!.OriginCommitSha == lastRevisionInfo.CommitSha)
-
- 366 bool cantSearch =
false;
- 367 foreach (var newTestMerge
in newTestMergeModels)
-
- 369 if (newTestMerge.TargetCommitSha !=
null)
- 370#pragma warning disable CA1308
- 371 newTestMerge.TargetCommitSha = newTestMerge.TargetCommitSha?.ToLowerInvariant();
- 372#pragma warning restore CA1308
-
-
-
-
- 377 var pr = await repo.GetTestMerge(newTestMerge,
currentModel, cancellationToken);
-
-
- 380 newTestMerge.TargetCommitSha = pr.TargetCommitSha;
-
-
+
+
+ 363 foreach (var newTestMergeWithoutTargetCommitSha
in newTestMergeModels.Where(x => String.IsNullOrWhiteSpace(x.TargetCommitSha)))
+ 364 newTestMergeWithoutTargetCommitSha.TargetCommitSha =
null;
+
+ 366 var repoOwner = repo.RemoteRepositoryOwner;
+ 367 var repoName = repo.RemoteRepositoryName;
+
+
+ 370 Models.RevisionInformation? revInfoWereLookingFor =
null;
+ 371 bool needToApplyRemainingPrs =
true;
+ 372 if (lastRevisionInfo!.OriginCommitSha == lastRevisionInfo.CommitSha)
+
+ 374 bool cantSearch =
false;
+ 375 foreach (var newTestMerge
in newTestMergeModels)
+
+ 377 if (newTestMerge.TargetCommitSha !=
null)
+ 378#pragma warning disable CA1308
+ 379 newTestMerge.TargetCommitSha = newTestMerge.TargetCommitSha?.ToLowerInvariant();
+ 380#pragma warning restore CA1308
+
+
-
-
-
-
-
-
-
- 391 List<Models.RevisionInformation>? dbPull =
null;
-
-
- 394 async databaseContext =>
- 395 dbPull = await databaseContext.RevisionInformations
-
-
- 398 && x.OriginCommitSha == lastRevisionInfo.OriginCommitSha
- 399 && x.ActiveTestMerges!.Count <= newTestMergeModels.Count
- 400 && x.ActiveTestMerges!.Count > 0)
- 401 .Include(x => x.ActiveTestMerges!)
- 402 .ThenInclude(x => x.TestMerge)
- 403 .ToListAsync(cancellationToken));
-
-
- 406 revInfoWereLookingFor = dbPull!
- 407 .Where(x => x.ActiveTestMerges!.Count == newTestMergeModels.Count
- 408 && x.ActiveTestMerges
- 409 .Select(y => y.TestMerge)
- 410 .All(y => newTestMergeModels
-
-
- 413 && y.TargetCommitSha!.StartsWith(z.TargetCommitSha!, StringComparison.Ordinal)
- 414 && (y.Comment?.Trim().ToUpperInvariant() == z.Comment?.Trim().ToUpperInvariant() || z.Comment ==
null))))
-
-
- 417 if (revInfoWereLookingFor ==
default && newTestMergeModels.Count > 1)
-
-
- 420 var listedNewTestMerges = newTestMergeModels.ToList();
-
- 422 var appliedTestMergeIds =
new List<long>();
-
- 424 Models.RevisionInformation? lastGoodRevInfo =
null;
-
-
- 427 foreach (var newTestMergeParameters
in listedNewTestMerges)
-
- 429 revInfoWereLookingFor = dbPull!
- 430 .Where(testRevInfo =>
-
- 432 if (testRevInfo.PrimaryTestMerge ==
null)
-
-
- 435 var testMergeMatch = newTestMergeModels.Any(testTestMerge =>
-
- 437 var numberMatch = testRevInfo.PrimaryTestMerge.Number == testTestMerge.Number;
-
-
-
- 441 var shaMatch = testRevInfo.PrimaryTestMerge.TargetCommitSha!.StartsWith(
- 442 testTestMerge.TargetCommitSha!,
- 443 StringComparison.Ordinal);
-
-
-
- 447 var commentMatch = testRevInfo.PrimaryTestMerge.Comment == testTestMerge.Comment;
-
-
-
-
-
-
- 454 var previousTestMergesMatch = testRevInfo
-
- 456 .Select(previousRevInfoTestMerge => previousRevInfoTestMerge.TestMerge)
- 457 .All(previousTestMerge => appliedTestMergeIds.Contains(previousTestMerge.Id));
+
+ 385 var pr = await repo.GetTestMerge(newTestMerge,
currentModel, cancellationToken);
+
+
+ 388 newTestMerge.TargetCommitSha = pr.TargetCommitSha;
+
+
+
+
+
+
+
+
+
+
+ 399 List<Models.RevisionInformation>? dbPull =
null;
+
+
+ 402 async databaseContext =>
+ 403 dbPull = await databaseContext.RevisionInformations
+
+
+ 406 && x.OriginCommitSha == lastRevisionInfo.OriginCommitSha
+ 407 && x.ActiveTestMerges!.Count <= newTestMergeModels.Count
+ 408 && x.ActiveTestMerges!.Count > 0)
+ 409 .Include(x => x.ActiveTestMerges!)
+ 410 .ThenInclude(x => x.TestMerge)
+ 411 .ToListAsync(cancellationToken));
+
+
+ 414 revInfoWereLookingFor = dbPull!
+ 415 .Where(x => x.ActiveTestMerges!.Count == newTestMergeModels.Count
+ 416 && x.ActiveTestMerges
+ 417 .Select(y => y.TestMerge)
+ 418 .All(y => newTestMergeModels
+
+
+ 421 && y.TargetCommitSha!.StartsWith(z.TargetCommitSha!, StringComparison.Ordinal)
+ 422 && (y.Comment?.Trim().ToUpperInvariant() == z.Comment?.Trim().ToUpperInvariant() || z.Comment ==
null))))
+
+
+ 425 if (revInfoWereLookingFor ==
default && newTestMergeModels.Count > 1)
+
+
+ 428 var listedNewTestMerges = newTestMergeModels.ToList();
+
+ 430 var appliedTestMergeIds =
new List<long>();
+
+ 432 Models.RevisionInformation? lastGoodRevInfo =
null;
+
+
+ 435 foreach (var newTestMergeParameters
in listedNewTestMerges)
+
+ 437 revInfoWereLookingFor = dbPull!
+ 438 .Where(testRevInfo =>
+
+ 440 if (testRevInfo.PrimaryTestMerge ==
null)
+
+
+ 443 var testMergeMatch = newTestMergeModels.Any(testTestMerge =>
+
+ 445 var numberMatch = testRevInfo.PrimaryTestMerge.Number == testTestMerge.Number;
+
+
+
+ 449 var shaMatch = testRevInfo.PrimaryTestMerge.TargetCommitSha!.StartsWith(
+ 450 testTestMerge.TargetCommitSha!,
+ 451 StringComparison.Ordinal);
+
+
+
+ 455 var commentMatch = testRevInfo.PrimaryTestMerge.Comment == testTestMerge.Comment;
+
+
- 459 return previousTestMergesMatch;
-
-
-
- 463 if (revInfoWereLookingFor !=
null)
-
- 465 lastGoodRevInfo = revInfoWereLookingFor;
- 466 appliedTestMergeIds.Add(revInfoWereLookingFor.PrimaryTestMerge!.Id);
- 467 listedNewTestMerges.Remove(newTestMergeParameters);
-
-
-
-
- 472 while (revInfoWereLookingFor !=
null && listedNewTestMerges.Count > 0);
-
- 474 revInfoWereLookingFor = lastGoodRevInfo;
- 475 needToApplyRemainingPrs = listedNewTestMerges.Count != 0;
- 476 if (needToApplyRemainingPrs)
- 477 model.NewTestMerges = listedNewTestMerges;
-
- 479 else if (revInfoWereLookingFor !=
null)
- 480 needToApplyRemainingPrs =
false;
-
-
-
- 484 if (revInfoWereLookingFor !=
null)
-
-
- 487 var commitSha = revInfoWereLookingFor.CommitSha!;
- 488 logger.LogDebug(
"Reusing existing SHA {sha}...", commitSha);
- 489 await repo.ResetToSha(commitSha, NextProgressReporter($
"Reset to {commitSha[..7]}"), cancellationToken);
- 490 lastRevisionInfo = revInfoWereLookingFor;
-
-
- 493 if (needToApplyRemainingPrs)
-
- 495 foreach (var newTestMerge
in newTestMergeModels)
-
- 497 if (lastRevisionInfo.ActiveTestMerges!.Any(x => x.TestMerge.Number == newTestMerge.Number))
-
-
- 500 var fullTestMergeTask = repo.GetTestMerge(newTestMerge,
currentModel, cancellationToken);
+
+
+
+ 462 var previousTestMergesMatch = testRevInfo
+
+ 464 .Select(previousRevInfoTestMerge => previousRevInfoTestMerge.TestMerge)
+ 465 .All(previousTestMerge => appliedTestMergeIds.Contains(previousTestMerge.Id));
+
+ 467 return previousTestMergesMatch;
+
+
+
+ 471 if (revInfoWereLookingFor !=
null)
+
+ 473 lastGoodRevInfo = revInfoWereLookingFor;
+ 474 appliedTestMergeIds.Add(revInfoWereLookingFor.PrimaryTestMerge!.Id);
+ 475 listedNewTestMerges.Remove(newTestMergeParameters);
+
+
+
+
+ 480 while (revInfoWereLookingFor !=
null && listedNewTestMerges.Count > 0);
+
+ 482 revInfoWereLookingFor = lastGoodRevInfo;
+ 483 needToApplyRemainingPrs = listedNewTestMerges.Count != 0;
+ 484 if (needToApplyRemainingPrs)
+ 485 model.NewTestMerges = listedNewTestMerges;
+
+ 487 else if (revInfoWereLookingFor !=
null)
+ 488 needToApplyRemainingPrs =
false;
+
+
+
+ 492 if (revInfoWereLookingFor !=
null)
+
+
+ 495 var commitSha = revInfoWereLookingFor.CommitSha!;
+ 496 logger.LogDebug(
"Reusing existing SHA {sha}...", commitSha);
+ 497 using var resetReporter = NextProgressReporter($
"Reset to {commitSha[..7]}");
+ 498 await repo.ResetToSha(commitSha, resetReporter, cancellationToken);
+ 499 lastRevisionInfo = revInfoWereLookingFor;
+
- 502 var mergeResult = await repo.AddTestMerge(
-
-
-
-
-
-
- 509 NextProgressReporter($
"Test merge #{newTestMerge.Number}"),
-
-
- 512 if (mergeResult.Status == MergeStatus.Conflicts)
-
-
-
- 516 $
"Test Merge #{newTestMerge.Number} at {newTestMerge.TargetCommitSha![..7]} conflicted! Conflicting files:{Environment.NewLine}{String.Join(Environment.NewLine, mergeResult.ConflictingFiles!.Select(file => $"\t- /{file}
"))}"));
-
-
-
-
- 521 fullTestMerge = await fullTestMergeTask;
-
-
-
- 525 logger.LogWarning(
"Error retrieving metadata for test merge #{testMergeNumber}!", newTestMerge.Number);
-
-
-
-
- 530 BodyAtMerge = ex.Message,
- 531 TitleAtMerge = ex.Message,
- 532 Comment = newTestMerge.Comment,
- 533 Number = newTestMerge.Number,
-
-
-
+ 502 if (needToApplyRemainingPrs)
+
+ 504 foreach (var newTestMerge
in newTestMergeModels)
+
+ 506 if (lastRevisionInfo.ActiveTestMerges!.Any(x => x.TestMerge.Number == newTestMerge.Number))
+
+
+ 509 var fullTestMergeTask = repo.GetTestMerge(newTestMerge,
currentModel, cancellationToken);
+
+
+ 512 using (var testMergeReporter = NextProgressReporter($
"Test merge #{newTestMerge.Number}"))
+ 513 mergeResult = await repo.AddTestMerge(
+
+
+
+
+
+
+
+
+
+ 523 if (mergeResult.
Status == MergeStatus.Conflicts)
+
+
+
+ 527 $
"Test Merge #{newTestMerge.Number} at {newTestMerge.TargetCommitSha![..7]} conflicted! Conflicting files:{Environment.NewLine}{String.Join(Environment.NewLine, mergeResult.ConflictingFiles!.Select(file => $"\t- /{file}
"))}"));
+
+
+
+
+ 532 fullTestMerge = await fullTestMergeTask;
+
+
+
+ 536 logger.LogWarning(
"Error retrieving metadata for test merge #{testMergeNumber}!", newTestMerge.Number);
-
- 539 fullTestMerge.TargetCommitSha = newTestMerge.TargetCommitSha;
-
- 541 await UpdateRevInfo(fullTestMerge);
-
-
-
-
- 546 var currentHead = repo.Head;
-
-
- 549 await repo.Synchronize(
- 550 NextProgressReporter(
"Synchronize"),
-
-
-
-
-
-
-
- 558 await UpdateRevInfo();
-
-
-
-
-
-
-
-
-
- 568 var secondStep = startReference !=
null && repo.Head != startSha;
-
-
- 571 await repo.CheckoutObject(
- 572 startReference ?? startSha,
-
-
-
-
- 577 progressReporter.
CreateSection($
"Checkout {startReference ?? startSha[..7]}", secondStep ? 0.5 : 1.0),
-
-
-
- 581 await repo.ResetToSha(startSha, progressReporter.
CreateSection($
"Hard reset to SHA {startSha[..7]}", 0.5),
default);
+
+
+
+ 541 BodyAtMerge = ex.Message,
+ 542 TitleAtMerge = ex.Message,
+ 543 Comment = newTestMerge.Comment,
+ 544 Number = newTestMerge.Number,
+
+
+
+
+
+ 550 fullTestMerge.TargetCommitSha = newTestMerge.TargetCommitSha;
+
+ 552 await UpdateRevInfo(fullTestMerge);
+
+
+
+
+ 557 var currentHead = repo.Head;
+
+
+ 560 using (var syncReporter = NextProgressReporter(
"Synchronize"))
+ 561 await repo.Synchronize(
+
+
+
+
+
+
+
+
+
+ 571 await UpdateRevInfo();
+
+
+
+
+
+
+
+
+
+ 581 var secondStep = startReference !=
null && repo.Head != startSha;
-
-
-
-
-
-
-
-
- 599 CancellationToken cancellationToken)
-
- 601 ArgumentNullException.ThrowIfNull(instance);
- 602 ArgumentNullException.ThrowIfNull(databaseContextFactory);
- 603 ArgumentNullException.ThrowIfNull(progressReporter);
-
- 605 progressReporter.StageName =
"Loading Old Repository";
-
-
- 608 string? oldReference;
-
- 610 ValueTask deleteTask;
- 611 using (var oldRepo = await instance.
RepositoryManager.LoadRepository(cancellationToken))
-
-
-
-
- 616 origin = oldRepo.Origin;
- 617 oldSha = oldRepo.Head;
- 618 oldReference = oldRepo.Reference;
-
-
+
+ 584 using (var checkoutReporter = progressReporter.
CreateSection($
"Checkout {startReference ?? startSha[..7]}", secondStep ? 0.5 : 1.0))
+ 585 await repo.CheckoutObject(
+ 586 startReference ?? startSha,
+
+
+
+
+
+
+
+
+ 595 using (var resetReporter = progressReporter.
CreateSection($
"Hard reset to SHA {startSha[..7]}", 0.5))
+ 596 await repo.ResetToSha(startSha, resetReporter,
default);
+
+
+
+
+
+
+
+
+
+ 614 CancellationToken cancellationToken)
+
+ 616 ArgumentNullException.ThrowIfNull(instance);
+ 617 ArgumentNullException.ThrowIfNull(databaseContextFactory);
+ 618 ArgumentNullException.ThrowIfNull(progressReporter);
+
+ 620 progressReporter.StageName =
"Loading Old Repository";
- 622 progressReporter.StageName =
"Deleting Old Repository";
-
-
-
-
-
-
-
-
-
-
-
-
-
- 636 progressReporter.
CreateSection(
"Cloning New Repository", 0.8),
-
-
- 639 ??
throw new JobException(
"A race condition occurred while recloning the repository. Somehow, it was fully cloned instantly after being deleted!");
-
-
-
- 643 logger.LogWarning(
"Reclone failed, clearing credentials!");
+
+ 623 string? oldReference;
+
+ 625 ValueTask deleteTask;
+ 626 using (var deleteReporter = progressReporter.
CreateSection(
"Deleting Old Repository", 0.1))
+
+ 628 using (var oldRepo = await instance.
RepositoryManager.LoadRepository(cancellationToken))
+
+
+
+
+ 633 origin = oldRepo.Origin;
+ 634 oldSha = oldRepo.Head;
+ 635 oldReference = oldRepo.Reference;
+
+
+
+
+
+
+
+
-
-
-
-
- 649 currentModel.AccessUser =
null;
- 650 currentModel.AccessToken =
null;
- 651 return context.Save(CancellationToken.None);
-
-
-
-
-
-
-
-
-
-
-
- 663 oldReference !=
null,
- 664 progressReporter.
CreateSection(
"Checking out previous Detached Commit", 0.1),
-
-
-
-
+
+
+
+ 648 using var cloneReporter = progressReporter.
CreateSection(
"Cloning New Repository", 0.8);
+
+
+
+
+
+
+
+
+ 657 ??
throw new JobException(
"A race condition occurred while recloning the repository. Somehow, it was fully cloned instantly after being deleted!");
+
+
+
+ 661 logger.LogWarning(
"Reclone failed, clearing credentials!");
+
+
+
+
+
+ 667 currentModel.AccessUser =
null;
+ 668 currentModel.AccessToken =
null;
+ 669 return context.Save(CancellationToken.None);
+
+
+
+
+
+
+ 676 using (var checkoutReporter = progressReporter.
CreateSection(
"Checking out previous Detached Commit", 0.1))
+
+
+
+
+
+
+ 683 oldReference !=
null,
+
+
+
+
+
+
virtual ? long Id
The ID of the entity.
Service for performing the complex Job of updating the repository on user request.
RepositoryUpdateService(RepositorySettings currentModel, User initiatingUser, ILogger< RepositoryUpdateService > logger, long instanceId)
Initializes a new instance of the RepositoryUpdateService class.
readonly ILogger< RepositoryUpdateService > logger
The ILogger<TCategoryName> for the RepositoryUpdateService.
async ValueTask RepositoryRecloneJob(IInstanceCore? instance, IDatabaseContextFactory databaseContextFactory, JobProgressReporter progressReporter, CancellationToken cancellationToken)
The job entrypoint used by Controllers.RepositoryController to reclone a repository.
async ValueTask RepositoryRecloneJob(IInstanceCore? instance, IDatabaseContextFactory databaseContextFactory, JobProgressReporter progressReporter, CancellationToken cancellationToken)
The job entrypoint used by Controllers.RepositoryController to reclone a repository.
readonly long instanceId
The EntityId.Id of the associated Instance.
readonly RepositorySettings currentModel
The current RepositorySettings for the RepositoryUpdateService.
async ValueTask RepositoryUpdateJob(RepositoryUpdateRequest model, IInstanceCore? instance, IDatabaseContextFactory databaseContextFactory, JobProgressReporter progressReporter, CancellationToken cancellationToken)
The job entrypoint used by Controllers.RepositoryController to update the repository's current HEAD.
readonly User initiatingUser
The User that initiated the repository update.
static async ValueTask< bool > LoadRevisionInformation(IRepository repository, IDatabaseContext databaseContext, ILogger logger, Models.Instance instance, string? lastOriginCommitSha, Action< Models.RevisionInformation >? revInfoSink, CancellationToken cancellationToken)
Load the RevisionInformation for the current repository state into a given databaseContext .
Represents the result of a repository test merge attempt.
MergeStatus Status
The resulting MergeStatus.
Operation exceptions thrown from the context of a Models.Job.
Progress reporter for a Job.
JobProgressReporter CreateSection(string? newStageName, double percentage)
Create a subsection of the JobProgressReporter with its optional own stage name.
void ReportProgress(double? progress)
Report progress.
Progress reporter for a Job.
JobProgressReporter CreateSection(string? newStageName, double percentage)
Create a subsection of the JobProgressReporter with its optional own stage name.
void ReportProgress(double? progress)
Report progress.
Represents an Api.Models.Instance in the database.
Many to many relationship for Models.RevisionInformation and Models.TestMerge.
Represents an on-disk git repository.
Task< DateTimeOffset > TimestampCommit(string sha, CancellationToken cancellationToken)
Gets the DateTimeOffset a given sha was created on.
string Head
The SHA of the IRepository HEAD.
ValueTask CheckoutObject(string committish, string? username, string? password, bool updateSubmodules, bool moveCurrentReference, JobProgressReporter? progressReporter, CancellationToken cancellationToken)
Checks out a given committish .
ValueTask CheckoutObject(string committish, string? username, string? password, bool updateSubmodules, bool moveCurrentReference, JobProgressReporter progressReporter, CancellationToken cancellationToken)
Checks out a given committish .
IEnumerable< TModel > Local
An IEnumerable<T> of TModel s prioritizing in the working set.
void Add(TModel model)
Add a given model to the the working set.
Factory for scoping usage of IDatabaseContexts. Meant for use by Components.
readonly IEventConsumer eventConsumer
The IEventConsumer for the SessionController.
BridgeResponse BridgeError(string message)
Log and return a BridgeResponse for a given message .
bool released
If process should be kept alive instead.
long MemoryUsage
Gets the process' memory usage in bytes.
readonly IChatManager chat
The IChatManager for the SessionController.
readonly IChatTrackingContext chatTrackingContext
The IChatTrackingContext for the SessionController.
Task< int?> Lifetime
The Task<TResult> resulting in the exit code of the process or null if the process was detached.
string GenerateQueryString(TopicParameters parameters, out string json)
Generates a Byond.TopicSender.ITopicClient query string for a given set of parameters .
void CheckDisposed()
Throws an ObjectDisposedException if DisposeAsync has been called.
readonly? IBridgeRegistration bridgeRegistration
The IBridgeRegistration for the SessionController.
long? MemoryUsage
Gets the process' memory usage in bytes.
async Task< LaunchResult > GetLaunchResult(IAssemblyInformationProvider assemblyInformationProvider, IAsyncDelayer asyncDelayer, uint? startupTimeout, bool reattached, bool apiValidate)
The Task<TResult> for LaunchResult.
IAsyncDisposable ReplaceDmbProvider(IDmbProvider dmbProvider)
Replace the IDmbProvider in use with a given newProvider , disposing the old one. An IAsyncDisposable...
Task OnStartup
A Task that completes when the server calls /world/TgsNew().
void SuspendProcess()
Suspends the process.
void ResumeProcess()
Resumes the process.
void AdjustPriority(bool higher)
Set's the owned global::System.Diagnostics.Process.PriorityClass to a non-normal value.
long MemoryUsage
Gets the process' memory usage in bytes.
long? MemoryUsage
Gets the process' memory usage in bytes.
ValueTask CreateDump(string outputFile, bool minidump, CancellationToken cancellationToken)
Create a dump file of the process.
Task< int?> Lifetime
The Task<TResult> resulting in the exit code of the process or null if the process was detached.
Abstraction over a global::System.Diagnostics.Process.
async ValueTask DeploymentProcess(Models.Job job, IDatabaseContextFactory databaseContextFactory, JobProgressReporter progressReporter, CancellationToken cancellationToken)
Task StopAsync(CancellationToken cancellationToken)
async Task StartAsync(CancellationToken cancellationToken)
async Task StartAsync(CancellationToken cancellationToken)
Task? timerTask
The auto update Task.
async ValueTask< IRepository?> LoadRepository(CancellationToken cancellationToken)
Attempt to load the IRepository from the default location. A ValueTask<TResult> resulting in the load...
Operation exceptions thrown from the context of a Models.Job.
Progress reporter for a Job.
JobProgressReporter CreateSection(string? newStageName, double percentage)
Create a subsection of the JobProgressReporter with its optional own stage name.
Progress reporter for a Job.
JobProgressReporter CreateSection(string? newStageName, double percentage)
Create a subsection of the JobProgressReporter with its optional own stage name.
Represents an Api.Models.Instance in the database.
static Job Create(JobCode code, User? startedBy, Api.Models.Instance instance)
Creates a new job for registering in the Jobs.IJobService.
Interface for using filesystems.
Manages the runtime of Jobs.
ValueTask RegisterOperation(Job job, JobEntrypoint operation, CancellationToken cancellationToken)
Registers a given Job and begins running it.
long MemoryUsage
Gets the process' memory usage in bytes.
long? MemoryUsage
Gets the process' memory usage in bytes.
For waiting asynchronously.
IIOManager IOManager
Gets the IIOManager for the EngineInstallerBase.
ILogger< EngineInstallerBase > Logger
Gets the ILogger for the EngineInstallerBase.
Implementation of IEngineInstaller for EngineType.OpenDream.
void GetExecutablePaths(string installationPath, out string serverExePath, out string compilerExePath)
Gets the paths to the server and client executables.
void GetExecutablePaths(string installationPath, out string serverExePath, out string compilerExePath)
Gets the paths to the server and client executables.
readonly IAbstractHttpClientFactory httpClientFactory
The IAbstractHttpClientFactory for the OpenDreamInstaller.
readonly IPlatformIdentifier platformIdentifier
The IPlatformIdentifier for the OpenDreamInstaller.
readonly IRepositoryManager repositoryManager
The IRepositoryManager for the OpenDream repository.
-
+
-
-
-
-
-
-
-
-
-
-
-
-
-
-
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
@@ -118,8 +119,8 @@ Inheritance diagram for IDisposable:
-
-
+
+
[legend]
The documentation for this class was generated from the following file:
diff --git a/class_i_disposable__inherit__graph.map b/class_i_disposable__inherit__graph.map
index d57e917630..1f830840e3 100644
--- a/class_i_disposable__inherit__graph.map
+++ b/class_i_disposable__inherit__graph.map
@@ -1,5 +1,5 @@
diff --git a/class_i_disposable__inherit__graph.md5 b/class_i_disposable__inherit__graph.md5
index 561eae9030..e44c5fe0c8 100644
--- a/class_i_disposable__inherit__graph.md5
+++ b/class_i_disposable__inherit__graph.md5
@@ -1 +1 @@
-abef3f329d9f3c26a44d4f6b85d85bae
\ No newline at end of file
+f9513d293e740a99aa4da8b073898629
\ No newline at end of file
diff --git a/class_i_disposable__inherit__graph.png b/class_i_disposable__inherit__graph.png
index ea4dd5ac8da78bd748a97d2d4908ad3a54abc77f..ba9c2b1c800d876beb2cd49f262c6784a64813aa 100644
GIT binary patch
literal 306239
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
