[PORT-7] testing Notion integration

.gitignore

@@ -3,6 +3,8 @@ __pycache__/
 *.py[cod]
 *$py.class
 
+# PyCharm
+.idea/
 # C extensions
 *.so
 

AUTHORS

@@ -0,0 +1,4 @@
+## AUTHORS
+======================================
+
+* Dedaldino Antonio, 3D - dedaldinoantonio7@gmail.com

LICENSE

@@ -1,121 +1,21 @@
-Creative Commons Legal Code
-
-CC0 1.0 Universal
-
-    CREATIVE COMMONS CORPORATION IS NOT A LAW FIRM AND DOES NOT PROVIDE
-    LEGAL SERVICES. DISTRIBUTION OF THIS DOCUMENT DOES NOT CREATE AN
-    ATTORNEY-CLIENT RELATIONSHIP. CREATIVE COMMONS PROVIDES THIS
-    INFORMATION ON AN "AS-IS" BASIS. CREATIVE COMMONS MAKES NO WARRANTIES
-    REGARDING THE USE OF THIS DOCUMENT OR THE INFORMATION OR WORKS
-    PROVIDED HEREUNDER, AND DISCLAIMS LIABILITY FOR DAMAGES RESULTING FROM
-    THE USE OF THIS DOCUMENT OR THE INFORMATION OR WORKS PROVIDED
-    HEREUNDER.
-
-Statement of Purpose
-
-The laws of most jurisdictions throughout the world automatically confer
-exclusive Copyright and Related Rights (defined below) upon the creator
-and subsequent owner(s) (each and all, an "owner") of an original work of
-authorship and/or a database (each, a "Work").
-
-Certain owners wish to permanently relinquish those rights to a Work for
-the purpose of contributing to a commons of creative, cultural and
-scientific works ("Commons") that the public can reliably and without fear
-of later claims of infringement build upon, modify, incorporate in other
-works, reuse and redistribute as freely as possible in any form whatsoever
-and for any purposes, including without limitation commercial purposes.
-These owners may contribute to the Commons to promote the ideal of a free
-culture and the further production of creative, cultural and scientific
-works, or to gain reputation or greater distribution for their Work in
-part through the use and efforts of others.
-
-For these and/or other purposes and motivations, and without any
-expectation of additional consideration or compensation, the person
-associating CC0 with a Work (the "Affirmer"), to the extent that he or she
-is an owner of Copyright and Related Rights in the Work, voluntarily
-elects to apply CC0 to the Work and publicly distribute the Work under its
-terms, with knowledge of his or her Copyright and Related Rights in the
-Work and the meaning and intended legal effect of CC0 on those rights.
-
-1. Copyright and Related Rights. A Work made available under CC0 may be
-protected by copyright and related or neighboring rights ("Copyright and
-Related Rights"). Copyright and Related Rights include, but are not
-limited to, the following:
-
-  i. the right to reproduce, adapt, distribute, perform, display,
-     communicate, and translate a Work;
- ii. moral rights retained by the original author(s) and/or performer(s);
-iii. publicity and privacy rights pertaining to a person's image or
-     likeness depicted in a Work;
- iv. rights protecting against unfair competition in regards to a Work,
-     subject to the limitations in paragraph 4(a), below;
-  v. rights protecting the extraction, dissemination, use and reuse of data
-     in a Work;
- vi. database rights (such as those arising under Directive 96/9/EC of the
-     European Parliament and of the Council of 11 March 1996 on the legal
-     protection of databases, and under any national implementation
-     thereof, including any amended or successor version of such
-     directive); and
-vii. other similar, equivalent or corresponding rights throughout the
-     world based on applicable law or treaty, and any national
-     implementations thereof.
-
-2. Waiver. To the greatest extent permitted by, but not in contravention
-of, applicable law, Affirmer hereby overtly, fully, permanently,
-irrevocably and unconditionally waives, abandons, and surrenders all of
-Affirmer's Copyright and Related Rights and associated claims and causes
-of action, whether now known or unknown (including existing as well as
-future claims and causes of action), in the Work (i) in all territories
-worldwide, (ii) for the maximum duration provided by applicable law or
-treaty (including future time extensions), (iii) in any current or future
-medium and for any number of copies, and (iv) for any purpose whatsoever,
-including without limitation commercial, advertising or promotional
-purposes (the "Waiver"). Affirmer makes the Waiver for the benefit of each
-member of the public at large and to the detriment of Affirmer's heirs and
-successors, fully intending that such Waiver shall not be subject to
-revocation, rescission, cancellation, termination, or any other legal or
-equitable action to disrupt the quiet enjoyment of the Work by the public
-as contemplated by Affirmer's express Statement of Purpose.
-
-3. Public License Fallback. Should any part of the Waiver for any reason
-be judged legally invalid or ineffective under applicable law, then the
-Waiver shall be preserved to the maximum extent permitted taking into
-account Affirmer's express Statement of Purpose. In addition, to the
-extent the Waiver is so judged Affirmer hereby grants to each affected
-person a royalty-free, non transferable, non sublicensable, non exclusive,
-irrevocable and unconditional license to exercise Affirmer's Copyright and
-Related Rights in the Work (i) in all territories worldwide, (ii) for the
-maximum duration provided by applicable law or treaty (including future
-time extensions), (iii) in any current or future medium and for any number
-of copies, and (iv) for any purpose whatsoever, including without
-limitation commercial, advertising or promotional purposes (the
-"License"). The License shall be deemed effective as of the date CC0 was
-applied by Affirmer to the Work. Should any part of the License for any
-reason be judged legally invalid or ineffective under applicable law, such
-partial invalidity or ineffectiveness shall not invalidate the remainder
-of the License, and in such case Affirmer hereby affirms that he or she
-will not (i) exercise any of his or her remaining Copyright and Related
-Rights in the Work or (ii) assert any associated claims and causes of
-action with respect to the Work, in either case contrary to Affirmer's
-express Statement of Purpose.
-
-4. Limitations and Disclaimers.
-
- a. No trademark or patent rights held by Affirmer are waived, abandoned,
-    surrendered, licensed or otherwise affected by this document.
- b. Affirmer offers the Work as-is and makes no representations or
-    warranties of any kind concerning the Work, express, implied,
-    statutory or otherwise, including without limitation warranties of
-    title, merchantability, fitness for a particular purpose, non
-    infringement, or the absence of latent or other defects, accuracy, or
-    the present or absence of errors, whether or not discoverable, all to
-    the greatest extent permissible under applicable law.
- c. Affirmer disclaims responsibility for clearing rights of other persons
-    that may apply to the Work or any use thereof, including without
-    limitation any person's Copyright and Related Rights in the Work.
-    Further, Affirmer disclaims responsibility for obtaining any necessary
-    consents, permissions or other rights required for any use of the
-    Work.
- d. Affirmer understands and acknowledges that Creative Commons is not a
-    party to this document and has no duty or obligation with respect to
-    this CC0 or use of the Work.
+The MIT License (MIT)
+
+Copyright (c) 2020 Dedaldino Antonio, a.k.a 3D
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

MANIFEST.in

@@ -0,0 +1,3 @@
+include LICENSE
+include README.md
+include requirements.txt

README.md

@@ -0,0 +1,53 @@
+**A python lib to run ejabberd XML-RPC commands**
+
+**Features**
+<ul>
+    <li>Execute XML-RPC commands</li>
+    <li>External authentication</li>
+    <li>Register Users</li>
+    <li>Delete Users</li>
+    <li>Create Rooms</li>
+    <li>Subscribe to Rooms</li>
+    <li>Send Messages</li>
+    <li> and many others features, ... .</li>
+</ul>
+
+#### How to install
+When working with python its a common approach to use a virtualenv to encapsulate all dependencies.
+First create a virtual environment:
+__if you have virtualenv installed run this code__
+```python
+virtualenv ejabberd_python3d_venv
+```
+__if not, so install with this code:__
+````python
+pip install virtualenv
+````
+and then install **ejabberd_python3d** lib:
+```python
+pip install ejabberd_python3d
+```
+
+To get the most updated version, you'll need to clone this repository:
+````git
+git clone http://github.com/Dedaldino3D/ejabberd_python3d.git
+````
+Run
+````python
+python setup.py
+````
+
+After installation is completed, create a client instance:
+
+````python
+from ejabberd_python3d.client import EjabberdAPIClient
+
+client = EjabberdAPIClient('localhost','dedaldino','123456')
+users = client.registered_users('localhost')
+# assuming that you have an user registered (the admin) 
+print(users) # [dedaldino]
+client.register('dedaldino3d','localhost','nopassword')
+users = client.registered_users('localhost')
+print(users) # ['dedaldino3d']
+````
+

TODOS.md

@@ -0,0 +1,122 @@
+# METHODS TO IMPLEMENT
+### TODO def backup(self, file): Store the database to backup file
+### TODO def change_room_option(self, name, service, option, value)
+### TODO def compile(self, file):
+### TODO def convert_to_scram(self, host):
+### TODO def convert_to_yaml(self, in, out):
+### TODO def create_room(self, name, service, host):
+### TODO def create_room_with_opts(self, name, service, host, options):
+### TODO def create_rooms_file(self, file):
+### TODO def delete_mnesia(self, host):
+### TODO def delete_old_mam_messages(self, type, days):
+### TODO def destroy_room(self, name, service):
+### TODO def destroy_rooms_file(self, file):
+### TODO def dump(self, file):
+### TODO def dump_table(self, file, table):
+### TODO def export2sql(self, host, file):
+### TODO def export_piefxis(self, dir):
+### TODO def export_piefxis_host(self, dir, host):
+### TODO def gen_html_doc_for_commands(self, file, regexp, examples):
+### TODO def gen_markdown_doc_for_commands(self, file, regexp, examples):
+### TODO def get_offline_count(self):
+### TODO def get_room_affiliations(self, name, service):
+### TODO def get_room_occupants(self, name, service):
+### TODO def get_room_occupants_number(self, name, service):
+### TODO def get_room_options(self, name, service):
+### TODO get_subscribers(self, name, service):
+### TODO get_user_rooms(self, user, host):
+### TODO def import_dir(self, file):
+### TODO def import_file(self, file):
+### TODO def import_piefxis(self, file):
+### TODO def import_prosody(self, dir) Import data from Prosody
+### TODO def install_fallback(self, file):
+### TODO def join_cluster(self, node):
+### TODO def leave_cluster(self, node):
+### TODO def load(self, file):
+### TODO def mnesia_change_nodename(self,
+### TODO def module_check(self, module):
+### TODO def module_install(self, module):
+### TODO def module_uninstall(self, module):
+### TODO def module_upgrade(self, module):
+### TODO def modules_update_specs(self):
+### TODO def muc_online_rooms(self, host):
+### TODO def muc_unregister_nick(self, nick):
+### TODO def privacy_set(self, user, host, xmlquery):
+### TODO def private_get(self, user, host, element, ns):
+### TODO def private_set(self, user, host, element):
+### TODO def push_roster(self, file, user, host):
+### TODO def push_roster_all(self, file):
+### TODO def restore(self, file):
+### TODO def rooms_unused_destroy(self, host, days):
+### TODO def rooms_unused_list(self, host, days):
+### TODO def rotate_log(self):
+### TODO def send_direct_invitation(self,
+### TODO def send_stanza(self, from, to, stanza):
+### TODO def set_room_affiliation(self, name, service, jid, affiliation):
+### TODO def subscribe_room(self, user, nick, room, nodes):
+### TODO def unsubscribe_room(self, user, room):
+### TODO: add argument options: [{name::string,value::string}]: List of options
+### TODO: nodes must be separated by commas, so therefore you can use an array and before send transform arguments
+### TODO: some arguments is not required
+### TODO: name is between: registeredusers onlineusers onlineusersnode uptimeseconds processes
+### TODO: name is between: registeredusers onlineusers
+### TODO def backup(self, file): Store the database to backup file
+### TODO def change_room_option(self, name, service, option, value)
+### TODO def compile(self, file):
+### TODO def convert_to_scram(self, host):
+### TODO def convert_to_yaml(self, in, out):
+### TODO def create_room(self, name, service, host):
+### TODO def create_room_with_opts(self, name, service, host, options):
+### TODO def create_rooms_file(self, file):
+### TODO def delete_mnesia(self, host):
+### TODO def delete_old_mam_messages(self, type, days):
+### TODO def destroy_room(self, name, service):
+### TODO def destroy_rooms_file(self, file):
+### TODO def dump(self, file):
+### TODO def dump_table(self, file, table):
+### TODO def export2sql(self, host, file):
+### TODO def export_piefxis(self, dir):
+### TODO def export_piefxis_host(self, dir, host):
+### TODO def gen_html_doc_for_commands(self, file, regexp, examples):
+### TODO def gen_markdown_doc_for_commands(self, file, regexp, examples):
+### TODO def get_offline_count(self):
+### TODO def get_room_affiliations(self, name, service):
+### TODO def get_room_occupants(self, name, service):
+### TODO def get_room_occupants_number(self, name, service):
+### TODO def get_room_options(self, name, service):
+### TODO get_subscribers(self, name, service):
+### TODO get_user_rooms(self, user, host):
+### TODO def import_dir(self, file):
+### TODO def import_file(self, file):
+### TODO def import_piefxis(self, file):
+### TODO def import_prosody(self, dir) Import data from Prosody
+### TODO def install_fallback(self, file):
+### TODO def join_cluster(self, node):
+### TODO def leave_cluster(self, node):
+### TODO def load(self, file):
+### TODO def mnesia_change_nodename(self,
+### TODO def module_check(self, module):
+### TODO def module_install(self, module):
+### TODO def module_uninstall(self, module):
+### TODO def module_upgrade(self, module):
+### TODO def modules_update_specs(self):
+### TODO def muc_online_rooms(self, host):
+### TODO def muc_unregister_nick(self, nick):
+### TODO def privacy_set(self, user, host, xmlquery):
+### TODO def private_get(self, user, host, element, ns):
+### TODO def private_set(self, user, host, element):
+### TODO def push_roster(self, file, user, host):
+### TODO def push_roster_all(self, file):
+### TODO def restore(self, file):
+### TODO def rooms_unused_destroy(self, host, days):
+### TODO def rooms_unused_list(self, host, days):
+### TODO def rotate_log(self):
+### TODO def send_direct_invitation(self,
+### TODO def send_stanza(self, from, to, stanza):
+### TODO def set_room_affiliation(self, name, service, jid, affiliation):
+### TODO def subscribe_room(self, user, nick, room, nodes):
+### TODO def unsubscribe_room(self, user, room):
+
+## Generics TODOS
+### TODO: add endpoint parameter
+### TODO: add it to logger

ejabberd_python3d/__init__.py

@@ -0,0 +1,2 @@
+from ejabberd_python3d import client, serializers, ejabberd_auth
+from ejabberd_python3d import muc, abc, defaults