Description¶

Most of the initial code is contributed by luigi project Started as discussion: https://groups.google.com/forum/#!topic/luigi-user/ZLGJCj0dBJI

... As a Luigi user for the past couple of years, I have found out that I am using the concept of Luigi targets in most of the projects I was working on. Transparent file system, atomic write/reads, formats is a great functionality, and is highly missing from the global Python eco system. Moreover, going over multiple workflow management project implementations(mrjob,airflow) I have always been surprised to see yet another implementation of the abstraction over fs/ssh/s3/ftp/etc all over again.

As a developer, and especially as a Python developer, I want to focus on implementation of my business requirements, instead of working with low level filesystem APIs. The standard “open” function is simply not strong enough. ...

Features¶

• TODO

Credits¶

This package was created with Cookiecutter evgenyshulman/cookiecutter-pypackage and the audreyr/cookiecutter-pypackage project template.

Initial version of Targets is based on Luigi project.

Luigi was built at Spotify, mainly by Erik Bernhardsson and Elias Freider. Many other people have contributed since open sourcing in late 2012. Arash Rouhani is currently the chief maintainer of Luigi.

Types of Contributions¶

Get Started!¶

Ready to contribute? Here’s how to set up targets for local development.

1. Fork the targets repo on GitHub.

2. Clone your fork locally:

   $ git clone git@github.com:your_name_here/targets.git
   

3. Install your local copy into a virtualenv. Assuming you have virtualenvwrapper installed, this is how you set up your fork for local development:

   $ mkvirtualenv targets
   $ cd targets/
   $ python setup.py develop
   

4. Create a branch for local development:

   $ git checkout -b name-of-your-bugfix-or-feature
   

   Now you can make your changes locally.

5. When you’re done making changes, check that your changes pass flake8 and the tests, including testing other Python versions with tox:

   $ flake8 targets tests
   $ make test
   $ make test-all
   

   To get flake8 and tox, just pip install them into your virtualenv.

6. Commit your changes and push your branch to GitHub:

   $ git add .
   $ git commit -m "Your detailed description of your changes."
   $ git push origin name-of-your-bugfix-or-feature
   

7. Submit a pull request through the GitHub website.

Pull Request Guidelines¶

Before you submit a pull request, check that it meets these guidelines:

1. The pull request should include tests.
2. If the pull request adds functionality, the docs should be updated. Put your new functionality into a function with a docstring, and add the feature to the list in README.rst.
3. The pull request should work for Python 2.7, 3.3, 3.4 and 3.5, and for PyPy. Check https://travis-ci.org/targets-fs/targets-python/pull_requests and make sure that the tests pass for all supported Python versions.

Tips¶

To run a subset of tests:

$ python -m unittest tests.test_targets

Development Lead¶

• evgenyshulman <shulman.e@gmail.com>

Contributors¶

None yet. Why not be the first?

Initial Version¶

Most of the initial code is contributed by luigi project Started at discussion: https://groups.google.com/forum/#!topic/luigi-user/ZLGJCj0dBJI

Luigi was built at Spotify, mainly by Erik Bernhardsson and Elias Freider. Many other people have contributed since open sourcing in late 2012. Arash Rouhani is currently the chief maintainer of Luigi.

0.1.0 (2016-1-22)¶

• First release on PyPI.