summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--.gitignore1
-rw-r--r--python-darwin-py.spec332
-rw-r--r--sources1
3 files changed, 334 insertions, 0 deletions
diff --git a/.gitignore b/.gitignore
index e69de29..9d7b254 100644
--- a/.gitignore
+++ b/.gitignore
@@ -0,0 +1 @@
+/darwin_py-0.8.23.tar.gz
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
diff --git a/sources b/sources
new file mode 100644
index 0000000..a68ce33
--- /dev/null
+++ b/sources
@@ -0,0 +1 @@
+3f323f9f673404d995b92d61e3ce7e0e darwin_py-0.8.23.tar.gz