Package: neofs-testlib
neofs-testlibThis library provides building blocks and utilities to facilitate development of automated tests for NeoFS system.InstallationLibrary can be installed via pip:$pipinstallneofs-testlibConfigurationSome library components support configuration that allows dynamic loading of extensions via plugins. Configuration of such components is described in this section.Reporter ConfigurationReporter is a singleton component that is used by the library to store test artifacts.Reporter sends artifacts to handlers that are responsible for actual storing in particular system. By default reporter is initialized without any handlers and won't take any actions to store the artifacts. To add handlers directly via code you can use methodregister_handler:fromneofs_testlib.reporterimportAllureHandler,get_reporterget_reporter().register_handler(AllureHandler())This registration should happen early at the test session, because any artifacts produced before handler is registered won't be stored anywhere.Alternative approach for registering handlers is to use methodconfigure. It is similar to methoddictConfigin a sense that it receives a config structure that describes handlers that should be registered in the reporter. Each handler is defined by it's plugin name; for example, to register the built-in Allure handler, we can use the following config:get_reporter().configure({"handlers":[{"plugin_name":"allure"}]})Hosting ConfigurationHosting component is a class that represents infrastructure (machines/containers/services) where neoFS is hosted. Interaction with specific infrastructure instance (host) is encapsulated in classes that implement interfaceneofs_testlib.hosting.Host. To pass information about hosts to theHostingclass in runtime we use methodconfigure:fromneofs_testlib.hostingimportHostinghosting=Hosting()hosting.configure({"hosts":[{"address":"localhost","plugin_name":"docker"...}]})PluginsTestlib usesentrypoint specificationfor plugins. Testlib supports the following entrypoint groups for plugins:neofs.testlib.reporter- group for reporter handler plugins. Plugin should be a class that implements interfaceneofs_testlib.reporter.interfaces.ReporterHandler.Example reporter pluginIn this example we will consider two Python projects:Project "my_neofs_plugins" where we will build a plugin that extends testlib functionality.Project "my_neofs_tests" that uses "neofs_testlib" and "my_neofs_plugins" to build some tests.Let's say we want to implement some custom reporter handler that can be used as a plugin for testlib. Pseudo-code of implementation can look like that:# File my_neofs_plugins/src/foo/bar/custom_handler.pyfromcontextlibimportAbstractContextManagerfromneofs_testlib.reporterimportReporterHandlerclassCustomHandler(ReporterHandler):defstep(self,name:str)->AbstractContextManager:...someimplementation...defattach(self,content:Any,file_name:str)->None:...someimplementation...Then in the filepyproject.tomlof "my_neofs_plugins" we should register entrypoint for this plugin. Entrypoint must belong to the groupneofs.testlib.reporter:# File my_neofs_plugins/pyproject.toml[project.entry-points."neofs.testlib.reporter"]my_custom_handler = "foo.bar.custom_handler:CustomHandler"Finally, to use this handler in our test project "my_neofs_tests", we should configure reporter with name of the handler plugin:# File my_neofs_tests/src/conftest.pyfromneofs_testlib.reporterimportget_reporterget_reporter().configure({"handlers":[{"plugin_name":"my_custom_handler"}]})Detailed information about registering entrypoints can be found atsetuptools docs.Library structureThe library provides the following primary components:blockchain- Contains helpers that allow to interact with neo blockchain, smart contracts, gas transfers, etc.cli- wrappers on top of neoFS command-line tools. These wrappers execute on a shell and provide type-safe interface for interacting with the tools.hosting- management of infrastructure (docker, virtual machines, services where neoFS is hosted). The library provides host implementation for docker environment (when neoFS services are running as docker containers). Support for other hosts is provided via plugins.reporter- abstraction on top of test reporting tool like Allure. Components of the library will report their steps and attach artifacts to the configured reporter instance.shell- shells that can be used to execute commands. Currently library provides local shell (on machine that runs the code) or SSH shell that connects to a remote machine via SSH.utils- Support functions.ContributingAny contributions to the library should conform to thecontribution guideline.