Skip to content

Commit 2746fd4

Browse files
committed
updated readme
1 parent bf25c4c commit 2746fd4

File tree

1 file changed

+36
-0
lines changed

1 file changed

+36
-0
lines changed

README.md

Lines changed: 36 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -77,17 +77,53 @@ class MyFormatter(Base):
7777
**Note:** The console should yell at you if you didn't write all the abstract methods. Be sure to read the docs on the `Base` formatter
7878
to make sure you understand all the caveats of each formatter function.
7979

80+
Local Development
81+
-----------------
82+
83+
Below are the instructions to work on this repo locally.
84+
85+
1. Clone the repo.
86+
1. Uninstall the plugin from sublime text.
87+
1. Symlink the github repo into your sublime text packages directory.
88+
- Debian example:
89+
```bash
90+
ln -s <absolute/path/to/github/repo/sublime_docblockr_python> $HOME/.config/sublime-text-3/Packages/Docblockr_Python
91+
```
92+
1. There are no runtime dependencies
93+
1. Pay attention to the sublime console ```ctrl + ` ```
94+
95+
96+
Testing Changes
97+
---------------
98+
99+
In addition to the setup instructions above, testing will require additinoal setup.
100+
101+
**System Requirements:**
102+
- [pyenv](https://github.com/pyenv/pyenv)
103+
- [pipenv](https://pipenv.readthedocs.io/en/latest/)
104+
105+
**Setup:**
106+
1. Install depedencies through pipenv `pipenv install --dev`
107+
1. Run unit tests `pipenv run tox`
108+
- [py.test](https://docs.pytest.org/en/latest/) unit tests
109+
- [flake8](http://flake8.pycqa.org/en/latest/) linting
110+
- [pydocstyle](http://www.pydocstyle.org/en/2.1.1/) (formerly PEP257) docstring checker
111+
80112

81113
Known Issues
82114
------------
83115
- Only detects closed docstring if it is on a line of the same indentation, and has no text in front of it. Single Line docstrings are converted to block
116+
- The tests run in python `3.4.3`, however sublime's python version is `3.3.6`. This is due to the difficulty of getting a working version of 3.3.6 in a dev environment, and the differences should be minimal.
84117

85118

86119
Roadmap
87120
-------
88121
Things I want to do wtih this project. Not necessarily an exhaustive or prioritized list.
89122

90123
- Unit Tests!
124+
- Needs a test harness of some sort for sublime internals.
125+
- CI, probably circleci
126+
- Coverage reporting
91127
- More completions!
92128
- Javadoc style formatter
93129
- Keyboard Shortcuts

0 commit comments

Comments
 (0)