Features/DevelopersAssistant

From FedoraProject

< Features(Difference between revisions)
Jump to: navigation, search
(Change date format for automatic processing)
(Detailed Description)
 
(20 intermediate revisions by 5 users not shown)
Line 22: Line 22:
 
== Current status ==
 
== Current status ==
 
* Targeted release: [[Releases/19 | Fedora 19 ]]  
 
* Targeted release: [[Releases/19 | Fedora 19 ]]  
* Last updated: 2013-01-23
+
* Last updated: 2013-03-12
* Percentage of completion: 2%
+
* Percentage of completion: 100%
 +
 
 +
See the progress at [https://github.com/bkabrda/devassistant https://github.com/bkabrda/devassistant]. Currently, we're finishing C/Java/Python assistants, we decided to include other languages later on (we'll probably do a non-disruptive update before beta freeze).
 +
 
 +
Package is now on review: https://bugzilla.redhat.com/show_bug.cgi?id=919460
 +
 
 +
Done.
  
 
<!-- CHANGE THE "FedoraVersion" TEMPLATES ABOVE TO PLAIN NUMBERS WHEN YOU COMPLETE YOUR PAGE. -->
 
<!-- CHANGE THE "FedoraVersion" TEMPLATES ABOVE TO PLAIN NUMBERS WHEN YOU COMPLETE YOUR PAGE. -->
 +
 
== Detailed Description ==
 
== Detailed Description ==
 
This feature aims on setting up development environment for various languages. Target groups include beginning developers but also experienced developers not used to GNU/Linux as well as experienced Linux developers not used to Fedora.
 
This feature aims on setting up development environment for various languages. Target groups include beginning developers but also experienced developers not used to GNU/Linux as well as experienced Linux developers not used to Fedora.
Line 32: Line 39:
  
 
There are other optional activities like vim/eclipse/emacs/... plugins, integration of rpm build tools, .... These optional parts are not goal for F19 but they will be integrated in time.
 
There are other optional activities like vim/eclipse/emacs/... plugins, integration of rpm build tools, .... These optional parts are not goal for F19 but they will be integrated in time.
 +
 +
Assistants can be written either as YAML configuration files or as python module.
  
 
Languages:  
 
Languages:  
* C (phracek [https://fedoraproject.org/wiki/User:Phracek/DevelopersAssistant FedoraProjectWiki])
+
* C/C++ (phracek [https://fedoraproject.org/wiki/User:Phracek/DevelopersAssistant FedoraProjectWiki])
 +
** create YAML configuration file
 +
** sample C/C++ files
 +
** rpm dependencies
 +
** compilation over autotools
 +
** spec file for creating RPM package
 +
** documentation how add new C/C++ sources and how to build up (README)
 
* Ruby (vondruch)
 
* Ruby (vondruch)
 +
** Ruby on Rails - create a default Ruby on Rails application and install all necessary dependencies; running "rails s" in the project directory starts the web server and allows to try the application in web browser
 +
** All Ruby assistants: create a git repository in the directory of the project; can register project repo on github
 
* Python (bkabrda)
 
* Python (bkabrda)
* Perl (mmaslano)
+
** Django - create a Django project with sane settings and install dependencies; running "manage.py runserver" in the project directory works straight away with no needed changes
 +
** Flask - create a Flask project with sane settings and install dependencies; running "manage.py runserver" in the project directory works straight away with no needed changes
 +
** Lib - create a custom Python (setuptools using) library skeleton; running "setup.py sdist" in the project directory works straight away with no needed changes
 +
** PyGTK - create a basic PyGTK window with basic widgets functionality; running "./template-gui.py" in the project directory works straight away with no needed changes
 +
** All the Python assistants: create a git repository in the directory of the project; can setup eclipse with pydev and import project into workspace; can register project repo on github
 +
* Perl (phracek and ppisar)
 +
** Dancer - create a Dancer project with sane settings and install dependencies; running "./bin/app.pl" in the project directory works straight away with no needed changes
 +
** Class - create a basic Perl class project; running "./main.pl" in project directory works straight away with no needed changes
 
* PHP (rcollet)
 
* PHP (rcollet)
 
* Java (msrb)
 
* Java (msrb)
 +
** Maven - create simple Maven project, install dependencies; command "./run" from project directory will run the project
 +
** JSF - create simple JavaServer Faces project, install dependencies; command "./run" from project directory will start embedded web server and user can check the result from browser (localhost:8080); command "./run rpm" from project directory will create SRPM and RPM packages
 +
** All Java assistants: create a git repository in the directory of the project; build the project; create tarball; can setup eclipse project which user can import to his workspace; can register project repository on github
 
* Javascript
 
* Javascript
 +
  
 
Other activities:
 
Other activities:
 
* vim (phracek)
 
* vim (phracek)
 +
** clarify whether is possible to include into vimrc file row which will enable devassistant
 
* eclipse (phracek)
 
* eclipse (phracek)
 +
** integrate project into eclipse environment
 +
** test basic eclipse functionality like compilation, debugging, etc.
 
* rpm build tools
 
* rpm build tools
 +
** each assistant should have one spec file for building RPM package
 +
** create sample subroutine in YAML configuration file which can be used by each language
 
* git integration
 
* git integration
 +
** create local repository
 +
** call git commands from configuration script (YAML)
 +
** registration project on GitHub repository
 +
** downloading project from GitHub repository
  
 
== Benefit to Fedora ==
 
== Benefit to Fedora ==
Line 85: Line 122:
 
== Documentation ==
 
== Documentation ==
 
<!-- Is there upstream documentation on this feature, or notes you have written yourself?  Link to that material here so other interested developers can get involved. -->
 
<!-- Is there upstream documentation on this feature, or notes you have written yourself?  Link to that material here so other interested developers can get involved. -->
Blog posts will be released to make some publicity. Man pages will be primary source of documentation for the functionality. The documentation will be developed along with the functionality.
+
Blog posts will be released to make some publicity. Man pages will be primary source of documentation for the functionality. The documentation will be developed along with the functionality
 +
 
 +
=== GitHub Integration ===
 +
 
 +
one part of that feature was to have a possibility export projects to the GitHub repository.
 +
 
 +
This part is mostly done but has one restriction.
 +
 
 +
User has to have already created account on the GitHub server. Without that it is not possible to upload projects on the GitHub server.
  
 
== Release Notes ==
 
== Release Notes ==

Latest revision as of 07:47, 24 June 2013


Contents

[edit] Developers Assistant

[edit] Summary

Perform a series of various changes to improve developer experience on Fedora.

[edit] Owner

  • Email: <jzeleny@redhat.com>
  • Email: <mmaslano@redhat.com>

(Please add yourself if you are responsible for some part of it).

[edit] Current status

  • Targeted release: Fedora 19
  • Last updated: 2013-03-12
  • Percentage of completion: 100%

See the progress at https://github.com/bkabrda/devassistant. Currently, we're finishing C/Java/Python assistants, we decided to include other languages later on (we'll probably do a non-disruptive update before beta freeze).

Package is now on review: https://bugzilla.redhat.com/show_bug.cgi?id=919460

Done.


[edit] Detailed Description

This feature aims on setting up development environment for various languages. Target groups include beginning developers but also experienced developers not used to GNU/Linux as well as experienced Linux developers not used to Fedora.

This feature will cover a basic set of tasks which will prepare Fedora for later additions. The first part of the feature is a review of comps groups which would lead to better granularity of package sets necessary for development in different languages. Another part is about providing tool or tools for simple start of a project in terms of creating project template based on different languages and/or frameworks which the project should use.

There are other optional activities like vim/eclipse/emacs/... plugins, integration of rpm build tools, .... These optional parts are not goal for F19 but they will be integrated in time.

Assistants can be written either as YAML configuration files or as python module.

Languages:

  • C/C++ (phracek FedoraProjectWiki)
    • create YAML configuration file
    • sample C/C++ files
    • rpm dependencies
    • compilation over autotools
    • spec file for creating RPM package
    • documentation how add new C/C++ sources and how to build up (README)
  • Ruby (vondruch)
    • Ruby on Rails - create a default Ruby on Rails application and install all necessary dependencies; running "rails s" in the project directory starts the web server and allows to try the application in web browser
    • All Ruby assistants: create a git repository in the directory of the project; can register project repo on github
  • Python (bkabrda)
    • Django - create a Django project with sane settings and install dependencies; running "manage.py runserver" in the project directory works straight away with no needed changes
    • Flask - create a Flask project with sane settings and install dependencies; running "manage.py runserver" in the project directory works straight away with no needed changes
    • Lib - create a custom Python (setuptools using) library skeleton; running "setup.py sdist" in the project directory works straight away with no needed changes
    • PyGTK - create a basic PyGTK window with basic widgets functionality; running "./template-gui.py" in the project directory works straight away with no needed changes
    • All the Python assistants: create a git repository in the directory of the project; can setup eclipse with pydev and import project into workspace; can register project repo on github
  • Perl (phracek and ppisar)
    • Dancer - create a Dancer project with sane settings and install dependencies; running "./bin/app.pl" in the project directory works straight away with no needed changes
    • Class - create a basic Perl class project; running "./main.pl" in project directory works straight away with no needed changes
  • PHP (rcollet)
  • Java (msrb)
    • Maven - create simple Maven project, install dependencies; command "./run" from project directory will run the project
    • JSF - create simple JavaServer Faces project, install dependencies; command "./run" from project directory will start embedded web server and user can check the result from browser (localhost:8080); command "./run rpm" from project directory will create SRPM and RPM packages
    • All Java assistants: create a git repository in the directory of the project; build the project; create tarball; can setup eclipse project which user can import to his workspace; can register project repository on github
  • Javascript


Other activities:

  • vim (phracek)
    • clarify whether is possible to include into vimrc file row which will enable devassistant
  • eclipse (phracek)
    • integrate project into eclipse environment
    • test basic eclipse functionality like compilation, debugging, etc.
  • rpm build tools
    • each assistant should have one spec file for building RPM package
    • create sample subroutine in YAML configuration file which can be used by each language
  • git integration
    • create local repository
    • call git commands from configuration script (YAML)
    • registration project on GitHub repository
    • downloading project from GitHub repository

[edit] Benefit to Fedora

Make the development on Fedora easier for beginners.

[edit] Scope

  • Adding new (leaf) packages, which will contain setup scripts.
  • Comps: a review of existing development-related package groups will take place
    • cleanup of some groups will be necessary
    • new groups might be created to meet the demand for per-language tool and library sets

[edit] How To Test

Try to install package containing setup for your favourite language.

[edit] User Experience

Entry barrier for development on Linux should be lower. Inexperienced users will be able to setup their development faster.

[edit] Dependencies

None at the moment, none expected. We intend to build on top of current state of Fedora.

[edit] Contingency Plan

Do not ship the result if not ready. Since the feature is not required for anything else in the system, there will be no complications if not shipped. Changes in comps groups will be consulted before pushed and if necessary, changes can be simply reverted.

[edit] Documentation

Blog posts will be released to make some publicity. Man pages will be primary source of documentation for the functionality. The documentation will be developed along with the functionality

[edit] GitHub Integration

one part of that feature was to have a possibility export projects to the GitHub repository.

This part is mostly done but has one restriction.

User has to have already created account on the GitHub server. Without that it is not possible to upload projects on the GitHub server.

[edit] Release Notes

Developers Assistant feature will provide packages containing skeletons, settings, which will provide help to developers. Also new or improved yum groups are part of this feature.

[edit] Comments and Discussion