diff options
Diffstat (limited to 'python-darwin-py.spec')
| -rw-r--r-- | python-darwin-py.spec | 332 |
1 files changed, 332 insertions, 0 deletions
diff --git a/python-darwin-py.spec b/python-darwin-py.spec new file mode 100644 index 0000000..6f5954c --- /dev/null +++ b/python-darwin-py.spec @@ -0,0 +1,332 @@ +%global _empty_manifest_terminate_build 0 +Name: python-darwin-py +Version: 0.8.23 +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.nju.edu.cn/pypi/web/packages/19/c7/37d61adb756eba96e41bf656e1d57e89addbf64dd01fd6aee541c541ec64/darwin_py-0.8.23.tar.gz +BuildArch: noarch + +Requires: python3-argcomplete +Requires: python3-humanize +Requires: python3-pillow +Requires: python3-pyyaml +Requires: python3-requests +Requires: python3-rich +Requires: python3-dataclasses +Requires: python3-upolygon +Requires: python3-jsonschema +Requires: python3-deprecation +Requires: python3-pydantic +Requires: python3-orjson +Requires: python3-numpy +Requires: python3-toml +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 +Requires: python3-tqdm +Requires: python3-types-pyyaml + +%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.23 + +%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 +* Mon May 15 2023 Python_Bot <Python_Bot@openeuler.org> - 0.8.23-1 +- Package Spec generated |