diff options
Diffstat (limited to 'python-rgwadmin.spec')
| -rw-r--r-- | python-rgwadmin.spec | 335 |
1 files changed, 335 insertions, 0 deletions
diff --git a/python-rgwadmin.spec b/python-rgwadmin.spec new file mode 100644 index 0000000..f4676b1 --- /dev/null +++ b/python-rgwadmin.spec @@ -0,0 +1,335 @@ +%global _empty_manifest_terminate_build 0 +Name: python-rgwadmin +Version: 2.4.2 +Release: 1 +Summary: Python Rados Gateway Admin API +License: LGPL v2.1 +URL: https://github.com/UMIACS/rgwadmin +Source0: https://mirrors.nju.edu.cn/pypi/web/packages/18/cc/4571c136b8b6aa48127c9adea55c08d25ad33bcf4a3c87dadcab02a5d7b6/rgwadmin-2.4.2.tar.gz +BuildArch: noarch + +Requires: python3-requests +Requires: python3-requests-aws4auth + +%description +# rgwadmin + +[](https://rgwadmin.readthedocs.io/en/latest/?badge=latest) + +rgwadmin is a Python library to access the Ceph Object Storage Admin API. + +http://docs.ceph.com/docs/master/radosgw/adminops/ + + +## API Example Usage + +```python +from rgwadmin import RGWAdmin + +rgw = RGWAdmin(access_key='XXX', secret_key='XXX', server='obj.example.com') +rgw.create_user( + uid='liam', + display_name='Liam Monahan', + email='liam@umiacs.umd.edu', + user_caps='usage=read, write; users=read', + max_buckets=1000) +rgw.set_user_quota( + uid='liam', + quota_type='user', + max_size_kb=1024*1024, + enabled=True) +rgw.remove_user(uid='liam', purge_data=True) +``` + +## User Example Usage +```python +from rgwadmin import RGWAdmin, RGWUser + +RGWAdmin.connect(access_key='XXX', secret_key='XXX', server='obj.example.com') +u = RGWUser.create(user_id='test', display_name='Test User') +u.user_quota.size = 1024 * 1024 # in bytes +u.user_quota.enabled = True +u.save() +u.delete() +``` + +## Requirements + +rgwadmin requires the following Python packages: + + * [requests](http://python-requests.org/) + * [requests-aws4auth](https://github.com/tedder/requests-aws4auth) + +Additionally, you need to have a [Ceph](http://www.ceph.org) Object Storage +instance with a user that has appropriate caps (capabilities) on the parts of +the API that you want to access. See the +[Ceph Object Storage](http://docs.ceph.com/docs/master/radosgw/) page for more +information. + +Version 2.3.1 was the last to support Python 2. As of version 2.4.0 we support +using V4 signing for requests to the Ceph RGW Admin server only. + +### Compatibility +rgwadmin implements all documented Admin API operations or recent versions of +Ceph. We also implement some of the undocumented ones, too... + +## Installation + +```pip install rgwadmin``` + + +## License + + rgwadmin - a Python interface to the Rados Gateway Admin API + Copyright (C) 2015 UMIACS + + This library is free software; you can redistribute it and/or + modify it under the terms of the GNU Lesser General Public + License as published by the Free Software Foundation; either + version 2.1 of the License, or (at your option) any later version. + + This library is distributed in the hope that it will be useful, + but WITHOUT ANY WARRANTY; without even the implied warranty of + MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU + Lesser General Public License for more details. + + You should have received a copy of the GNU Lesser General Public + License along with this library; if not, write to the Free Software + Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA + + Email: + github@umiacs.umd.edu + + +%package -n python3-rgwadmin +Summary: Python Rados Gateway Admin API +Provides: python-rgwadmin +BuildRequires: python3-devel +BuildRequires: python3-setuptools +BuildRequires: python3-pip +%description -n python3-rgwadmin +# rgwadmin + +[](https://rgwadmin.readthedocs.io/en/latest/?badge=latest) + +rgwadmin is a Python library to access the Ceph Object Storage Admin API. + +http://docs.ceph.com/docs/master/radosgw/adminops/ + + +## API Example Usage + +```python +from rgwadmin import RGWAdmin + +rgw = RGWAdmin(access_key='XXX', secret_key='XXX', server='obj.example.com') +rgw.create_user( + uid='liam', + display_name='Liam Monahan', + email='liam@umiacs.umd.edu', + user_caps='usage=read, write; users=read', + max_buckets=1000) +rgw.set_user_quota( + uid='liam', + quota_type='user', + max_size_kb=1024*1024, + enabled=True) +rgw.remove_user(uid='liam', purge_data=True) +``` + +## User Example Usage +```python +from rgwadmin import RGWAdmin, RGWUser + +RGWAdmin.connect(access_key='XXX', secret_key='XXX', server='obj.example.com') +u = RGWUser.create(user_id='test', display_name='Test User') +u.user_quota.size = 1024 * 1024 # in bytes +u.user_quota.enabled = True +u.save() +u.delete() +``` + +## Requirements + +rgwadmin requires the following Python packages: + + * [requests](http://python-requests.org/) + * [requests-aws4auth](https://github.com/tedder/requests-aws4auth) + +Additionally, you need to have a [Ceph](http://www.ceph.org) Object Storage +instance with a user that has appropriate caps (capabilities) on the parts of +the API that you want to access. See the +[Ceph Object Storage](http://docs.ceph.com/docs/master/radosgw/) page for more +information. + +Version 2.3.1 was the last to support Python 2. As of version 2.4.0 we support +using V4 signing for requests to the Ceph RGW Admin server only. + +### Compatibility +rgwadmin implements all documented Admin API operations or recent versions of +Ceph. We also implement some of the undocumented ones, too... + +## Installation + +```pip install rgwadmin``` + + +## License + + rgwadmin - a Python interface to the Rados Gateway Admin API + Copyright (C) 2015 UMIACS + + This library is free software; you can redistribute it and/or + modify it under the terms of the GNU Lesser General Public + License as published by the Free Software Foundation; either + version 2.1 of the License, or (at your option) any later version. + + This library is distributed in the hope that it will be useful, + but WITHOUT ANY WARRANTY; without even the implied warranty of + MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU + Lesser General Public License for more details. + + You should have received a copy of the GNU Lesser General Public + License along with this library; if not, write to the Free Software + Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA + + Email: + github@umiacs.umd.edu + + +%package help +Summary: Development documents and examples for rgwadmin +Provides: python3-rgwadmin-doc +%description help +# rgwadmin + +[](https://rgwadmin.readthedocs.io/en/latest/?badge=latest) + +rgwadmin is a Python library to access the Ceph Object Storage Admin API. + +http://docs.ceph.com/docs/master/radosgw/adminops/ + + +## API Example Usage + +```python +from rgwadmin import RGWAdmin + +rgw = RGWAdmin(access_key='XXX', secret_key='XXX', server='obj.example.com') +rgw.create_user( + uid='liam', + display_name='Liam Monahan', + email='liam@umiacs.umd.edu', + user_caps='usage=read, write; users=read', + max_buckets=1000) +rgw.set_user_quota( + uid='liam', + quota_type='user', + max_size_kb=1024*1024, + enabled=True) +rgw.remove_user(uid='liam', purge_data=True) +``` + +## User Example Usage +```python +from rgwadmin import RGWAdmin, RGWUser + +RGWAdmin.connect(access_key='XXX', secret_key='XXX', server='obj.example.com') +u = RGWUser.create(user_id='test', display_name='Test User') +u.user_quota.size = 1024 * 1024 # in bytes +u.user_quota.enabled = True +u.save() +u.delete() +``` + +## Requirements + +rgwadmin requires the following Python packages: + + * [requests](http://python-requests.org/) + * [requests-aws4auth](https://github.com/tedder/requests-aws4auth) + +Additionally, you need to have a [Ceph](http://www.ceph.org) Object Storage +instance with a user that has appropriate caps (capabilities) on the parts of +the API that you want to access. See the +[Ceph Object Storage](http://docs.ceph.com/docs/master/radosgw/) page for more +information. + +Version 2.3.1 was the last to support Python 2. As of version 2.4.0 we support +using V4 signing for requests to the Ceph RGW Admin server only. + +### Compatibility +rgwadmin implements all documented Admin API operations or recent versions of +Ceph. We also implement some of the undocumented ones, too... + +## Installation + +```pip install rgwadmin``` + + +## License + + rgwadmin - a Python interface to the Rados Gateway Admin API + Copyright (C) 2015 UMIACS + + This library is free software; you can redistribute it and/or + modify it under the terms of the GNU Lesser General Public + License as published by the Free Software Foundation; either + version 2.1 of the License, or (at your option) any later version. + + This library is distributed in the hope that it will be useful, + but WITHOUT ANY WARRANTY; without even the implied warranty of + MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU + Lesser General Public License for more details. + + You should have received a copy of the GNU Lesser General Public + License along with this library; if not, write to the Free Software + Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA + + Email: + github@umiacs.umd.edu + + +%prep +%autosetup -n rgwadmin-2.4.2 + +%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-rgwadmin -f filelist.lst +%dir %{python3_sitelib}/* + +%files help -f doclist.lst +%{_docdir}/* + +%changelog +* Thu May 18 2023 Python_Bot <Python_Bot@openeuler.org> - 2.4.2-1 +- Package Spec generated |