From 48f62aba8db8efe3a109837cda52d04b1b9aad5b Mon Sep 17 00:00:00 2001 From: alyx Date: Sun, 24 Dec 2023 02:25:26 -0500 Subject: Fixed import cycle, began on docs. --- docs/index.rst | 61 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 61 insertions(+) create mode 100644 docs/index.rst (limited to 'docs/index.rst') diff --git a/docs/index.rst b/docs/index.rst new file mode 100644 index 0000000..ec56a5d --- /dev/null +++ b/docs/index.rst @@ -0,0 +1,61 @@ +.. bbss.py documentation master file, created by + sphinx-quickstart on Tue Dec 5 20:26:05 2023. + You can adapt this file completely to your liking, but it should at least + contain the root `toctree` directive. + +.. role:: python(code) + :language: python + +======= +bbss.py +======= + +For more information on BBSS itself, look `here `_. +This is a simple python module to allow for quickly scraping or exploring BBSS directories on sites. + +bbss.site +========= + +.. py:module:: bbss.site + +.. py:class:: Site(domain: str[, path: str[, *, scheme: str = 'https']]) + + `domain` + The domain to check for BBSS files + + `path` + An optional subdirectory to treat as the root of the BBSS directory + + `scheme` + What protocol to download over; can be either :python:`'http'` or :python:`'https'` + + A representation of some BBSS directory. On construction, all information about an individual site + is downloaded. + + .. py:attribute:: default_path + :type: bool + + Whether the site was generated from a default directory, or a user-supplied one + + .. py:attribute:: has_sizes_txt + :type: bool + + Whether the BBSS directory contains a :code:`sizes.txt` file + + .. py:attribute:: sizes + :type: bbss.sizes.SizeListFile + + A list of the sizes found at the site + + .. py:attribute:: friends + :type: Optional[bbss.friends.FriendListFile] + + A list of friend sites found at the site + +================== +Indices and tables +================== + +* :ref:`genindex` +* :ref:`modindex` +* :ref:`search` -- cgit v1.2.3-54-g00ecf