Many resources are needed to download a project. Please understand that we have to compensate our server costs. Thank you in advance.
Project price only 1 $
You can buy this project and download/modify it how often you want.
io.github.bonigarcia.wdm.BrowserManager Maven / Gradle / Ivy
/*
* (C) Copyright 2015 Boni Garcia (http://bonigarcia.github.io/)
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*
*/
package io.github.bonigarcia.wdm;
import com.google.gson.*;
import com.google.gson.internal.LinkedTreeMap;
import org.apache.commons.codec.binary.Base64;
import org.jsoup.Jsoup;
import org.slf4j.Logger;
import org.w3c.dom.Document;
import org.w3c.dom.Element;
import org.w3c.dom.NodeList;
import org.xml.sax.InputSource;
import org.xml.sax.SAXException;
import javax.xml.parsers.DocumentBuilder;
import javax.xml.parsers.DocumentBuilderFactory;
import javax.xml.parsers.ParserConfigurationException;
import java.io.*;
import java.net.MalformedURLException;
import java.net.URL;
import java.util.*;
import java.util.function.Function;
import static io.github.bonigarcia.wdm.Architecture.X32;
import static io.github.bonigarcia.wdm.Architecture.X64;
import static io.github.bonigarcia.wdm.DriverVersion.LATEST;
import static io.github.bonigarcia.wdm.DriverVersion.NOT_SPECIFIED;
import static io.github.bonigarcia.wdm.OperativeSystem.*;
import static io.github.bonigarcia.wdm.WdmConfig.*;
import static java.lang.Integer.signum;
import static java.lang.Integer.valueOf;
import static java.lang.System.getProperty;
import static java.lang.System.getenv;
import static java.lang.invoke.MethodHandles.lookup;
import java.nio.file.Files;
import static java.util.Arrays.sort;
import static java.util.Collections.reverse;
import static java.util.Collections.reverseOrder;
import static java.util.concurrent.TimeUnit.SECONDS;
import java.util.stream.Collectors;
import static javax.xml.xpath.XPathConstants.NODESET;
import static javax.xml.xpath.XPathFactory.newInstance;
import static org.apache.commons.io.FileUtils.listFiles;
import static org.apache.commons.lang3.SystemUtils.*;
import static org.slf4j.LoggerFactory.getLogger;
/**
* Generic manager.
*
* @author Boni Garcia ([email protected] )
* @since 1.0.0
*/
public abstract class BrowserManager {
final Logger log = getLogger(lookup().lookupClass());
public static final String SLASH = "/";
protected abstract List getDrivers() throws IOException;
protected static BrowserManager instance;
protected String myOsName = defaultOsName();
protected boolean useBetaVersions = false;
protected boolean mirrorLog = false;
protected boolean isForcingCache = false;
protected boolean isForcingDownload = false;
protected List listVersions;
protected List driverName;
protected Architecture architecture;
protected WdmHttpClient httpClient;
protected Downloader downloader;
protected UrlFilter urlFilter;
protected URL driverUrl;
protected String versionToDownload;
protected String downloadedVersion;
protected String version;
protected String proxyValue;
protected String binaryPath;
protected String proxyUser;
protected String proxyPass;
protected String exportParameter;
protected String driverVersionKey;
protected String driverUrlKey;
protected String[] ignoredVersions;
private boolean usingTaobao;
private boolean usingNexus;
protected String getDriverVersion() {
return version == null ? getString(getDriverVersionKey()) : version;
}
protected URL getDriverUrl() {
return driverUrl == null ? getUrl(getDriverUrlKey()) : driverUrl;
}
protected String preDownload(String target, String version) {
log.trace("Pre-download. target={}, version={}", target, version);
return target;
}
protected File postDownload(File archive) throws IOException {
File target = archive;
List ls = Files.find(archive.getParentFile().toPath(),
Integer.MAX_VALUE,
(filePath, fileAttr) -> fileAttr.isRegularFile()).map(path->path.toFile()).collect(Collectors.toList());
for (File f : ls) {
if (isExecutable(f)) {
target = f;
log.trace("Found binary in post-download: {}", target);
break;
}
}
return target;
}
protected String getCurrentVersion(URL url, String driverName) {
if (usingNexus) {
String[] urlParts = url.getFile().split(SLASH);
if (urlParts.length > 1) {
return urlParts[urlParts.length - 2];
} else {
final String errorMessage = "Can't get current driver version from nexus. Bad nexus URL " + url.toString();
log.error(errorMessage);
throw new WebDriverManagerException(errorMessage);
}
} else {
return url.getFile().substring(url.getFile().indexOf(SLASH) + 1,
url.getFile().lastIndexOf(SLASH));
}
}
protected void manage(Architecture arch, String version) {
httpClient = new WdmHttpClient.Builder().proxy(proxyValue)
.proxyUser(proxyUser).proxyPass(proxyPass).build();
try (WdmHttpClient wdmHttpClient = httpClient) {
downloader = new Downloader(this, wdmHttpClient);
urlFilter = new UrlFilter();
if (isForcingDownload) {
downloader.forceDownload();
}
updateValuesWithConfig();
boolean getLatest = version == null || version.isEmpty()
|| version.equalsIgnoreCase(LATEST.name())
|| version.equalsIgnoreCase(NOT_SPECIFIED.name());
boolean cache = this.isForcingCache || getBoolean("wdm.forceCache")
|| !isNetAvailable();
log.trace(">> Managing {} arch={} version={} getLatest={} cache={}",
getDriverName(), arch, version, getLatest, cache);
String driverInCache = handleCache(arch, version,
getLatest, cache);
if (null != driverInCache) {
versionToDownload = version;
downloadedVersion = version;
log.debug("Driver for {} {} found in cache {}", getDriverName(),
versionToDownload, driverInCache);
exportDriver(getExportParameter(), driverInCache);
} else {
List candidateUrls = filterCandidateUrls(arch, version,
getLatest);
if (candidateUrls.isEmpty()) {
String versionStr = getLatest ? "(latest version)"
: version;
String errorMessage = getDriverName() + " " + versionStr
+ " for " + myOsName + arch.toString()
+ " not found in " + getDriverUrl();
log.error(errorMessage);
throw new WebDriverManagerException(errorMessage);
}
downloadCandidateUrls(candidateUrls);
}
} catch (Exception e) {
handleException(e, arch, version);
}
}
protected void updateValuesWithConfig() {
String wdmForceOs = getString("wdm.forceOs");
if (!wdmForceOs.equals("")) {
myOsName = wdmForceOs;
}
String wdmProxy = getString("wdm.proxy");
if (!wdmProxy.equals("")) {
proxyValue = wdmProxy;
}
String wdmProxyUser = getString("wdm.proxyUser");
if (!wdmProxyUser.equals("")) {
proxyUser = wdmProxyUser;
}
String wdmProxyPass = getString("wdm.proxyPass");
if (!wdmProxyPass.equals("")) {
proxyPass = wdmProxyPass;
}
if (getBoolean("wdm.useTaobaoMirror")) {
useTaobaoMirror();
}
}
protected void handleException(Exception e, Architecture arch,
String version) {
if (!isForcingCache) {
isForcingCache = true;
log.warn(
"There was an error managing {} {} ({}) ... trying again forcing to use cache",
getDriverName(), version, e.getMessage());
manage(arch, version);
} else {
throw new WebDriverManagerException(e);
}
}
protected void downloadCandidateUrls(List candidateUrls)
throws IOException, InterruptedException {
reverse(candidateUrls);
URL url = candidateUrls.iterator().next();
String export = candidateUrls.contains(url) ? getExportParameter()
: null;
downloader.download(url, versionToDownload, export, getDriverName());
downloadedVersion = versionToDownload;
}
protected List filterCandidateUrls(Architecture arch, String version,
boolean getLatest) throws IOException {
List urls = getDrivers();
List candidateUrls;
log.trace("All URLs: {}", urls);
boolean continueSearchingVersion;
do {
// Get the latest or concrete version
candidateUrls = getLatest ? getLatest(urls, getDriverName())
: getVersion(urls, getDriverName(), version);
log.trace("Candidate URLs: {}", candidateUrls);
if (versionToDownload == null
|| this.getClass().equals(EdgeDriverManager.class)) {
break;
}
// Filter by architecture and OS
candidateUrls = urlFilter.filterByOs(candidateUrls, myOsName);
candidateUrls = urlFilter.filterByArch(candidateUrls, arch);
// Extra round of filter phantomjs 2.5.0 in Linux
if (myOsName.equalsIgnoreCase("linux")
&& getDriverName().contains("phantomjs")) {
candidateUrls = urlFilter.filterByDistro(candidateUrls,
"2.5.0");
}
// Filter by ignored version
if (ignoredVersions != null) {
candidateUrls = urlFilter.filterByIgnoredVersions(candidateUrls,
ignoredVersions);
}
// Find out if driver version has been found or not
continueSearchingVersion = candidateUrls.isEmpty() && getLatest;
if (continueSearchingVersion) {
log.info(
"No binary found for {} {} ... seeking another version",
getDriverName(), versionToDownload);
urls = removeFromList(urls, versionToDownload);
versionToDownload = null;
}
} while (continueSearchingVersion);
return candidateUrls;
}
protected String handleCache(Architecture arch, String version,
boolean getLatest, boolean cache) {
String driverInCache = null;
if (cache) {
driverInCache = forceCache(downloader.getTargetPath());
} else if (!getLatest) {
versionToDownload = version;
driverInCache = existsDriverInCache(downloader.getTargetPath(),
version, arch);
}
return driverInCache;
}
protected String forceCache(String repository) {
String driverInCache;
for (String driver : getDriverName()) {
log.trace("Checking if {} exists in cache {}", driver, repository);
Collection listFiles = listFiles(new File(repository), null,
true);
Object[] array = listFiles.toArray();
sort(array, reverseOrder());
for (Object f : array) {
driverInCache = f.toString();
log.trace("Checking {}", driverInCache);
if (driverInCache.contains(driver)
&& isExecutable(new File(driverInCache))) {
log.info("Found {} in cache: {} ", driver, driverInCache);
return driverInCache;
}
}
}
return null;
}
protected String existsDriverInCache(String repository,
String driverVersion, Architecture arch) {
String driverInCache;
for (String driver : getDriverName()) {
log.trace("Checking if {} {} ({} bits) exists in cache {}", driver,
driverVersion, arch, repository);
Collection listFiles = listFiles(new File(repository), null,
true);
Object[] array = listFiles.toArray();
sort(array, reverseOrder());
for (Object f : array) {
driverInCache = f.toString();
boolean checkArchitecture = !shouldCheckArchitecture()
|| driverInCache.contains(arch.toString());
log.trace("Checking {}", driverInCache);
if (driverInCache.contains(driverVersion)
&& driverInCache.contains(driver) && checkArchitecture
&& isExecutable(new File(driverInCache))) {
log.debug("Found {} {} ({} bits) in cache: {}",
driverVersion, driver, arch, driverInCache);
return driverInCache;
}
}
}
return null;
}
protected boolean isExecutable(File file) {
return myOsName.equalsIgnoreCase("win")
? file.getName().toLowerCase().endsWith(".exe")
: file.canExecute();
}
protected boolean shouldCheckArchitecture() {
return true;
}
protected boolean isNetAvailable() {
try {
if (!httpClient.isValid(getDriverUrl())) {
log.warn("Page not available. Forcing the use of cache");
return false;
}
} catch (IOException e) {
log.warn("Network not available. Forcing the use of cache");
return false;
}
return true;
}
protected List removeFromList(List list, String version) {
List out = new ArrayList<>(list);
for (URL url : list) {
if (url.getFile().contains(version)) {
out.remove(url);
}
}
return out;
}
protected List getVersion(List list, List match,
String version) {
List out = new ArrayList<>();
if (getDriverName().contains("MicrosoftWebDriver") && !usingNexus) {
int i = listVersions.indexOf(version);
if (i != -1) {
out.add(list.get(i));
}
}
for (String s : match) {
reverse(list);
for (URL url : list) {
if (url.getFile().contains(s) && url.getFile().contains(version)
&& !url.getFile().contains("-symbols")) {
out.add(url);
}
}
}
versionToDownload = version;
log.debug("Using {} {}", match, version);
return out;
}
protected List getLatest(List list, List match) {
log.trace("Checking the lastest version of {} with URL list {}", match,
list);
List out = new ArrayList<>();
reverse(list);
List copyOfList = new ArrayList<>(list);
for (URL url : copyOfList) {
for (String driver : match) {
try {
handleDriver(url, driver, out);
} catch (Exception e) {
log.trace("There was a problem with URL {} : {}",
url.toString(), e.getMessage());
list.remove(url);
}
}
}
if (versionToDownload.startsWith(".")) {
versionToDownload = versionToDownload.substring(1);
}
log.info("Latest version of {} is {}", match, versionToDownload);
return out;
}
protected void handleDriver(URL url, String driver, List out) {
if (!useBetaVersions && !getBoolean("wdm.useBetaVersions")
&& url.getFile().toLowerCase().contains("beta")) {
return;
}
if (url.getFile().contains(driver)) {
String currentVersion = getCurrentVersion(url, driver);
if (currentVersion.equalsIgnoreCase(driver)) {
return;
}
if (versionToDownload == null) {
versionToDownload = currentVersion;
}
if (versionCompare(currentVersion, versionToDownload) > 0) {
versionToDownload = currentVersion;
out.clear();
}
if (url.getFile().contains(versionToDownload)) {
out.add(url);
}
}
}
protected boolean isUsingTaobaoMirror() {
return usingTaobao;
}
protected boolean isUsingNexus() {
return usingNexus;
}
protected Integer versionCompare(String str1, String str2) {
String[] vals1 = str1.replaceAll("v", "").split("\\.");
String[] vals2 = str2.replaceAll("v", "").split("\\.");
if (vals1[0].equals("")) {
vals1[0] = "0";
}
if (vals2[0].equals("")) {
vals2[0] = "0";
}
int i = 0;
while (i < vals1.length && i < vals2.length
&& vals1[i].equals(vals2[i])) {
i++;
}
if (i < vals1.length && i < vals2.length) {
return signum(valueOf(vals1[i]).compareTo(valueOf(vals2[i])));
} else {
return signum(vals1.length - vals2.length);
}
}
/**
* This method works also for http://npm.taobao.org/ and
* https://bitbucket.org/ mirrors.
*/
protected List getDriversFromMirror(URL driverUrl) throws IOException {
if (!mirrorLog) {
log.info("Crawling driver list from mirror {}", driverUrl);
mirrorLog = true;
} else {
log.trace("[Recursive call] Crawling driver list from mirror {}",
driverUrl);
}
String driverStr = driverUrl.toString().toLowerCase();
String driverUrlContent = driverUrl.getPath().toLowerCase();
int timeout = (int) SECONDS.toMillis(getInt("wdm.timeout"));
WdmHttpClient.Response response = httpClient
.execute(new WdmHttpClient.Get(driverStr, timeout));
try (InputStream in = response.getContent()) {
org.jsoup.nodes.Document doc = Jsoup.parse(in, null, "");
List urlList = new ArrayList<>();
for (org.jsoup.nodes.Element element : doc.select("a")) {
String link = element.attr("href").toLowerCase();
if (link.contains("mirror") && link.endsWith(SLASH)) {
urlList.addAll(getDriversFromMirror(new URL(
driverStr + link.replace(driverUrlContent, ""))));
} else if (link.startsWith(driverUrlContent)
&& !link.contains("icons")) {
urlList.add(new URL(
driverStr + link.replace(driverUrlContent, "")));
}
}
return urlList;
}
}
protected List getDriversFromJson(URL driverUrl, Function> parserFunction) throws IOException {
log.info("Crawling driver list from {}", driverUrl);
String driverStr = driverUrl.toString().toLowerCase();
int timeout = (int) SECONDS.toMillis(getInt("wdm.timeout"));
WdmHttpClient.Response response = httpClient
.execute(new WdmHttpClient.Get(driverStr, timeout));
List listUlrs = new ArrayList<>();
try (InputStream in = response.getContent()) {
JsonElement result = JsonParser.parseReader(new InputStreamReader(in));
listUlrs.addAll(parserFunction.apply(result));
}
return listUlrs;
}
protected List getDriversFromNexus(URL driverUrl) throws IOException {
if (!mirrorLog) {
log.info("Crawling driver list from nexus {}", driverUrl);
mirrorLog = true;
} else {
log.trace("[Recursive call] Crawling driver list from nexus {}",
driverUrl);
}
int timeout = (int) SECONDS.toMillis(getInt("wdm.timeout"));
WdmHttpClient.Response response = httpClient
.execute(new WdmHttpClient.Get(driverUrl.toString(), timeout));
try (InputStream in = response.getContent()) {
org.jsoup.nodes.Document doc = Jsoup.parse(in, null, "");
List urlList = new ArrayList<>();
for (org.jsoup.nodes.Element element : doc.select("a")) {
String link = element.attr("href").toLowerCase();
if (link.startsWith("http") && link.contains("nexus")) {
if (link.endsWith(SLASH)) {
urlList.addAll(getDriversFromNexus(new URL(link)));
} else if (link.endsWith(".bin") || link.endsWith(".jar")) {
urlList.add(new URL(link));
}
}
}
return urlList;
}
}
protected List getDriversFromXml(URL driverUrl) throws IOException {
log.info("Reading {} to seek {}", driverUrl, getDriverName());
List urls = new ArrayList<>();
WdmHttpClient.Response response = httpClient
.execute(new WdmHttpClient.Get(driverUrl));
try {
try (BufferedReader reader = new BufferedReader(
new InputStreamReader(response.getContent()))) {
Document xml = loadXML(reader);
NodeList nodes = (NodeList) newInstance().newXPath().evaluate(
"//Contents/Key", xml.getDocumentElement(), NODESET);
for (int i = 0; i < nodes.getLength(); ++i) {
Element e = (Element) nodes.item(i);
urls.add(new URL(driverUrl
+ e.getChildNodes().item(0).getNodeValue()));
}
}
} catch (Exception e) {
throw new WebDriverManagerException(e);
}
return urls;
}
protected Document loadXML(Reader reader)
throws SAXException, IOException, ParserConfigurationException {
DocumentBuilderFactory factory = DocumentBuilderFactory.newInstance();
DocumentBuilder builder = factory.newDocumentBuilder();
InputSource is = new InputSource(reader);
return builder.parse(is);
}
protected String defaultOsName() {
String os = getProperty("os.name").toLowerCase();
if (IS_OS_WINDOWS) {
os = WIN.name();
} else if (IS_OS_LINUX) {
os = LINUX.name();
} else if (IS_OS_MAC) {
os = MAC.name();
}
return os;
}
protected void exportDriver(String variableName, String variableValue) {
log.info("Exporting {} as {}", variableName, variableValue);
binaryPath = variableValue;
System.setProperty(variableName, variableValue);
}
protected InputStream openGitHubConnection(URL driverUrl)
throws IOException {
WdmHttpClient.Get get = new WdmHttpClient.Get(driverUrl)
.addHeader("User-Agent", "Mozilla/5.0")
.addHeader("Connection", "keep-alive");
String gitHubTokenName = WdmConfig.getString("wdm.gitHubTokenName");
gitHubTokenName = isNullOrEmpty(gitHubTokenName)
? getenv("WDM_GIT_HUB_TOKEN_NAME")
: gitHubTokenName;
String gitHubTokenSecret = WdmConfig.getString("wdm.gitHubTokenSecret");
gitHubTokenSecret = isNullOrEmpty(gitHubTokenSecret)
? getenv("WDM_GIT_HUB_TOKEN_SECRET")
: gitHubTokenSecret;
if (!isNullOrEmpty(gitHubTokenName)
&& !isNullOrEmpty(gitHubTokenSecret)) {
String userpass = gitHubTokenName + ":" + gitHubTokenSecret;
String basicAuth = "Basic "
+ new String(new Base64().encode(userpass.getBytes()));
get.addHeader("Authorization", basicAuth);
}
return httpClient.execute(get).getContent();
}
protected Architecture getDefaultArchitecture() {
if (architecture == null) {
String archStr = getString("wdm.architecture");
if (archStr.equals("")) {
archStr = getProperty("sun.arch.data.model");
}
architecture = Architecture.valueOf("X" + archStr);
}
return architecture;
}
protected List getDriversFromGitHub() throws IOException {
List urls;
if (isUsingTaobaoMirror()) {
urls = getDriversFromMirror(getDriverUrl());
} else {
String driverVersion = versionToDownload;
try (BufferedReader reader = new BufferedReader(
new InputStreamReader(
openGitHubConnection(getDriverUrl())))) {
GsonBuilder gsonBuilder = new GsonBuilder();
Gson gson = gsonBuilder.create();
GitHubApi[] releaseArray = gson.fromJson(reader,
GitHubApi[].class);
if (driverVersion != null) {
releaseArray = new GitHubApi[]{
getVersion(releaseArray, driverVersion)};
}
urls = new ArrayList<>();
for (GitHubApi release : releaseArray) {
if (release != null) {
List> assets = release
.getAssets();
for (LinkedTreeMap asset : assets) {
urls.add(new URL(asset.get("browser_download_url")
.toString()));
}
}
}
}
}
return urls;
}
protected GitHubApi getVersion(GitHubApi[] releaseArray, String version) {
GitHubApi out = null;
for (GitHubApi release : releaseArray) {
log.trace("Get version {} of {}", version, release);
if ((release.getName() != null
&& release.getName().contains(version))
|| (release.getTagName() != null
&& release.getTagName().contains(version))) {
out = release;
break;
}
}
return out;
}
protected String getExportParameter() {
return exportParameter;
}
protected String getDriverVersionKey() {
return driverVersionKey;
}
protected String getDriverUrlKey() {
return driverUrlKey;
}
protected List getDriverName() {
return driverName;
}
protected void reset() {
myOsName = defaultOsName();
useBetaVersions = false;
mirrorLog = false;
isForcingCache = false;
isForcingDownload = false;
usingNexus = false;
usingTaobao = false;
listVersions = null;
architecture = null;
driverUrl = null;
version = null;
versionToDownload = null;
proxyValue = null;
proxyUser = null;
proxyPass = null;
ignoredVersions = null;
}
public synchronized void setup() {
String driverVersion = getDriverVersion();
if (!driverVersion.equals("")) {
manage(getDefaultArchitecture(),
isNullOrEmpty(driverVersion) ? NOT_SPECIFIED.name()
: driverVersion);
reset();
}
}
public String getDownloadedVersion() {
return downloadedVersion;
}
public BrowserManager version(String version) {
this.version = version;
return this;
}
public BrowserManager architecture(Architecture architecture) {
this.architecture = architecture;
return this;
}
public BrowserManager arch32() {
architecture(X32);
return this;
}
public BrowserManager arch64() {
architecture(X64);
return this;
}
public BrowserManager forceCache() {
this.isForcingCache = true;
return this;
}
public BrowserManager forceDownload() {
this.isForcingDownload = true;
return this;
}
public BrowserManager driverRepositoryUrl(URL url) {
this.driverUrl = url;
return this;
}
public BrowserManager useTaobaoMirror() {
String errorMessage = "Binaries for " + getDriverName()
+ " not available in taobao.org mirror (http://npm.taobao.org/mirrors/)";
log.error(errorMessage);
throw new WebDriverManagerException(errorMessage);
}
public BrowserManager useTaobaoMirror(String taobaoUrl) {
usingTaobao = true;
driverUrl = getUrl(taobaoUrl);
return instance;
}
public BrowserManager useNexus() {
String errorMessage = "Binaries for " + getDriverName()
+ " not available in nexus";
log.error(errorMessage);
throw new WebDriverManagerException(errorMessage);
}
public BrowserManager useNexus(String nexusUrl) {
usingNexus = true;
try {
driverUrl = new URL(nexusUrl);
}catch (MalformedURLException e) {
throw new WebDriverManagerException(e);
}
return instance;
}
public BrowserManager proxy(String proxy) {
this.proxyValue = proxy;
return this;
}
public BrowserManager proxyUser(String proxyUser) {
this.proxyUser = proxyUser;
return this;
}
public BrowserManager proxyPass(String proxyPass) {
this.proxyPass = proxyPass;
return this;
}
public String getBinaryPath() {
return binaryPath;
}
public BrowserManager useBetaVersions() {
this.useBetaVersions = true;
return this;
}
public BrowserManager ignoreVersions(String... versions) {
this.ignoredVersions = versions;
return this;
}
public BrowserManager forceOperativeSystem(
OperativeSystem operativeSystem) {
this.myOsName = operativeSystem.name();
return this;
}
}
