documentation #1
46
README.md
46
README.md
@@ -22,62 +22,30 @@ configuration sections such as system data, interfaces, and VLANs.
|
|||||||
|
|
||||||
## Installation
|
## Installation
|
||||||
|
|
||||||
The package is distributed through a private Gitea Package Registry and from the
|
The package is distributed from the source repository. It is not published to
|
||||||
source repository. It is not published to PyPI.
|
PyPI yet.
|
||||||
|
|
||||||
**Requirements:** Python 3.10+
|
**Requirements:** Python 3.10+
|
||||||
|
|
||||||
### From Gitea Package Registry
|
### From GitHub Source
|
||||||
|
|
||||||
Install the package by pointing `pip` to the private registry:
|
|
||||||
|
|
||||||
```bash
|
|
||||||
pip install oxipy \
|
|
||||||
--index-url https://gitea.imbastark.ru/api/packages/Netbox/pypi/simple/
|
|
||||||
```
|
|
||||||
|
|
||||||
You can also configure the registry permanently in `pip.conf` or `pip.ini`:
|
|
||||||
|
|
||||||
```ini
|
|
||||||
# ~/.config/pip/pip.conf (Linux/macOS)
|
|
||||||
# %APPDATA%\pip\pip.ini (Windows)
|
|
||||||
|
|
||||||
[global]
|
|
||||||
extra-index-url = https://gitea.imbastark.ru/api/packages/Netbox/pypi/simple/
|
|
||||||
```
|
|
||||||
|
|
||||||
After that, install normally:
|
|
||||||
|
|
||||||
```bash
|
|
||||||
pip install oxipy
|
|
||||||
```
|
|
||||||
|
|
||||||
If the registry requires authentication, pass a token in the index URL:
|
|
||||||
|
|
||||||
```bash
|
|
||||||
pip install oxipy \
|
|
||||||
--index-url https://__token__:<your_token>@gitea.imbastark.ru/api/packages/Netbox/pypi/simple/
|
|
||||||
```
|
|
||||||
|
|
||||||
### From Gitea Source
|
|
||||||
|
|
||||||
Install directly from the repository:
|
Install directly from the repository:
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
pip install git+https://gitea.imbastark.ru/Netbox/oxipy.git
|
pip install git+https://github.com/sttarsky/oxipy.git
|
||||||
```
|
```
|
||||||
|
|
||||||
Install a specific tag or branch:
|
Install a specific tag or branch:
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
pip install git+https://gitea.imbastark.ru/Netbox/oxipy.git@v0.1.0
|
pip install git+https://github.com/sttarsky/oxipy.git@v0.1.0
|
||||||
pip install git+https://gitea.imbastark.ru/Netbox/oxipy.git@dev
|
pip install git+https://github.com/sttarsky/oxipy.git@dev
|
||||||
```
|
```
|
||||||
|
|
||||||
For local development:
|
For local development:
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
git clone https://gitea.imbastark.ru/Netbox/oxipy
|
git clone https://github.com/sttarsky/oxipy
|
||||||
cd oxipy
|
cd oxipy
|
||||||
pip install -e .
|
pip install -e .
|
||||||
```
|
```
|
||||||
|
|||||||
@@ -20,6 +20,9 @@ dependencies = [
|
|||||||
"ttp>=0.10.0",
|
"ttp>=0.10.0",
|
||||||
]
|
]
|
||||||
|
|
||||||
|
[project.urls]
|
||||||
|
Repository = "https://github.com/sttarsky/oxipy"
|
||||||
|
|
||||||
[tool.setuptools.packages.find]
|
[tool.setuptools.packages.find]
|
||||||
where = ["."]
|
where = ["."]
|
||||||
include = ["oxi*"]
|
include = ["oxi*"]
|
||||||
|
|||||||
Reference in New Issue
Block a user