path: root/python-darwin-py.spec

%global _empty_manifest_terminate_build 0
Name:		python-darwin-py
Version:	0.8.27
Release:	1
Summary:	Library and command line interface for darwin.v7labs.com
License:	MIT
URL:		https://docs.v7labs.com/reference/getting-started-2
Source0:	https://mirrors.aliyun.com/pypi/web/packages/bf/dc/d60340ee4c9f611d68ffa869ddbc3b3f0838fe5b5cd69a87eda0db23f7f2/darwin_py-0.8.27.tar.gz
BuildArch:	noarch

Requires:	python3-argcomplete
Requires:	python3-humanize
Requires:	python3-pillow
Requires:	python3-pyyaml
Requires:	python3-requests
Requires:	python3-rich
Requires:	python3-upolygon
Requires:	python3-jsonschema
Requires:	python3-deprecation
Requires:	python3-pydantic
Requires:	python3-orjson
Requires:	python3-numpy
Requires:	python3-toml
Requires:	python3-tqdm
Requires:	python3-types-pyyaml
Requires:	python3-dataclasses
Requires:	python3-nibabel
Requires:	python3-connected-components-3d
Requires:	python3-scikit-learn
Requires:	python3-torch
Requires:	python3-torchvision
Requires:	python3-black
Requires:	python3-isort
Requires:	python3-flake8
Requires:	python3-mypy
Requires:	python3-responses
Requires:	python3-pytest
Requires:	python3-pytest-describe
Requires:	python3-flake8-pyproject
Requires:	python3-debugpy
Requires:	python3-types-requests
Requires:	python3-mpire

%description
## Usage as a Command Line Interface (CLI)
Once installed, `darwin` is accessible as a command line tool.
A useful way to navigate the CLI usage is through the help command `-h/--help` which will
provide additional information for each command available.
### Client Authentication
To perform remote operations on Darwin you first need to authenticate.
This requires a [team-specific API-key](https://darwin.v7labs.com/?settings=api-keys).
If you do not already have a Darwin account, you can [contact us](https://www.v7labs.com/contact) and we can set one up for you.
To start the authentication process:
```
$ darwin authenticate
API key:
Make example-team the default team? [y/N] y
Datasets directory [~/.darwin/datasets]:
Authentication succeeded.
```
You will be then prompted to enter your API-key, whether you want to set the corresponding team as
default and finally the desired location on the local file system for the datasets of that team.
This process will create a configuration file at `~/.darwin/config.yaml`.
This file will be updated with future authentications for different teams.
### Listing local and remote datasets
Lists a summary of local existing datasets
```
$ darwin dataset local
NAME            IMAGES     SYNC_DATE         SIZE
mydataset       112025     yesterday     159.2 GB
```
Lists a summary of remote datasets accessible by the current user.
```
$ darwin dataset remote
NAME                       IMAGES     PROGRESS
example-team/mydataset     112025        73.0%
```
### Create/remove a dataset
To create an empty dataset remotely:
```
$ darwin dataset create test
Dataset 'test' (example-team/test) has been created.
Access at https://darwin.v7labs.com/datasets/579
```
The dataset will be created in the team you're authenticated for.
To delete the project on the server:
```
$ darwin dataset remove test
About to delete example-team/test on darwin.
Do you want to continue? [y/N] y
```
### Upload/download data to/from a remote dataset
Uploads data to an existing remote project.
It takes the dataset name and a single image (or directory) with images/videos to upload as
parameters.
The `-e/--exclude` argument allows to indicate file extension/s to be ignored from the data_dir.
e.g.: `-e .jpg`
For videos, the frame rate extraction rate can be specified by adding `--fps <frame_rate>`
Supported extensions:
- Video files: [`.mp4`, `.bpm`, `.mov` formats].
- Image files [`.jpg`, `.jpeg`, `.png` formats].
```
$ darwin dataset push test /path/to/folder/with/images
100%|████████████████████████| 2/2 [00:01<00:00,  1.27it/s]
```
Before a dataset can be downloaded, a release needs to be generated:
```
$ darwin dataset export test 0.1
Dataset test successfully exported to example-team/test:0.1
```
This version is immutable, if new images / annotations have been added you will have to create a new release to included them.
To list all available releases
```
$ darwin dataset releases test
NAME                           IMAGES     CLASSES                   EXPORT_DATE
example-team/test:0.1               4           0     2019-12-07 11:37:35+00:00
```
And to finally download a release.
```
$ darwin dataset pull test:0.1
Dataset example-team/test:0.1 downloaded at /directory/choosen/at/authentication/time.

%package -n python3-darwin-py
Summary:	Library and command line interface for darwin.v7labs.com
Provides:	python-darwin-py
BuildRequires:	python3-devel
BuildRequires:	python3-setuptools
BuildRequires:	python3-pip
%description -n python3-darwin-py
## Usage as a Command Line Interface (CLI)
Once installed, `darwin` is accessible as a command line tool.
A useful way to navigate the CLI usage is through the help command `-h/--help` which will
provide additional information for each command available.
### Client Authentication
To perform remote operations on Darwin you first need to authenticate.
This requires a [team-specific API-key](https://darwin.v7labs.com/?settings=api-keys).
If you do not already have a Darwin account, you can [contact us](https://www.v7labs.com/contact) and we can set one up for you.
To start the authentication process:
```
$ darwin authenticate
API key:
Make example-team the default team? [y/N] y
Datasets directory [~/.darwin/datasets]:
Authentication succeeded.
```
You will be then prompted to enter your API-key, whether you want to set the corresponding team as
default and finally the desired location on the local file system for the datasets of that team.
This process will create a configuration file at `~/.darwin/config.yaml`.
This file will be updated with future authentications for different teams.
### Listing local and remote datasets
Lists a summary of local existing datasets
```
$ darwin dataset local
NAME            IMAGES     SYNC_DATE         SIZE
mydataset       112025     yesterday     159.2 GB
```
Lists a summary of remote datasets accessible by the current user.
```
$ darwin dataset remote
NAME                       IMAGES     PROGRESS
example-team/mydataset     112025        73.0%
```
### Create/remove a dataset
To create an empty dataset remotely:
```
$ darwin dataset create test
Dataset 'test' (example-team/test) has been created.
Access at https://darwin.v7labs.com/datasets/579
```
The dataset will be created in the team you're authenticated for.
To delete the project on the server:
```
$ darwin dataset remove test
About to delete example-team/test on darwin.
Do you want to continue? [y/N] y
```
### Upload/download data to/from a remote dataset
Uploads data to an existing remote project.
It takes the dataset name and a single image (or directory) with images/videos to upload as
parameters.
The `-e/--exclude` argument allows to indicate file extension/s to be ignored from the data_dir.
e.g.: `-e .jpg`
For videos, the frame rate extraction rate can be specified by adding `--fps <frame_rate>`
Supported extensions:
- Video files: [`.mp4`, `.bpm`, `.mov` formats].
- Image files [`.jpg`, `.jpeg`, `.png` formats].
```
$ darwin dataset push test /path/to/folder/with/images
100%|████████████████████████| 2/2 [00:01<00:00,  1.27it/s]
```
Before a dataset can be downloaded, a release needs to be generated:
```
$ darwin dataset export test 0.1
Dataset test successfully exported to example-team/test:0.1
```
This version is immutable, if new images / annotations have been added you will have to create a new release to included them.
To list all available releases
```
$ darwin dataset releases test
NAME                           IMAGES     CLASSES                   EXPORT_DATE
example-team/test:0.1               4           0     2019-12-07 11:37:35+00:00
```
And to finally download a release.
```
$ darwin dataset pull test:0.1
Dataset example-team/test:0.1 downloaded at /directory/choosen/at/authentication/time.

%package help
Summary:	Development documents and examples for darwin-py
Provides:	python3-darwin-py-doc
%description help
## Usage as a Command Line Interface (CLI)
Once installed, `darwin` is accessible as a command line tool.
A useful way to navigate the CLI usage is through the help command `-h/--help` which will
provide additional information for each command available.
### Client Authentication
To perform remote operations on Darwin you first need to authenticate.
This requires a [team-specific API-key](https://darwin.v7labs.com/?settings=api-keys).
If you do not already have a Darwin account, you can [contact us](https://www.v7labs.com/contact) and we can set one up for you.
To start the authentication process:
```
$ darwin authenticate
API key:
Make example-team the default team? [y/N] y
Datasets directory [~/.darwin/datasets]:
Authentication succeeded.
```
You will be then prompted to enter your API-key, whether you want to set the corresponding team as
default and finally the desired location on the local file system for the datasets of that team.
This process will create a configuration file at `~/.darwin/config.yaml`.
This file will be updated with future authentications for different teams.
### Listing local and remote datasets
Lists a summary of local existing datasets
```
$ darwin dataset local
NAME            IMAGES     SYNC_DATE         SIZE
mydataset       112025     yesterday     159.2 GB
```
Lists a summary of remote datasets accessible by the current user.
```
$ darwin dataset remote
NAME                       IMAGES     PROGRESS
example-team/mydataset     112025        73.0%
```
### Create/remove a dataset
To create an empty dataset remotely:
```
$ darwin dataset create test
Dataset 'test' (example-team/test) has been created.
Access at https://darwin.v7labs.com/datasets/579
```
The dataset will be created in the team you're authenticated for.
To delete the project on the server:
```
$ darwin dataset remove test
About to delete example-team/test on darwin.
Do you want to continue? [y/N] y
```
### Upload/download data to/from a remote dataset
Uploads data to an existing remote project.
It takes the dataset name and a single image (or directory) with images/videos to upload as
parameters.
The `-e/--exclude` argument allows to indicate file extension/s to be ignored from the data_dir.
e.g.: `-e .jpg`
For videos, the frame rate extraction rate can be specified by adding `--fps <frame_rate>`
Supported extensions:
- Video files: [`.mp4`, `.bpm`, `.mov` formats].
- Image files [`.jpg`, `.jpeg`, `.png` formats].
```
$ darwin dataset push test /path/to/folder/with/images
100%|████████████████████████| 2/2 [00:01<00:00,  1.27it/s]
```
Before a dataset can be downloaded, a release needs to be generated:
```
$ darwin dataset export test 0.1
Dataset test successfully exported to example-team/test:0.1
```
This version is immutable, if new images / annotations have been added you will have to create a new release to included them.
To list all available releases
```
$ darwin dataset releases test
NAME                           IMAGES     CLASSES                   EXPORT_DATE
example-team/test:0.1               4           0     2019-12-07 11:37:35+00:00
```
And to finally download a release.
```
$ darwin dataset pull test:0.1
Dataset example-team/test:0.1 downloaded at /directory/choosen/at/authentication/time.

%prep
%autosetup -n darwin_py-0.8.27

%build
%py3_build

%install
%py3_install
install -d -m755 %{buildroot}/%{_pkgdocdir}
if [ -d doc ]; then cp -arf doc %{buildroot}/%{_pkgdocdir}; fi
if [ -d docs ]; then cp -arf docs %{buildroot}/%{_pkgdocdir}; fi
if [ -d example ]; then cp -arf example %{buildroot}/%{_pkgdocdir}; fi
if [ -d examples ]; then cp -arf examples %{buildroot}/%{_pkgdocdir}; fi
pushd %{buildroot}
if [ -d usr/lib ]; then
	find usr/lib -type f -printf "\"/%h/%f\"\n" >> filelist.lst
fi
if [ -d usr/lib64 ]; then
	find usr/lib64 -type f -printf "\"/%h/%f\"\n" >> filelist.lst
fi
if [ -d usr/bin ]; then
	find usr/bin -type f -printf "\"/%h/%f\"\n" >> filelist.lst
fi
if [ -d usr/sbin ]; then
	find usr/sbin -type f -printf "\"/%h/%f\"\n" >> filelist.lst
fi
touch doclist.lst
if [ -d usr/share/man ]; then
	find usr/share/man -type f -printf "\"/%h/%f.gz\"\n" >> doclist.lst
fi
popd
mv %{buildroot}/filelist.lst .
mv %{buildroot}/doclist.lst .

%files -n python3-darwin-py -f filelist.lst
%dir %{python3_sitelib}/*

%files help -f doclist.lst
%{_docdir}/*

%changelog
* Thu Jun 08 2023 Python_Bot <Python_Bot@openeuler.org> - 0.8.27-1
- Package Spec generated