DSAG, Walldorf, 2018
@LarsHvam
larshp

What is git and GitHub?


Decentralized version control system, it allows you to:
  • Compare changes over time
  • Rollback files to old version
  • Track who changed what
  • And alot more


GitHub
Hosting service for git, free for public projects.
  • Provides graphical web interface
  • Collaboration via Pull Requests

Why git and GitHub?

As of April 2017, GitHub reports having almost 20 million users and 57 million repositories.

Disclaimer

Test in sandbox
  • Open source
  • Old versions available
  • Contribute
client for ABAP
started ~4 years ago
~3000 commits
50 contributors
~70000 lines
7.02 and up?
MIT License
Alexander Tsybulsky Eduardo Copat
Oliver Jägle Alexander Geppart
Andrei Vishnevsky Bohdan Petrushchak
Graham Robinson Gregor Wolf
Nuno Godinho Fabio Zuber
Fabian Lupa Christian Günter
Christian Tapia Sabogal Domi Bigl
Giovanni Degani Kasper Vilhelm Torp
Christian Pfaller Alex Chan
Johannes Konings Thoralf Hänsel
Jakub Filak + more

Design Goals

  • Easy installation
  • Easy upgrade
  • Small system footprint
  • Code readable in git repository

Connectivity

cl_http_client=>create_by_url(
  EXPORTING
    url    = 'https://github.com'
    ssl_id = 'ANONYM'
  IMPORTING
    client = li_client ).
li_client->request->set_cdata( '' ).
li_client->request->set_header_field(
  name  = '~request_method'
  value = 'GET' ).
li_client->request->set_header_field(
  name  = 'user-agent'
  value = 'git/abapGitv1.9.7' ).
li_client->request->set_header_field(
  name  = '~request_uri'
  value = '/larshp/abapOpenChecks.git/info/refs?service=git-upload-pack' ).
li_client->send( ).

001e# service=git-upload-pack
000000fb868c5c06d2b51f6b83668f80922260f42a7ff4ca HEAD multi_ack thin-pack ...
003f868c5c06d2b51f6b83668f80922260f42a7ff4ca refs/heads/master
0040c1398119983b0ae48ec4091d9519194768a71bae refs/pull/268/head
0000

Serialization

zhello.prog.abap 
REPORT zhello.

WRITE 'hello'.
zhello.prog.xml 
<?xml version="1.0" encoding="utf-8"?>
<abapGit version="v1.0.0" serializer="LCL_OBJECT_PROG" serializer_version="v1.0.0">
 <asx:abap xmlns:asx="http://www.sap.com/abapxml" version="1.0">
  <asx:values>
   <PROGDIR>
    <NAME>ZHELLO</NAME>
    <STATE>A</STATE>
    <VARCL>X</VARCL>
    <SUBC>1</SUBC>
    <RLOAD>E</RLOAD>
    <FIXPT>X</FIXPT>
    <UCCHECK>X</UCCHECK>
   </PROGDIR>
   <TPOOL>
    <item>
     <ID>R</ID>
     <ENTRY>test</ENTRY>
     <LENGTH>4</LENGTH>
    </item>
   </TPOOL>
  </asx:values>
 </asx:abap>
</abapGit>

And deserialization

All files can be imported back into the ABAP system

Supported object types

ACID AUTH CLAS DCLS DDLS DOCT
DOCV DOMA DTEL ENHC ENHO ENHS
ENQU FUGR IARP IASP IATU MSAG
NROB PARA PINF PROG SAMC SAPC
SFBF SFBS SFSW SHI3 SHLP SICF
SPLO SSFO SSST SFPI SFPF SMIM
STYL SUSC SUSO TABL TOBJ TRAN
TTYP TYPE VCLS VIEW W3HT W3MI
WAPA WDYA WDYN WEBI XSLT + more

Features: Works With


Team Services

git status


git diff

git add


git commit, push


git log

And more

  • Merging branches
  • git patch
  • Running code inspector
  • Tagging
  • Switching between branches
  • git reset

Features: Offline projects

Features: Background mode

Use case: Share/Collaborate


Fork
Commit
Create Pull Request
Review
Merge
Understanding the GitHub Flow

Use case: Extra visibility/backup


abapGitServer Setup Guide




Serban Petrescu

Roadmap

  • Release as often as possible
  • ADT_Frontend => abapGit API
  • Parallel processing
  • Git dependencies


not abapGit

  • decentralized git
  • same restrictions as all other ABAP programs(branching)
  • code promotion/deployment

#ABAPisNotDead

https://larshp.github.io/Presentations/dsag2018

http://docs.abapgit.org/other-where-used.html

Contribute

 http://abapgit.org

Twitter

 @LarsHvam

Features: Explore

How did it start?

Datamatrix

First commit

evolution: single report -> includes -> global classes

abapmerge (MIT License)

Masterplan

  • strategy/masterplan
  • open open source
  • break stuff and ship it
  • how and what to contribute

Github Support

The HTTP header incident
rfc2616-sec4.html#sec4.2
"Field names are case-insensitive"
The SHA1 mismatch
Git protocol: "Server and client MUST use lowercase for obj-id, both MUST treat obj-id as case-insensitive."