summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authormathieui <mathieui@mathieui.net>2016-07-27 19:05:27 +0200
committermathieui <mathieui@mathieui.net>2016-07-27 19:05:27 +0200
commitf6960d09f0e84903954e801397209ef7eb1450ce (patch)
treead008d7c44edebd96258a1e2b1c8087070cdf165 /doc
parent15bef8d7521dae6d23e3fa251132395919010208 (diff)
downloadpoezio-f6960d09f0e84903954e801397209ef7eb1450ce.tar.gz
poezio-f6960d09f0e84903954e801397209ef7eb1450ce.tar.bz2
poezio-f6960d09f0e84903954e801397209ef7eb1450ce.tar.xz
poezio-f6960d09f0e84903954e801397209ef7eb1450ce.zip
Fix doc building
Broken by the namespace change
Diffstat (limited to 'doc')
-rw-r--r--doc/source/conf.py2
-rw-r--r--doc/source/dev/common.rst2
-rw-r--r--doc/source/dev/overview.rst2
-rw-r--r--doc/source/dev/plugin.rst2
-rw-r--r--doc/source/dev/theming.rst2
-rw-r--r--doc/source/dev/timed_events.rst2
-rw-r--r--doc/source/themes.rst2
-rw-r--r--doc/stub/args.py34
-rw-r--r--doc/stub/config.py225
9 files changed, 7 insertions, 266 deletions
diff --git a/doc/source/conf.py b/doc/source/conf.py
index 61f17b38..ff3a9031 100644
--- a/doc/source/conf.py
+++ b/doc/source/conf.py
@@ -15,7 +15,7 @@
import sys, os, time
sys.path.insert(0, os.path.abspath('../stub'))
-sys.path.append(os.path.abspath('../../poezio/'))
+sys.path.append(os.path.abspath('../../'))
sys.path.append(os.path.abspath('../../plugins/'))
# If extensions (or modules to document with autodoc) are in another directory,
diff --git a/doc/source/dev/common.rst b/doc/source/dev/common.rst
index f9ee7c77..97a952a3 100644
--- a/doc/source/dev/common.rst
+++ b/doc/source/dev/common.rst
@@ -1,7 +1,7 @@
Common operations documentation
===============================
-.. automodule:: common
+.. automodule:: poezio.common
:members:
:undoc-members:
diff --git a/doc/source/dev/overview.rst b/doc/source/dev/overview.rst
index 3b27fe9e..fb880073 100644
--- a/doc/source/dev/overview.rst
+++ b/doc/source/dev/overview.rst
@@ -146,4 +146,4 @@ Examples:
See the source of the CommandArgParser for more information.
-.. autoclass:: decorators.CommandArgParser
+.. autoclass:: poezio.decorators.CommandArgParser
diff --git a/doc/source/dev/plugin.rst b/doc/source/dev/plugin.rst
index 323a058a..7a63ed8f 100644
--- a/doc/source/dev/plugin.rst
+++ b/doc/source/dev/plugin.rst
@@ -4,7 +4,7 @@ Plugin API documentation
BasePlugin
----------
-.. module:: plugin
+.. module:: poezio.plugin
.. autoclass:: BasePlugin
:members: init, cleanup, api, core
diff --git a/doc/source/dev/theming.rst b/doc/source/dev/theming.rst
index 6ad5105d..20d60306 100644
--- a/doc/source/dev/theming.rst
+++ b/doc/source/dev/theming.rst
@@ -1,7 +1,7 @@
Theming module
==============
-.. automodule:: theming
+.. automodule:: poezio.theming
.. autoclass:: Theme
diff --git a/doc/source/dev/timed_events.rst b/doc/source/dev/timed_events.rst
index 82f49232..6eb7335a 100644
--- a/doc/source/dev/timed_events.rst
+++ b/doc/source/dev/timed_events.rst
@@ -1,7 +1,7 @@
Timed events documentation
==========================
-.. automodule:: timed_events
+.. automodule:: poezio.timed_events
.. autoclass:: TimedEvent
diff --git a/doc/source/themes.rst b/doc/source/themes.rst
index 0c2b143f..f6da6af5 100644
--- a/doc/source/themes.rst
+++ b/doc/source/themes.rst
@@ -110,5 +110,5 @@ All available options can be found into the default theme, which is into the
**theming.py** file from the poezio’s source code.
-.. autoclass:: theming.Theme
+.. autoclass:: poezio.theming.Theme
diff --git a/doc/stub/args.py b/doc/stub/args.py
deleted file mode 100644
index 4691a224..00000000
--- a/doc/stub/args.py
+++ /dev/null
@@ -1,34 +0,0 @@
-"""
-Module related to the argument parsing
-
-There is a fallback to the deprecated optparse if argparse is not found
-"""
-from os import path
-
-def parse_args(CONFIG_PATH=''):
- """
- Parse the arguments from the command line
- """
- try:
- from argparse import ArgumentParser, SUPPRESS
- except ImportError:
- from optparse import OptionParser
- from optparse import SUPPRESS_HELP as SUPPRESS
- parser = OptionParser()
- parser.add_option("-f", "--file", dest="filename", default=path.join(CONFIG_PATH, 'poezio.cfg'),
- help="The config file you want to use", metavar="CONFIG_FILE")
- parser.add_option("-d", "--debug", dest="debug",
- help="The file where debug will be written", metavar="DEBUG_FILE")
- parser.add_option("-v", "--version", dest="version",
- help=SUPPRESS, metavar="VERSION", default="0.8-dev")
- (options, args) = parser.parse_args()
- else:
- parser = ArgumentParser()
- parser.add_argument("-f", "--file", dest="filename", default=path.join(CONFIG_PATH, 'poezio.cfg'),
- help="The config file you want to use", metavar="CONFIG_FILE")
- parser.add_argument("-d", "--debug", dest="debug",
- help="The file where debug will be written", metavar="DEBUG_FILE")
- parser.add_argument("-v", "--version", dest="version",
- help=SUPPRESS, metavar="VERSION", default="0.8-dev")
- options = parser.parse_args()
- return options
diff --git a/doc/stub/config.py b/doc/stub/config.py
deleted file mode 100644
index 2bfe5b55..00000000
--- a/doc/stub/config.py
+++ /dev/null
@@ -1,225 +0,0 @@
-# Copyright 2010-2011 Florent Le Coz <louiz@louiz.org>
-#
-# This file is part of Poezio.
-#
-# Poezio is free software: you can redistribute it and/or modify
-# it under the terms of the zlib license. See the COPYING file.
-
-"""
-Defines the global config instance, used to get or set (and save) values
-from/to the config file
-"""
-
-DEFSECTION = "Poezio"
-
-from configparser import RawConfigParser, NoOptionError, NoSectionError
-from os import environ, makedirs, path
-from shutil import copy2
-from args import parse_args
-from common import safeJID
-
-
-
-class Config(RawConfigParser):
- """
- load/save the config to a file
- """
- def __init__(self, file_name):
- self.file_name = file_name
- RawConfigParser.__init__(self, None)
- # make the options case sensitive
- self.optionxform = str
- try:
- RawConfigParser.read(self, file_name, encoding='utf-8')
- except TypeError: # python < 3.2 sucks
- RawConfigParser.read(self, file_name)
- # Check config integrity and fix it if it’s wrong
- for section in ('bindings', 'var'):
- if not self.has_section(section):
- self.add_section(section)
-
- def get(self, option, default, section=DEFSECTION):
- """
- get a value from the config but return
- a default value if it is not found
- The type of default defines the type
- returned
- """
- try:
- if type(default) == int:
- res = self.getint(option, section)
- elif type(default) == float:
- res = self.getfloat(option, section)
- elif type(default) == bool:
- res = self.getboolean(option, section)
- else:
- res = self.getstr(option, section)
- except (NoOptionError, NoSectionError):
- return default
- return res
-
- def getl(self, option, default, section=DEFSECTION):
- """
- get a value and return it lowercase
- """
- return self.get(option, default, section).lower()
-
- def get_by_tabname(self, option, default, tabname, fallback=True, fallback_server=True):
- """
- Try to get the value for the option. First we look in
- a section named `tabname`, if the option is not present
- in the section, we search for the global option if fallback is
- True. And we return `default` as a fallback as a last resort.
- """
- if tabname in self.sections():
- if option in self.options(tabname):
- # We go the tab-specific option
- return self.get(option, default, tabname)
- if fallback_server:
- return self.get_by_servname(tabname, option, default, fallback)
- if fallback:
- # We fallback to the global option
- return self.get(option, default)
- return default
-
- def get_by_servname(self, jid, option, default, fallback=True):
- """
- Try to get the value of an option for a server
- """
- server = safeJID(jid).server
- if server:
- server = '@' + server
- if server in self.sections() and option in self.options(server):
- return self.get(option, default, server)
- if fallback:
- return self.get(option, default)
- return default
-
-
- def __get(self, option, section=DEFSECTION):
- """
- facility for RawConfigParser.get
- """
- return RawConfigParser.get(self, section, option)
-
- def getstr(self, option, section=DEFSECTION):
- """
- get a value and returns it as a string
- """
- return self.__get(option, section)
-
- def getint(self, option, section=DEFSECTION):
- """
- get a value and returns it as an int
- """
- try:
- return int(self.__get(option, section))
- except ValueError:
- return -1
-
- def getfloat(self, option, section=DEFSECTION):
- """
- get a value and returns it as a float
- """
- return float(self.__get(option, section))
-
- def getboolean(self, option, section=DEFSECTION):
- """
- get a value and returns it as a boolean
- """
- return RawConfigParser.getboolean(self, section, option)
-
- def write_in_file(self, section, option, value):
- """
- Our own way to save write the value in the file
- Just find the right section, and then find the
- right option, and edit it.
-
- TODO: make it write also new values in the file, not just what did already
- exist
- """
- if path.exists(self.file_name):
- df = open(self.file_name, 'r', encoding='utf-8')
- lines_before = (line.strip() for line in df.readlines())
- df.close()
- else:
- lines_before = []
- result_lines = []
- we_are_in_the_right_section = False
- written = False
- section_found = False
- for line in lines_before:
- if line.startswith('['): # check the section
- if we_are_in_the_right_section and not written:
- result_lines.append('%s = %s' % (option, value))
- written = True
- if line == '[%s]' % section:
- we_are_in_the_right_section = True
- section_found = True
- else:
- we_are_in_the_right_section = False
- if (line.startswith('%s ' % (option,)) or
- line.startswith('%s=' % (option,)) or
- line.startswith('%s = ' % (option,))) and we_are_in_the_right_section:
- line = '%s = %s' % (option, value)
- written = True
- result_lines.append(line)
-
- if not section_found:
- result_lines.append('[%s]' % section)
- result_lines.append('%s = %s' % (option, value))
- elif not written:
- result_lines.append('%s = %s' % (option, value))
-
-
- df = open(self.file_name, 'w', encoding='utf-8')
- for line in result_lines:
- df.write('%s\n' % line)
- df.close()
-
- def set_and_save(self, option, value, section=DEFSECTION):
- """
- set the value in the configuration then save it
- to the file
- """
- # Special case for a 'toggle' value. We take the current value
- # and set the opposite. Warning if the no current value exists
- # or it is not a bool.
- if value == "toggle":
- current = self.get(option, "", section)
- if current.lower() == "false":
- value = "true"
- elif current.lower() == "true":
- value = "false"
- else:
- return "Could not toggle option: %s. Current value is %s." % (option, current or "empty")
- if self.has_section(section):
- RawConfigParser.set(self, section, option, value)
- else:
- self.add_section(section)
- RawConfigParser.set(self, section, option, value)
- self.write_in_file(section, option, value)
- return "%s=%s" % (option, value)
-
-
- def set(self, option, value, section=DEFSECTION):
- """
- Set the value of an option temporarily
- """
- try:
- RawConfigParser.set(self, section, option, value)
- except NoSectionError:
- pass
-
-
-# creates the configuration directory if it doesn't exist
-# and copy the default config in it
-
-#options = parse_args(CONFIG_PATH)
-class Stub(object):
- def __getattribute__(self, v):
- def stub_func(self, *args, **kwargs): return ''
- return stub_func
-
-options = Stub()
-config = Stub()