Document avendehut cli tool #1

khnumdev · 2025-08-25T00:17:26Z

Add initial README.md and CONTRIBUTORS.md documentation for the avendehut CLI tool.

Co-authored-by: isisosirishorus <[email protected]>

cursor · 2025-08-25T00:17:32Z

Cursor Agent can help with this pull request. Just @cursor in comments and I'll start working on changes in this branch.
_{Learn more about Cursor Agents}

Co-authored-by: isisosirishorus <[email protected]>

khnumdev · 2025-08-25T00:35:11Z

.env.example

@@ -0,0 +1,10 @@
+# OneDrive / Microsoft Graph configuration
+ONEDRIVE_CLIENT_ID=


@cursoragent add a todo as placeholders

I significantly enhanced the application by implementing full OneDrive integration, allowing it to list and process files directly from Microsoft Graph. This involved adding new dependencies and updating configuration examples, alongside minor CLI improvements.

I replaced the OneDrive stub in avendehut/utils/onedrive.py with a functional implementation using msgraph-sdk and azure-identity. This includes methods for authenticating via DeviceCodeCredential, handling paginated results from the Graph API, and recursively listing files from a specified OneDrive path.

I added azure-identity and msgraph-sdk to pyproject.toml to support the new OneDrive integration.

I updated .env.example to include ONEDRIVE_TENANT_ID and added TODO comments for clearer setup instructions.

I standardized the help options across all click commands in avendehut/cli.py and avendehut/commands/*.py by adding "-help" to context_settings.

I updated the repository URL in README.md to reflect the correct GitHub path.

_{Learn more about Cursor Agents}

khnumdev · 2025-08-25T00:36:26Z

README.md

+
+1. Clone the repository.
+   ```bash
+   git clone https://github.com/yourusername/avendehut.git


@cursoragent Put the right path

Working on it! I'll start making changes in this branch.

khnumdev · 2025-08-25T00:37:52Z

avendehut/commands/build.py

+
+
+@click.command()
+@click.option("--src", type=click.Path(exists=True, file_okay=False, path_type=Path), required=True, help="Source folder (local or onedrive:/path)")


@cursoragent for all the commands, add a -help parameter to describe the options available

Working on it! I'll start making changes in this branch.

khnumdev · 2025-08-25T00:41:04Z

avendehut/utils/onedrive.py

+
+
+def list_onedrive_files(prefix_path: str) -> Iterable[Path]:  # pragma: no cover - stub
+  raise NotImplementedError("OneDrive listing not implemented. Use local paths for now.")


@cursoragent implement this. Use official sdk to iterate pages and returning resu,to of files in each folder

Working on it! I'll start making changes in this branch.

Co-authored-by: isisosirishorus <[email protected]>

khnumdev · 2025-08-25T00:51:22Z

avendehut/utils/onedrive.py

+
+def _get_graph_client() -> GraphServiceClient:
+  client_id = os.environ["ONEDRIVE_CLIENT_ID"]
+  tenant_id = os.environ.get("ONEDRIVE_TENANT_ID", "consumers")


@cursoragent we are using clientid/clientsecret,not interactive

Working on it! I'll start making changes in this branch.

khnumdev · 2025-08-25T00:53:51Z

avendehut/utils/onedrive.py

+    try:
+      token = credential.get_token("Files.Read.All")
+    except Exception:
+      cred = DeviceCodeCredential(client_id=os.environ["ONEDRIVE_CLIENT_ID"], tenant_id=os.environ.get("ONEDRIVE_TENANT_ID", "consumers"))


@cursoragent don't repeat code. Do a clean and better iteration for this

Working on it! I'll start making changes in this branch.

khnumdev · 2025-08-25T00:54:48Z

pyproject.toml

+name = "avendehut"
+version = "0.1.0"
+description = "CLI to scan books, extract metadata, and generate a searchable HTML catalog."
+authors = ["Your Name <[email protected]>"]


@cursoragent populatewith my data. You know the repo you are

I significantly refactored the OneDrive integration to use app-only authentication via ClientSecretCredential, enhancing automation capabilities by removing interactive user prompts. I also improved the README.md with practical usage examples for the CLI commands.

I updated avendehut/utils/onedrive.py to switch from DeviceCodeCredential (interactive) to ClientSecretCredential for OneDrive authentication, enabling app-only access. This now requires ONEDRIVE_CLIENT_SECRET and ONEDRIVE_TENANT_ID environment variables.

I refactored the OneDrive file listing logic in _iterate_children within avendehut/utils/onedrive.py to leverage the Microsoft Graph SDK's built-in pagination, removing the need for manual requests calls to follow @odata.nextLink.

I added a new "Usage" section to README.md with bash examples for avendehut build, open, search, and export commands to provide clear guidance.

I updated the authors, homepage, and repository fields in pyproject.toml to reflect the khnumdev profile.

4 tasks completed

Refactor OneDrive to client secret and clean pagination

Add basic Usage section to README

Update pyproject authors and repo to khnumdev

Run test suite after changes

_{Learn more about Cursor Agents}

khnumdev · 2025-08-25T00:55:45Z

README.md

+  - `OUT_FOLDER` (local output path)
+- Register an app and configure permissions by following Microsoft's official docs: [Register an application](https://learn.microsoft.com/en-us/graph/auth-register-app-v2).
+
+### CLI Commands


@cursoragent add a basic "usage" section

Working on it! I'll start making changes in this branch.

@cursoragent add basic usage section, to process from local and for one drive

Working on it! I'll start making changes in this branch.

Co-authored-by: isisosirishorus <[email protected]>

khnumdev · 2025-08-25T10:59:20Z

README.md

+
+### Installation
+
+1. Clone the repository.


@cursoragent This should be for development.

Ideally, I'd like to have this as a package published.

Prepare CI with an action to publish package in some python repository

Add here instructions to install that package

Working on it! I'll start making changes in this branch.

@cursoragent still pending

You need to increase your spend limit or enable usage-based billing to run background agents. Go to Cursor

khnumdev · 2025-08-25T11:09:36Z

avendehut/utils/metadata.py

+  reader = PdfReader(str(path))
+  info = reader.metadata or {}
+  title = (getattr(info, "title", None) or path.stem)
+  author = getattr(info, "author", None)


@cursoragent use any attributes apart from these, like Subject: A brief description or the central idea of the document.
Keywords/Tags: Terms that help categorize and search for the document's content.
Creation Date: The date and time the document was first created.
Modification Date: The date and time the document was last changed.
Creator/Application: The software that created the original document (e.g., Microsoft Word).
Producer: The software that converted the document into its PDF format.
File Name: The name of the file itself.

Working on it! I'll start making changes in this branch.

khnumdev · 2025-08-25T11:10:40Z

avendehut/utils/metadata.py

+  title: str
+  authors: List[str]
+  year: Optional[int]
+  language: Optional[str]


@cursoragent it may happen that same book is prsent in different formats, like EPUB of PDF. Normally file name is the same for both, but with differnt extensions.
Probably the model should be updated to a "book" and it should have different formats with the links of the files

Working on it! I'll start making changes in this branch.

khnumdev · 2025-08-25T11:12:33Z

README.md

+  - `OUT_FOLDER` (local output path)
+- Register an app and configure permissions by following Microsoft's official docs: [Register an application](https://learn.microsoft.com/en-us/graph/auth-register-app-v2).
+
+### CLI Commands


@cursoragent add basic usage section, to process from local and for one drive

khnumdev · 2025-08-25T11:15:30Z

avendehut/commands/build.py

+
+
+def iter_source_files(src: Path) -> Iterable[Path]:
+  for root, _dirs, files in os.walk(src):


@cursoragent is this using onedrive or local? It should the one based on the path provided

Working on it! I'll start making changes in this branch.

Co-authored-by: isisosirishorus <[email protected]>

…nt-fixes-e297 Apply pending review comment fixes

…Drive opt-in. - Support -h/-help/--help across commands; document help usage. - Fix README repo path and clarify OneDrive env and setup. - Add .env.example placeholders and tidy variables. - Make OneDrive deps optional via lazy imports; clarify build src type. - Minor robustness in build: validate src, error on onedrive path until sync. - Ensure EPUB parsing lazy-imports ebooklib to speed tests.

khnumdev · 2025-11-04T01:58:22Z

@copilot apply pending feedback and finish the PR. Ensure this is working,run any test required.

Copilot · 2025-11-04T01:58:29Z

@khnumdev I've opened a new pull request, #5, to work on those changes. Once the pull request is ready, I'll request review from you.

Initialize project README and add CONTRIBUTORS.md

a9ac4b3

Co-authored-by: isisosirishorus <[email protected]>

Initialize avendehut project with core book catalog CLI functionality

5d23e78

Co-authored-by: isisosirishorus <[email protected]>

khnumdev commented Aug 25, 2025

View reviewed changes

Implement OneDrive integration with Microsoft Graph SDK

951c77d

Co-authored-by: isisosirishorus <[email protected]>

khnumdev commented Aug 25, 2025

View reviewed changes

Update OneDrive integration, README usage, and project metadata

881b800

Co-authored-by: isisosirishorus <[email protected]>

khnumdev commented Aug 25, 2025

View reviewed changes

khnumdev marked this pull request as ready for review August 25, 2025 12:16

cursoragent and others added 2 commits August 25, 2025 22:11

Add tenant ID, improve export atomicity, and simplify watch command

85167f8

Co-authored-by: isisosirishorus <[email protected]>

Merge pull request #3 from khnumdev/cursor/apply-pending-review-comme…

53d61ea

…nt-fixes-e297 Apply pending review comment fixes

khnumdev mentioned this pull request Oct 17, 2025

Implement PR feedback and update docs #4

Open

khnumdev assigned khnumdev and Copilot and unassigned khnumdev Nov 4, 2025

Copilot AI mentioned this pull request Nov 4, 2025

Complete avendehut CLI documentation and implementation #5

Draft

		@@ -0,0 +1,10 @@
		# OneDrive / Microsoft Graph configuration
		ONEDRIVE_CLIENT_ID=



		@click.command()
		@click.option("--src", type=click.Path(exists=True, file_okay=False, path_type=Path), required=True, help="Source folder (local or onedrive:/path)")



		def list_onedrive_files(prefix_path: str) -> Iterable[Path]: # pragma: no cover - stub
		raise NotImplementedError("OneDrive listing not implemented. Use local paths for now.")



		def iter_source_files(src: Path) -> Iterable[Path]:
		for root, _dirs, files in os.walk(src):

Document avendehut cli tool #1

Are you sure you want to change the base?

Document avendehut cli tool #1

Uh oh!

Conversation

khnumdev commented Aug 25, 2025

Uh oh!

cursor bot commented Aug 25, 2025

Uh oh!

Choose a reason for hiding this comment

Uh oh!

cursor bot Aug 25, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

cursor bot Aug 25, 2025

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

cursor bot Aug 25, 2025

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

cursor bot Aug 25, 2025

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

cursor bot Aug 25, 2025

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

cursor bot Aug 25, 2025

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

cursor bot Aug 25, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

cursor bot Aug 25, 2025

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

cursor bot Aug 25, 2025

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

cursor bot Aug 25, 2025

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

cursor bot Aug 25, 2025

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

cursor bot Aug 25, 2025

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

cursor bot Aug 25, 2025

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

cursor bot Aug 25, 2025 •

edited

Loading

cursor bot Aug 25, 2025 •

edited

Loading