Version 0.1.5 (#207)

* Bump beautifulsoup4 from 4.12.3 to 4.13.3

Bumps [beautifulsoup4](https://www.crummy.com/software/BeautifulSoup/bs4/) from 4.12.3 to 4.13.3.

---
updated-dependencies:
- dependency-name: beautifulsoup4
  dependency-type: direct:production
  update-type: version-update:semver-minor
...

Signed-off-by: dependabot[bot] <[email protected]>

* Bump pip-audit from 2.7.3 to 2.8.0

Bumps [pip-audit](https://github.com/pypa/pip-audit) from 2.7.3 to 2.8.0.
- [Release notes](https://github.com/pypa/pip-audit/releases)
- [Changelog](https://github.com/pypa/pip-audit/blob/main/CHANGELOG.md)
- [Commits](pypa/pip-audit@v2.7.3...v2.8.0)

---
updated-dependencies:
- dependency-name: pip-audit
  dependency-type: direct:development
  update-type: version-update:semver-minor
...

Signed-off-by: dependabot[bot] <[email protected]>

* Bump coverage from 7.6.9 to 7.6.11

Bumps [coverage](https://github.com/nedbat/coveragepy) from 7.6.9 to 7.6.11.
- [Release notes](https://github.com/nedbat/coveragepy/releases)
- [Changelog](https://github.com/nedbat/coveragepy/blob/master/CHANGES.rst)
- [Commits](nedbat/coveragepy@7.6.9...7.6.11)

---
updated-dependencies:
- dependency-name: coverage
  dependency-type: direct:development
  update-type: version-update:semver-patch
...

Signed-off-by: dependabot[bot] <[email protected]>

* Bump myst-parser from 4.0.0 to 4.0.1

Bumps [myst-parser](https://github.com/executablebooks/MyST-Parser) from 4.0.0 to 4.0.1.
- [Release notes](https://github.com/executablebooks/MyST-Parser/releases)
- [Changelog](https://github.com/executablebooks/MyST-Parser/blob/master/CHANGELOG.md)
- [Commits](executablebooks/MyST-Parser@v4.0.0...v4.0.1)

---
updated-dependencies:
- dependency-name: myst-parser
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

Signed-off-by: dependabot[bot] <[email protected]>

* Bump lxml from 5.3.0 to 5.3.1

Bumps [lxml](https://github.com/lxml/lxml) from 5.3.0 to 5.3.1.
- [Release notes](https://github.com/lxml/lxml/releases)
- [Changelog](https://github.com/lxml/lxml/blob/master/CHANGES.txt)
- [Commits](lxml/lxml@lxml-5.3.0...lxml-5.3.1)

---
updated-dependencies:
- dependency-name: lxml
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

Signed-off-by: dependabot[bot] <[email protected]>

* Bump bandit from 1.8.2 to 1.8.3

Bumps [bandit](https://github.com/PyCQA/bandit) from 1.8.2 to 1.8.3.
- [Release notes](https://github.com/PyCQA/bandit/releases)
- [Commits](PyCQA/bandit@1.8.2...1.8.3)

---
updated-dependencies:
- dependency-name: bandit
  dependency-type: direct:development
  update-type: version-update:semver-patch
...

Signed-off-by: dependabot[bot] <[email protected]>

* Bump coverage from 7.6.11 to 7.6.12

Bumps [coverage](https://github.com/nedbat/coveragepy) from 7.6.11 to 7.6.12.
- [Release notes](https://github.com/nedbat/coveragepy/releases)
- [Changelog](https://github.com/nedbat/coveragepy/blob/master/CHANGES.rst)
- [Commits](nedbat/coveragepy@7.6.11...7.6.12)

---
updated-dependencies:
- dependency-name: coverage
  dependency-type: direct:development
  update-type: version-update:semver-patch
...

Signed-off-by: dependabot[bot] <[email protected]>

* Bump pytest from 8.3.4 to 8.3.5

Bumps [pytest](https://github.com/pytest-dev/pytest) from 8.3.4 to 8.3.5.
- [Release notes](https://github.com/pytest-dev/pytest/releases)
- [Changelog](https://github.com/pytest-dev/pytest/blob/main/CHANGELOG.rst)
- [Commits](pytest-dev/pytest@8.3.4...8.3.5)

---
updated-dependencies:
- dependency-name: pytest
  dependency-type: direct:development
  update-type: version-update:semver-patch
...

Signed-off-by: dependabot[bot] <[email protected]>

* Bump jinja2 from 3.1.5 to 3.1.6

Bumps [jinja2](https://github.com/pallets/jinja) from 3.1.5 to 3.1.6.
- [Release notes](https://github.com/pallets/jinja/releases)
- [Changelog](https://github.com/pallets/jinja/blob/main/CHANGES.rst)
- [Commits](pallets/jinja@3.1.5...3.1.6)

---
updated-dependencies:
- dependency-name: jinja2
  dependency-type: direct:production
  update-type: version-update:semver-patch
...

Signed-off-by: dependabot[bot] <[email protected]>

* Bump coverage from 7.6.12 to 7.7.0

Bumps [coverage](https://github.com/nedbat/coveragepy) from 7.6.12 to 7.7.0.
- [Release notes](https://github.com/nedbat/coveragepy/releases)
- [Changelog](https://github.com/nedbat/coveragepy/blob/master/CHANGES.rst)
- [Commits](nedbat/coveragepy@7.6.12...7.7.0)

---
updated-dependencies:
- dependency-name: coverage
  dependency-type: direct:development
  update-type: version-update:semver-minor
...

Signed-off-by: dependabot[bot] <[email protected]>

* Bump coverage from 7.7.0 to 7.7.1

Bumps [coverage](https://github.com/nedbat/coveragepy) from 7.7.0 to 7.7.1.
- [Release notes](https://github.com/nedbat/coveragepy/releases)
- [Changelog](https://github.com/nedbat/coveragepy/blob/master/CHANGES.rst)
- [Commits](nedbat/coveragepy@7.7.0...7.7.1)

---
updated-dependencies:
- dependency-name: coverage
  dependency-type: direct:development
  update-type: version-update:semver-patch
...

Signed-off-by: dependabot[bot] <[email protected]>

* Cli load extensions and hello command (#204)

* Add hello command to cli and extension argument

* Change LOGIN_XML to support loading extensions

* Update the docs

* set the version to 0.1.5

---------

Signed-off-by: dependabot[bot] <[email protected]>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
Co-authored-by: levius0 <[email protected]>

Author: 3 people

README.md

@@ -1,15 +1,16 @@
 # PyEPP
-> A Python API on top of EPP protocol to work with registry systems.
+>
+> A Python API on top of the EPP protocol to work easier with registry systems.
 
 This a Python API on [EPP](https://en.wikipedia.org/wiki/Extensible_Provisioning_Protocol) protocol to connect to
 any registry systems that support EPP and work with it. It supports bellow RFCs:
+
 - [RFC 5730 - Extensible Provisioning Protocol](https://datatracker.ietf.org/doc/html/rfc5730)
 - [RFC 5731 - Domain Name Mapping](https://datatracker.ietf.org/doc/html/rfc5731)
 - [RFC 5732 - Host Mapping](https://datatracker.ietf.org/doc/html/rfc5732)
 - [RFC 5733 - Contact Mapping](https://datatracker.ietf.org/doc/html/rfc5733)
 - [RFC 5734 - Transport over TCP](https://datatracker.ietf.org/doc/html/rfc5734)
 
-
 ## Installation
 
 ```sh
@@ -96,6 +97,7 @@ renew_domain = domain.renew(domain_name='example-1.nz', expiry_date=date(2024, 2
 ```
 
 ## PyEPP CLI
+
 PyEPP also has a command line interface that allows the user to interact with the registry system.
 
 ```text
@@ -108,8 +110,10 @@ Options:
   --port TEXT                     [required]
   --user TEXT                     [required]
   --password TEXT                 [required]
-  --client-cert TEXT              [optional]
-  --client-key TEXT               [optional]
+  --client-cert TEXT
+  --client-key TEXT
+  --extension TEXT                The extension to be loaded for the EPP
+                                  command.
   -o, --output-format [XML|OBJECT|MIN]
                                   [default: XML]
   --no-pretty
@@ -124,46 +128,53 @@ Options:
 Commands:
   contact  To work with Contact objects in the registry.
   domain   To work with Domain name objects in the registry.
+  hello    Sends a hello command to the server and receives the Greeting...
   host     To work with Host objects in the registry.
   poll     To manage registry service messages.
   run      Receive an XML file containing an EPP XML command and execute it.
 ```
 
 ### Enable shell autocomplete
+
 To enable shell autocompletion for your shell follow the below commands:
 
 #### Zsh
+
 ```sh
 mkdir -p ~/.pyepp
 _PYEPP_COMPLETE=zsh_source pyepp > ~/.pyepp/shell-complete.zsh
 ```
 
 Source the file in `~/.zshrc`.
+
 ```sh
 . ~/.pyepp/shell-complete.zsh
 ```
 
 #### Bash
+
 ```sh
 mkdir -p ~/.pyepp
 _PYEPP_COMPLETE=bash_source pyepp > ~/.pyepp/shell-complete.bash
 ```
 
 Source the file in `~/.bashrc`.
+
 ```sh
 . ~/.pyepp/shell-complete.bash
 ```
 
 ## Development setup
-Clone this project. It's recommended to create virtual environment. Then install the dependencies and 
+
+Clone this project. It's recommended to create virtual environment. Then install the dependencies and
 development dependencies:
 
 ```shell
 pip install -r requirements.txt
 pip install -r requirements.dev.txt
 ```
 
-Before creating any pull requests please make sure your code lints and there is no security issues in your code 
+Before creating any pull requests please make sure your code lints and there is no security issues in your code
 by running below scripts:
 
 ```shell
@@ -172,8 +183,9 @@ by running below scripts:
 ```
 
 Happy developing!
+
 ## Contributing
+
 Please refer to [CONTRIBUTING.md](CONTRIBUTING.md)
 
 <!-- Markdown link & img dfn's -->
-[wiki]: https://github.com/internetnz/pyepp/wiki

docs/cli.rst

@@ -17,15 +17,17 @@ To see the help page:
     sh> pyepp -h
     Usage: pyepp [OPTIONS] COMMAND [ARGS]...
 
-    A command line interface to work with PyEpp library.
+      A command line interface to work with PyEpp library.
 
     Options:
       --server TEXT                   [required]
       --port TEXT                     [required]
       --user TEXT                     [required]
       --password TEXT                 [required]
-      --client-cert TEXT              [optional]
-      --client-key TEXT               [optional]
+      --client-cert TEXT
+      --client-key TEXT
+      --extension TEXT                The extension to be loaded for the EPP
+                                      command.
       -o, --output-format [XML|OBJECT|MIN]
                                       [default: XML]
       --no-pretty
@@ -40,6 +42,7 @@ To see the help page:
     Commands:
       contact  To work with Contact objects in the registry.
       domain   To work with Domain name objects in the registry.
+      hello    Sends a hello command to the server and receives the Greeting...
       host     To work with Host objects in the registry.
       poll     To manage registry service messages.
       run      Receive an XML file containing an EPP XML command and execute it.

docs/index.rst

@@ -110,10 +110,12 @@ PyEPP also has a command line interface that allows the user to interact with th
     Options:
       --server TEXT                   [required]
       --port TEXT                     [required]
-      --client-cert TEXT              [required]
-      --client-key TEXT               [required]
       --user TEXT                     [required]
       --password TEXT                 [required]
+      --client-cert TEXT
+      --client-key TEXT
+      --extension TEXT                The extension to be loaded for the EPP
+                                      command.
       -o, --output-format [XML|OBJECT|MIN]
                                       [default: XML]
       --no-pretty
@@ -128,6 +130,7 @@ PyEPP also has a command line interface that allows the user to interact with th
     Commands:
       contact  To work with Contact objects in the registry.
       domain   To work with Domain name objects in the registry.
+      hello    Sends a hello command to the server and receives the Greeting...
       host     To work with Host objects in the registry.
       poll     To manage registry service messages.
       run      Receive an XML file containing an EPP XML command and execute it.

docs/requirements.txt

@@ -1,3 +1,3 @@
 sphinx==8.1.3
-myst-parser==4.0.0
+myst-parser==4.0.1
 sphinx-rtd-theme==3.0.2

pyepp/__init__.py

@@ -2,7 +2,7 @@
 PyEPP Package
 """
 
-__version__ = "0.1.4"
+__version__ = "0.1.5"
 
 from pyepp.epp import (
     EppCommunicator,

pyepp/cli/__main__.py

@@ -62,6 +62,13 @@ def load_config():
 @click.option("--password", envvar="PYEPP_PASSWORD", required=True)
 @click.option("--client-cert", envvar="PYEPP_CLIENT_CERT", required=False)
 @click.option("--client-key", envvar="PYEPP_CLIENT_KEY", required=False)
+@click.option(
+    "--extension",
+    envvar="PYEPP_EXTESION",
+    required=False,
+    help="The extension to be loaded for the EPP command.",
+    multiple=True,
+)
 @click.option(
     "-o",
     "--output-format",
@@ -91,6 +98,7 @@ def pyepp_cli(
     client_key,
     user,
     password,
+    extension,
     output_format,
     no_pretty,
     dry_run,
@@ -106,6 +114,7 @@ def pyepp_cli(
         client_key,
         user,
         password,
+        extension,
         output_format,
         no_pretty,
         dry_run,
@@ -132,8 +141,17 @@ def run_xml(ctx, xml):
     utils.echo(result)
 
 
+@click.command("hello")
+@click.pass_context
+def hello(ctx):
+    """Sends a hello command to the server and receives the Greeting response."""
+    greeting = ctx.obj.hello()
+    utils.echo(greeting)
+
+
 pyepp_cli.add_command(run_xml)
 pyepp_cli.add_command(contact_group)
 pyepp_cli.add_command(domain_group)
 pyepp_cli.add_command(host_group)
 pyepp_cli.add_command(poll_group)
+pyepp_cli.add_command(hello)

pyepp/cli/cli.py

@@ -38,6 +38,7 @@ def __init__(
         client_key,
         user,
         password,
+        extensions,
         output_format,
         no_pretty,
         dry_run=False,
@@ -47,6 +48,8 @@ def __init__(
         self.user = user
         self.password = password
 
+        self.extensions = extensions
+
         self.output_format = output_format
         self.no_pretty = no_pretty
         self.dry_run = dry_run
@@ -57,11 +60,16 @@ def connect(self):
         self.epp.connect()
 
     def login(self):
-        self.epp.login(self.user, self.password)
+        self.epp.login(self.user, self.password, extensions=self.extensions)
 
     def logout(self):
         self.epp.logout()
 
+    def hello(self):
+        self.connect()
+        result = self.epp.hello()
+        return result
+
     def format_output(self, result: EppResultData):
         output = result
         if self.output_format == "XML":

pyepp/command_templates.py

@@ -24,13 +24,14 @@
         <lang>en</lang>
       </options>
       <svcs>
+        <objURI>urn:ietf:params:xml:ns:epp-1.0</objURI>
         <objURI>urn:ietf:params:xml:ns:domain-1.0</objURI>
         <objURI>urn:ietf:params:xml:ns:contact-1.0</objURI>
         <objURI>urn:ietf:params:xml:ns:host-1.0</objURI>
         <svcExtension>
           <extURI>urn:ietf:params:xml:ns:secDNS-1.1</extURI>
           {% for extension in extensions %}
-          <extURI>{{ extension }}</extURI>
+          <extURI>urn:ietf:params:xml:ns:{{ extension }}</extURI>
           {% endfor %}
         </svcExtension>
       </svcs>

requirements.dev.txt

@@ -1,5 +1,5 @@
-bandit==1.8.2
-coverage==7.6.9
+bandit==1.8.3
+coverage==7.7.1
 pylint==3.2.7
-pytest==8.3.4
-pip-audit==2.7.3
+pytest==8.3.5
+pip-audit==2.8.0

requirements.txt

@@ -1,4 +1,4 @@
-jinja2==3.1.5
-lxml==5.3.0
-beautifulsoup4==4.12.3
+jinja2==3.1.6
+lxml==5.3.1
+beautifulsoup4==4.13.3
 click==8.1.8