Metadata-Version: 2.4
Name: xmipp3-installer
Version: 2.1.0
Summary: Package to handle the installation of Xmipp3
Author-email: Martín Salinas <ssalinasmartin@gmail.com>
License: GPL-3.0-only
Project-URL: Homepage, https://github.com/I2PC/xmipp3-installer
Project-URL: Issues, https://github.com/I2PC/xmipp3-installer/issues
Keywords: xmipp3,installer
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Operating System :: POSIX :: Linux
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE.txt
Requires-Dist: typing-extensions>=4.12
Requires-Dist: distro>=1.8.0
Provides-Extra: test
Requires-Dist: pytest==8.*; python_version < "3.10" and extra == "test"
Requires-Dist: pytest==9.*; python_version >= "3.10" and extra == "test"
Requires-Dist: pytest-cov==5.*; python_version < "3.9" and extra == "test"
Requires-Dist: pytest-cov==7.*; python_version >= "3.9" and extra == "test"
Requires-Dist: pytest-subprocess==1.*; extra == "test"
Requires-Dist: pytest-localserver==0.*; extra == "test"
Requires-Dist: ruff==0.*; extra == "test"
Requires-Dist: cmake==4.*; extra == "test"
Requires-Dist: ninja==1.*; extra == "test"
Dynamic: license-file

# xmipp3-installer
Python package that handles the installation of [xmipp3](https://github.com/I2PC/xmipp3).

## Installation
To install the package, simply run:
```
pip install xmipp3-installer
```

## Usage
This package has a CLI built-in, with help messages that explain how to use it.
To run such help, once the package is installed, run:
```
xmipp3_installer -h
```

## Installation telemetry
This installer collects **basic information about your installation environment** (such as library versions, system architecture, and operating system) to improve compatibility, performance, and stability.

If you prefer **not to send this data**, you can disable data collection by simply setting the environment variable `XMIPP3_SEND_INSTALLATION_STATISTICS=OFF` before running the installation command.

For more information, please visit [the documentation](https://i2pc.github.io/docs/Others/Enhancing/index.html#data-collection).

## Testing the code
In order to run the tests for this project, the project needs to be installed in development mode and also the test dependencies need to be installed.

To do that, you need to clone this project, move inside the repository's folder, and run:
```
pip install -e .[test]
```
Once the dependencies have been installed, the automatic tests for this package can be run using `./scripts/run-tests.sh` in bash, or `.\scripts\run-tests.ps1` in PowerShell.
If you intend to run this tests from within VSCode, you will need extension `Test Adapter Converter`, and a local `.vscode` folder with a file named `settings.json` inside with the following content:
```json
{
  "python.testing.pytestArgs": [
    ".",
    "--capture=no"
  ],
  "python.testing.unittestEnabled": false,
  "python.testing.pytestEnabled": true
}
```

## SonarQube status
[![Quality Gate Status](https://sonarcloud.io/api/project_badges/measure?project=I2PC_xmipp3-installer&metric=alert_status)](https://sonarcloud.io/summary/new_code?id=I2PC_xmipp3-installer)

### Ratings
[![Maintainability Rating](https://sonarcloud.io/api/project_badges/measure?project=I2PC_xmipp3-installer&metric=sqale_rating)](https://sonarcloud.io/summary/new_code?id=I2PC_xmipp3-installer)
[![Reliability Rating](https://sonarcloud.io/api/project_badges/measure?project=I2PC_xmipp3-installer&metric=reliability_rating)](https://sonarcloud.io/summary/new_code?id=I2PC_xmipp3-installer)
[![Security Rating](https://sonarcloud.io/api/project_badges/measure?project=I2PC_xmipp3-installer&metric=security_rating)](https://sonarcloud.io/summary/new_code?id=I2PC_xmipp3-installer)

### Specific metrics
[![Bugs](https://sonarcloud.io/api/project_badges/measure?project=I2PC_xmipp3-installer&metric=bugs)](https://sonarcloud.io/summary/new_code?id=I2PC_xmipp3-installer)
[![Code Smells](https://sonarcloud.io/api/project_badges/measure?project=I2PC_xmipp3-installer&metric=code_smells)](https://sonarcloud.io/summary/new_code?id=I2PC_xmipp3-installer)
[![Vulnerabilities](https://sonarcloud.io/api/project_badges/measure?project=I2PC_xmipp3-installer&metric=vulnerabilities)](https://sonarcloud.io/summary/new_code?id=I2PC_xmipp3-installer)
[![Coverage](https://sonarcloud.io/api/project_badges/measure?project=I2PC_xmipp3-installer&metric=coverage)](https://sonarcloud.io/summary/new_code?id=I2PC_xmipp3-installer)
[![Duplicated Lines (%)](https://sonarcloud.io/api/project_badges/measure?project=I2PC_xmipp3-installer&metric=duplicated_lines_density)](https://sonarcloud.io/summary/new_code?id=I2PC_xmipp3-installer)
[![Lines of Code](https://sonarcloud.io/api/project_badges/measure?project=I2PC_xmipp3-installer&metric=ncloc)](https://sonarcloud.io/summary/new_code?id=I2PC_xmipp3-installer)
[![Technical Debt](https://sonarcloud.io/api/project_badges/measure?project=I2PC_xmipp3-installer&metric=sqale_index)](https://sonarcloud.io/summary/new_code?id=I2PC_xmipp3-installer)
