def generar_docstring_rst(self):
"""Esta función permite estructurar una lista de archivos obtimos para utilizar los comandos de Pyment"""
for f in self.get_files('py'):
fpatch = f+".patch"
c = PyComment(f)
c.proceed()
c.diff_to_file(fpatch)
cmd("patch {0} {1}",f,fpatch)
cmd("rm {0}",fpatch)
def run(source,
files=[],
input_style='auto',
output_style='reST',
first_line=True,
quotes='"""',
init2class=False,
convert=False,
config_file=None,
ignore_private=False,
overwrite=False):
if input_style == 'auto':
input_style = None
config = get_config(config_file)
if 'init2class' in config:
init2class = config.pop('init2class')
if 'convert_only' in config:
convert = config.pop('convert_only')
if 'quotes' in config:
quotes = config.pop('quotes')
if 'input_style' in config:
input_style = config.pop('input_style')
if 'output_style' in config:
output_style = config.pop('output_style')
if 'first_line' in config:
first_line = config.pop('first_line')
for f in files:
if os.path.isdir(source):
path = source + os.sep + os.path.relpath(os.path.abspath(f),
os.path.abspath(source))
path = path[:-len(os.path.basename(f))]
else:
path = ''
c = PyComment(f,
quotes=quotes,
input_style=input_style,
output_style=output_style,
first_line=first_line,
ignore_private=ignore_private,
convert_only=convert,
**config)
c.proceed()
if init2class:
c.docs_init_to_class()
if overwrite:
c.write_to_file()
else:
c.diff_to_file(os.path.basename(f) + ".patch", path, path)
def run(source, files=[], input_style='auto', output_style='reST', first_line=True, quotes='"""', init2class=False, convert=False, config_file=None, ignore_private=False):
if input_style == 'auto':
input_style = None
config = get_config(config_file)
if 'init2class' in config:
init2class = config.pop('init2class')
if 'convert_only' in config:
convert = config.pop('convert_only')
if 'quotes' in config:
quotes = config.pop('quotes')
if 'input_style' in config:
input_style = config.pop('input_style')
if 'output_style' in config:
output_style = config.pop('output_style')
if 'first_line' in config:
first_line = config.pop('first_line')
for f in files:
if os.path.isdir(source):
path = source + os.sep + os.path.relpath(os.path.abspath(f), os.path.abspath(source))
path = path[:-len(os.path.basename(f))]
else:
path = ''
c = PyComment(f, quotes=quotes,
input_style=input_style,
output_style=output_style,
first_line=first_line,
ignore_private=ignore_private,
convert_only=convert,
**config)
c.proceed()
if init2class:
c.docs_init_to_class()
c.diff_to_file(os.path.basename(f) + ".patch", path, path)
def run(source, files=[], input_style='auto', output_style='reST', first_line=True, quotes='"""',
init2class=False, convert=False, config_file=None, ignore_private=False, overwrite=False):
if input_style == 'auto':
input_style = None
config = get_config(config_file)
if 'init2class' in config:
init2class = config.pop('init2class')
if 'convert_only' in config:
convert = config.pop('convert_only')
if 'quotes' in config:
quotes = config.pop('quotes')
if 'input_style' in config:
input_style = config.pop('input_style')
if 'output_style' in config:
output_style = config.pop('output_style')
if 'first_line' in config:
first_line = config.pop('first_line')
for f in files:
if os.path.isdir(source):
path = source + os.sep + os.path.relpath(os.path.abspath(f), os.path.abspath(source))
path = path[:-len(os.path.basename(f))]
else:
path = ''
c = PyComment(f, quotes=quotes,
input_style=input_style,
output_style=output_style,
first_line=first_line,
ignore_private=ignore_private,
convert_only=convert,
**config)
c.proceed()
if init2class:
c.docs_init_to_class()
if overwrite:
list_from, list_to = c.compute_before_after()
lines_to_write = list_to
else:
lines_to_write = c.get_patch_lines(path, path)
if f == '-':
sys.stdout.writelines(lines_to_write)
else:
if overwrite:
if list_from != list_to:
c.overwrite_source_file(lines_to_write)
else:
c.write_patch_file(os.path.basename(f) + ".patch", lines_to_write)
def run(source,
files=[],
input_style='auto',
output_style='reST',
first_line=True,
quotes='"""',
init2class=False,
convert=False,
config_file=None,
ignore_private=False,
overwrite=False):
if input_style == 'auto':
input_style = None
config = get_config(config_file)
if 'init2class' in config:
init2class = config.pop('init2class')
if 'convert_only' in config:
convert = config.pop('convert_only')
if 'quotes' in config:
quotes = config.pop('quotes')
if 'input_style' in config:
input_style = config.pop('input_style')
if 'output_style' in config:
output_style = config.pop('output_style')
if 'first_line' in config:
first_line = config.pop('first_line')
for f in files:
if os.path.isdir(source):
path = source + os.sep + os.path.relpath(os.path.abspath(f),
os.path.abspath(source))
path = path[:-len(os.path.basename(f))]
else:
path = ''
c = PyComment(f,
quotes=quotes,
input_style=input_style,
output_style=output_style,
first_line=first_line,
ignore_private=ignore_private,
convert_only=convert,
**config)
c.proceed()
if init2class:
c.docs_init_to_class()
if overwrite:
list_from, list_to = c.compute_before_after()
lines_to_write = list_to
else:
lines_to_write = c.get_patch_lines(path, path)
if f == '-':
sys.stdout.writelines(lines_to_write)
else:
if overwrite:
if list_from != list_to:
c.overwrite_source_file(lines_to_write)
else:
c.write_patch_file(
os.path.basename(f) + ".patch", lines_to_write)
param2 - descr of param2
Returns:
some value
Raises:
keyError: raises key exception
TypeError: raises type exception
'''
pass
class A:
def method(self, param1, param2=None):
pass
if __name__ == "__main__":
import os
from pyment import PyComment
filename = __file__
print filename
c = PyComment(filename)
c.proceed()
c.diff_to_file(os.path.basename(filename) + ".patch")
for s in c.get_output_docs():
print(s)
def docstring(filename, write, verbose):
"""Manage the docstrings for the project.
If verbose is passed in, print out the diffs.
If a filename is passed in, run only on that file. Otherwise run on all files.
If write is passed in, and a filename is passed. Then overwrite the changes and run black.
"""
# Only overwrite if looking at a single file and write flag is passed in.
if filename and write:
pycom = PyComment(filename, output_style="google")
pycom.proceed()
list_from, list_to = pycom.compute_before_after()
if list_from != list_to:
click.echo(
f"Overwriting file: { filename } with changes and calling tool black"
)
pycom.overwrite_source_file(list_to)
call(["black", filename])
else:
click.echo(f"No changes needed for file: { filename }")
return
file_list = []
if filename:
file_list = [filename]
else:
files_and_directories = get_root_files_and_directories()
for item in files_and_directories:
file_list.extend(get_files_from_dir(item))
files_with_changes = 0
files_without_changes = 0
total_files = len(file_list)
for file in file_list:
pycom = PyComment(file, output_style="google")
pycom.proceed()
# calculate the difference and track stats
diff = pycom.diff()
if len(diff) > 0:
files_with_changes = files_with_changes + 1
if verbose:
click.echo(f"File: { file } has changes")
for line in diff:
click.echo(line, nl=False)
else:
files_without_changes = files_without_changes + 1
if verbose:
click.echo(f"File: { file } does not have changes")
click.echo((
f"{total_files} files scanned, {files_with_changes} files with changes and "
f"{files_without_changes} files without changes."))
#!/usr/bin/env python
# coding: utf-8
import os
import re
from pyment import PyComment
import gensim
import numpy as np
from sklearn.metrics.pairwise import cosine_similarity
import networkx as nx
try:
FILENAME = 'pagesummarizer.py'
C = PyComment(FILENAME)
C.proceed()
C.diff_to_FILE(os.path.basename(FILENAME) + ".patch")
for s in C.get_output_docs():
print(s)
# reading FILE
FILE = open("mayowa.txt", "r")
DATA = FILE.readlines()
FILE.close()
def preprocessor(text):
"""Lowers the case of the input, removes everything
inside [] then removes 's and fetches only ascii characters
param1 - descr of param1 that has True for default value.
param2 - descr of param2
Returns:
some value
Raises:
keyError: raises key exception
TypeError: raises type exception
'''
pass
class A:
def method(self, param1, param2=None):
pass
if __name__ == "__main__":
import os
from pyment import PyComment
filename = __file__
print filename
c = PyComment(filename)
c.proceed()
c.diff_to_file(os.path.basename(filename) + ".patch")
for s in c.get_output_docs():
print(s)