Metadata-Version: 2.4
Name: obsidiana
Version: 2026.5.3
Summary: Tools for working with Obsidian vault(s)
Project-URL: Issues, https://github.com/Julian/obsidiana/issues/
Project-URL: Funding, https://github.com/sponsors/Julian
Project-URL: Source, https://github.com/Julian/obsidiana
Author-email: Julian Berman <Julian+obsidiana@GrayVines.com>
License-Expression: MIT
License-File: COPYING
Keywords: notes,notetaking,obsidian
Classifier: Development Status :: 3 - Alpha
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Programming Language :: Python :: Implementation :: CPython
Classifier: Programming Language :: Python :: Implementation :: PyPy
Requires-Python: >=3.12
Requires-Dist: attrs
Requires-Dist: jsonschema[format]
Requires-Dist: markdown-it-py>=4.0.0
Requires-Dist: networkx>=3.6.1
Requires-Dist: python-frontmatter
Requires-Dist: rich-click
Requires-Dist: url-py>=0.21.0
Description-Content-Type: text/x-rst

=============
``Obsidiana``
=============

|PyPI| |CI|

.. |PyPI| image:: https://img.shields.io/pypi/v/obsidiana.svg
  :alt: PyPI version
  :target: https://pypi.org/project/obsidiana/

.. |CI| image:: https://github.com/Julian/obsidiana/workflows/CI/badge.svg
  :alt: Build status
  :target: https://github.com/Julian/obsidiana/actions?query=workflow%3ACI

A set of tools for working with (my? your?) Obsidian vault.


Should I Use This?
------------------

If you're not @Julian, possibly not as-is, but I like making my tools public in case they do turn out useful to you, or even so you can tell me if you do similar things yourself, so feel free to peruse or use.


Graph Queries
-------------

``ob list`` queries the reference graph of the vault.
Wikilinks, markdown relative links, and frontmatter aliases all count as references.

* ``ob list isolated`` — notes with no references in or out
* ``ob list sources`` (alias ``orphans``) — notes with no incoming references
* ``ob list sinks`` (alias ``leaves``) — notes with no outgoing references
* ``ob list broken`` — references that don't resolve to any note in the vault


What's in a Name
----------------

"Obsidiana" is spanish for Obsidian.
Unlike ``obsidian`` it also wasn't yet taken on PyPI.
