Skip to content


Subversion checkout URL

You can clone with
Download ZIP
Fetching contributors…

Cannot retrieve contributors at this time

132 lines (130 sloc) 8.239 kb
# Once basic functionality has been restored
* See all TODO markings in source code
* Take a step back, reorganize. E.g.:
* stuff in `utils` should be user-useful only, other subroutines ought to go
* Should probably move subroutines in `main` to another module so that
`main` is just that: `main()`. New module would be something like `core` -
subroutines of the same sort found in `utils` but NOT usually for user
consumption (and ALSO not generally used multiple times by internals? or
should this be the same spot as other non-user-facing subroutines?)
* Also note that a number of main() subroutines right now, such as the
ones for finding settings, and setting host lists, should be updated so
that library users can use them!
* Re-examine API of existing operations, e.g. prompt's `validate` option
* wrt `validate`, figure out which is better: 'dual-mode' single arguments
like that, or splitting it into 2 different arguments
* dual-mode makes sense given an either-or situation like that one
* but at the same time it feels kind of messy
* see how stdlib does it in similar situations. guessing 2 arguments
with "only X or Y may be given, but not both at the same time" note?
* look at the rest too
* Output handling -- how to deal with:
* Status info
* Warnings
* Errors/failures (both printing info, and how to abort or not abort flow)
* Also provide easy access to the return code, regardless of whether
Fabric actually fails -- i.e. have some level where the user can
inspect return codes and decide on their own whether to abort() or what
* Exceptions (outside of the ones involved with errors/failures)
* As mentioned elsewhere, want to make this as flexible as possible
* Put in logging-to-disk and/or leverage the logging module for stdout too?
* e.g. it already has the concepts of info/warn/etc -- can that be used?
* Ensure things behave gracefully when used as a lib
* Temporarily had 'invoked_as_fab' env var set in main(); but that made
testing a huge pain, so backed it out. Put it back in? or find some
other method? perhaps inverse -- setting has to be turned on
explicitly by a library user? or just ensure that e.g. printing,
exceptions have simple controls for making them shut up?
* Regardless of other work in this area, make sure `local` can be
configured to print its output without being wrapped in `print` (durr)
* Continue building out any previously made tests till implies we
have pretty decent coverage (100% would be nice but even a 100% from
doesn't literally mean full coverage...)
* Have started using Nose for testing, probably stick with that;
* Ditto with Fudge for mocking/stubbing/expecting; may need to contribute
some patches to it, though, it's not great for functional coding and I
don't see the need to 100% class-ify my code just so my mocker works better.
* Sphinx documentation
* Build out the API docs; probably just one RST file per module, with
automodule in use (see test api.rst file for details).
* Update all docstrings so they "read well" in the generated API:
* General language / tense / etc
* Where applicable, turn ``function()`` into `function` (so the default
role takes effect and makes it a link)
* If that default role doesn't work right for non-functions, add the
appropriate :type: prefixes.
* Go over old static docs to make sure anything applicable is copied over
and updated.
* Don't forget the top level text files, e.g. INSTALL
* Run Pylint, fix what it complains about (and generate a config file to make it
shut up about stuff I don't care about)
* Make sure "constants" are consistently named: I've been trending towards not
using ALL_CAPS, but in some places I probably did use them, so check and
update (or change my mind and go back; but it just feels ugly when one is
referencing e.g. ENV in user code all over...)
* Possibly note in docs that callables imported into one's fabfile will show up
as executable tasks; i.e. they'll clutter --list and can be invoked via
* If we do note this for users, probably suggest the obvious: import
modules instead of callables, and use module.callable instead.
* Also good to note that they can take *advantage* of this to make
"meta-fabfiles" collecting a number of sub-fabfiles' tasks into one
user-facing presentation.
* Although, with flags for manually specifying 1+ sub-fabfiles at
runtime, that becomes less necessary, though still useful.
* Start a 'lib' type thing with non-atomic builtin commands, e.g. `sudo_put`.
Figure out how best to accomplish this: where should it live? what's the most
idiomatic way to present it to users?
* Could borrow a page from Django and call it `contrib`
* Or, if all previously builtin "commands" are now option flags, we could
simply have `commands`, which makes it obvious that they are on the same
level as user-defined commands.
* Terminology: rename 'commands' to 'tasks', 'operations' to 'commands' or
'functions' or something?
* Plus: 'tasks' and etc sounds more natural to me; given how big of a
shake-up this is, why not go whole hog?
* Minus: commands/operations aren't all that bad for names, and should
avoid tendency to redo everything for redoing's sake.
* Minus: 'commands' feels like the most natural fit for a rename of
'operations' -- but then it's pretty confusing given the previous use of
* Add Paramiko SSHConfig support: it can provide username and port and other
options. Look at `man ssh_config` for what else people can put in that file.
* Try to make Fabric threadsafe (and/or not using threads for outputting)
* Right now it uses threads and shared state for outputting, and shared
state for env/connection/etc stuff. This is probably not threadsafe as-is.
* Even if the shared state works OK, the thread use in outputting is kind
of wonky. See if it can be redone with coroutines or Twisted or something.
* Make execution model more robust/flexible:
* Right now, relatively simple, calls each function one by one, and for each
function, runs on each host one by one, and the host list may be different
* What may make more sense is to specify host list "first", then for each
host, you call each function in turn (in which case the order of functions
may matter more than it does now). This would mean that the logic for host
discovery changes a decent amount.
* Do we want to allow this to be switched up dynamically? I.e. allow user
to specify a "mode" (like in the old Fabric) to determine which of those
two algorithms is used?
* How do these decisions affect what decorators/etc can be applied? I.e.
@hosts doesn't make any sense in the latter scenario because there is only
one global host list per session. (But isn't that the more sensible
solution? When would you execute a `fab` command line and expect the host
list to change during the session?
* Possibly add back in the old `shell` functionality (it would have to be a
command line option such as `--shell` -- there are no more internal "commands"
and it doesn't make sense as one anyway, as it cannot be run along with other
commands at the same time.)
* Probably leverage IPython as a library, I've seen it done before
* Should end up equivalent to a user running `ipython` and then doing a
bunch of typical Fabric imports, i.e. all the operations plus `env`.
* Check Python 2.6 compatibility.
* Consider tweaking `prompt` so the env-setting aspect is optional. I expect
many people will only be using it to return the value (in which case it's
basically just a nicer `raw_input`, but still.)
* Bash tab-completion for Fab tasks, assuming it can be done without being too
* Possibly allow "aliases" in `env`, i.e. user/username are treated as being the
same key to limit possible confusion.
<!-- vim:set filetype=mkd : -->
Jump to Line
Something went wrong with that request. Please try again.