feat: Login flow v2

[blvdek]

Changes proposed in this pull request:

• Implement Login flow v2 for standard Nextcloud clients.
• Allow user to initialize standard Nextcloud clients without providing credentials so that the user can log in using Login flow v2.

[bigcat88]

To make docs pass you can add:

.. autoclass:: NcSession
    :members:

at the end of Session.rst

And create LoginFlowV2.rst file with such content(and include it in index.rst):

.. py:currentmodule:: nc_py_api.loginflow_v2

LoginFlow V2
============

Two base classes for working with Nextcloud. The first for working as a client, the second as an application.

All required functionality is incorporated in them, they contains all other classes required to work with the Nextcloud.

.. autoclass:: _LoginFlowV2API
    :inherited-members:
    :members:

.. autoclass:: Credentials
    :inherited-members:
    :members:

.. autoclass:: LoginFlow
    :inherited-members:
    :members:

[bigcat88]

and for tests(test_init_poll, test_init_poll_async) as this stuff is not for AppAPI:

nc_any should be nc_client and anc_any should be anc_client

def test_init_poll(nc_client):
    lf = nc_client.loginflow_v2.init()
    ...

this help to not trigger these tests for NextcloudApp class.

[codecov]

Codecov Report

Attention: Patch coverage is 78.35052% with 21 lines in your changes are missing coverage. Please review.

Project coverage is 95.72%. Comparing base (ddce6bf) to head (2cba348).

Additional details and impacted files

@@            Coverage Diff             @@
##             main     #255      +/-   ##
==========================================
- Coverage   96.05%   95.72%   -0.33%     
==========================================
  Files          44       45       +1     
  Lines        5165     5261      +96     
==========================================
+ Hits         4961     5036      +75     
- Misses        204      225      +21     

Files	Coverage Δ
nc_py_api/_session.py	96.44% <100.00%> (+0.03%)	⬆️
nc_py_api/nextcloud.py	97.99% <100.00%> (+0.04%)	⬆️
nc_py_api/loginflow_v2.py	75.58% <75.58%> (ø)

[bigcat88]

As I understand this should be used like this:

import nc_py_api


if __name__ == "__main__":
    nc = nc_py_api.Nextcloud(nextcloud_url="http://stable29.local")
    r = nc.loginflow_v2.init()
    print(r)  # here open link in browser and agree to connect
    r2 = nc.loginflow_v2.poll(r.token)
    print(r2)
    print(nc.capabilities)
    print(nc.files.listdir())

---

Thank you for your pull request and interest in Nextcloud and nc_py_api, after changing the URL I will gladly merge it. :)

[bigcat88]

Thanks again, good job :)

[blvdek]

Thank you too